帮助和常见问题

下载 HeyLook_<version>_windows_x64-setup.exe（Windows 10或11，64位；推荐）。.msi适用于集中管理的部署，本身不会安装WebView2；setup.exe则会安装。通过MSI更新时需要管理员权限。

安装程序尚未经过代码签名。如果出现SmartScreen提示，请依次选择更多信息和仍要运行。

通用版.dmg适用于macOS 11或更高版本，支持Apple芯片和Intel。应用使用自签名证书签名，但没有经过Apple公证，所以macOS会在首次启动时拦截一次。

1. 打开.dmg，把 Hey Look! 拖到应用程序，然后从“应用程序”中启动它（不要从磁盘映像中启动）。
2. macOS会提示“Hey Look!”未打开。点击完成，不要点“移到废纸篓”。
3. 打开系统设置 > 隐私与安全性，滚动到安全性，点击提示Hey Look!的那条消息旁边的仍要打开，用密码或Touch ID确认，然后点击打开。

想用“终端”？可以只运行一次下面的命令，代替第2步和第3步：xattr -dr com.apple.quarantine "/Applications/Hey Look!.app"

Hey Look!自行安装的版本可以正常启动。程序坞图标会显示未读数（设置 > 通知与托盘 > 程序坞角标）。此版本在macOS上不提供通知。

从1.0.6之前的版本更新：首次启动时，钥匙串会再次询问您保存的密码，因为应用现在使用固定的证书签名。PDF附件用您的默认应用打开（预览提供“打开”和“另存为”）。

HeyLook_<version>_linux_amd64.AppImage可在任何发行版上运行；.deb适用于Debian和Ubuntu；.rpm（_linux_x86_64.rpm）适用于Fedora和openSUSE。安装.deb和.rpm时会要求输入您的密码。

如果您的桌面没有托盘区域，关闭窗口就会退出Hey Look!。

链接和附件通过 xdg-open 打开（属于xdg-utils软件包；接下来会依次尝试gio和sensible-browser），所以您需要有默认浏览器和默认应用。通知需要通知服务（只有窗口管理器的环境需要自行安装一个，例如dunst）。密码保存需要GNOME Keyring或KWallet正在运行并已解锁。

托盘图标点击没有动作：请使用其菜单里的“打开Hey Look!”。PDF附件用您的默认应用打开（预览提供“打开”和“另存为”）。

会挂钩其他程序图形输出的覆盖层工具（例如随MSI Afterburner一同提供的RivaTuner Statistics Server）可能会让绘制Hey Look!界面的网页视图崩溃。Hey Look!会检测到崩溃，把原因写入其数据文件夹中的startup.log，并自行重启（十分钟内最多三次）。如果问题持续出现，请在该工具中将hey-look.exe和msedgewebview2.exe排除在外。

在欢迎界面选择使用Google登录、使用Microsoft登录或其他账户（IMAP / SMTP）。

Gmail：用您的Google账户登录。在Google仍在审核Hey Look!期间，Google会先显示一条警告，并把登录限制在前100人；请参阅Google提示“Google未验证此应用”。使用个人Gmail账户时，您也可以用应用专用密码添加Gmail（其他电子邮件账户，服务商选Gmail）。

Microsoft（Outlook.com、Hotmail、Microsoft 365）在Microsoft自己的窗口中登录。工作和学校账户（Microsoft把每个组织称为“租户”）可能会屏蔽IMAP/SMTP，直到管理员为该邮箱启用为止。

您的邮件会在后台下载。关闭窗口后，Hey Look!会继续在托盘中运行；如需退出，请使用托盘菜单中的退出。

Hey Look!尚未完成Google的审核。在审核完成之前，您第一次用Google登录时，以及开启Google日历同步时，Google都会显示一个警告页面：“Google未验证此应用”。凡是仍在审核中的应用，Google都会显示这个页面。这并不表示您的账户有问题，也没有任何内容被更改。

继续的方法：

1. 在警告页面上选择高级，然后选择转至 Hey Look!（不安全）。
2. 阅读Google列出的权限，确认可以接受后再允许。Hey Look!只请求其邮件和日历功能所需的权限，而且它是开源的，您可以自行核查；请参阅Google API数据使用。如果您不想点过这个警告，可以改用应用专用密码（见下文）。

100人的上限。审核期间，Google最多允许100人用Google登录，人数按项目存续期间累计计算。达到这个数字后，新用户将无法完成“使用Google登录”，要等到Google批准Hey Look!之后才行。这时您可以这样做：

• 用应用专用密码使用Gmail（已开启两步验证的个人Gmail）：在myaccount.google.com/apppasswords创建一个应用专用密码，然后在Hey Look!中选择设置 > 添加账户 > 其他电子邮件账户，服务商选Gmail，输入您的邮箱地址和应用专用密码。工作或学校账户通常无法创建应用专用密码。
• 等待审核结果。Google批准Hey Look!之后，警告就会消失，所有人都可以用Google登录。发行说明里会注明这一点。

与Google的日历同步始终会请求Google自己的日历权限，即使是使用应用专用密码的Gmail邮箱也是如此，所以同样的警告和同样的上限也适用于它。Microsoft邮箱的日历同步不受影响。

任何支持IMAP和SMTP的账户都可以使用。检测设置会为某个地址查找服务器（预设、服务商的autoconfig（含服务器设置的文件）、Thunderbird ISPDB、DNS和探测）。只会发送域名和地址，绝不会发送密码。

iCloud需要从account.apple.com获取App专用密码（登录与安全，App专用密码），因为Apple没有为第三方邮件应用提供登录窗口。Yahoo同样使用应用专用密码。

服务器必须提供SSL/TLS或STARTTLS；只接受未加密连接的服务器无法添加。

Proton Mail Bridge在127.0.0.1上监听，使用自签名证书：在服务商列表中选择Proton Mail Bridge，并使用Bridge显示的用户名和密码。对于其他服务器，请在高级设置中打开信任此服务器的证书。之后该账户的IMAP和SMTP将不再检查证书，所以只应对您自己掌控的服务器使用。

设置 > 邮箱 > 阅读与同步 > 每个邮箱最多下载的邮件数可选500、1000、2000或5000（默认2000），按每个邮箱所有文件夹合计。当某个邮箱超出上限时，最旧的邮件会被移除，但只是从这台电脑上移除；它们仍留在服务器上。草稿、已标记的邮件、已置顶或设为稍后提醒的对话，以及每个文件夹中最新的一封邮件会被保留。新邮件始终会收到。

这项功能是可选的，按邮箱分别设置，在您开启之前默认关闭：设置 > 邮箱 >（账户）> 日历 > 与Google同步日历（或Microsoft）。浏览器会打开服务商自己的页面，请求日历权限。这与您的邮件登录是分开的，邮件登录不会改变。然后选择要同步的日历：它们的事件会显示在Hey Look!的日历中，而您添加、修改、删除或回复的事件会同步保存回Google日历或Outlook。

关闭开关后，已同步的日历和事件会从这台电脑上移除，日历登录令牌也会被删除；它们仍保留在您的服务商那里。来自已同步日历的重复事件是只读的。关于Google，请参阅Google提示“Google未验证此应用”；Microsoft工作或学校账户可能需要管理员批准日历访问。不支持CalDAV和其他服务。

在支持IMAP IDLE的服务器上，只要Hey Look!正在运行，收件箱的新邮件就会立即送达。设置 > 邮箱 > 阅读与同步 > 即时获取收件箱新邮件（推送）可以将其关闭，可对所有账户或单个邮箱设置；邮箱的服务器面板会显示推送或轮询。如果服务器不支持IDLE，或连接持续失败，Hey Look!会按您设定的间隔检查（默认每2分钟一次）。推送正常工作时，对所有文件夹的常规检查只会每10分钟运行一次（如果您设定的间隔更长，则按您的间隔），而且推送只覆盖收件箱。

打开设置 > 邮箱。所有账户里是默认值。每个账户都有相同的页面；您在那里更改的设置会标记为自定义，仅对该邮箱覆盖默认值。重置则恢复为继承默认值。邮件签名、模板和过滤器可以属于所有账户，也可以只属于某一个邮箱。

按 Ctrl K（macOS上为 Cmd K）打开命令栏：输入命令或文件夹名称。

点击“新建邮件”“回复”“全部回复”或“转发”时按住Shift（或按Shift+C、R、A、F），双击草稿，或在写邮件时点击“弹出窗口”（Ctrl+Shift+O）。要在独立窗口中阅读，双击一个对话或按Shift+Enter。设置 > 写邮件 > 在单独的窗口中打开新邮件、回复和转发可把独立窗口设为默认方式，此时Shift的作用相反。最多可同时打开8个窗口；每个窗口都记住大小和位置，关闭有邮件的窗口会询问保存、放弃或取消。退出或更新时，会先把每个窗口里的邮件保存到草稿。

格式工具栏只有一行；窗口较窄时，更多按钮会移到“更多”菜单里（查找和替换、更改大小写、文字方向、缩放、间距）。从Word、Excel、网页或其他应用粘贴的内容会被清理，“粘贴选项”按钮可让您保留源格式、合并格式或只保留文本；默认方式在设置 > 写邮件里设定。回复会把原邮件引用在一个保留原样的块里。

邮件大约每30秒自动保存到草稿，并在您的电脑上保存一份副本。如果应用意外结束，下次启动时会自动把邮件保存到草稿，不再询问，并显示一条在您关闭前一直保留的通知，其中有“继续撰写”。

文件夹窗格顶部的按钮，或Ctrl B（Cmd B），可把窗格折叠成一列图标：每个邮箱显示为它的颜色和未读数。窗口窄于1100像素时会自动折叠；设置 > 外观 > 侧边菜单里可选择“自动”“始终展开”或“始终仅显示图标”。拖动邮箱可改变顺序（或使用Alt+上和Alt+下），并可在设置里为它设置显示名称。

撤销发送：点击发送后，邮件会在本地发件箱中等待0、5、10、20、30或60秒（默认10秒），点击“撤销”即可取消发送。如果Hey Look!被强制关闭（崩溃、任务管理器、安装程序），邮件会在下次启动时发出。正常退出则会立即发出仍在等待的邮件。

归档、删除和移至垃圾邮件的操作会在3、6、10、15或30秒后（默认6秒）才应用到服务器，所以您可以撤销。

定时发送：选一个预设，或任意日期和时间，最长可安排到一年后。邮件由应用内部的后台任务发出，所以Hey Look!必须正在运行。发送时间在应用关闭期间已过的邮件，默认会在下次启动时发出；如果把设置改为“先询问我”，它就会作为“已逾期”等待您处理。遇到临时错误最多重试3次，每次间隔5分钟。

在搜索框中输入运算符：from: to: subject: body: folder: is:unread|read|flagged|pinned has:attachment after:2026-01-31 before: after:7d，以及用引号括起来的短语，如"quoted phrases"。只会搜索已下载到这台电脑上的邮件。对于已知网页邮箱入口的邮箱，会有一个在网页邮箱中搜索按钮可以打开该网页邮箱；Gmail则会用转换后的运算符执行同样的搜索。

打开设置 > 常规，在第一行选择英语、越南语、法语、简体中文、西班牙语、日语、德语或俄语。立即生效，无需重启。默认语言是英语，Hey Look!不会根据您的系统自动选择语言。译文是新的，可能有错误；如果您发现了，请到GitHub告诉我们。

Hey Look!会在您同意之后自行更新。它会在应用启动时，以及窗口（从托盘或后台）隔了几个小时重新回来时检查，检查失败则15分钟后重试，也可以在设置 > 关于中手动检查。在那里关闭自动检查（“自动检查更新”），应用就不会再自动发出任何请求。

下载并安装会在您继续工作的同时下载更新并显示进度条，检查其签名，然后经过一个可以取消的5秒倒计时后重启并进入新版本。如果您正在写邮件，它会先询问，并把这封邮件保存为草稿；稍后会在您退出时安装更新。跳过此版本会隐藏该版本的提示。

只会向GitHub发出请求，在您同意之前不会下载任何内容。每个更新包都带有签名，应用会拒绝任何与其内置公钥不匹配的内容。MSI安装需要管理员权限；安装.deb和.rpm时会要求输入您的密码。如果更新无法安装，应用会改为提供从GitHub下载的方式。

关闭窗口后，Hey Look!及其同步会继续在托盘中运行。在设置中关闭“关闭窗口后在托盘中继续运行”，关闭按钮就会直接退出应用（如果有定时发送的邮件在等待，会先询问）。

在Windows上，新邮件通知最多可以有三个按钮（归档、删除、标记为已读、标记、回复、稍后提醒）。Linux上的通知没有按钮。此版本不显示macOS通知，因为应用没有使用Apple Developer ID签名；新邮件仍会显示在应用里和菜单栏图标上。稍后提醒可以让对话暂时离开收件箱，到预设时间或您自己设定的时间再回来。

邮件缓存和设置保存在一个SQLite文件里：Windows上为%APPDATA%\thnonl.heylook\heylook.db，macOS上为~/Library/Application Support/thnonl.heylook/，Linux上为~/.local/share/thnonl.heylook/。

密码、OAuth令牌、AI密钥和OAuth客户端密钥保存在Windows凭据管理器、macOS钥匙串，或Linux上的Secret Service中（GNOME Keyring、KWallet；其中一个必须正在运行并已解锁）。所有条目的名称都是heylook…的形式。OpenPGP私钥是例外：它们保存在应用的数据库中，由各自的密码短语保护。

除了以下这些地方，不会向任何地方发送任何内容：您的邮件服务器；Google和Microsoft的登录服务；Google日历和Microsoft Graph（仅限您开启了日历同步的邮箱）；您点击检测设置时的Thunderbird ISPDB和您自己域名的autoconfig地址（域名公布其服务器设置的位置）；您配置的AI端点；您允许加载的图片背后的服务器；您点击“取消订阅”链接时该链接背后的发件人地址；以及用于检查更新的github.com（GitHub能看到您的IP地址；您同意更新后，安装包也来自github.com）。

源代码里没有分析或崩溃报告代码。这是通过查看源代码确认的，而不是靠网络抓包。详见隐私政策。

远程图片和背景图片在您允许之前一直被阻止（允许一次、按邮箱允许，或始终允许）。跟踪像素就是一张远程图片，所以会和其他图片一起被阻止；应用没有跟踪器名单。您允许加载的图片，应用会尽量自己下载；对于它自己无法获取的图片，网页视图可能会直接请求。链接上显示的文字是网址、但实际指向别处时，会请您确认；打开可执行文件附件前也会先询问。

它只会与您配置的端点通信（任何兼容OpenAI的API，包括本地服务器），而且只在您点击按钮时才通信。总结最多发送一个对话中可读邮件的24,000个字符，翻译最多60,000个字符，“用AI撰写”则会发送您的草稿、主题，回复邮件时还会发送您所回复邮件的最多6,000个字符。解密后的OpenPGP内容也会一并发送，因为助手读取的是可读文本。密钥保存在您系统的凭据存储中。长邮件会按约8,000个字符一部分来翻译，点击“取消”即可停止。如果助手无法使用，屏幕上会留下一条提示，它的按钮会打开设置中对应的字段。

先在Hey Look!中移除您的账户（设置 > 邮箱 > 账户 > 移除账户；邮件仍留在服务器上），然后卸载应用，再删除它的数据文件夹（见“我的数据存放在哪里？”）以及系统凭据存储中所有名称形如heylook…的条目。

创建Ed25519 / Curve25519或RSA 3072密钥，可设置有效期，并用密码短语加锁。在撰写窗口中，您可以用收件人的密钥加密并签名；发送前，应用会显示每位收件人是否有可用的密钥。收到的邮件可以解密，签名也可以验证。

可以导入和导出密钥（ASCII Armor格式），并保存受密码短语保护的备份文件（*-secret-key-BACKUP.asc）。如果没有备份就关闭密钥页面，会询问“立即备份”还是“仍然关闭”。多次输入错误的密码短语后，需等待30秒才能解锁。

私钥保存在应用自己的数据库中，用您的密码短语加锁，而不是放在操作系统的凭据存储里。与其他OpenPGP软件的互通性尚未测试。

请在GitHub上提交一个议题。议题是公开的，所以千万不要贴出私人邮件、密码或令牌。请说明您使用的系统和Hey Look!版本（设置 > 关于，那里还有指向网站、支持页面和源代码的链接）。Hey Look!是业余时间做的，所以回复可能要等一阵子。

请私下报告：打开github.com/thnonl/hey-look/security并选择“Report a vulnerability”（报告漏洞），或发邮件到namth.onl@gmail.com。请不要公开提交议题。详见安全。

• macOS上没有通知（程序坞图标会显示未读数）；应用使用项目自己的证书签名，未经公证；“打印”菜单项只在Windows和Linux上有。Linux上通知没有按钮，托盘图标点击没有动作，“机密”邮件也不会对屏幕截图隐藏。
• 安装程序没有经过代码签名，macOS版应用也没有经过公证。
• 推送（IMAP IDLE）只覆盖支持该功能的服务器的收件箱；其他文件夹以及不支持推送的服务器通过轮询获取（默认每2分钟一次）。
• 搜索只涵盖已下载到这台电脑上的邮件。
• 日历同步支持Google和Microsoft；CalDAV和其他服务可能会在以后的更新中提供。在Google完成审核之前，Google登录和Google日历同步仅限前100位用户使用（参见Google提示“Google未验证此应用”）。无法编辑重复事件中单独的某一次。没有共享收件箱。
• Hey Look!不会创建缺少的标准文件夹（草稿、已发送、归档、已删除邮件）；需要用到它们的操作会显示错误。
• 您正在写的邮件大约每30秒保存到草稿，并在您的电脑上保存一份副本。如果Hey Look!被强制结束，或在macOS上注销、重启、关机，下次启动时会自动保存到草稿，并用一条在您关闭前一直保留的通知告诉您（“继续撰写”）；如果无法保存到服务器，会在这台电脑上最多保留30天（最后几秒的文字可能丢失，开启了加密的邮件不会被复制）。已发送的邮件会保留，并在下次启动时发出。
• 当发件人地址与组织者一致时，日历的更新和取消邮件才会被接受。不做DKIM、SPF或S/MIME检查。
• 界面默认为英语，在设置中可选择越南语、法语、简体中文、西班牙语、日语、德语和俄语。这些译文是借助AI撰写并经语言专家审校；更多语言可能会在以后的更新中提供。
• 只有在Windows上，PDF才在应用内显示；在macOS和Linux上，PDF会用您的默认应用打开。写邮件时没有纯文本模式，格式刷、自动套用格式和浮动迷您工具栏暂时还没有。