# @agfpd/iapeer 中文文档 规范地址：https://npmcn.com/package/%40agfpd/iapeer/ 版本：0\.4\.166 npm 元数据更新时间：2026-11-05T21:35:55.995Z 中文译文更新时间：2026-11-05T23:52:16.666Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40agfpd/iapeer 原文对照：https://npmcn.com/package/%40agfpd/iapeer/?lang=original 项目主页：https://github.com/agfpd/iapeer#readme 源码仓库：https://github.com/agfpd/iapeer ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.8 MB，197 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：8 个 - 首次发布：2026-06-08T15:06:15.917Z - 最新版本发布：2026-11-05T21:35:55.604Z - 近 30 天下载量：8884（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：269（近 12 个月 269 个） ## 中文简介 运行 Claude Code和Codex CLI 作为本地背景代理,互相传递消息,按需要唤醒,共享一个内存. ## 安装 ```sh npm install @agfpd/iapeer ``` 也可以使用：`pnpm add @agfpd/iapeer`、`yarn add @agfpd/iapeer`、`bun add @agfpd/iapeer` ## README # 动物 **运行 Claude Code, Codex CLI 和 OpenCode 作为本地背景代理,相互传递消息,按需要唤醒,共享一个内存.** [![CI](https://github.com/agfpd/iapeer/actions/workflows/ci.yml/badge.svg)](https://github.com/agfpd/iapeer/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/@agfpd/iapeer)](https://www.npmjs.com/package/@agfpd/iapeer) [![license](https://img.shields.io/npm/l/@agfpd/iapeer)](https://npmcn.com/package/%40agfpd/iapeer/LICENSE) [![platform](https://img.shields.io/badge/platform-macOS-lightgrey)](https://npmcn.com/package/%40agfpd/iapeer/#readme-quick-start) iapeer保持一组AI代理,人类,以及服务在一个主机上总是可以达到的,每一个消息都离开. 每个参与者都是 **端点**: Claude Code或Codex CLI代理,Telegram上的人,或调度员/监视员服务. 任何特工通过一个电话联系到任何其他人, `send_to_peer(, )`;如果收受者已经入睡了,被守护神唤醒并交付. Claude和Codex的特工是不同销售商的AI运行时间,但他们是平等的同行。 人类参加Telegram,或者直接在终端中与同伴的直播会合 `iapeer attach`。 。 。 . ![A person messages one peer on Telegram; heterogeneous peers (Claude + Codex) relay a baton over one protocol and report back to Telegram.](https://npmcn.com/package/%40agfpd/iapeer/.github/assets/iapeer-pingpong.gif) _Claude 和 Codex 的同龄人通过一个警棍传递到同一个协议上 Telegram上的报告._ ## 如何运作 ```text send_to_peer(name, text) ← from any peer │ ▼ router daemon — always on; finds the recipient, checks liveness, delivers │ ▼ recipient peer — asleep? the daemon wakes it and delivers on wake ``` ## 是什么让它不同 - **真正的交互式CLI会话,不是无头一发.** 每个人工智能对等器都是Claude代码或Codex CLI会话,不是一次性的 `claude -p` 编号 : `codex exec` 电话. - **随需要暖和,总是可以达到的.** 直播会话迅速回答;当它闲置了守护进程时,它就会在下一个信息上将其停放并带回——背景恢复了。 能否出席决不取决于一个人能否继续开会. [生命周期和守护进程](https://npmcn.com/package/%40agfpd/iapeer/docs/04-lifecycle-and-daemon.md)。 。 。 . - **一个身份贯穿整个运行时间 一个记忆.** 一个同伴 `personality` 与运行时间脱钩: 相同的对等点运行在克洛德或Codex上, 并带有命令切换. 默认( 设置于 `iapeer onboard`)它携带着一个共享的记忆(iapeer-memory),按着个性而不是跑步时间——一个个性,一个记忆,无论它运行在哪个跑步时间. - **异相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.** AI代理,人类(Telegram),以及服务(timer = cron, watcher = event)都是一流的,用同样的方式在总是在MCP守护进程上,它暴露出一个完全一样的工具, `send_to_peer`。 。 。 . ## 快开始 所需经费: **马科斯** (Linux上线) [路线图](https://npmcn.com/package/%40agfpd/iapeer/#readme-roadmap))和至少一个代理运行时间——克洛德代码或Codex CLI(每个AI对等是1的活会话). 安装者处理其余部分( E)[包头](https://bun.sh/) 财务报告和审定财务报表 `~/.local/bin` 打开 `PATH`) (中文(简体) ). **安装——一行.** 缺少时安装包子, 构建 `iapeer` 二进制,然后切换到交互式 `onboard`数字 : ```sh curl -fsSL https://agfpd.github.io/iapeer/install.sh | sh ``` **不想把剧本塞进你的壳里?** 手动运行相同的步骤( 需要) [包头](https://bun.sh/) 打开 `PATH`: ```sh # install — the iapeer binary and the ~/.iapeer layout npx @agfpd/iapeer # or: bunx @agfpd/iapeer # set up the host — router daemon, scheduler peers, Telegram, shared memory iapeer onboard ``` 任一路径运行 `onboard` 交互:它会浮出安全检查(runtime sign-in,macOS Full Disk Access),并在安装内存提供者之前询问——没有任何东西在你的背后是自动批准的. 你识字 [`install.sh`](https://npmcn.com/package/%40agfpd/iapeer/install.sh) 在运行前,或预览每个步骤 `IAPEER_INSTALL_DRYRUN=1`。 。 。 . **然后创建你的特工,让他们联系.** Claude 同行和 Codex 同行谈话平等——每次运行时创建一次: ```sh # create two peers, one per runtime iapeer create architect --runtime claude iapeer create implementer --runtime codex # message one from your terminal iapeer send implementer --message "Draft the parser API; the architect will review." # or join a peer's live session — detach with Ctrl-] (or just close it; the agent keeps running) iapeer attach architect ``` 在同伴自己的会话中,代理联系到其他人 `send_to_peer(, )`· ; `iapeer send` 是终端等同的. **已有项目文件夹吗 ?** 在步骤3中,使用 `init` 改为 `create`数字 : `cd` 输入项目,并将文件夹本身登记为对等点. ```sh cd ~/projects/myagent iapeer init ``` 对等方的名称是文件夹名称, 已规范( Q)`myagent`) (中文(简体) ). `create` 在下方设置新文件夹 `~/.iapeer/peers/`· ; `init` 将您所在的文件夹变成对等点 。 两者的设定都一样. 在您的终端与本地特工合作的两种方式: - **加入其现场会议** —— 说 `iapeer attach architect`守护进程会先唤醒同伴,如果它睡着了。 切换为 `Ctrl-]` ——或只是关闭终端——会话在后台持续运行;再接上 `iapeer attach` 随时需要它. - **在对等文件夹中打开新会话** ——去对等器目录,启动运行时间: ```sh cd ~/.iapeer/peers/architect iapeer claude ``` 这开始一个完整的会话 同行的身份和学说 并让你直接进入它。 实际上, `iapeer claude` 实值 `claude` 对于这个对等者——相同的交互式CLI,但会话具有稳定的身份,有自己的记忆,其他对等者可以到达的地址. 特工们互相联系 `send_to_peer`;也可以在Telegram上发送任何端点. ## 旁通权限模式 **警告:iapeer在绕行-permission / no-sandbox模式中运行您的 Claude 和 Codex 等同器——它们执行工具( shell 命令,文件编辑,网络呼叫)而不要求您批准每个动作.** 这从设计上来说:对等者是一个背景,无头会话,没有人类监视它的终端,所以没有人回答每个工具的许可提示. 发射装置从克洛德开始 `--dangerously-skip-permissions` 代码 `--dangerously-bypass-approvals-and-sandbox`,以及 **自动接受代表您的一次性“ 接受绕行模式” 屏幕** 第一次在新鲜机器上穿对等靴. 这对你来说意味着什么: - 同行可以运行任何运行时间可以运行的命令——在您家目录的任何地方读取和写入文件,安装软件,制作网络呼叫——使用 **无确认步骤**经纪人和你的机器之间没有沙盒. - 你相信模型的判断, 和你给每个同伴的理论, 就像你信任一个开发者的方式. - 亚佩尔有 **没有** 默默地削弱自己的互动 `claude` 编号 : `codex` 设置。 绕行接受记录为每对端, 在代理的自定义中; 项目- MCP 预核准为写入 **项目-当地**,在对等文件夹下——永远不要到您的全局用户设置. **想要一个人类在循环中 对于给定的同伴?** 设定其批准模式为 `gated` —— 说 `iapeer approval-mode gated`。同伴发射 **无** 绕行旗,每一次屏蔽批准,其运行时间会升起,都会向您传递——一个Telegram按钮,在托盘中点击,或者 `iapeer approve` 在CLI上——工具运行前 `allow`编号 :`deny` (有原因的)回流和工具继续或被拒绝。 默认保留 `yolo` 每个同龄人; `gated` 每个对等方选择进入。 见 [docs/17——人类的核准](https://npmcn.com/package/%40agfpd/iapeer/docs/17-approval.md)。 。 。 . 在您控制的主机上运行iapeer, 给每个对等方只提供它所需要的访问, 并将对等方的指令视为安全相关 . `iapeer onboard` 在设置时声明这一点;在此重复,所以在创建第一个代理之前,权衡是明确的。 每个首运行对话框的细节 : [文件/07——安装和更新](https://npmcn.com/package/%40agfpd/iapeer/docs/07-install-and-update.md#first-run-dialogs-on-a-clean-machine)。 。 。 . ## 文档 [`docs/`](https://npmcn.com/package/%40agfpd/iapeer/docs/README.md) ——产品方面:它是什么,如何使用. 两种语文——英语(默认)和 [Русский](https://npmcn.com/package/%40agfpd/iapeer/docs/ru/README.md)。该存储器是执行. ## 路线图 计划,尚未建造: - **Linux 支持** ——iapeer在今天运行于macOS;Linux是计划. - **更多代理运行时间** -比如 `antigravity`,与克洛德代码, Codex 和 [打开代码](https://npmcn.com/package/%40agfpd/iapeer/docs/20-opencode.md)。 。 。 . - **Discord 运行时间** ——"Discord"与"Telegram"并列的人类出场时间. 已经可用 : [打开代码](https://npmcn.com/package/%40agfpd/iapeer/docs/20-opencode.md), (中文(简体) ), [人类对Telegram/Tray/CLI的认可](https://npmcn.com/package/%40agfpd/iapeer/docs/17-approval.md),并通过单独安装的浏览器控制台 `web-runtime` 软件包。 核心会暴露 [舰队 API](https://npmcn.com/package/%40agfpd/iapeer/docs/15-fleet-api.md) 用于操作客户端. ## 许可证 Apache-2. 平台:macOS / sunchd. iapeer是更大的生态系统的基础;运行时间和能力插件在其上方被构建. ## 常见问题 ### @agfpd/iapeer 是什么？ 运行 Claude Code和Codex CLI 作为本地背景代理,互相传递消息,按需要唤醒,共享一个内存\. ### 如何安装 @agfpd/iapeer？ 在项目目录运行 npm install @agfpd/iapeer，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 iapeer，可以用 npx iapeer 直接运行。 ### @agfpd/iapeer 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agfpd\_\_iapeer 是否存在。 ### @agfpd/iapeer 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @agfpd/iapeer 可以商用吗？ @agfpd/iapeer 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @agfpd/iapeer 的下载量有多少？ 根据 npm 官方下载统计，@agfpd/iapeer 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,884 次，日均约 296 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @agfpd/iapeer 还在维护吗？ 最新版本 0\.4\.166 发布于 2026/11/06（1 天前）；至今共发布 269 个版本，其中过去 12 个月发布了 269 个；首次发布于 2026/06/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。