# @gleapai/kai-bridge 中文文档

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

版本：0\.16\.1
npm 元数据更新时间：2026-11-09T15:56:47.894Z
中文译文更新时间：2026-11-16T16:20:34.384Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.1 MB，72 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：10 个
- 首次发布：2026-08-26T13:02:24.602Z
- 最新版本发布：2026-11-09T15:56:47.438Z
- 近 30 天下载量：3231（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

Kai Code Bridge在您的计算机或服务器上运行Kai Code,并使用自己的编码订阅和本地预览.

## 安装

```sh
npm install @gleapai/kai-bridge
```

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

## README

# 凯密码桥

运行 [Gleap Kai 代码](https://gleap.io/) 在计算机或服务器上 Claude Code / Codex 登录, 和当地 dev- server 预览.

```bash
npm i -g @gleapai/kai-bridge   # one install, so the background service has a stable path
kai-bridge login             # pair this machine with your Gleap account
kai-bridge service install   # run at login (launchd / systemd / Task Scheduler)
kai-bridge status
kai-bridge ps                # sessions running on this machine, with dashboard links (--json for tooling)
```

(单位:千美元)`npx @gleapai/kai-bridge login` 长得很快,不过 `install` 需求 全局安装—— npm 垃圾收集 npx 缓存, 这将留下 背景服务指向被删除的文件。 )

那就选吧 **运行在你的机器** 在任何凯码会话。 发现回收物 自动下方 `~/Documents`, (中文(简体) ), `~/code`, (中文(简体) ), `~/dev`, (中文(简体) ), `~/Projects`, (中文(简体) ), `~/src` (增加内容与 `kai-bridge repo roots add <dir>`); 每一会在一个孤立的工作树下运行 `~/.kai/worktrees` 除非你选"在我的退票里工作" 会话保持其编码代理运行 在转弯之间,所以背景任务和dev服务器 代理开始存活到您的下一封信 (单场会话在30分钟后结束,或者在背景工作进行期间结束2小时;每台机最多4个; `KAI_BRIDGE_LIVE_SESSIONS=0` 每转弯开始新鲜剂). 停止一个回合结束 代理和推代理 编辑到会话分支为"Kai Code: 正在进行中的工作"; 失败转弯和 Gleap 停止(队友拿走了 罚单通过、答复或停止会话),两者都无法打开拉出请求。 Claude 代码会话只装入 MCP服务器Kai通过,而不是你的全球服务器`KAI_BRIDGE_USER_MCP=1` 在服务环境 保持你的。 一天一度,工作树 几天前结束的会话(合并、停止、失败、关闭)被删除,除非它们举行 未承诺的改变或未兑现的承诺.

## 账户

大桥是官方的 `claude` 编号 : `codex` 安装在您的机器下的二进制 **** 登录( n)`ambient` 简介). 添加第二个有管理配置文件的账户 :

```bash
kai-bridge profile add personal --harness claude
kai-bridge profile login personal
```

您的吊带记录从不离开机器; 桥只存储其配对符 (单位:千美元)`~/.kai/config.json`) (中文(简体) ).

## 当地干线运行

```bash
kai-bridge run --task "Explain the auth flow in this repo" --cwd ~/code/my-app
```

## 发展

`npm run sync-runner [-- <analyzer checkout>]` 复制 ACP 跑者从一个 `gleap_code_analyzer` 退出( 默认 : `gleap_code_analyzer` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}除了结账或者父母之一 它从一个 `.claude/worktrees/*` 并把它钉入 `runner/SOURCE.json` (分析器每个文件 + sha256). 永不编辑 `runner/` 通过手:改变分析器的 `e2b-coder-template/runner` (仅限装置的行为落后) `KAI_RUNNER_HOST=device`),执行 在那里,然后同步. `npm test` 运行单元套件( 使用真实 `git`包括漂移检查 (单位:千美元)`npm run check-runner`),它失败于一手编辑或肮脏的跑道.

### 尝试本地 CLI 更改

```bash
npm run cli -- status          # any kai-bridge command, run from this checkout
npm run cli -- login --name "dev laptop"
npm run cli -- start           # foreground daemon; Ctrl-C stops it
npm run test:cli               # fast CLI regression suite (test/cli.test.mjs)
```

`npm run cli` (标注/dev-cli.mjs)使用 `<repo>/.kai-dev` 作为 `KAI_HOME` 转弯 自我更新,所以它永远不会触碰 `~/.kai` 或背景服务运行 已发布版本。 导出 `KAI_API_BASE` 编号 : `KAI_APP_BASE` 指向本地服务器. 别 `npm link` 软件包: 登录服务以绝对方式运行全局安装 路径, 链接将转换为此退出 .

### 释放

合并正在释放。 每次合并到 `main` 改变包裹的船 (单位:千美元)`bin`, (中文(简体) ), `src`, (中文(简体) ), `runner`, 发送的脚本、 依赖性) 发布下一个补丁 后 npm 时 `latest` (0.12.9、0.12.10.),标签 `v<version>` 并创建 GitHub 释放( `CHANGELOG.md` 区域,如果有,则另列出承诺清单 设备通过自我更新来取出. Docs/ CI 合并后不发布任何信息 . 在发布前, 检查运行者所承诺的工作流程 `runner/SOURCE.json` 开始 `GleapSDK/gleap_code_analyzer` `main` (单位:千美元)`node scripts/check-runner.mjs --on-main`, GitHub 的比较 API). 这需要 存储器密钥 **`ANALYZER_READ_TOKEN`**:一个精致的代币,与 _目录:已读_ 打开 `GleapSDK/gleap_code_analyzer`没有它,或者一个跑者同步从一个 未合并分析器分支, 发布失败 —— 合并分析器更改, 同步从 联合国 `main`,然后再次合并. `package.json` 打开 `main` 保留最后一个手设版本——自动版本在 标记和npm.

未成年人或少校,撞伤 `version` 在公关中`npm version minor --no-git-tag-version`(中文(简体) ) 并添加 `## <version>` changelog 一节。 预发版本( :`0.13.0-beta.1`(中文(简体) ) 出来在下面 `next` 标记, 自动更新忽略 (单位:千美元)`npm i -g @gleapai/kai-bridge@next` 试试看 逻辑是 `scripts/next-release.mjs`。 。 。 .

### 电脑和自己的服务器

Kai 代码报价 **凯代码云** (Gleap的管理下执行,使用AI信用)或 **凯密码桥** (您的编码代理在您的计算机或您管理的服务器上,使用您自己的AI订阅).

运行 `npm i -g @gleapai/kai-bridge && kai-bridge` 在本地终端或超过SSH。 被引导的设置对设备,安装其背景服务并帮助签名来编码代理. 需要节点.js 20+和 Git. 在 Linux 服务器上, 使用您的系统服务配置在登录后保持用户服务运行 ; `kai-bridge service status` 财务报告和审定财务报表 `kai-bridge service logs --follow` 显示它在做什么.

科德克斯和克洛德密码船 与凯密码桥。 缺失的代理可以安装或修复,现有代理可以独立更新:

```sh
kai-bridge harness install codex
kai-bridge harness update codex
kai-bridge profile login codex --device-auth

kai-bridge harness install claude
kai-bridge harness update claude
kai-bridge profile login claude
```

安装到 `~/.kai/harnesses`,验证新的可执行文件,然后选择用于以后的会话。 下载或启动失败后, 上一个版本将被选中 。 为运行的会话保留现有版本; 您的全球 CLI 安装和代理登录不覆盖 . `--version <version>` 选择一个特定的软件包版本(对于克洛德,克劳德代理SDK软件包版本).

Codex在SSH或无头的Linux上自动使用设备编码的登录. 如果 Codex 要求, 在账户设置中启用设备编码签名 。 克劳德使用其本土 `auth login` 流程:在 SSH 终端中遵循 URL并提示. 盘子 **签名** 在桌面设备上打开一个终端;对于无头服务器,它显示了运行于SSH的确切命令. 登录自动取出.

**本地预览出Kai代码桥装置.** 打开电脑,或者点击 **公开** 在仪表板的预览弹出器中获得稳定的HTTPS链接(`https://web-<repo>-<id>.gleap-preview.dev`用手机或队友的笔记本电脑工作 公共链接通过 Cloudflare 隧道: 守护进程启动 `cloudflared` 在设备上(它使用您 PATH 中的一个, 否则下载一个被绑定的发布到 `~/.kai/bin`· ; `brew install cloudflared`, (中文(简体) ), `apt install cloudflared` 或者说 `winget install Cloudflare.cloudflared` 也参与工作。 此设备的回放每张门票的地址都是一样的,因此被保存的登录从一张门票到下一张门票都能活下来,每张回放每张门票一次只能有一张门票在设备上公开:让另一张门票在它上点出相同的链接并停止了之前的预览(其主人看到了通知). 在有人点击公示前,没有东西离开设备. `kai-bridge ps` 显示运行中的内容.

预览从 repo 开始 `.gleap/dev.yaml`还有克洛德密码 `.claude/launch.json` (它的第一个配置在repo内部运行), 换句话说, 包. json `dev` 编号 : `start` 剧本. Kai也可以在转弯时自己启动dev服务器并曝光它:然后以会话预览的方式显示,就像你开始的预览一样. Kai在工作的同时,用无头浏览器检查应用程序(你的Chrome,或者Playwright的Chrome,安装时的Chrome; `KAI_BROWSER_MCP=0` 在服务环境中关闭.

## 常见问题

### @gleapai/kai-bridge 是什么？

Kai Code Bridge在您的计算机或服务器上运行Kai Code,并使用自己的编码订阅和本地预览\.

### 如何安装 @gleapai/kai-bridge？

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

### @gleapai/kai-bridge 支持 TypeScript 吗？

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

### @gleapai/kai-bridge 支持 ESM 还是 CommonJS？

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

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

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

### @gleapai/kai-bridge 可以商用吗？

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

### @gleapai/kai-bridge 的下载量有多少？

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

### @gleapai/kai-bridge 还在维护吗？

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

