帮助

帮助：在 Mac 上安装和使用 Hark

本页描述的都是应用当前发布版本的实际情况。如果这里有不对的地方，或者没有找到你的问题，请写信至 support@souplin.com，会有真人回复你。

系统要求与安装

Hark 可在搭载 Apple 芯片（M1 或更新机型）、运行 macOS 14（Sonoma）或更高版本的 Mac 上运行；不支持搭载 Intel 处理器的 Mac。你还需要一个 Gmail 或 Google Workspace 账户。

首次启动时，选择“Sign in with Google”。macOS 会在系统提供的窗口中打开 Google 自己的登录页面——Hark 永远看不到你的密码，两步验证或安全密钥在这里也和在其他地方一样可用。完成后，窗口会关闭，你的收件箱随即载入。

Google 的授权页面会列出 Hark 申请的权限。下面用通俗的话逐项说明，并附上每项的理由：

读取、整理和发送你的 Gmail 邮件。 这是邮件客户端本身的功能：显示邮件、标为已读、标签、归档、稍后提醒、草稿和发送。Hark 特意不申请永久删除邮件的权限，所以它最多只能把邮件移到“已删除邮件”。
基本的 Gmail 设置。 包括签名、休假自动回复、过滤器和“发件人”地址，让你可以在 Hark 的设置中管理它们，改动也会在网页版上生效。
你的日历。 查看、创建和编辑日程，回复邀请，显示和隐藏日历，以及创建和共享日历。
你的任务。 即日历旁边的 Google Tasks 面板。
你的联系人（只读）。 用于在你输入时自动补全收件人或邀请对象，以及显示发件人头像。Hark 从不写入你的联系人。
你选择的 Drive 文件。 用于附加你在 Google 自己的文件选择器中选中的 Google Drive 文件。Hark 只能看到你选中的文件，永远看不到你的整个 Drive。
你的电子邮件地址和姓名。 用于在 Hark 中标识这个账户。

已通过 Google 审核

Hark 对你 Google 账号的访问权限已于 2026 年通过 Google 的 OAuth 验证和一次独立的 CASA 安全评估，获得 Google 的审核批准。

Workspace 账户

只要你所在的组织允许使用第三方应用，Google Workspace 账户也以同样的方式登录。如果组织不允许，Google 会在登录页面上显示相应提示，Hark 无法继续；你的管理员可以在 Workspace 管理控制台中允许使用 Hark。

多个账户

要添加另一个 Google 账户，请点击窗口右上角的账户头像并选择“Add account…”，或在“Settings › Accounts and Import”中点“Add account…”。登录方式与第一个账户相同，Hark 最多可连接五个账户。有两个或更多账户时，侧边栏中的“All Inboxes”会把所有账户的收件箱合并成一个列表，从那里发起的搜索会覆盖所有账户。

通知、程序坞和菜单栏

在你做出选择之前，Hark 会在窗口顶部显示一条横幅，询问是否开启通知；点按“Turn On”后，macOS 会请求你的许可。同样的请求也可以通过“Settings › General › Desktop notifications”下的“Allow…”按钮发起。如果你之前拒绝了又改变了主意，可以在“系统设置 › 通知 › Hark”中开启。

Hark 会通知你哪些内容，可以在“Settings › General › Desktop notifications”中设置：新邮件；日历邀请、变更和取消；通知中是否显示主题和预览；以及是否播放提示音。Hark 是当前活跃应用时，它会保持安静——为已经显示在屏幕上的内容发出提示音，只是噪音。

程序坞角标显示收件箱的未读数，与 Gmail 显示的数字一致——有多个账户时，显示的是开启了“Count in Dock badge”的账户的总数（“Settings › Accounts and Import”）；如需关闭，请在“Settings › General › Appearance”中关闭“Show unread count in Dock”。菜单栏图标让你无需把窗口调到前面，就能瞥一眼刚收到的内容。

邮件

你的标签显示在侧边栏和邮件上，它们就是你 Gmail 里的标签——在 Hark 中做的改动，会同步出现在网页版和手机上。阅读窗格中提供你所熟悉的操作：归档、加标签、加星标、标为未读、稍后提醒到你选定的时间（由 Hark 而不是 Google 负责把邮件送回来，所以届时 Hark 必须在运行，邮件才会回来）、忽略会话、移到“已删除邮件”。邮件列表的邮件会在顶部显示“Unsubscribe”（退订）链接。

搜索。 Gmail 自己的运算符——from:、has:attachment、is:unread、older_than:1y——会原样发送给 Google，搜索结果也来自 Gmail。想保留的搜索可以通过“Create filter”转为 Gmail 过滤器，之后该过滤器会在 Google 端运行，对你所有的设备都生效。
写信。 写信在真正的 macOS 文本视图中进行：格式栏提供粗体、斜体和下划线，还支持链接、内嵌图片和系统拼写检查。把文件拖到邮件上即可添加附件，也可以从文件选择器中附加 Google Drive 文件。“Undo Send”（撤销发送）会在你点击发送后将邮件保留几秒钟（5 到 30 秒，在“Settings › General › Sending”中设置）。“Schedule Send”（定时发送）会把邮件存为草稿，并在你选定的时间发出——届时 Hark 必须在运行，否则会在 Hark 下次打开时发出，因为 Gmail 的 API 本身不提供定时发送。
移到“已删除邮件”，而不是彻底删除。 Hark 只会把邮件移到“已删除邮件”，从不永久删除，这是有意为之；清空“已删除邮件”需要在网页版 Gmail 中操作。
邮件中的图片。 默认情况下，Hark 会显示邮件中的远程图片。如果希望先询问，请在“Settings › General”中将“External images”设为“Ask before displaying”。
只能在网页上修改的设置。 有少数 Gmail 设置对任何应用都不开放。Hark 会在设置中列出它们，并附上链接，在网页版 Gmail 中直接打开对应账户，而不是假装它们不存在。

日历和任务

在左侧导航栏点一下，就能从收件箱切换到日历。提供日、周、月、年和日程视图，另有 4 天、2 周和 4 周的跨度；拖动即可创建，拖动即可移动或调整时长；修改后会出现可撤销的提示；重复日程可以选择只改此日程、此日程及后续日程，或全部日程。日历可在侧边栏中显示或隐藏，侧边栏还可以创建、共享和订阅日历。Google Tasks 在网格旁边的面板中打开，把任务拖到某一天，它就会被安排在那一天。

邮件中收到的邀请会在邮件上显示“Yes”、“No”和“Maybe”，你的回复会直接写入日历。完整介绍请参阅作为原生 Mac 应用的 Google Calendar。

键盘

j 和 k，或方向键 在列表中上下移动。
Esc 离开当前邮件并返回列表。
粗体、斜体和下划线 暂时没有快捷键；写信时可以在格式栏中找到。
“Zoom In”、“Zoom Out”和“Actual Size” 位于“View”菜单中，用于调整邮件文字的大小。
⌘, 打开设置，和所有 Mac 应用一样。
⇧⌘R 打开“Report a Bug”（报告错误）。

你的数据存放在哪里

Hark 没有存放你邮件的服务器；它保存的一切都在你的 Mac 上。你 Google 账号的凭据保存在 macOS 钥匙串中。它保存的其他一切——邮件、日程和任务的缓存（每个账户一个文件夹）、下载的附件、缓存的远程图片、发件人头像和标志、你的设置、最近 25 次搜索，以及你已忽略的会话的 ID——都位于 Hark 的沙盒容器 ~/Library/Containers/com.souplin.hark 中，也在你自己的“资源库”文件夹内。

“Settings › Advanced”中有三个与此相关的控制项。“Clear cache”会清除缓存的图片和已下载的附件——你的邮件、草稿、设为稍后提醒的会话和账户都不受影响，图片和附件会在下次使用时重新获取。“Send crash reports”默认关闭；开启后，应用崩溃时会发送堆栈跟踪、异常类型、信号和终止原因、崩溃的线程、崩溃时间和 macOS 为该次崩溃分配的 ID、应用的版本号、构建号和提交号，以及 macOS 版本和硬件型号——绝不包含你的邮件。“Look up avatars on gravatar.com”默认关闭；开启后，它会把每个联系人地址的哈希值发送给该服务。完整说明（包括错误报告包含哪些内容）请参阅从不接触你邮件的 Gmail 客户端。

退出登录与卸载

要退出登录，请点按窗口右上角的账户头像，选择“Sign out of”加你的地址那一项，或者使用“Settings › Accounts and Import”中的“Sign out”。退出唯一（或最后一个）账户会做三件事：通知 Google 撤销 Hark 对你账户的访问权限，从钥匙串中删除凭据，并从磁盘上移除该账户的缓存。有多个账户时，“Settings › Accounts and Import”会为每个账户提供“Remove…”，账户菜单则为当前账户提供“Remove”加你的地址那一项：它会删除该账户的凭据和缓存，只有勾选“Also revoke Hark’s access to this Google account.”时，才会在 Google 那边撤销 Hark 的访问权限。

要卸载，请先移除所有账户，每次出现“Also revoke Hark’s access to this Google account.”时都勾选它——退出最后一个账户时总会撤销授权——然后退出 Hark，把它从“应用程序”拖到废纸篓。如需彻底清除所有痕迹，还要删除 ~/Library/Containers/com.souplin.hark。

如果你删除了应用或某个账户，却没有撤销 Hark 的访问权限，授权仍然保留在你的 Google 账号中：打开 myaccount.google.com/permissions，在第三方应用中找到 Hark，移除它的访问权限。钥匙串项目可以在“钥匙串访问”中找到，名称以 com.hark.oauth 开头。

报告错误

从“Help”菜单中选择“Report a Bug”（⇧⌘R），选择问题所在的功能区域，描述发生了什么。报告会包含：你输入的内容；你标记的是错误还是功能请求；你选择的区域；你附上的图片；姓名或电子邮件字段——默认填入你登录的地址，如果不想被识别，可以清空；以及关于应用和机器的信息：版本号、构建号和提交号、macOS 版本、硬件型号、CPU 核心数、内存大小、可用磁盘空间、区域设置、时区、散热状态、低电量模式、开机以来的小时数、发送时间、已连接的账户数量（仅数量）和一个每次安装随机生成的 ID。它绝不包含邮件内容、主题、其他人的地址、令牌或日志。截图往往是向我们展示错误最快的方式——但它也是你收件箱中的内容唯一可能到达我们这里的途径，所以如果介意，请先裁剪。

你也可以写信至 support@souplin.com。如果方便，请附上“About Hark”中显示的构建号。

语言

Hark 提供英文和简体中文版本。“Settings › General › Language”会同时设置你的 Gmail 显示语言和 Hark 自身的界面语言；已翻译的部分 Hark 会跟随该设置，其余部分保持英文。重新启动 Hark 后，界面语言才会更改。