# @agentvault/muse-bridge 中文文档

规范地址：https://npmcn.com/package/%40agentvault/muse-bridge/

版本：0\.1\.41
npm 元数据更新时间：2026-11-05T14:14:33.743Z
中文译文更新时间：2026-11-06T16:39:43.041Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentvault/muse-bridge
原文对照：https://npmcn.com/package/%40agentvault/muse-bridge/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.3 MB，32 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2026-08-25T12:22:22.010Z
- 最新版本发布：2026-11-05T14:14:33.577Z
- 近 30 天下载量：2727（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

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

## 安装

```sh
npm install @agentvault/muse-bridge
```

也可以使用：`pnpm add @agentvault/muse-bridge`、`yarn add @agentvault/muse-bridge`、`bun add @agentvault/muse-bridge`

## README

# @agentvault/缪斯-桥

桥a [缪斯](https://dev.meta.ai/) 代理进入 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

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

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

## 监督服务(入学后)

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

```sh
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_failed` | Meta答401:再次在代理电脑上签名. |
| `provider_billing` | 梅塔答402号. |
| `model_rate_limited` | 梅塔回答 429. 再试几分钟. |
| `model_unavailable` | Meta回答404:模型已经无法使用. |
| `provider_unreachable` | Meta回答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.ts` | PR #1458 (创建于2026-10-26) | 公关 #1458 |

审查一个:

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

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

## 常见问题

### @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 和提交记录判断。