@agentvault/muse-bridge

中文文档
0.1.41发布于 2026/11/05MITTypeScriptES Module近 30 天下载 2727

Agent Vault Muse Bridge——守护进程将一个Muse代理连接到E2E加密的Agent Vault直接消息和房间.

中文使用文档
文档目录7 节
  1. 先决条件
  2. 首次入学l
  3. 监督服务(入学后)
  4. 拥有权
  5. Meta 推理恢复
  6. 当回复失败时
  7. 调自分类账——定期审查

@agentvault/缪斯-桥

桥a 缪斯 代理进入 E2E 加密代理 直接的信息和房间.

此软件包是一个单独的实体,来自 @agentvault/claude-bridge 财务报告和审定财务报表 @agentvault/grok-bridge。 。 。 . 他们没有运行时间代码。 这孩子是 muse exec --json (JSONL),不是非加太语.

先决条件

安装 Muse 代码并设定 META_API_KEY (总是胜出). muse login 实值 但Muse 1.0.1在macOS键链中存储登录. 桥 没有 复制只使用密钥链的主机 auth.json 进入围栏 - 这让孩子 SecItemAdd 并可以弹出“ 找不到钥匙链 ”

文件 providers.meta.api_key 已切入 <dataDir>/meta-api-key.json (模式) 0600页:1 META_API_KEY。 。 。 . 它从未被写入发射/系统.

首次入学l

AV_AGENT_NAME=<agent> AV_DATA_DIR="$HOME/.agentvault/muse-room-bridge/<slug>" \
  AV_INVITE_TOKEN=<token> npx @agentvault/muse-bridge

有一个 没有 --install 旗帜。 那场比赛让其他桥梁变哑了 穆斯从不 生长了它.

监督服务(入学后)

全权证书必须长期有效(agentvault.json) (中文(简体) ). 然后说:

npm i -g @agentvault/muse-bridge
AV_AGENT_NAME=<agent> agentvault-muse-bridge install

install 拒绝电流 npx编号 :dlx 因此发射点不能烤出 缓存路径 .

拥有权

--yolo 只有在两笔入学补助金上(workAllowed 财务报告和审定财务报表 gatesRemoved) (中文(简体) ). 否则 --disable-shell 财务报告和审定财务报表 --disable-write (没有终端,没有文件工具) ) (中文(简体) ).

Meta 推理恢复

每个原生的Meta Muse转弯都使用被固定在Meta上的临时回回转适配器 反应API. 它消除了旧时的不透明推理 保存对话信息、工具呼叫/结果、设置和现有 缪斯会话. 在当前工具循环中的原因将保留,直到Meta拒绝 请求带有特定的加密推理过期错误。 那么,适配器 (一) 重复提供商要求的一次,删除其余推理 它的工具没有重新启动或重放。 成功SSE响应流通. 使用不透明请求 previous_response_id 不重写就通过.

已删除的推理不能促进其先前的私人推理连续性; 对话与工具历史仍然可用。 适配器既不编辑 Muse 日记或旋转会话ID 。 它只能用新鲜的回放 密道并关闭在转角。 诊断包括计数和固定结果.

当回复失败时

转弯失败永远不会沉默。 事情是这样的 一步一步地发生

  1. 大桥记录下来了. 它发出一个 model_turn 代理的问题 健康页面(最近的问题),有事业代码和聊天内容 请回答。 还写了一条日志: turn_failed code=<code> exit=<exit status or none>。Meta的状态编号和 可能随附一个简短的错误类型符号。 提供文本、 请求 ID 和信件 文本从不访问日志、聊天或健康.
  2. 然后它告诉聊天. 如果转弯需要答复(房主1:1或房间) 在聊天时
    • 在您 1: 1 中, 句子命名了原因, 例如一个已过期的 Meta sign- in.
    • 在房间里,总是一句"不能回答这个信息". 原因在于你自己的Meta账户, 所以它保持私人在健康. 通知最多要等十秒 下一个排队开始.

这座桥今天能分辨出原因:

代码这是什么意思
provider_auth_failedMeta答401:再次在代理电脑上签名.
provider_billing梅塔答402号.
model_rate_limited梅塔回答 429. 再试几分钟.
model_unavailableMeta回答404:模型已经无法使用.
provider_unreachableMeta回答5xx,否则大桥完全无法到达Meta.
ai_tool_unsupported这个 muse 二进制缺失,不能执行,或者只执行 TUI .
model_error其他一切,包括那个转弯时间.

一个无法重新打开的保存的会话会自己重启. 每个车道(你的) 和所有其他人的分享) 恢复一个保存的Muse会话。 何时 Meta说会话保存的推理已经过期 转弯会失败 时间。 相反,桥开始一个新的会话, 给它聊天最近 并回答您的留言。 没有发出通知。 日志上说 turn_recovered code=session_resume_failed lane=<owner|shared>。 。 。 .

  • 新代号取代了旧代号 muse-session-id (或 muse-owner-session-id) 只有在新会话回答之后.
  • 被替换的第一个身份被保存在 <file>.prev。该文件永远不会 覆写.
  • 每转一转就试一次 如果新会话也失败了,你就会得到通知.
  • 您的车道只从您自己的 1:1 聊天开始播种。 完全进入房间不是 所以其他成员的言语永远不能进入你的车道 共享道 只在被回答的房间播种.

提示: 要在日志中找到这些, 请搜索 turn_failed 或者说 turn_recovered。 。 。 .

重启后. 如果桥被停止或重新启动(例如在 虽然它欠一个消息一个答案,但没有任何信息可以重播,所以 聊天得到一个简单的"Wowzer无法回答这个消息"句子. 从来没有 命名一个原因,没有记录在健康, 因为模型没有 失败。 也一样,一个信息等待它的轮回 和一个着陆的同时 桥停了 日志行是 turn_cancelled reason=shutdown notice=<sent, failed, timeout or none>,与 queued=true 或者说 late=true 适用的地方. notice=none delivered=true 表示 答案已经在路上了,所以没有其他的了。 桥在等待 这些句子最多10秒,全站15秒.

调自分类账——定期审查

这些文件曾被从克洛德桥复制过一次,现在在这里拥有. 一个固定 没有找到我们.

文件从 packages/claude-room-bridge 时间上次审查
src/room-context.tsPR #1458 (创建于2026-10-26)公关 #1458

审查一个:

git log <last-reviewed>..HEAD -- packages/claude-room-bridge/src/<file>

切入任何应用,然后移动“ 上次审查” 向前看是否您 移植任何东西。 一个没有移动的入口,那么诚实地说,没有人看.

版本与发布记录

@agentvault/muse-bridge 共发布 42 个版本,首次发布于 2026/08/25;过去 12 个月发布了 42 个版本。

版本发布日期距今
0.1.41latest2026/11/052 天前
0.1.402026/11/052 天前
0.1.392026/11/052 天前
0.1.382026/11/053 天前
0.1.372026/11/034 天前
0.1.362026/11/016 天前

关于 @agentvault/muse-bridge 的常见问题

@agentvault/muse-bridge 是什么?

Agent Vault Muse Bridge——守护进程将一个Muse代理连接到E2E加密的Agent Vault直接消息和房间.

如何安装 @agentvault/muse-bridge?

在项目目录运行 npm install @agentvault/muse-bridge,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentvault-muse-bridge,可以用 npx agentvault-muse-bridge 直接运行。

@agentvault/muse-bridge 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agentvault/muse-bridge 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agentvault/muse-bridge 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agentvault/muse-bridge 可以商用吗?

@agentvault/muse-bridge 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agentvault/muse-bridge 的下载量有多少?

根据 npm 官方下载统计,@agentvault/muse-bridge 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,727 次,日均约 91 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentvault/muse-bridge 还在维护吗?

最新版本 0.1.41 发布于 2026/11/05(2 天前);至今共发布 42 个版本,其中过去 12 个月发布了 42 个;首次发布于 2026/08/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。