kimi-webbridge-dsh：Kimi 浏览器扩展接入 DeepSeek Harness

前言¶

DeepSeek Harness (DSH) 采用「一切皆插件」的架构。当需要调用浏览器能力（如抓取网页、截图、自动化操作）时，通常需要维护一个本地守护进程。kimi-webbridge-dsh 插件的作用是：在 DSH 生态中自动供应 Kimi 官方守护进程，并注册对应的官方技能包，让模型可以直接通过 DSH 调用浏览器能力。

核心功能¶

这个插件主要负责三件事：
* 守护进程供应：按官方清单下载对应平台的二进制文件（带 SHA-256 校验），未运行时自动拉起，默认路径为 ~/.kimi-webbridge/bin/。
* 技能注册：随包内置官方技能文档，启动时注册为 kimi-webbridge skill。
* 健康锚点：提供一个瘦工具 kimi_webbridge，仅提供 status 命令用于检查守护进程和扩展的健康状态。

安装与启用¶

使用官方安装命令添加插件。插件自带 bundle patch，无需手动修改配置文件，重启 DSH 即可生效。

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

典型用法¶

使用前需先加载对应的 skill，然后通过瘦工具或 HTTP 接口进行操作。

加载 kimi-webbridge skill（触发词通常包含 browser、网页、截图 等）。
先调用瘦工具确认环境健康：

    kimi_webbridge status

此命令会自动补装或拉起守护进程，并检查扩展连接状态。

按 skill 文档的规范，向守护进程发送 POST 请求：

    curl -X POST http://127.0.0.1:10086/command \
      -H "Content-Type: application/json" \
      -d '{"action": "...", "args": [...], "session": "..."}'

**注意**：在 Windows 系统下，由于 shell 对非 ASCII 字符的处理限制，请求体 JSON 必须通过临时文件承载。

配置¶

守护进程的配置项位于 ~/.dsh/profiles/web/cordis.patch.yml。可以覆盖默认值，整份替换该文件中的 kimi-webbridge 配置段。

- id: kimi-webbridge
  config:
    baseUrl: http://127.0.0.1:10086
    requestTimeoutMs: 120000
    autoStartDaemon: true
    autoInstallDaemon: true
    daemonVersion: v2.0.22
    registerSkill: true

配置项	默认值	说明
`baseUrl`	`http://127.0.0.1:10086`	守护进程监听地址
`requestTimeoutMs`	`120000`	单次请求超时时间（毫秒）
`autoStartDaemon`	`true`	守护进程未运行时自动启动
`autoInstallDaemon`	`true`	守护进程二进制缺失时自动下载安装
`daemonVersion`	`latest`	自动安装的版本号（需带 v 前缀）
`registerSkill`	`true`	是否注册官方 skill

要求与注意事项¶

DSH 版本：该插件依赖宿主提供的 @deepseek-ai/* 工具库。兼容范围涵盖 DSH 0.1.0-rc.7 至 0.2.0-rc.1。如果升级 DSH 后发现工具或 skill 消失，通常是插件版本未覆盖新 dsh，需升级本插件。
浏览器扩展：插件本身不代理浏览器操作，浏览器能力由官方 skill 文档定义。你需要自行在浏览器商店安装 Kimi WebBridge 扩展并保持连接。
守护进程管理：不要自行执行 upgrade、stop、restart、uninstall 等操作，这会中断正在运行的守护进程。
技能列表：status 输出中的 status.skills 为空是正常的，守护进程只识别特定列表的技能，DSH 的技能注册是本插件完成的。
源码与许可：安装前请检查源码与 MIT 许可证。

移除¶

如需移除插件，执行以下命令并重启：

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

生态背景¶

此插件属于 DSH 社区目录项目，与 DeepSeek 官方无隶属关系。DSH 的设计理念是「一切皆插件」，开发者可通过目录管理本地开发环境。