# agent-interop-runtime 中文文档 规范地址：https://npmcn.com/package/agent-interop-runtime/ 版本：1\.0\.2 npm 元数据更新时间：2026-11-03T00:08:20.035Z 中文译文更新时间：2026-11-03T04:32:33.509Z 软件包许可：MIT 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/agent-interop-runtime 原文对照：https://npmcn.com/package/agent-interop-runtime/?lang=original 项目主页：https://github.com/Praket7/agent-interop-runtime#readme 源码仓库：https://github.com/Praket7/agent-interop-runtime ## 关键信息（来自 npm 元数据） - 包体积（解压后）：620 kB，33 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=20 \<27 - 运行依赖：3 个 - 首次发布：2026-09-08T20:10:07.262Z - 最新版本发布：2026-11-03T00:08:19.707Z - 已发布版本数：22（近 12 个月 22 个） ## 中文简介 通过本地MCP运行时协调编码代理，同时保持提供程序帐户和工作空间的分离。 ## 安装 ```sh npm install agent-interop-runtime ``` 也可以使用：`pnpm add agent-interop-runtime`、`yarn add agent-interop-runtime`、`bun add agent-interop-runtime` ## README # Agent互操作运行时 您的编码代理已经知道如何工作，代理互操作运行时可以帮助它们共享任务，同时每个代理都保持自己的身份、帐户和工作环境。 将本地MCP客户端连接到运行时，它将找到安装在计算机上的编码代理，因此您可以选择会话，将其发送工作，跟踪其进度并将结果传递给另一个会话。每个提供者仍然使用自己的帐户、权限、历史记录和项目访问权限，因此运行时可以协调工作，而无需合并单独的环境。 可以将其视为编码代理的流量台，因为它显示哪个会话接收了任务，记录提供者发回的更新，并将每个检查的结果保存在一个地方，而不会将单独的对话转换为共享聊天。 ![A simple view of one MCP client sending work through a local coordinator to separate provider sessions](https://npmcn.com/package/agent-interop-runtime/docs/media/agent-interop.png) [观看简短的图解之旅](https://npmcn.com/package/agent-interop-runtime/docs/media/agent-interop.mp4) ![Automated tests, offline handoff results plus CI matrix size](https://npmcn.com/package/agent-interop-runtime/docs/media/agent-interop-stats.png) 这些图片是插图，因此它们解释了工作流程和可用的度量，但不显示实时的提供者会话。 ## 当你发送工作时发生了什么 运行时将您的消息发送到您选择的提供者会话，并且收据可能确认提供者接受了它；然而，接受只是确认交付给提供商，并不意味着代理完成了任务。运行时只有在观察到该会话的结果后才报告完成情况。 同样的规则也适用于传递不确定的情况，因为网络故障可能发生在提供者接受您的消息之后，但在运行时收到确认之前。在这种情况下，运行时将交付标记为未知，并且不会再次静默地发送提示，从而避免重复可能已经在进行的工作。 ## 它能做什么 在计算机上查找受支持的提供程序会话，以便在选择将工作发送到何处之前查看可用的本地工具。 当选定的提供程序支持这些操作时，创建或恢复会话，并使用提供程序报告检查设置中可用的控件。 发送工作、请求取消、读取进度和收集提供程序差异（当所选提供程序支持这些特性时）。 保持共享工作笔记、交接、证据、审查和合作资源声明，以便参与会议可以围绕同一任务进行协调。 当显式启用验证时，在指定的工作空间内运行本地检查，并在将配置的程序委托给项目之前检查它们。 读取已批准的项目文件夹中的小文本文件，同时阻止普通凭证文件，对凭证形状的文本进行编校，并拒绝二进制文件。 供应商的功能各不相同，因此医生报告显示每个已安装的供应商可以做什么；单独查找提供者并不能确认其登录状态或是否已准备好接受工作。 ## 它做不到的事 它不会合并提供者帐户或历史记录，并且每个会话仍然受其提供者自己的设置的约束。 它不会绕过登录、同意提示或权限请求，因此您必须通过提供商本身完成这些步骤。 它不会让代理访问没有安装在运行运行时的计算机上的提供程序，也不会替换该提供程序自己的应用程序。 它不会沙箱命令，因为验证运行的是您配置的程序，您的帐户可以访问，所以只对您信任的工作和命令使用它。 资源声明协调使用此运行时的代理，但它们不能阻止运行时之外的其他程序编辑相同的文件。 ## 供应商 Freebuff桌面使用其本地应用程序连接，并且在发送工作之前需要当前启动检查；Freebuff CLI使用一个托管终端会话。 OpenCode使用它的本地服务器，运行时可能在需要时在环回上启动，并且可能改变工作的请求在不确定的网络结果之后永远不会重播。每个会话仍然绑定到公开它的服务器，因此切换服务器不会静默地重定向现有工作。 Codex使用Codex应用服务器，而Claude Code和Cursor使用各自支持的代理客户端协议命令。 可用的功能取决于提供程序版本、本地设置和帐户状态，并且大多数协议检查使用模拟提供程序而不是实时会话。在依赖MCP服务器进行实时工作之前，请检查将运行MCP服务器的计算机上的提供程序。 ## 选择客户端看到的工具 运行时从一组集中的9个工具开始，因此新的MCP连接可以查找提供者、检查和控制会话、读取事件以及取消或恢复工作，而无需加载更大的协调目录。当您的工作需要共享对话、证据、移交或Freebuff特定控件时，您可以选择更大的集合，并且可以保留原始的0.3。在迁移现有客户端时使用X名称。 | 配置文件 | 工具 | 使用它 | | --- | --: | --- | | `minimal` | 9 | 您需要提供程序会话的推荐启动集。 | | `core` | 30. | 您还需要共享对话、工作记录、交接、审查、证据和索赔。 | | `freebuff` | 16 | 您主要使用Freebuff项目和线程。 | | `full` | 49 | 您需要为每个受支持的特性使用现代名称。 | | `legacy` | 52 | 现有的MCP客户机仍然调用原来的0.3。X工具名称。 | 现代概要文件使用可预测的动词名，并且相关的进度操作已经组合在一起，因此一个工具可以读取快照或等待更新。遗留概要文件在迁移期间保留以前的名称，而 [迁移指南](https://npmcn.com/package/agent-interop-runtime/docs/migration-1.0.md) 将每个旧工具映射到它的新名称或替代品。 在服务器命令或设置上选择一个配置文件 `INTEROP_TOOLS_PROFILE` 当客户端配置不能传递参数时。 ```sh npx -y agent-interop-runtime@1.0.2 serve --profile minimal npx -y agent-interop-runtime@1.0.2 serve --profile core npx -y agent-interop-runtime@1.0.2 serve --profile freebuff npx -y agent-interop-runtime@1.0.2 serve --profile full npx -y agent-interop-runtime@1.0.2 serve --profile legacy ``` 只读模式删除更改提供程序或协调状态的工具，并且可以通过设置启用 `INTEROP_READ_ONLY=1` 在服务器环境中。 ## 安装 使用Node 20到Node 26，在检查哪些提供商可用之前，先用npm或pnpm安装当前的主要版本。 ```sh npm install --global agent-interop-runtime@1 agent-interop-runtime doctor ``` 当你改变项目时，你也可以使用源代码签出，它的构建运行与发布工作流使用的TypeScript编译器相同。 ```sh git clone https://github.com/Praket7/agent-interop-runtime.git cd agent-interop-runtime pnpm install pnpm build node dist/src/cli.js doctor ``` ## 连接本地MCP客户端 运行时与安装在同一台计算机上的提供商应用程序和工具进行对话，因此推荐的连接是通过标准输入和输出的本地MCP服务器。从客户机的setup命令开始，并在更改其配置后重新启动或重新加载该客户机。 ### 食典委 安装程序添加或修复本地Codex条目，在更改现有配置之前备份现有配置，并保留不相关的设置。 ```sh npx -y agent-interop-runtime@1.0.2 install --write ``` ### 光标 Cursor安装程序在用户配置中写入与项目无关的条目，并且 `--project` 仅在当前项目中需要连接时可以添加。 ```sh npx -y agent-interop-runtime@1.0.2 cursor-setup --write ``` ### 克劳德代码 Claude Code可以直接启动本地服务器，下面的命令从推荐的9个工具开始。 ```sh claude mcp add --transport stdio agent-interop-runtime -- npx -y agent-interop-runtime@1 serve --profile minimal ``` ### OpenCode 将以下条目添加到OpenCode配置中，本地进程将公开相同的聚焦工具集。 ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "agent-interop-runtime": { "type": "local", "command": ["npx", "-y", "agent-interop-runtime@1", "serve", "--profile", "minimal"], "enabled": true } } } ``` 其他MCP客户端也可以启动相同的程序 `serve` 命令，并且提供程序应用程序必须在运行运行时的计算机上可用。HTTP模式可以支持有意的远程设置，但它需要身份验证和网络保护，因为会话标识符不能取代访问控制。 ## 现有的证据 自动化测试和离线基准测试使用模拟的供应商来检查工具的行为，这些结果不需要联系实时代理、测量速度或估计供应商成本。GitHub CI针对四种支持的Node版本检查三种操作系统，共有十二种组合。 早期的本地检查观察到Freebuff GLM 5.3 Flash的响应，而OpenCode Big Pickle接受了一个提示，尽管在该会话中没有观察到完成。这些观察结果仅适用于所测试的特定会话，因此不能确定一般的提供者支持。 ## 运行检查 ```sh pnpm typecheck pnpm test pnpm lint pnpm mcp:validate pnpm schema:check pnpm bench:check pnpm audit --prod --audit-level=high npm audit --prefix media/remotion --audit-level=high pnpm pack:check ``` 读 [提供者指南](https://npmcn.com/package/agent-interop-runtime/docs/adapters.md)， [简单语言架构指南](https://npmcn.com/package/agent-interop-runtime/docs/architecture.md)， [兼容性说明](https://npmcn.com/package/agent-interop-runtime/docs/compatibility.md)， [1.0迁移指南](https://npmcn.com/package/agent-interop-runtime/docs/migration-1.0.md), [故障排除](https://npmcn.com/package/agent-interop-runtime/docs/troubleshooting.md) 查看设置和行为细节。 ## 安全和隐私 本地标准输入和输出服务器是最简单的设置，而HTTP模式在默认情况下绑定到环回，并且需要一个承载令牌。远程访问需要显式设置和网络保护，因为会话标识符不能取代身份验证。 项目文件读取将保留在选定的项目文件夹中，并且在根据公共凭据模式检查文本时拒绝公共凭据文件。这些检查不能检测到每个秘密，所以要将敏感值从代理可以读取的文件中删除。 默认情况下，验证是关闭的，但是当启用时，它会在没有shell的情况下运行配置的程序，并检查工作文件夹是否留在指定的工作区中。子程序没有沙盒，因此它们保留您帐户授予的访问权限。 ## 帮助改善它 使用 `doctor` 在发送工作之前和报告问题时，包括提供程序名称、版本、操作系统、尝试的操作以及提供程序是否接受任务或返回已完成的结果。在报告中保留私有提示和凭据。 该项目欢迎可重复的兼容性报告和代码贡献，特别是当它们解释了特定的提供程序版本和计算机上发生的事情时。 ## 常见问题 ### agent-interop-runtime 是什么？ 通过本地MCP运行时协调编码代理，同时保持提供程序帐户和工作空间的分离。 ### 如何安装 agent-interop-runtime？ 在项目目录运行 npm install agent-interop-runtime，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-interop-runtime，可以用 npx agent-interop-runtime 直接运行。 ### agent-interop-runtime 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agent-interop-runtime 是否存在。 ### agent-interop-runtime 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### agent-interop-runtime 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20 \<27。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### agent-interop-runtime 可以商用吗？ agent-interop-runtime 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### agent-interop-runtime 还在维护吗？ 最新版本 1\.0\.2 发布于 2026/11/03（今天）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/09/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。