Megastructure Arc 2.2.0

• Arc 运行的任意智能体都可以从精简工具列表开始。“智能体设置 → 对话”中新增了“工具列表”选项。选择“精简”时，智能体只带几个核心工具和较短的提示开始，每次发送的请求更小；其他工具在需要时通过搜索找到，权限不变。选择“完整”时，智能体会从托管智能体一直使用的较长列表开始；Arc 中较少用到的工具仍需通过搜索找到。运行模型文件和自托管服务器的智能体原本就从精简列表开始，API 智能体则从完整列表开始，默认设置保持不变；现在你可以为 Arc 运行的任意智能体选择其中一种，从它的下一轮开始生效。
• 查看提供商缓存提供了智能体多少输入。“工作”标签页中的每一轮以及智能体的会话合计，现在都会显示提供商报告的 token 数：输入、已缓存输入、未缓存输入、缓存写入、输出、最大的一次请求、发送了多少请求，以及保存了多少个检查点。只有当每个请求都报告了已缓存输入和缓存写入时才会显示这两个数值，否则显示“不可用”，绝不会显示为 0；漏掉某个请求的输入合计会标注为部分数据。未缓存输入等于输入减去已缓存输入，只在两者都已知时显示，并且从不扣除缓存写入。Arc 根据字符数估算的最大请求大小会标注为估算值。报告已缓存 0 个 token 的提供商现在会显示 0：以前 Arc 会丢掉报告的 0，因此“没有缓存”和“未报告”看起来一样。智能体可以用 detail=full 读取同样的合计：运行的合计在 arc_run_status 中，单个席位的合计在 arc_seat_status 中。
• 智能体一步就能读取多个文件。Arc 运行的智能体在开始工作前需要读取几个文件时，现在可以一次调用读取最多八个，而不必每个文件调用一次。这些文件共用一次读取的大小上限；它无权读取的文件会单独报告，不会中断其余文件的读取；每个文件都会附带之后保存时所需的哈希。智能体通过搜索找到这个工具，因此在智能体查找它之前，它不会给智能体的请求增加任何内容。
• 长时间运行的智能体在每个检查点之后发给模型的旧文本大幅减少。以前，Arc 运行的智能体超过步骤上限时，Arc 会保存检查点并继续，而之后的每个请求都会再次重放先前每一段的续接消息：旧的笔记、旧的文件列表和旧的读取进度，一遍又一遍。现在，一个请求会把整条链作为一轮对话重放：原始请求加上它运行期间你发送的所有备注，以及最新的回复；当前的续接消息则带有最新的笔记和需要重新检查的文件。在一次长时间试验中，这部分内容占下一个请求所带历史的四分之三。智能体的上下文视图和已保存的日志仍会显示每一段。
• 智能体在检查点之后仍保留保存工作所需的文件哈希。要替换文件，Arc 运行的智能体必须提供它所读取版本的哈希，这样就绝不会覆盖别人做的更改。以前在检查点之后，智能体只保留读到一半的文件的哈希，因此它第一次保存其他文件时常常被拒绝，只得重新读取该文件。现在续接消息会列出智能体最近读取或保存的最多十二个文件的哈希，并与文件逐一核对：未改动的文件保留其哈希，已改动的文件会标注为需要重新读取。Arc 仍然从不替智能体填入哈希。保存被拒绝时，消息现在会指出可获得该哈希的具体读取调用。
• 中文界面对智能体统一使用一个称呼。以前繁体中文窗口约有一百处用另一个词称呼智能体，简体中文窗口也有几十处如此。现在两者分别统一为“智能體”和“智能体”，MCP 设置以及 Arc 以中文提供给智能体的指令也是如此。

• 连接 Claude Cowork 后会提示你重启 Claude Desktop。以前 Arc 连接 Claude Cowork 后，房间会提示开始一个新会话，但 Claude Desktop 只在启动时读取它的连接。现在房间会请你完全退出 Claude Desktop，然后重新打开。
• 智能体设置会说明智能体重新读取哪些内容。“对话记忆”计算智能体的每一轮对话，而不只是与你的对话；“阅读房间”读取公开发布的消息以及 Arc 运行的其他智能体收发的消息，而不只是你发给它们的消息。现在四种语言的提示都会这样说明。
• 模型服务器回复“Streaming is not supported”时，智能体现在也能收到回复。Arc 会请模型以流式方式回复，服务器拒绝时再请求一次性返回完整回复。以前它能识别指明 stream 字段的拒绝，却无法识别只说“Streaming is not supported”的拒绝，因此智能体会停在这个错误上。现在它会请求完整回复。
• 发布到房间的提供商错误不再显示你的提供商账户 ID。OpenRouter 会在每个错误旁附上你的用户 ID，OpenAI 的速率限制错误会写出你的组织，因此当 Arc 运行的智能体因这类错误停下时，房间里的每个人都能看到这个 ID。现在 Arc 会把错误文本中的用户、账户和组织 ID 替换为 [REDACTED]，就像它一直对 API 密钥所做的那样。
• 仅限部分房间的智能体不能再读取其他房间中由 Arc 管理的智能体会话。以前，邀请只允许读取特定房间的智能体虽然无法读取其他房间的消息，但在同一台电脑上仍能读取任何由 Arc 管理的智能体的会话、它运行的命令及其输出、它的历史记录和日志。现在这些读取遵循该智能体的房间访问权限。Arc Desktop 不受影响。
• arc mcp --no-ensure 会在 Arc 未运行时告诉智能体。以前没有运行中的 Hub 时，桥接程序会在智能体的应用连接之前就退出，原因只出现在日志里的错误堆栈之后。现在桥接程序会正常连接，每次 Arc 工具调用都会回答“Arc hub not running at <url>; start Arc”。Arc 启动后，下一次工具调用即可正常工作，无需重启智能体。
• Arc 不再让 Claude Code 中的智能体调用它还看不到的工具。以前智能体用 arc_search_tools 或 arc_describe_tool 找到工具后，Arc 会说该工具已加入它的工具列表，可以直接调用。Claude Code 要在重新读取工具后才会加入这类工具，因此调用会失败并显示“No such tool available”。现在 Arc 会让智能体通过 arc_call_tool 调用该工具，这种方式始终有效。对于能立即显示该工具的应用，工具仍会加入列表。
• Arc 无法打开你的主文件夹时，它运行的智能体也能看到电脑上的编程工具。Arc 会从你的主文件夹运行每个编程工具（Python、Node.js、Go 等），以检查电脑上装了哪些。以前该文件夹无法打开时，每项检查都会失败，Arc 会在十分钟内告诉新智能体这台电脑一个都没有。现在遇到这种情况，Arc 会从磁盘的根目录运行检查；因文件夹问题而无法启动的检查会在下一个智能体启动时重试，而不会被记住。
• 模型以错误格式发送数字、true/false 或列表时，智能体不再卡住。有些模型会把数字作为文本发送（“42”），把 true 或 false 作为文本发送，或者把列表包装成 {"item": ...}。以前 Arc 会拒绝这些调用，因此智能体可能一遍又一遍地发送同一个调用：曾有一个智能体十多次都没能设置好它的工作要达到的完成条件。更糟的是，为“替换所有匹配项”这类选项发送“false”的智能体，反而会让该选项被打开。现在 Arc 会按工具的预期读取这些值，适用于所有工具。其他任何值都会像以前一样原样传递。
• Arc 运行的智能体可以在单个文件中搜索。以前智能体像使用 grep 那样把文件传给 workspace_search 时，会被告知一个确实存在的文件“directory does not exist”。智能体认为调用没错，于是反复发送，直到 Arc 因重复操作而暂停它们。现在用文件路径搜索就会搜索该文件，无法读取的文件会说明原因。
• 你可以放弃提供商始终没有回应的模型步骤。以前提供商接受了一个步骤却什么也没返回时，智能体会一直保留这个步骤以及之后发给它的每条回复，直到你停止智能体：arc_cancel_seat_turn 报告智能体处于空闲状态，恢复卡片也没有任何出路。现在卡片上有“放弃此步骤”：它会在没有回应的情况下结束该步骤，保留智能体已完成的工具工作，并按顺序运行保留的回复；勾选“同时丢弃保留的回复”则会改为丢弃它们。取消智能体的当前轮次（包括使用 arc_cancel_seat_turn）现在也会以同样方式放弃保留的步骤，而且 Arc 重启后该步骤仍保持已放弃状态。在智能体保留某个步骤期间更改其模型、房间访问权限或文件夹，会使 Arc 拒绝再次发送该步骤：现在卡片会说明设置已更改，关闭重试，并把“放弃此步骤”放在首位；把设置改回去后，重试会重新可用。
• “立即重试未完成的步骤”现在会真正重试，卡片也会告诉你结果。自 2.1.5 引入提供商恢复以来，卡片上的“立即重试未完成的步骤”和“暂停重试”在智能体看到之前就会被 Hub 拒绝，因为应用没有出示它的操作员密钥；卡片上只显示 operator_only。现在它们会送达智能体。卡片会立即切换到重试状态，显示步骤的发送时间和已等待的时长，并提供“取消”。如果重试仍然没有收到回复，卡片会显示“18:05 的第 1 次重试仍然没有输出。”，重试次数也不再归零。Hub 仍会拒绝的请求会用文字说明原因。对于 API 或自托管服务器智能体，卡片标题现在会说明智能体正在等你处理、该步骤没有收到回复，并提示你在重试前先调高“响应期限”，因为重试会等待同样长的时间。关于缺少请求 ID 的说明已移到“恢复详情”中。步骤被放弃，或经过一次或多次重试后恢复时，智能体的历史记录会留下一行简短的说明。这也更正了 2.1.5 的说明：当时说卡片上的“立即重试未完成的步骤”和“暂停重试”可以使用，并说只有停止智能体才能结束失败的步骤；现在“放弃此步骤”和取消智能体的当前轮次也能结束它，而无需停止智能体。
• 回复中途出现的提供商错误不再被自动重新发送，失败请求的用量会显示为未知。在回复的任何内容到达之前出现的网关 502、503 或 504 错误，仍会在同一恢复预算内自动重试。以前在部分回复已流式传回之后出现的此类错误也会被重新发送，导致该回复再次生成，并可能再次计费；现在该步骤会在恢复卡片上等你处理。以前已发送但失败的请求不报告用量，并被当作不产生费用来计算；现在它会被算作用量未知的步骤，因此智能体的用量会显示为部分数据，运行也会继续。
• arc stop --storage <path> 只会停止为该数据库提供服务的 Hub。以前未指定 --port 时，arc stop、arc app stop 和 arc reset 会停止在 6969 端口应答的任何 Hub，因此按数据库停止测试用 Hub 时，可能反而停掉你的主 Arc Hub。现在指定 --storage 时，它们会通过该数据库旁的 pidfile 找到对应的 Hub。为其他数据库提供服务的 Hub 会继续运行，命令会说明没有为该数据库运行的 Hub。
• “设置 → 数据与项目 → 截图 → 打开文件夹”在新安装中也能使用，无法打开时会说明原因。截图文件夹要等智能体拍下第一张截图才会创建，因此在那之前这个按钮没有任何作用，其他失败也会被隐藏。现在它会创建该文件夹并打开。你选择的主文件夹以外的文件夹会在其上级文件夹中显示；Arc 无法打开或显示该文件夹时会说明原因。
• 演示模式会隐藏更多属于你的信息。以前开启“隐藏私人信息”后，“添加智能体”窗口仍会在来源列表、模型列表标题、搜索框、底部栏和“整理”中显示你为 API 密钥、服务器和已保存的配置起的名称，以及网络服务器的地址。现在密钥会显示为其提供商（“OpenRouter 1”“OpenRouter 2”），服务器或已保存的配置显示为“服务器”或“已保存的配置”，有多个时会编号；从房间复制的智能体则以其模型显示。“设置 → 工具接入适配器”和“数据与项目”，以及“添加智能体”窗口中的文件夹面板，现在会在配置、数据和文件夹路径中把你的主文件夹显示为 ~。在“数据与项目”中导出项目时，现在会从你当前打开的项目开始，演示期间也只列出该项目。关闭演示模式后，一切都会像以前一样显示。
• “安全”的说明现在与它实际允许的操作一致。以前选择房间访问权限时，说明称“安全”不允许任何网络访问。其实在“安全”房间中，Arc 运行的智能体可以搜索网页、阅读公开页面，正如文档所述；它们仍然不能运行 shell 命令、编辑文件，也不能访问本地和局域网地址。
• 认领在 Hub 重启后仍会保留。以前 Hub 重启后，智能体尚未过期的认领虽然仍能阻止其他智能体接手它的任务，却不再算作该智能体自己的认领：房间状态会把它们列为已预留，直到智能体逐一重新认领。现在 Hub 会在重启后保留每一个尚未过期的认领，持有者和到期时间保持不变，也不会再要求智能体重新认领。在 Hub 停止期间到期的认领会像以前一样失效。文件锁保持不变：重启后，智能体需要重新锁定文件，才能让锁归自己所有。

Windows 10/11（64 位），或搭载 Apple 芯片的 macOS 11 及更高版本。内置本地 AI 需要 macOS 26 或更高版本。电脑操作需要 macOS 14 或更高版本。