连接器

每个连接器能让 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”,指的就是这个窗口。

  1. 点击侧边栏底部显示您姓名或邮箱的账户栏,然后选择“Connectors…”(连接器…)。
  2. 在该连接器所在的行上,点击“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

  1. 在 Gmail 或 Google Calendar 行上点击“Sign in”(登录),然后在浏览器中允许 Google 列出的访问权限。对于 Gmail,请保持勾选“Send email on your behalf”(代表您发送电子邮件),否则 Gmail 不会连接。
  2. 页面显示“Signed in ✓”(已登录 ✓)后,返回 Haruno。该行会显示账号、一个开关和一个 ⋯ 菜单。

Gmail 和 Google Calendar 在这台 Mac 上各连接一个 Google 账号;用另一个账号登录会替换原来的账号。通过贵组织的应用,Haruno 可以将邮件附件保存到对话的工作文件夹中,即您通过“File ▸ Open Folder…”(文件 ▸ 打开文件夹…)打开的文件夹,或 Haruno 自己的 Workspace 文件夹。要基于该附件结账,请像其他导出文件一样将它添加到公司。

连接 Google Drive

  1. 在 Google Drive 行上点击“Connect”(连接),再点击“Continue to Google Drive”(继续前往 Google 云端硬盘),然后在浏览器中允许访问。请保持勾选 Drive 访问权限,否则不会建立连接。使用贵组织的应用时,请保持勾选“See, edit, create and delete all of your Google Drive files”(查看、修改、创建和删除您的所有 Google 云端硬盘文件),才能访问“我的云端硬盘”;如果不勾选,Haruno 只会使用它自己的文件夹。
  2. 点击“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 只能访问您自己的云盘,因此共享云盘或仅与您共享的文件夹可能不会出现;这类文件请改为下载。

  1. 在相应服务的行上点击“Connect”(连接)。OneDrive 提供“Tenant (optional)”(租户,可选);SharePoint 可填写“Site ID (optional)”(站点 ID,可选)或“Drive ID (optional)”(驱动器 ID,可选)。
  2. 点击“Continue to OneDrive”、“Continue to SharePoint”或“Continue to Dropbox”(继续前往相应服务)并登录。OneDrive、SharePoint 和 Dropbox 会请求访问您的整个账号;限制 Haruno 访问范围的,是您对文件夹的选择。
  3. 点击“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 可以搜索。

共享文件夹不等于公司的账簿
同步文件夹中的文件不参与结账。要基于公司在云盘中共享的导出文件结账,请把它下载到您的 Mac,然后像其他导出文件一样添加到公司。Haruno 可以列出文件夹的内容,或搜索 Google Drive,帮您找到它。

Slack

Slack 让 Haruno 可以在聊天中于您的工作区发布消息和读取频道:例如向财务频道发布结账状态,或者找到同事提出的与某家公司有关的问题。在 Slack 行上点击 Sign in(登录),然后在浏览器中选择工作区;请先登录 Haruno。

Slack 用于聊天,而不是定时任务
定时任务从不会获得 Slack,也不会获得您添加的任何其他服务器,因此它所做的任何事都不会在那里发布内容。要在 Slack 中发帖,请在聊天中提出,那里仍然适用“Require confirmation before posting and writing”(发布与写入前需要确认)。

Discord

Discord 通过一个由您创建并邀请到您服务器的机器人连接。之后,Haruno 可以在您选择的频道,以及该机器人能看到的任何其他频道中读取消息、发布消息和文件;因此,如果机器人只应留在一个频道中,请在 Discord 中限制它的访问权限。

  1. 在 Discord 的开发者门户中创建一个应用,在其 Bot 页面上重置令牌,然后邀请该机器人加入您的服务器,并授予发送消息和附加文件的权限。
  2. 在 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 撰写的文档。

Haruno 编制的工作簿只是工作底稿
它保存在对话所在的工作文件夹中(“Files”(文件)标签页,⌘3),不会改变总账;报表和报告只根据账簿生成。在转发之前,请先将其中的数字与该公司的报告相核对。

自定义服务器(Advanced view)

在 Advanced view(高级视图)中,“Connectors”窗口有一个“Custom MCP servers”(自定义 MCP 服务器)部分,用于将 Haruno 连接到您自己的服务器。MCP(Model Context Protocol,模型上下文协议)是一项向 AI 助手提供工具的开放标准。大多数财务团队从不需要这项功能。

  1. 在“Settings ▸ General”(设置 ▸ 通用)中开启 Advanced view。

    参见普通视图与 Advanced view。

  2. 点击“Add server”(添加服务器),填写“Name”(名称)和“Server URL”(服务器 URL,通常为 https://…),然后选择“Authentication”(认证方式):“None”(无)、“Header”(标头)或“OAuth”。
  3. 点击“Connect”(连接),将每个工具设为“On”(开启)、“Confirm”(确认)或“Off”(关闭),然后点击“Save”(保存)。

    设为“Confirm”后,Haruno 每次使用该工具之前都会先在聊天中征求您的同意。参见自定义服务器的逐工具设置。

安全沙盒无法通过 localhost 地址访问这台 Mac 上的服务器;请使用主机名或网络地址。关闭 Advanced view 会隐藏该部分;如果要让 Haruno 停止使用某个服务器,请先将其关闭或移除。

添加之前
自定义服务器会收到 Haruno 发送给它的一切内容,其中可能包括您账簿中的数字和名称,而 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。

项目MacWindows
位置账户菜单 ▸ “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通过机器人收发消息和文件。
YayoiMisoca 开票。组织管理员需要先登记组织的 Misoca 应用。
弥生会計 Next将某一个月的日记账或试算平衡表导出到项目文件夹。只读:不会在弥生会計中创建、更改或支付任何内容。要据此为某月结账,请将试算平衡表 ZIP 添加到公司。

该列表来自 Haruno 的目录,因此无需更新应用也可能发生变化。Git、LinkedIn、WhatsApp 和 X 只在已经拥有其中某一个的电脑上提供,QuickBooks Online 则不是连接器。网页搜索以及读取和预览文件始终处于开启状态,没有对应的卡片。批准,参见Windows 上的批准。在 Windows 上,Google Drive 会请您在“Haruno connection folder”(Haruno 连接文件夹)和“My Drive”(我的云端硬盘)之间进行选择,参见Windows 上的 Google 连接器。

后续步骤

连接器服务于聊天和定时任务。结账依据的是您添加的导出文件,或通过“Sync”(同步)导入的月份。