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 的設計理念是「一切皆插件」，開發者可通過目錄管理本地開發環境。