@gleapai/kai-bridge

中文文档
0.16.1发布于 2026/11/09MITES Module近 30 天下载 3231

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

中文使用文档
文档目录6 节
  1. 账户
  2. 当地干线运行
  3. 发展
  4. 尝试本地 CLI 更改
  5. 释放
  6. 电脑和自己的服务器

凯密码桥

运行 Gleap Kai 代码 在计算机或服务器上 Claude Code / Codex 登录, 和当地 dev- server 预览.

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 简介). 添加第二个有管理配置文件的账户 :

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

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

当地干线运行

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 更改

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 显示它在做什么.

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

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 共发布 40 个版本,首次发布于 2026/08/26;过去 12 个月发布了 40 个版本。

版本发布日期距今
0.16.1latest2026/11/097 天前
0.16.02026/11/097 天前
0.15.12026/10/1829 天前
0.15.02026/10/1829 天前
0.13.02026/10/151 个月前
0.12.152026/10/081 个月前

关于 @gleapai/kai-bridge 的常见问题

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