kimi-webbridge-dsh

kimi-webbridge-dsh

把 Kimi 浏览器扩展（Kimi Browser Extension，原 Kimi WebBridge）接进 dsh：供应守护进程 + 注册官方技能包。插件本身不代理浏览器操作——浏览器能力全部由官方技能文档描述，模型照它驱动本地守护进程。

职责	说明
守护进程供应	按官方清单下载对应平台二进制（SHA-256 校验），未运行时自动拉起；落在 ~/.kimi-webbridge/bin/
技能注册	随包内置官方技能文档（含 references/），启动时注册为 kimi-webbridge skill
健康锚点	瘦工具 kimi_webbridge，只有 status 一个动作（守护进程 + 扩展 + 已装技能副本）

安装

dsh plugin --profile web add kimi-webbridge-dsh

自带 bundle patch，无需手改 cordis.patch.yml；重启一次 dsh 生效。

用法

1. 需要真实浏览器时加载 kimi-webbridge skill（触发词：browser / 网页 / 截图 / ……，也包括"给某个网站做个可复用 CLI"）；
2. 先调 kimi_webbridge 的 status 确认守护进程 + 扩展健康（会自动补装 / 拉起）；
3. 按 skill 文档 POST http://127.0.0.1:10086/command，请求体 {action, args, session}；
4. Windows 必须用临时文件承载 JSON 请求体（shell 会破坏非 ASCII），skill 里有说明。

工具清单、参数与注意事项一律以 skill 文档为准。

配置

在 ~/.dsh/profiles/web/cordis.patch.yml 按 id 覆盖（整份替换，未给出的键取默认）：

- id: kimi-webbridge
  config:
    daemonVersion: v2.0.32

键	默认	说明
baseUrl	http://127.0.0.1:10086	守护进程地址
requestTimeoutMs	120000	单次请求超时（ms）
autoStartDaemon	true	未运行时自动启动
autoInstallDaemon	true	二进制缺失时自动下载安装
autoUpdateDaemon	true	守护进程落后于已发布版本或落后于扩展时，自动 upgrade（每进程最多一次）
daemonVersion	latest	安装/升级失败后手工兜底时使用的版本，带 v 前缀
registerSkill	true	注册 kimi-webbridge skill

要求与提示

• 浏览器扩展：需自行安装并连接（Chrome Web Store）；status 显示 extension_connected: true 即可用。
• 守护进程：无需预装，插件自动供应；与官方安装器共用 ~/.kimi-webbridge/bin/（Windows %USERPROFILE%\.kimi-webbridge\bin\）。
• dsh 版本：只 import 宿主提供的 @deepseek-ai/*（声明为 peer，不打包副本），已在 0.2.1-rc.3 验证，peer 范围覆盖 0.1.0-rc.7 起的整个 0.1.x / 0.2.x。dsh 换代后如果 kimi_webbridge 工具、系统提示段落和 skill 一起消失，通常就是插件版本还没覆盖新 dsh——升级本插件再重启即可。
• 守护进程自动更新：浏览器扩展会随商店自动更新，守护进程不会——所以插件在每次进程内的第一次 status 发现它落后时，直接调用上游的 kimi-webbridge upgrade（它会停掉、换二进制、再拉起，并顺带刷新其他 agent 运行时里的技能副本）。因为这次重启不可避免，插件只在开始浏览器任务之前尝试，且每进程最多一次；失败或想全程手动就设 autoUpdateDaemon: false，改用 status 报出的命令。
• status 里的 version_mismatch / update_available / skill_mismatch：把其中的 command 原样交给用户执行；不要自行 upgrade / stop / restart / uninstall，它们会杀掉正在运行的守护进程。
• status.skills 为空是正常的：守护进程只识别 Claude Code / Codex / Hermes / OpenClaw / Kimi，dsh 拿到技能的唯一途径就是本插件。

移除

dsh plugin --profile web remove kimi-webbridge-dsh

重启后生效；skill 随插件注册，移除即消失。