连接器
每个连接器能让 Haruno 在聊天或定时任务中做什么,如何连接和断开连接器,以及为什么月末结账从不需要连接器。
连接器能做什么,不用来做什么
连接器让 Haruno 可以在聊天或定时任务中使用您的某个账号或工具:发送电子邮件、添加日历活动、在共享文件夹中处理文件、在团队频道中发帖。连接器是可选的,其中任何一个都不属于月末结账。
结账只读取您添加到各公司的导出文件,或通过“Sync”(同步)从 QuickBooks 导入的月份,并为过入总账的每个文件保留一份带数字指纹的副本,因此已结账月份所依据的,都是您可以出示给审计师的文件。而每当有人补录一张迟到的账单或做一笔重分类,实时连接中的数据就会变化,因此无法充当这样的证据。参见向公司添加文件。
| 您要做的事 | 使用 |
|---|---|
| 通过电子邮件向公司索取月末导出文件 | Gmail,任何 Google 登录方式均可 |
| 在邮箱中找到公司的导出文件并保存附件 | Gmail,需通过贵组织的 Google 应用登录 |
| 处理云存储或 SharePoint 文档库中的文件 | Google Drive、OneDrive、SharePoint 或 Dropbox |
| 为结账预留时间,或查看日历 | Google Calendar |
| 向团队通报结账进展 | 在聊天中使用 Slack,或通过您自己创建的机器人使用 Discord |
| 在 Excel 中编制明细表、在 Word 中撰写备忘录,或在 PowerPoint 中制作董事会演示文稿 | “Office Tools”(Office 工具)。无需安装 Microsoft Office。 |
| 查询准则、税率或申报截止日期 | 网页搜索,登录期间始终开启 |
| 询问某家公司的 QuickBooks 数字 | 没有连接器。请在 Portfolio(投资组合)中通过“Add company ▸ From QuickBooks”(添加公司 ▸ 从 QuickBooks)添加该公司,然后在聊天中提问:Haruno 会根据该公司的账簿作答。 |
| 处理 Outlook 邮件或 Outlook 日历 | 仅 Windows 应用提供 |
| 引入银行、薪酬系统、Stripe 或 HubSpot 的数据 | 没有对应的连接器。Stripe 发票和 HubSpot 交易的导出文件,像其他导出文件一样添加即可。 |
其他来源的导出文件,参见QuickBooks 以外的来源。每月通过电子邮件发出的现成索取请求,参见向每家公司索取当月导出文件。
连接器从不向公司添加文件、更改科目映射、为月份结账、锁定或重新开启月份,也不会把数字写入已结账的月份:这些由应用自身的控件完成;在聊天中,Haruno 能更改的只有公司的科目映射,而且只在您提出要求时(参见向 Haruno 提问)。连接器也不会监视您的收件箱或日历。只有在您于聊天中提出要求,或定时任务在设定时间运行时,Haruno 才会使用连接器,而且仅限 Haruno 正在运行期间。
打开“Connectors”(连接器)窗口
“Connectors”(连接器)有自己单独的窗口,从账户菜单打开,而不是从“Settings”(设置)中打开。如果某条消息指引您前往“Connectors”,指的就是这个窗口。
- 点击侧边栏底部显示您姓名或邮箱的账户栏,然后选择“Connectors…”(连接器…)。
- 在该连接器所在的行上,点击“Sign in”(登录)或“Connect”(连接)。“Office Tools”(Office 工具)则是一个开关。
各行按以下分组排列:“Google”(含 Gmail、Google Calendar、Google Drive)、“Cloud storage”(云存储,含 OneDrive、SharePoint、Dropbox)、“Communication”(通讯,含 Slack、Discord)和“Built-in tools”(内置工具,含 Office Tools);在 Advanced view(高级视图)中还有“Custom MCP servers”(自定义 MCP 服务器)。网页搜索,以及读取您交给 Haruno 的文档、PDF、图片和音频,始终处于开启状态,没有对应的行。安装 Haruno 后,连接器要等安全沙盒完成一次性设置才能使用;在此之前,窗口底部会有一行文字说明当前进度。参见一次性下载安全沙盒。
大多数连接器会在浏览器中打开该服务自己的页面进行登录。Discord 需要机器人令牌。Slack 通过 Haruno 的服务登录,因此请先登录 Haruno(账户菜单 ▸ Sign In…(登录…)),然后在大约三分钟内在浏览器中完成登录。在此期间,该行(云存储则是对话框)会显示 Finish signing in in your browser…(请在浏览器中完成登录…),并带有一个 Cancel(取消)按钮。
连接之后,Gmail、Google Calendar、Slack 和 Discord 这几行以及每个自定义服务器都有一个开关:关闭开关会保留登录,但 Haruno 不再使用它。云存储没有开关;您共享了哪些文件夹,就决定了 Haruno 可以使用哪些内容。
能够触达他人的连接器还有一项 Require confirmation before…(以下操作前需要确认…)设置,默认开启:Haruno 在该服务中发送、发布或更改任何内容之前,会先在聊天中征求您的同意。云存储则始终会先询问。请保持这些设置开启;正是靠它们,您才能在邮件发给公司之前先过目。参见连接器确认开关。在此窗口中所做的更改,只对您之后新开始的对话生效,不影响已经打开的对话;因此在依赖某项更改之前,请先开始一个新对话(⌘N)。
QuickBooks Online
QuickBooks Online 在“Connectors”中没有对应的行,聊天和定时任务也都不会获得 QuickBooks 工具。请按 QuickBooks Online 中的说明连接公司、同步其各月数据并为这些月份结账;之后聊天会根据该公司的账簿作答,并说明账簿涵盖到哪个月份。Haruno 只读取 QuickBooks。
Google:Gmail、Google Calendar 和 Google Drive
每项 Google 服务都在浏览器中单独登录。它能做什么,取决于登录所经由的 Google 应用:Haruno 的内置应用,或者贵组织的 Google 应用(如果贵组织已经有一个;参见贵组织的 Google 应用)。
| 连接器 | 内置 Google 应用 | 贵组织的 Google 应用 |
|---|---|---|
| Gmail | 只能发送邮件和管理标签。 | 还可以搜索和阅读邮件、保存附件、在原邮件会话中回复,以及将邮件移入“已删除邮件”。 |
| Google Calendar | 查看、添加、更改和删除活动。 | 同左。 |
| Google Drive | 仅限 Haruno 创建的文件夹。 | 如果您保留完整的 Drive 访问权限,可访问您自己的“我的云端硬盘”(My Drive)。不包括共享云端硬盘,也不包括仅与您共享的文件夹。 |
连接 Gmail 或 Google Calendar
- 在 Gmail 或 Google Calendar 行上点击“Sign in”(登录),然后在浏览器中允许 Google 列出的访问权限。对于 Gmail,请保持勾选“Send email on your behalf”(代表您发送电子邮件),否则 Gmail 不会连接。
- 页面显示“Signed in ✓”(已登录 ✓)后,返回 Haruno。该行会显示账号、一个开关和一个 ⋯ 菜单。
Gmail 和 Google Calendar 在这台 Mac 上各连接一个 Google 账号;用另一个账号登录会替换原来的账号。通过贵组织的应用,Haruno 可以将邮件附件保存到对话的工作文件夹中,即您通过“File ▸ Open Folder…”(文件 ▸ 打开文件夹…)打开的文件夹,或 Haruno 自己的 Workspace 文件夹。要基于该附件结账,请像其他导出文件一样将它添加到公司。
连接 Google Drive
- 在 Google Drive 行上点击“Connect”(连接),再点击“Continue to Google Drive”(继续前往 Google 云端硬盘),然后在浏览器中允许访问。请保持勾选 Drive 访问权限,否则不会建立连接。使用贵组织的应用时,请保持勾选“See, edit, create and delete all of your Google Drive files”(查看、修改、创建和删除您的所有 Google 云端硬盘文件),才能访问“我的云端硬盘”;如果不勾选,Haruno 只会使用它自己的文件夹。
- 点击“Save”(保存),勾选 Haruno 可以使用的文件夹,或者开启“Share everything”(共享所有内容),然后再点击“Save”。
此后,Google Drive 的用法与其他云存储连接相同。如果贵组织的 Google 应用发生变化,该行会提示您何时需要重新登录;参见成员的连接会怎样。
OneDrive、SharePoint 和 Dropbox
与 Google Drive 一样,“Cloud storage”(云存储)部分会让 OneDrive、SharePoint 文档库或 Dropbox 中的文件夹与这台 Mac 上的副本保持同步。在 OneDrive、SharePoint、Dropbox 和 Google Drive 中,由您选择 Haruno 可以使用的文件夹,Haruno 从不删除其中的任何内容;经您批准后,它可以把文件移到回收站。OneDrive 和 Google Drive 只能访问您自己的云盘,因此共享云盘或仅与您共享的文件夹可能不会出现;这类文件请改为下载。
- 在相应服务的行上点击“Connect”(连接)。OneDrive 提供“Tenant (optional)”(租户,可选);SharePoint 可填写“Site ID (optional)”(站点 ID,可选)或“Drive ID (optional)”(驱动器 ID,可选)。
- 点击“Continue to OneDrive”、“Continue to SharePoint”或“Continue to Dropbox”(继续前往相应服务)并登录。OneDrive、SharePoint 和 Dropbox 会请求访问您的整个账号;限制 Haruno 访问范围的,是您对文件夹的选择。
- 点击“Save”(保存),然后选择 Haruno 可以使用的文件夹,再点击“Save”。
完成之前,该行会显示“No folders shared yet — choose which folders Haruno can use”(尚未共享任何文件夹——请选择 Haruno 可以使用的文件夹),并带有一个 Choose folders…(选择文件夹…)按钮。
该行的 ⋯ 菜单中有 Shared folders…(共享文件夹…)、Re-check(重新检查)、Edit…(编辑…)、Add another account…(添加另一个账号…)和 Sign out…(退出登录…)。该行还会显示这台 Mac 上副本的同步状态:“Syncing…”(正在同步…)、“Synced”(已同步)或“Sync error”(同步错误);Re-check 用于测试连接。停止共享某个文件夹时,您可以选择是否删除 Haruno 从中下载的内容;云端的文件不会改变。在聊天中,Haruno 在这台 Mac 上打开云文件夹、同步文件夹或上传文件之前都会先询问您;已打开的文件夹会保持双向同步,因此 Haruno 所做的更改会同步回云端。只有 Google Drive 可以搜索。
Slack
Slack 让 Haruno 可以在聊天中于您的工作区发布消息和读取频道:例如向财务频道发布结账状态,或者找到同事提出的与某家公司有关的问题。在 Slack 行上点击 Sign in(登录),然后在浏览器中选择工作区;请先登录 Haruno。
Discord
Discord 通过一个由您创建并邀请到您服务器的机器人连接。之后,Haruno 可以在您选择的频道,以及该机器人能看到的任何其他频道中读取消息、发布消息和文件;因此,如果机器人只应留在一个频道中,请在 Discord 中限制它的访问权限。
- 在 Discord 的开发者门户中创建一个应用,在其 Bot 页面上重置令牌,然后邀请该机器人加入您的服务器,并授予发送消息和附加文件的权限。
- 在 Discord 行上点击“Connect”(连接),将令牌粘贴到“Bot token”(机器人令牌)中,点击“Continue”(继续),选择“Server”(服务器)和“Channel”(频道),然后点击“Use this channel”(使用此频道)。
如果开发者门户中该机器人的 Message Content Intent 处于关闭状态,Haruno 读取到的消息除非提及该机器人,否则内容都是空白的。在定时任务中,Discord 帖子会暂存在“Waiting”(待处理)中等您处理。
网页搜索
登录期间,网页搜索始终开启,没有对应的行。当问题需要最新的公开信息时,例如准则的变化、税率或申报截止日期,Haruno 会进行搜索。搜索词会离开您的 Mac,因此请勿在要求它查询的内容中包含公司的机密信息。Haruno 在搜索前征求您的同意时,卡片上会显示 Haruno wants to search the web.(Haruno 想要搜索网络。)以及 Your search text leaves your Mac.(您的搜索文本会离开您的 Mac。)请把搜索结果当作线索:打开来源,并核对其日期。打开网页时,可能会出现 Let Haruno open this website?(要让 Haruno 打开此网站吗?)的询问(参见网站)。
Office 文档
“Office Tools”(Office 工具)让 Haruno 无需安装 Microsoft Office,就能创建和编辑 Word、Excel 和 PowerPoint 文件,例如滚动表、董事会备忘录或业绩演示文稿。安装了 Word、Excel 或 PowerPoint 时,它默认开启;否则该行会显示“Microsoft Office not installed”(未安装 Microsoft Office),您仍然可以将其开启。一旦您自行设置过,就会一直沿用您的选择。无论是否开启,Haruno 都能读取工作簿、文档、PDF 和图片,转写音频,以及生成 PDF。如何预览和保存它编写的文件,参见Haruno 撰写的文档。
自定义服务器(Advanced view)
在 Advanced view(高级视图)中,“Connectors”窗口有一个“Custom MCP servers”(自定义 MCP 服务器)部分,用于将 Haruno 连接到您自己的服务器。MCP(Model Context Protocol,模型上下文协议)是一项向 AI 助手提供工具的开放标准。大多数财务团队从不需要这项功能。
- 在“Settings ▸ General”(设置 ▸ 通用)中开启 Advanced view。
- 点击“Add server”(添加服务器),填写“Name”(名称)和“Server URL”(服务器 URL,通常为 https://…),然后选择“Authentication”(认证方式):“None”(无)、“Header”(标头)或“OAuth”。
- 点击“Connect”(连接),将每个工具设为“On”(开启)、“Confirm”(确认)或“Off”(关闭),然后点击“Save”(保存)。
设为“Confirm”后,Haruno 每次使用该工具之前都会先在聊天中征求您的同意。参见自定义服务器的逐工具设置。
安全沙盒无法通过 localhost 地址访问这台 Mac 上的服务器;请使用主机名或网络地址。关闭 Advanced view 会隐藏该部分;如果要让 Haruno 停止使用某个服务器,请先将其关闭或移除。
定时任务中的连接器
定时任务运行时没有人来确认,因此确认设置不适用。邮件、回复、有邀请对象的日历邀请、Discord 帖子以及对同步云文件夹的更改,都会暂存在 Waiting(待处理)中,直到您将其发送。添加标签、移入“已删除邮件”以及创建没有邀请对象的活动会立即执行;更改或删除已有活动会被拒绝。允许自行发送的任务会立即执行以上所有操作。无论任务可以发送什么,它都不会获得 Slack 或自定义服务器。参见哪些操作会暂存,哪些立即执行。
连接器共享哪些内容,登录信息保存在哪里
连接器的登录信息保存在您 Mac 的登录钥匙串中。它们不会转移到另一台 Mac 或 Windows 应用,删除您的 Haruno 账户也不会将其移除。开启的连接器还会让安全沙盒可以访问该服务,因此不会再像对待普通网站那样请您允许访问。服务返回的内容会成为对话的一部分,并经由 Inferara 的托管服务发送给模型提供方。参见数据处理与安全。
断开连接
关闭连接器的开关即可暂停使用,登录信息会保留。要彻底结束连接,请使用该行的 ⋯ 菜单。
| 连接器 | 菜单项 | 结果 |
|---|---|---|
| Gmail、Google Calendar、Slack | “Sign out”(退出登录) | 删除登录信息,并要求该服务终止 Haruno 的访问权限。 |
| Google Drive、OneDrive、SharePoint、Dropbox | “Sign out…”(退出登录…) | 删除登录信息;由您选择是否保留已下载的内容。云端文件不会改变。 |
| Discord | “Disconnect”(断开连接) | 删除机器人令牌。在您于 Discord 中将机器人移除之前,它会一直留在您的服务器中。 |
| 自定义服务器 | “Remove”(移除) | Haruno 无法再使用该服务器。 |
要确保访问权限确已终止,请同时在该服务自己的账号设置中移除 Haruno。Delete local data…(删除本地数据…)会清除这台 Mac 上所有连接器的登录信息,连同 Haruno 在这台 Mac 上保存的其他所有内容一并清除,账簿也不例外,并且不会联系任何服务(参见删除本地数据)。如果某个服务拒绝了已保存的登录信息,Haruno 会停用该连接器的工具,最长一天,或直到您从该行重新登录为止。之后,请开始一个新对话。
可能看到的消息
大多数消息见故障排除 ▸ 连接器,Google 相关的消息见在成员的 Mac 上。其余消息如下:
| 您看到的内容 | 处理方法 |
|---|---|
| “Sign in to Haruno in Settings before connecting Slack.”(连接 Slack 之前,请先在设置中登录 Haruno。) | 选择账户菜单 ▸ “Sign In…”(登录…),然后再连接。 |
| “Slack sign-in timed out. Please try again.”(Slack 登录超时。请重试。) | 重新登录,并在大约三分钟内在浏览器中完成。 |
| “Discord did not accept that bot token. Copy it again from the Bot page of your application.”(Discord 不接受该机器人令牌。请从您应用的 Bot 页面重新复制。) | 从开发者门户重新复制令牌。 |
| “This bot has not been invited to a server yet. …”(此机器人尚未受邀加入任何服务器。……) | 从开发者门户邀请它,然后重新打开该对话框。 |
| “The bot cannot see that channel. …”(机器人看不到该频道。……)或“The bot cannot see any text channels in that server. …”(机器人在该服务器中看不到任何文字频道。……) | 在 Discord 中授予机器人访问某个频道的权限,然后重试,或重新选择服务器。 |
| “Discord is asking us to slow down. Wait a moment and try again.”(Discord 要求我们放慢速度。请稍候再试。) | 稍等片刻,然后重试。 |
| “This Google service isn't switched on for the Google app this sign-in used. …”(本次登录所用的 Google 应用未启用这项 Google 服务。……) | 由贵组织的管理员为其 Google 应用启用该服务。 |
| “This connection now only sees the Haruno folder in your Google Drive. …”(此连接现在只能看到您 Google Drive 中的 Haruno 文件夹。……) | 选择 ⋯ ▸ “Edit…”(编辑…),以完整的 Drive 访问权限重新登录,然后重新选择文件夹。 |
| “Use an https:// URL.”(请使用 https:// 开头的 URL。) | 为自定义服务器填写 https:// 开头的地址。 |
| Unlock your keychain to reconnect.(请解锁钥匙串以重新连接。) | 解锁您 Mac 的登录钥匙串。 |
| Sign in again soon to keep this connection working.(请尽快重新登录,以保持此连接正常使用。) | 这个 Google 连接是通过 Haruno 已不再持有的应用建立的。请重新登录。 |
| Tools server unavailable(工具服务器不可用) | 退出并重新打开 Haruno。如果问题仍然存在,请联系技术支持。 |
在 Windows 上
Windows 应用也有连接器。它们与 Mac 上的不同之处,参见Windows 版 Haruno。
| 项目 | Mac | Windows |
|---|---|---|
| 位置 | 账户菜单 ▸ “Connectors…”(连接器…) | “Settings ▸ Connectors”(设置 ▸ 连接器)中的“Integrations”(集成)卡片 |
| 开启连接器 | “Sign in”(登录)或“Connect”(连接) | “Enable”(启用)会从 Haruno 的目录下载该连接器的已签名软件包;然后点击“Connect” |
| 自定义服务器 | 仅限 Advanced view | 仅限 Advanced view(高级视图),且在沙盒会话中不可用 |
| 定时任务 | 外发操作暂存在“Waiting”(待处理)中 | 设为“Confirm”(确认)的工具会被拒绝;没有 Waiting 队列 |
| 移除 | “Sign out”(退出登录)或“Disconnect”(断开连接) | “Remove”(移除)会删除该软件包及其保存的账号信息 |
只有 Windows 应用才有的连接器
| 连接器 | 功能 |
|---|---|
| Outlook Mail | 搜索、阅读、发送、回复和删除邮件。 |
| Outlook Calendar | 读取和管理日历活动。 |
| Notion | 搜索和更新工作区。 |
| Telegram | 通过机器人收发消息和文件。 |
| Yayoi | Misoca 开票。组织管理员需要先登记组织的 Misoca 应用。 |
| 弥生会計 Next | 将某一个月的日记账或试算平衡表导出到项目文件夹。只读:不会在弥生会計中创建、更改或支付任何内容。要据此为某月结账,请将试算平衡表 ZIP 添加到公司。 |
该列表来自 Haruno 的目录,因此无需更新应用也可能发生变化。Git、LinkedIn、WhatsApp 和 X 只在已经拥有其中某一个的电脑上提供,QuickBooks Online 则不是连接器。网页搜索以及读取和预览文件始终处于开启状态,没有对应的卡片。批准,参见Windows 上的批准。在 Windows 上,Google Drive 会请您在“Haruno connection folder”(Haruno 连接文件夹)和“My Drive”(我的云端硬盘)之间进行选择,参见Windows 上的 Google 连接器。