批准与权限

Haruno 会就哪些操作请求您批准,如何回答批准卡片,以及在普通视图、“Advanced view”(高级视图)和定时任务中可以更改哪些设置。

批准如何运作

在聊天中,Haruno 执行每一步之前都会先检查该步骤。读取和常规工作会直接进行;发送、发布、更改共享数据或无法撤销的步骤,可能会暂停下来等待您批准。月末结账从不请求批准:结账的每一步都由您自己用应用中的按钮执行。

这条规则就是您在付款流程中早已实行的“经办与复核分离”:Haruno 负责准备,凡是要离开您手中的内容,都由您来放行。允许 Haruno 起草发给某家公司的邮件,不等于允许它发送;允许它准备发票,也不等于允许它把发票记入公司的账目。

各类步骤如何处理

新安装的 Haruno 使用普通视图。在普通视图中,各类步骤的处理方式如下;在“Advanced view”(高级视图)中,您选择的权限模式会改变其中一部分。

步骤处理方式
读取或搜索 Haruno 工作文件夹或其旁边所显示账簿中的文件、阅读文档、启动辅助任务直接进行。
在该文件夹中创建或更改文件直接进行。请参阅下方的警告。
搜索网络通常直接进行;没有针对它的开关。如果弹出卡片询问,卡片上会注明“Your search text leaves your Mac.”(您的搜索文本会离开您的 Mac。)
运行命令、读取网站上的某个页面,以及其他步骤由自动安全检查决定:放行该步骤、询问您,或将其阻止。
“Require confirmation”(需要确认)开关所涵盖的连接器操作,例如发送邮件始终询问。
向云存储文件夹镜像、同步或上传始终询问。没有针对它的开关。
连接到安全沙盒网站列表之外的网站单独的提示:“Let Haruno open this website?”(要让 Haruno 打开此网站吗?)
批准卡片并不保护您的账簿
Haruno 在其工作文件夹旁边看到的是您的账簿,且为只读,因此它无法更改账簿,也就不需要卡片。例外是公司的科目映射:在您提出要求时,它可以就地编辑,并会报告它更改过的每一行。对账簿的其他每一项更改,都通过应用自身的控件完成,例如“Close month…”(结账…)、“Reopen…”(重新开启…)和“Approve mapping”(批准科目映射)。关闭“Sandboxed Engine”(沙盒引擎)后,约束它遵守这一点的只剩 Haruno 的指令。

结账本身也有检查:已导入文件的副本被更改或删除时,会产生一项检查项为 evidence_integrity 的发现事项;如果导出文件会改变已锁定月份,结账会拒绝这些导出文件。但这两项检查都不能覆盖所有可能的更改。如果希望 Haruno 每次更改文件之前都询问您,请使用 Advanced view 中的 Ask each time(每次询问)或 Ask(询问)模式(参见“Advanced view 中的批准”)。

哪些操作从不弹出卡片

以下操作都由您自己用应用自身的控件完成,因此不涉及任何卡片:添加公司和导出文件,同步 QuickBooks 公司,起草和批准科目映射、记录回答,为月份结账和重新开启月份,以及打开报告并将其导出。公司页面上的“Ask Haruno”(向 Haruno 提问)按钮只会把问题放进聊天输入框;在您点击“Send”(发送)之前,不会发送任何内容。

批准卡片

当 Haruno 需要您批准时,回复会停在聊天中的一张卡片上,聊天底部显示已用时间的那一行也会停止计时并变成灰色,直到您作答。在普通视图中,卡片会用通俗的语言说明 Haruno 想做什么、要作用于什么对象(例如文件、网站、收件人或公司),点击 Show details(显示详细信息)可查看完整请求。Haruno says(Haruno 的说明)一行是 Haruno 自己的描述,而不是应用给出的描述,因此请将它与其他各行对照核实。

按钮作用
“Allow once”(允许一次)只运行这一个步骤。下一个同类步骤会重新判断,可能会再次询问。
“Deny”(拒绝)该步骤不会运行,Haruno 会得知您拒绝了它。请在聊天中告诉它您希望它改做什么。
“Allow for this session”(在本次会话中允许)仅在 Advanced view(高级视图)中提供:同时允许本对话中之后所有同类步骤。

按 Return 键不会回答卡片:请点击按钮,或在按钮获得焦点时按空格键。如果卡片是由安全检查或常设规则(例如 Require confirmation(需要确认)开关)触发的,普通视图还会加上一句 Haruno pauses before anything that sends, publishes, changes shared data, or can't be undone.(Haruno 会在发送、发布、更改共享数据或无法撤销的任何操作之前暂停。)

卡片标题的含义

标题Haruno 想做的事
“Haruno wants to run something on your Mac.”(Haruno 想在您的 Mac 上运行某项操作。)运行一条命令;在普通视图中,命令在安全沙盒内运行。“Haruno says”一行会描述这条命令。
“Haruno wants to change a file.”(Haruno 想更改一个文件。)编辑文件。“Currently”(当前内容)和“Will become”(更改后的内容)分别显示更改前后的文本。
“Haruno wants to save a file.”(Haruno 想保存一个文件。)写入文件,内容显示在“What Haruno will write”(将写入的内容)中;同名的文件会被替换。
“Haruno wants to open a file.”(Haruno 想打开一个文件。)/“Haruno wants to look through your files.”(Haruno 想查看您的文件。)读取文件,或搜索文件(“Looking for”(查找内容)一行列出要找的内容)。卡片上注明“Haruno will only read it.”(Haruno 只会读取它。)
“Haruno wants to read a page on [site].”(Haruno 想读取 [site] 上的一个页面。)读取一个网页(见“Website”(网站)一行)。
“Haruno wants to search the web.”(Haruno 想要搜索网络。)搜索“Looking for”下列出的词语。
“Haruno wants to start a background task.”(Haruno 想启动一项后台任务。)启动一项辅助任务,显示为“Working on a subtask”(正在执行子任务)。
“Haruno wants to update its plan.”(Haruno 想更新它的工作计划。)更改它为本次回复维护的分步清单。
“Haruno wants to use [connector].”(Haruno 想使用 [connector]。)“Action”(操作)一行写明具体操作,例如“Gmail send”(Gmail 发送);最多还有四行,显示收件人、频道、主题或消息内容。
“Haruno wants to add an event to your calendar.”(Haruno 想在您的日历中添加活动。)创建一个 Google 日历活动。“Everyone listed will be emailed an invitation.”(列出的所有人都会收到邀请邮件。)表示 Google 会给每位受邀者发送邮件。
“Haruno finished planning and is ready to start.”(Haruno 已完成计划,准备开始。)出现在通知中:有一份计划已准备好,等您审阅。
“Haruno needs your approval for a technical step.”(Haruno 需要您批准一项技术性步骤。)卡片上写着“This step can't be described in plain language. Check the details below, or deny it and ask Haruno what it is trying to do.”(这一步无法用通俗的语言描述。请查看下方的详细信息,或拒绝它,并询问 Haruno 它想做什么。)

如果安全检查直接阻止了某个步骤,就不会出现卡片,聊天中会注明“[step] blocked by auto mode”([step] 已被自动模式阻止;参见处理方法)。如果卡片再次出现并显示“Couldn't deliver a response to the engine: …”(无法将回复传递给引擎:……),说明您的回答没有送达 Haruno:请再次作答。如果不想作答,而是要停止整个回复,请点击 Stop(停止)或按 ⌘.(Chats ▸ Cancel Turn,即对话 ▸ 取消本轮回复)。保存在“History”(历史记录)中的对话,就是您批准过哪些操作的记录;Activities(活动)面板(⌥⌘0)则列出 Haruno 执行过的每一步。

如果 Haruno 不在前台,会出现一条 Permission required(需要权限)通知,其中提供卡片上的按钮;网站提示则以 Allow network access?(要允许网络访问吗?)通知的形式出现。如果在“System Settings ▸ Notifications”(系统设置 ▸ 通知)中关闭了通知,卡片会在聊天中等待,但网站提示会在 55 秒后拒绝该连接。带有 Your answer(您的回答)和 Send(发送)的提问卡片不是批准卡片(参见“Haruno 向您提问时”)。

普通视图中的批准

普通视图没有批准设置:每个对话都在安全沙盒内以自动模式运行,每张卡片只提供 Allow once(允许一次)和 Deny(拒绝)。您只需通过 Require confirmation(需要确认)开关,选择哪些连接器操作始终询问;安全检查从不替您批准这些操作。

设置项在普通视图中
权限模式固定为“Automatic”(自动),从“History”(历史记录)中重新打开的对话也是如此。“Chats ▸ Cycle Permission Mode”(对话 ▸ 切换权限模式,⌃⌘P)不起作用。
安全沙盒始终开启。如果沙盒无法启动,对话就不会开始:Haruno 从不在没有沙盒的情况下运行。
“Allow for this session”(在本次会话中允许)从不提供:每一步都单独批准,属于逐笔审批,而不是长期授权。
自定义服务器和允许访问的主机不显示,但在 Advanced view(高级视图)中添加的项目会继续适用于新对话。

沙盒能看到哪些内容,请参阅“数据处理与安全”。如需使用权限模式和会话批准,请开启 Advanced view(参见“普通视图与 Advanced view”);为月份结账并不需要它。

Advanced view 中的批准

在“Settings ▸ General”(设置 ▸ 通用)中开启 Advanced view(高级视图)后,会增加 Default Permission Mode(默认权限模式)设置、每个对话的模式菜单、带有 Allow for this session(在本次会话中允许)的完整卡片、网站提示中的更多选项,以及自定义服务器的逐个工具设置。除非您更改,新对话都以 Ask each time(每次询问)开始,因此卡片会更多。

Default Permission Mode(默认权限模式)

它决定新对话从哪种模式开始。选择 Ask each time 或 Automatic(自动)时,当前打开的对话也会立即切换;选择 Deny all(全部拒绝)时,当前对话会改为询问;选择 Allow all(全部允许)则要等到下一个新对话(⌘N)才生效。

选项作用
“Ask each time”(每次询问,默认)在每个需要批准的步骤之前询问。
“Automatic”(自动)由自动安全检查决定,与普通视图相同。
“Allow all”(全部允许)不经询问直接运行各步骤,即使是“Require confirmation”(需要确认)开关所涵盖的操作也是如此。请尽量少用。
“Deny all”(全部拒绝)拒绝所有需要批准的步骤,包括开关所涵盖的连接器操作。

更改当前对话的模式

点击聊天输入框左侧的 +,打开 Permissions(权限);它的标题会显示当前模式,例如 Permissions (Auto)。Chats ▸ Cycle Permission Mode(对话 ▸ 切换权限模式,⌃⌘P)会在同样的四种模式之间依次切换。该菜单只更改当前对话;从“History”(历史记录)中重新打开这个对话时,它会保留所设的模式。Allow all 和 Deny all 不在菜单中:要退出其中任何一种,请更改 Default Permission Mode,然后开始新对话。

模式作用
“Auto”(自动)由自动安全检查决定。
“Ask”(询问)在每个需要批准的步骤之前询问。
“Accept Edits”(接受编辑)对 Haruno 工作文件夹中文件的更改直接进行;其他步骤会询问。
“Plan”(规划)Haruno 先研究任务(读取和搜索直接进行),并先写出一份计划。随后卡片会提供“Approve plan”(批准计划)、“Send feedback”(发送反馈,提示为“What should change?”,即需要修改哪里)和“Reject”(驳回);计划写出之前,卡片会显示“No plan file has been written yet.”(尚未写出任何计划文件。)

完整的批准卡片

在这里,卡片按 Haruno 发送的原样显示请求,并提供 Allow once(允许一次)、Deny(拒绝)和 Allow for this session。卡片还可能显示风险标记(Low risk(低风险)、Medium risk(中风险)或 High risk(高风险))、附有安全检查理由的 Auto mode flagged this action(自动模式标记了此操作),或者一行说明是哪条常设规则要求询问。

Allow for this session(在本次会话中允许)

选择它后,在本对话的剩余时间里,Haruno 不会再就这类步骤询问您。聊天输入框上方带数字的盾牌图标会列出您的 Active grants(有效授权);选择 Revoke [rule](撤销 [规则])即可撤回其中一项。新对话开始时没有任何授权。

会话批准的效力高于确认开关
对“Require confirmation”(需要确认)开关所涵盖的操作(例如发送邮件)选择“Allow for this session”,会让该开关在本对话的剩余时间里不再询问。凡是会触及他人的操作,请使用“Allow once”。

Sandboxed Engine(沙盒引擎)开关

“Settings ▸ Advanced ▸ Security”(设置 ▸ 高级 ▸ 安全性)中有 Sandboxed Engine(沙盒引擎)开关,默认开启。请保持开启:关闭后,新对话对您的 Mac 拥有与应用本身相同的访问权限,网站列表也不再适用。请参阅“Sandboxed Engine”;关于在两种视图之间切换时哪些设置会沿用,请参阅“设置:Advanced view”。

自定义服务器的逐个工具设置

在 Mac 上,只有自定义服务器的工具需要逐个设置(参见“自定义服务器”;添加之后,可在该服务器所在行点击 Edit…(编辑…)更改)。内置连接器则改为提供 Require confirmation(需要确认)开关。自定义服务器会收到 Haruno 发送给其工具的所有内容,包括您各家公司的数字,因此请只添加您信任的服务器。

设置Haruno 可以做什么
“On”(开启)无需询问即可使用该工具。适用于读取和查询类工具。
“Confirm”(确认)只有在您批准每一次使用后才能使用;自动模式从不替您批准。适用于任何写入、发送或更改数据的工具。
“Off”(关闭)完全不使用该工具。

连接器确认开关

每个以您的名义发送、发布或更改内容的内置连接器,都有一个以 Require confirmation before…(以下操作前需要确认…)开头的开关,在两种视图中都默认开启。开关开启时,它涵盖的每项操作都会通过卡片询问您,在自动模式下也是如此;读取从不询问。请保持这些开关开启:它们涵盖的是他人能看到、而您无法撤回的操作。

连接器连接后,该开关会出现在“Connectors”(连接器)窗口中该连接器所在的行上(账户菜单 ▸ Connectors…(连接器…))。更改从下一个新对话(⌘N)开始生效,且只作用于这台 Mac。开关下方可能有一条说明:“In Automatic permission mode, writes are checked by an automated safety review instead of prompting you.”(在自动权限模式下,写入操作由自动安全审查检查,而不会提示您。)尽管如此,开关涵盖的操作在自动模式下仍会询问。

连接器开关询问的操作
Gmail“Require confirmation before sending, replying, and deleting”(发送、回复和删除前需要确认)发送、回复、将邮件移入“已删除邮件”。
Google 日历“Require confirmation before changing events”(更改活动前需要确认)创建、更改、删除活动。
Slack“Require confirmation before posting and writing”(发布和写入前需要确认)任何写入操作,例如发帖、回复、定时发送消息或添加表情回应。
Discord“Require confirmation before posting to Discord”(发布到 Discord 前需要确认)发送消息或文件。
云存储没有开关镜像、同步或上传前始终询问。

开关涵盖的操作在所有模式下都会询问,只有 Allow all(全部允许)和 Deny all(全部拒绝)例外:前者直接运行,后者直接拒绝;自定义服务器中设为 Confirm(确认)的工具也是如此。对开关涵盖的操作选择 Allow for this session(在本次会话中允许)后,该对话中就不再询问。定时任务的情况请参阅“定时任务的运行”。

网站:Let Haruno open this website?

安全沙盒只能访问一份列表中的网站(参见“沙盒可以访问哪些网站”)。对于其他任何网站,无论处于哪种权限模式,应用都会询问 Let Haruno open this website?(要让 Haruno 打开此网站吗?),并写明网站名称。对待陌生网站,要像对待陌生收款人一样:除非您知道 Haruno 为什么需要它,否则请拒绝。

回答结果
“Allow once”(允许一次)在本对话的剩余时间里,Haruno 都可以访问该网站。
“Deny”(拒绝)在本对话的剩余时间里,该网站保持被阻止状态,不再询问。
55 秒内未作答这次连接被拒绝;下次尝试时会再次询问。
“Always allow this website”(始终允许此网站;仅限 Advanced view(高级视图))将该网站添加到您允许访问的主机中,此后每个新对话都可以直接访问它,无需询问。
“Allow all sites for this session”(在本次会话中允许所有网站;仅限 Advanced view)在本对话的剩余时间里允许所有网站,并回答仍未处理的提示。聊天中会注明“Connected to [site] (allowed for this session).”(已连接到 [site](在本次会话中允许)。)

新对话(⌘N)会再次询问。在 Advanced view 中,提示显示为 Allow the sandboxed agent to connect to this site?(要允许沙盒中的代理连接到此网站吗?),而“Allowed hosts”(允许访问的主机)列出每个新对话都可以访问的网站。

“Haruno wants to read a page on [site].”(Haruno 想读取 [site] 上的一个页面。)是另一种卡片:它只读取单个页面,和其他步骤一样接受判断,无需经过此提示即可访问该页面。消息、网络搜索以及没有开关涵盖的连接器操作,同样不经过此提示就会离开您的 Mac(参见“每项操作发送的内容”)。

定时任务的运行

定时任务在无人值守的情况下运行,因此不显示任何卡片:无论您的“Default Permission Mode”(默认权限模式)如何设置,每一步都会自动批准,Require confirmation(需要确认)开关也不适用。取而代之的是:邮件、回复、带受邀者的邀请、Discord 帖子或同步文件夹的更改,会在“Scheduled”(定时)页面(⌘5)的 Waiting(待处理)中等候,直到您发送或放弃它:这就是事后的批准卡片。更改或删除已有活动会被拒绝,除非该任务被允许自行发送;沙盒网站列表之外的网站会被拒绝;Haruno 提出的问题也不会有人回答。

任务从不会获得 Slack 或自定义服务器
定时任务不能使用 Slack,也不能使用您在 Advanced view(高级视图)中添加的服务器,因此它所做的任何事都不会通过这些服务器发出。请改在聊天中提出:那里的确认步骤仍然适用。

任务的 Let this automation send emails, invitations and cloud changes on its own(允许此自动化自行发送邮件、邀请和云端更改)开关默认关闭。开启后,Gmail、Google 日历、Discord 和云文件夹的操作会立即执行。请参阅“哪些操作等待、哪些立即执行”。

在 Windows 上

Windows 版 Haruno 有它自己的批准控件,其中大多数只有在 Settings ▸ General(设置 ▸ 通用)中打开 Advanced view(高级视图)开关后才会出现(参见“Windows 上的普通视图与 Advanced view”)。

项目在 Windows 上
权限模式普通视图:固定为“Auto”(自动)。Advanced view:在“Settings ▸ Advanced ▸ Default permission mode”(设置 ▸ 高级 ▸ 默认权限模式)中选择 Default、Accept Edits、Plan、Auto 或 Bypass(默认、接受编辑、规划、自动、绕过),也可以在对话中点击权限状态标签,它会打开一个包含同样五项的“Permission mode”(权限模式)菜单。
批准卡片两种视图都提供“Allow once”(允许一次)、“Allow for this session”(在本次会话中允许)和“Deny”(拒绝)。会话批准显示在对话的“Activities”(活动)面板中(Advanced view)。
逐项操作规则在“Settings ▸ Connectors”(设置 ▸ 连接器)中为每个连接器操作设置“On”(开启)、“Off”(关闭)或“Confirm”(确认)(Advanced view)。发送、发布、付款、上传或更改外部数据的操作,初始设置为“Confirm”。
计划审阅“Approve plan”(批准计划)、“Request changes”(要求修改)、“Reject plan”(驳回计划)。
定时任务和 hook(钩子)没有“Waiting”(待处理)列表:设为“Confirm”的操作会被拒绝。要允许该操作,请在 Advanced view 中将其设为“On”,而这也会让对话在执行该操作时不再询问。
网站Advanced view:在“Settings ▸ Advanced”(设置 ▸ 高级)中开启“Allow Web Fetch without asking”(无需询问即允许 Web Fetch)。内置浏览器:在“Settings ▸ Connectors”(设置 ▸ 连接器)中设置“Let Haruno use a browser”(允许 Haruno 使用浏览器)和“Sites Haruno may open”(Haruno 可以打开的网站)。

更多信息请参阅“与 Mac 版 Haruno 的区别”。

后续步骤

连接您使用的服务,了解哪些内容会离开您的 Mac,或设置等待您查看的工作。