# @chatpanel/bridge 中文文档

规范地址：https://npmcn.com/package/%40chatpanel/bridge/

版本：0\.47\.1
npm 元数据更新时间：2026-10-30T03:32:57.922Z
中文译文更新时间：2026-11-09T19:39:08.749Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40chatpanel/bridge
原文对照：https://npmcn.com/package/%40chatpanel/bridge/?lang=original
项目主页：https://chatpanel.net/
源码仓库：https://github.com/chatpanel/chatpanel-bridge

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

- 包体积（解压后）：538 kB，124 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-06-12T04:49:28.806Z
- 最新版本发布：2026-10-30T03:32:57.746Z
- 近 30 天下载量：1773（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：134（近 12 个月 134 个）

## 中文简介

将安装在您机器上的 AI 编码剂—— Claude Code(CLI)、 Codex(CLI) 和 Antigravity CLI(原双子星CLI, 仍可供企业/企业使用) —— 暴露在 ChatPannel Chrome 扩展线上的 ChatPanel Chrome

## 安装

```sh
npm install @chatpanel/bridge
```

也可以使用：`pnpm add @chatpanel/bridge`、`yarn add @chatpanel/bridge`、`bun add @chatpanel/bridge`

## README

# 聊天板桥

一个小的本地主机服务器, 它让 ChatPannel Chrome 扩展到 在你的机器上编码代理。 浏览器扩展不能生成本地进程, 因此,这弥补了差距.

-   **克劳德代码** - 嵌入通过 `@anthropic-ai/claude-agent-sdk`时,使用您的 已存在的 Claude 代码登录( 或) `ANTHROPIC_API_KEY`) (中文(简体) ).
-   **代码** 驱动通过 `codex exec` CLI,用你的电话 `codex login`。 。 。 .
-   **反重力CLI** 驱动通过 `agy -p` CLI,使用你的抗重力登录. 这是谷歌对双子座CLI的接班人; **双子座CLI** 它本身仍然可用 用于商业/企业(支付API密钥),可作为定制代理添加.

带出您已经安装的代理设备—— 扩展自动检测 那些桥报到的.

## 运行它

### macOS / Linux — 一行, 需要节点. js

```bash
curl -fsSL https://dl.chatpanel.net/bridge/install.sh | bash
```

下载独立的二进制, 安装, 并设定从登录开始 (通过卷发进行总和可以避免macOS"被损坏"的快取). 重跑是干净的 现场升级.

### Windows — 通过节点( 建议)

Windows SmartScreen旗下未签名下载,因此在Windows上运行桥接通 节点——如果使用克洛德代码/Codex(两者均为npm CLis),则已经拥有了, 没有安全提示:

```powershell
npm i -g @chatpanel/bridge
chatpanel-bridge --install      # starts hidden at login
```

只是尝试一下? `npx @chatpanel/bridge` 一次在前地运行它.

任何地方管理它 : `chatpanel-bridge --status` • 妇女 `--uninstall`。 。 。 .

### 手工下载

从中抓取二进制 [最新发布](https://github.com/chatpanel/chatpanel-bridge/releases/latest) 和:

```bash
# macOS (clear the download quarantine first, then install)
xattr -cr chatpanel-bridge-macos-arm64
chmod +x chatpanel-bridge-macos-arm64
./chatpanel-bridge-macos-arm64 --install

# Windows (PowerShell) — click "More info → Run anyway" if SmartScreen warns
.\chatpanel-bridge-windows-x64.exe --install
```

> 这些二进制还没有签名,所以macOS/Windows可能会在第一跑时警告 (弯曲/npm的路线在边上). **麦克情报?** 没有 x64 二进制 使用 npm (% 1)`npx @chatpanel/bridge`. 苹果硅的使用 `chatpanel-bridge-macos-arm64`。 。 。 .

### 先决条件

您想要使用的代理必须已经设置 :

-   **克劳德代码**: 安装并签字于(`claude`),或设置 `ANTHROPIC_API_KEY`。 。 。 .
-   **代码**数字 : `codex` 在你身边 `PATH` 财务报告和审定财务报表 `codex login` 结束了.
-   **反重力CLI**数字 : `agy` 在你身边 `PATH` 并签名(安装反重力应用程序,然后运行) `agy` 一次签入). 替换双子双子CLI;企业/企业用户仍然可以运行 `gemini` 作为定制代理.

延长投票 `/health` 并显示可用的/无法使用的每个代理.

## 开发( 从源)

除非你是黑进桥里

```bash
git clone https://github.com/chatpanel/chatpanel-bridge
cd chatpanel-bridge
npm install
npm start                    # → http://127.0.0.1:4319
```

## API 密码

| 方法 | 路径 | 目的 |
| --- | --- | --- |
| `GET` | `/health` | `{ ok, version, agents:[{id,label,available,reason}] }` |
| `POST` | `/chat` | SSE 流-体 `{ agent, system, options, messages }` |
| `GET` | `/v1/models` | OpenAI 可兼容的本地代理列表 |
| `POST` | `/v1/chat/completions` | OpenAI-相容的聊天补全(流出与非流出) |
| `POST` | `/v1/completions` | OpenAI 兼容后遗症文本 完成(流出与非流出) |
| `POST` | `/v1/responses` | OpenAI 兼容响应 API(流与非流) |
| `POST` | `/v1/messages` | Anthropic- 兼容信件 API( 流与非流) |
| `GET` | `/skills` | 安装于此机上的技巧, 遍及每个代理设备 + 配置的文件夹 |
| `GET` | `/skills/<name>` • 妇女 `/skills/<name>/file/<path>` | · 一个参考文件 |
| `POST` | `/mcp` | MCP端点 - `chatpanel_skill_*` 任何 CLI 可调用的工具( ChatPannel 聊天驱动时加上浏览器工具) |

`/chat` 串流服务器- 恒定事件 : `{type:'delta',text}` 正如答案是 生成, `{type:'tool',name,summary}` 编号 : `{type:'status'}` 用于活动,a 最终 `{type:'done'}` (或 `{type:'error',error}`) (中文(简体) ).

### 使用任意 CLI 中的技能

桥发现了你机器上安装的技能——克洛德代码,代码,副驾驶, 双子座 赫尔墨斯, `~/.agents/skills`,以及任何您配置的文件夹——并将其曝光为 MCP 工具 (单位:千美元)`chatpanel_skill_list` 编号 : `_open` 编号 : `_read`) (中文(简体) ). 指向任何 MCP 客户端 `http://127.0.0.1:4319/mcp` 它可以列出并加载它们,没有打开浏览器.

对于 **一个** 添加本地服务器 **历史** (聊天、会议、说明-编辑) _并行_ 你的技能,添加 [隐私网关](https://github.com/chatpanel/chatpanel-gateway) 转而指向您的 CLI 时间 `chatpanel-gateway mcp`。网关代表这些技能工具,并将编辑放在前面.

`options` 每个代理( 在聊天板设置中设置) :

```jsonc
{
  "workingDir": "/path/to/project",   // where the agent reads/works
  "permissionMode": "default",         // default | acceptEdits | bypassPermissions
  "model": ""                          // optional model override
}
```

### OpenAI 和 Anthropic SDK 兼容性

兼容路径运行本地编码代理; 它们不调用提供者 API (英语). 使用从 `~/.chatpanel/bridge-token` 作为 SDK API 键。 符号保护可以启动本地进程的端点, 所以不要设置 以浏览器发送的代码或共享它.

对于 OpenAI 客户端, 设置基础 URL 为 `http://127.0.0.1:4319/v1` 并使用 已安装代理 id 如 `codex` 作为模式:

```js
import OpenAI from 'openai';
import { readFileSync } from 'node:fs';

const client = new OpenAI({
  apiKey: readFileSync(`${process.env.HOME}/.chatpanel/bridge-token`, 'utf8').trim(),
  baseURL: 'http://127.0.0.1:4319/v1',
});

const result = await client.responses.create({
  model: 'codex',
  input: 'Explain this project in three bullets.',
});
console.log(result.output_text);
```

`client.chat.completions.create(...)` 遗产 `client.completions.create(...)` 通过同一基址工作。 对于Anthropic SDK,使用 `http://127.0.0.1:4319` 作为其基础URL,与其 API 密钥相同; 请求 `/v1/messages` 也可以使用 `model: "codex"`。 。 。 .

模型字段选择本地代理. `codex/gpt-5.5`例如,选择 密码代理和通行证 `gpt-5.5` 因为它的CLI模型覆盖。 高级桥 设置可以通过额外方式提供 `chatpanel` 请求对象 :

```jsonc
{
  "model": "codex",
  "messages": [{ "role": "user", "content": "Fix the failing tests." }],
  "chatpanel": {
    "working_dir": "/absolute/path/to/project",
    "permission_mode": "acceptEdits",
    "use_local_config": true
  }
}
```

适配器目前覆盖文本对话. 提供者托管的功能工具, 存储的回复、日志概率和准确的符号核算不 可用; 不支持的工具请求返回 HTTP 400, 使用数为零 .

## 安全问题

-   捆绑到 `127.0.0.1` 只有这个 每个请求都必须有回放 `Host` (无 DNS 重新约束)和,如果它有 `Origin`,允许使用(没有网页).
-   **谁可以经营经纪人.** 启动本地进程的路径需要 _对齐_ 呼叫者: ChatPannel 出版的 Chrome/ Edge 扩展名( 因其扩展名而识别) id – 浏览器从不让一个扩展发送另一个的出处) 或每个安装 符号在 `~/.chatpanel/bridge-token` (0600;桌面应用和CLIS读取). 一个 包括查特帕内尔自己的Firefox建筑, 其来源为每张可见的 UUID —— 仍可聊天,但运行被封入 对话层次:没有文件,没有外壳,没有网络,没有工作目录, 工作空间、证书或请求机构的许可模式选项。 答复 告诉用户为什么.
-   **相对相.** `chatpanel-bridge pair` 打印一次性代码(5分钟,5次尝试). 在 ChatPanel 中输入 – 设置 → 编码代理 , 而浏览器从那时起持有此符号 继续 Dev 建筑可以由 id 来支撑: `CHATPANEL_BRIDGE_EXTENSION_IDS=<id>`。 。 。 . 问桥对你的感受 `POST /whoami` → `{ trust, paired }`。 。 。 .
-   克劳德的工具是 **默认只读** (阅读/Grep/Glob/WebFatch). 书写和 shell 只在代理许可模式为时运行 `acceptEdits` 或者说 `bypassPermissions`。 。 。 .
-   在您信任的工作目录中指定每个代理.

## 运行为背景服务( 可选)

macOS(启动d)实例——保存到 `~/Library/LaunchAgents/app.chatpanel.bridge.plist`数字 :

```xml
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0"><dict>
  <key>Label</key><string>app.chatpanel.bridge</string>
  <key>ProgramArguments</key>
  <array><string>/usr/local/bin/node</string><string>/ABSOLUTE/PATH/chatpanel/bridge/src/server.js</string></array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
</dict></plist>
```

礛 `launchctl load ~/Library/LaunchAgents/app.chatpanel.bridge.plist`。 。 。 .

## 许可证

[**PolyForm盾牌许可证 1.0.0**](https://npmcn.com/package/%40chatpanel/bridge/LICENSE) - 运行和修改,供自己使用 不用来提供产品或服务 **竞争** 与查特帕内尔。 时间 软件包和二进制舰只的精度。 上面记载了这座桥所做的一切 以设计为界: 它听 `127.0.0.1` 只开你已经有的CLI探员 与您自己的登录, 没有发送任何自己的地方—— 每一个外出连接 你的一个特工在跟自己的供应商说话 隐私问题: [隐私@ chatpanel.net](mailto:privacy@chatpanel.net); 安全报告: [页:1](mailto:security@chatpanel.net)。 。 。 .

## 商标和品牌

名称 **“专题小组”**,标志,和品牌资产是 **查特班的商标, 未取得执照** 根据上述规定——"盾牌"牌照仅涵盖密码. 不要在 ChatPannel 名称或标记下再分配一叉(例如到 npm).

## 常见问题

### @chatpanel/bridge 是什么？

将安装在您机器上的 AI 编码剂—— Claude Code\(CLI\)、 Codex\(CLI\) 和 Antigravity CLI\(原双子星CLI, 仍可供企业/企业使用\) —— 暴露在 ChatPannel Chrome 扩展线上的 ChatPanel Chrome

### 如何安装 @chatpanel/bridge？

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

### @chatpanel/bridge 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chatpanel\_\_bridge 是否存在。

### @chatpanel/bridge 支持 ESM 还是 CommonJS？

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

### @chatpanel/bridge 需要什么版本的 Node\.js？

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

### @chatpanel/bridge 可以商用吗？

@chatpanel/bridge 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @chatpanel/bridge 的下载量有多少？

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

### @chatpanel/bridge 还在维护吗？

最新版本 0\.47\.1 发布于 2026/10/30（10 天前）；至今共发布 134 个版本，其中过去 12 个月发布了 134 个；首次发布于 2026/06/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。