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 生效。
用法
- 需要真实浏览器时加载
kimi-webbridge skill（触发词：browser / 网页 / 截图 / ……，也包括"给某个网站做个可复用 CLI"）；
- 先调
kimi_webbridge 的 status 确认守护进程 + 扩展健康（会自动补装 / 拉起）；
- 按 skill 文档
POST http://127.0.0.1:10086/command，请求体 {action, args, session}；
- 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 随插件注册，移除即消失。
