# @agentvault/openai-bridge 中文文档 规范地址：https://npmcn.com/package/%40agentvault/openai-bridge/ 版本：0\.1\.18 npm 元数据更新时间：2026-11-05T14:15:53.845Z 中文译文更新时间：2026-11-07T06:37:05.685Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40agentvault/openai-bridge 原文对照：https://npmcn.com/package/%40agentvault/openai-bridge/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：5.2 MB，10 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20 - 运行依赖：1 个 - 首次发布：2026-09-14T16:55:35.618Z - 最新版本发布：2026-11-05T14:15:53.612Z - 近 30 天下载量：2035（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：19（近 12 个月 19 个） ## 中文简介 代理服务器 OpenAI 加密所有者信件和房间的编码桥 ## 安装 ```sh npm install @agentvault/openai-bridge ``` 也可以使用：`pnpm add @agentvault/openai-bridge`、`yarn add @agentvault/openai-bridge`、`bun add @agentvault/openai-bridge` ## README # 代理服务器 OpenAI 桥 连接一个本地的 OpenAI Codex 登录到加密 AgentVault 拥有者直接消息和房间. 这是 `openai` 现有框架 `harness` 运行时间。 它不使用 OpenAI API 密钥或存档的 Codex 频道运行时间 . **发布状态 :** 初释. 该应用程序仅在注册安装和所有者认证的实时消息检查合格后提供安装服务. 单凭测试不能确定账户存取、开具账单或生产交付. ## 先决条件和登录 节点.js 20或更新,macOS或Linux,以及 **本地代码CLI 0.154.0可执行文件** 需要选择路径。 支持的模型固定为 `gpt-5.6-terra`. JavaScript npm 启动器需要 Homebrew/ Custom PATH 的节点,它不能运行在故意最小的孩子 PATH 内;而是安装本地的可执行代码。 其他 CLI 版本由于在升级前必须再次测量被禁用的工具边界而失效. 在全球安装`npm install -g @agentvault/openai-bridge`) (中文(简体) ). 开发建设可以运行 `node dist/index.js --help`;背景服务安装拒绝临时包卡切入点. 选择一个代理名称并用于每个命令 : ```sh AV_AGENT_NAME=aster agentvault-openai-bridge login AV_AGENT_NAME=aster agentvault-openai-bridge doctor AV_AGENT_NAME=aster AV_INVITE_TOKEN='' agentvault-openai-bridge run ``` `login` 明确运行正式的 Codex 设备自动登录。 它使用此代理的专用认证目录, 并且不重用您正常的 Codex 登录或配置 。 完成由 Codex 打印的浏览器指令. 在软件包安装,帮助,版本或测试过程中,不发生登录或提供者呼叫. 请柬仍为0600模式 `pending-invite` 文件,直到加密频道在批准后准备好。 重新开始装入已有的 AgentVault 证书 。 保持不变 `AV_AGENT_NAME`;另一个名称选择单独的认证、设备证书和历史. ## 背景服务 经过明确登录和全球安装后: ```sh AV_AGENT_NAME=aster AV_INVITE_TOKEN='' agentvault-openai-bridge install AV_AGENT_NAME=aster agentvault-openai-bridge status AV_AGENT_NAME=aster agentvault-openai-bridge logs AV_AGENT_NAME=aster agentvault-openai-bridge restart AV_AGENT_NAME=aster agentvault-openai-bridge uninstall ``` macOS使用每个用户的启动服务;Linux使用用户系统d. Linux 服务通常需要活动用户管理器;如果在登录后需要执行,则要单独配置滞留的用户. 服务使用已解析出的稳定节点和桥道,以及所保存的绝对Codex路径. `uninstall` 删除服务定义并保留证书/历史. `status` 报告服务管理状态; `doctor` 检查二进制兼容性和文件存在,不打开证书或声称账户有效. 如果 Codex 升级,在重新启动前再次安装所支持的版本. 如果认证过期, 请运行 `uninstall`运行 `login` ,然后运行 `install` 再来一次 这些命令保留了代理证书和历史. 替换时,请停止现有服务 `uninstall`从应用程序中获取新的恢复邀请,然后运行: ```sh AV_AGENT_NAME=aster AV_INVITE_TOKEN='' agentvault-openai-bridge replace ``` 替换在将先前的代理证书归档之前获取代理锁 `replacement-recovery//` 目录和强制入学。 代码登录和历史被保留. 此明确命令从不默默地重用已有的证书 。 如果注册失败, 归档将保留为故意操作员恢复; 正常重启不会自动恢复 。 经批准后,停止前期流程并再安装服务. 不将另一个代理的证书复制到此状态目录中 . 共享安全频道目前仅在激活后继续使用新的入学密钥。 批准前的坠机可以让被邀请者在没有可收回的本地密钥的情况下被消耗. 保留 `pending-invite` 无法解决这一缺口:如果中断的入学无法恢复,请重新获得恢复邀请. ## 对话与隐私界限 只有SecureChannel作为所有者1:1消息的正面证明的直接消息才能发出私人转会. 房间根据Agent Vault的共享引用策略进行回答,在打出的标题上进行评估,并保持安静而被屏蔽. 房间使用地址室的最近消息;1:1开始新代码会话的种子只有1:1的最近消息. 从一个浏览器打开的聊天, 代理机尚未映射到没有更早的消息之前, 可以开始, 直到代理机得知属于哪个人 。 答复与原始对话身份证或房间身份证有关。 设备 ID, 对话类型, 和对话 ID 联合选择一个单独的持久 Codex 会话 UUID; 桥从未恢复“ last ” . 每个特工都把状态藏在下面 `~/.agentvault/openai//`,包括孤立 `home`, (中文(简体) ), `codex`, (中文(简体) ), `work`, (中文(简体) ), `tmp`,以及 `sessions` 目录(0700). Codex Auth和当地谈话记录一直存在. 加密保护 AgentVault 传输; 本地的 Codex 历史为平正文本并依赖于主机账户的文件系统保护. 不共享此目录 . Codex儿童只得到一个专门的家庭、CODEQHOME、TMPDIR和最低限度的治疗方法。 被测量的配置会禁用 shell,文件系统工具,网页搜索,MCP/apps/plugins,授权等集成. 只读沙箱和批准 `never` 强制的,因为一个没有广告的补丁处理器仍然存在。 内建的Codex系统技能描述可能出现在上下文中,但主机用户技能/配置没有被继承. 任意的模型、提供者、环境和工具配置是故意不可用的. 大桥仅接受0号出站后终端成功助理回复. 由于Exec流省略了消息相,它额外地验证了当前转折的 `final_answer` ; 先前恢复的回合或评注不能授权交付。 部分、故障、畸形、过大或超时的转弯被丢弃。 断接并关闭失效,等待结果. 一个被捆绑的队列按顺序进行推论并等待发送;在另一个转弯开始前杀死并收割儿童进程组. 日志中包含桥自有状态代码,没有提示,回复,信使或提供者诊断. ## 当回复失败时 当一个转弯失败时,桥会先记录下来,然后告诉聊天. 它不会掉出一个失败的转弯,没有痕迹. - **在一个1: 1**,所有者看到一个简单的句子,在桥能分辨出是什么时,将原因命名. 例如:"Aster无法回答这个消息:其OpenAI的登录过期. 再次在特工的电脑上签字". 此桥还能够分辨出OpenAI何时无法被接通以及Codex CLI何时需要关注. 共享列表也涵盖了计费问题,费率限制和已退役模型,但这座桥还没有发现这些. 当原因不明时,句子只是说代理人无法回答这个消息. - **在房间里**,句子没有为原因取名,因为其他人和特工可以读取. 房间只看到特工无法回答这个信息. - **在这两种情况下**确切原因在软件的主人看来是私下的 **卫生,最近的问题**。 。 。 . 这些失败通知从桥在后期转会时发送给Codex的上下文中被忽略. 桥道日志`agentvault-openai-bridge logs`每个事件写一行: | 日志行 | 这是什么意思 | | --- | --- | | `turn_failed code= exit=` | Codex没有提供经核实的答复。 密码是指定桥梁的原因 `exit` 是 Codex 退出状态,或 `none` 当没有退出状态时。 随函附上通知. | | `reply_failed code=` | Codex回答,但无法将答复送达聊天. | | `notice_failed code=` | 转弯失败,失败通知也无法送达. 故障仍在健康项下记录. | | `turn_cancelled reason=shutdown notice=` | 桥被停止或重新启动(例如在更新期间),而它欠这通信息一个答案。 无事可回放消息,因此聊天得到了"Aster无法回答这个消息"的平话. 它从来没有命名一个事业. `notice` 说那句子是不是送来的. `late=true` 写着桥停站时到达的信息. `notice=none delivered=true` 表示答案已经发送并到达,所以没有再张贴了. 桥顶最多等待了10秒,因此被卡住的发件无法支撑重启. 因为模型没有出故障. | | `turn_cancelled reason=` | 转弯被故意缩短,因此没有张贴答复或通知。 原因: `auth_failed` (代理证书被拒绝,这就是被吊销的设备如何出现,然后是 `channel_state`, (中文(简体) ), `channel_state` (加密频道已关闭或重新连接), `delivery_timeout` (结束太久), `hushed` (房间被遮住), `device_changed` (代理设备ID更改),和 `unknown`。 。 。 . | | `turn_recovered code=session_resume_failed` | 本次聊天所保存的Codex会话已去掉了,于是桥开始了一款新鲜的会话,其回复也通过了最终的答题检查. 然后按惯例记录交货情况。 见下文. | | `dm_dropped reason=unmapped_conversation` | 1分1分的讯息传到,代理商尚不能与谈话相匹配. 这条信息没有得到答复,也没有通知. | **自恢复保存的会话 .** 每个聊天都保留了自己保存的 Codex 会话 `sessions` 目录。 如果无法再找到所保存的会话, 桥将运行一个新会话, 以同一聊天的最近消息为种子 。 它只有在新答复通过与其他答复相同的最后答复检查后,才取代所保存的会话。 所取代的第一届会议保留在 `.prev` 旁边的文件,该文件从不被覆盖,所以以后重启不能去除原件。 如果新会话也失败,则无一被替换,转弯报告为 `turn_failed`。 。 。 . 该日志只持有这些代码和出站号码. 它从不保存消息文本或提供者错误文本. ## 当地检查 ```sh npm test npm run typecheck npm run build node dist/index.js --help npm pack --dry-run --ignore-scripts ``` 测试使用一次性固定根,假可执行器,假加密通道,并注入服务指令. 他们从不运行 sloadctl/ systemctl, 登录到一个账户, 联系AgentVault, 或呼叫一个真正的提供者. 建筑将新建成的本地安全通道文物捆绑起来,检查需要入学/招标田地. 可选的实二进制闸门只有在建成后明确引用时才会运行: ```sh python3 scripts/mock-provider-gate.py --codex /absolute/path/to/native/codex ``` 它约束一个回回回模拟提供者,声称一个空工具目录,否认敌对处决/批发,检查准确的UUID恢复,拒绝评论和超时输出,并保留固定文物以供检查。 它从不登录账户或到达真正的提供者. ## 常见问题 ### @agentvault/openai-bridge 是什么？ 代理服务器 OpenAI 加密所有者信件和房间的编码桥 ### 如何安装 @agentvault/openai-bridge？ 在项目目录运行 npm install @agentvault/openai-bridge，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentvault-openai-bridge，可以用 npx agentvault-openai-bridge 直接运行。 ### @agentvault/openai-bridge 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @agentvault/openai-bridge 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @agentvault/openai-bridge 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @agentvault/openai-bridge 可以商用吗？ @agentvault/openai-bridge 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @agentvault/openai-bridge 的下载量有多少？ 根据 npm 官方下载统计，@agentvault/openai-bridge 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,035 次，日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @agentvault/openai-bridge 还在维护吗？ 最新版本 0\.1\.18 发布于 2026/11/05（2 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 19 个；首次发布于 2026/09/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。