在 DeepSeek Harness (DSH) 的生態中，ctx.web 是擴展聯網能力的入口。通常，網絡搜索和網絡獲取需要分別配置 Provider，且往往需要不同的憑證。dsh-web-kimi 插件通過將 Kimi Coding 的 API 同時註冊到 ctx.web 的兩個入口，解決了這一痛點，讓一個 coding-plan 密鑰即可同時覆蓋搜索與獲取兩個場景。
插件定位¶
dsh-web-kimi 是一個 DSH 插件，旨在將 Kimi Coding 的能力直接接入 Harness 的 Web 模塊。它通過註冊兩個 Provider 到 ctx.web seam，統一了認證邏輯。
該插件註冊了以下兩個提供者：
* kimi-coding：作爲 WebSearchProvider，對接 Kimi Coding 的搜索接口 (POST /v1/search)。返回結果包含 url、title、snippet 和 publishedAt。
* kimi-coding-fetch：作爲 WebFetchProvider，對接 Kimi Coding 的獲取接口 (POST /v1/fetch)。支持服務器端 JavaScript 渲染，並返回乾淨的 Markdown 格式內容。
兩者共用同一個 coding-plan 密鑰，且支持從 Kimi CLI 的配置文件中進行只讀回退。
安裝¶
通過 DSH 的 CLI 工具安裝該插件：
dsh plugin --profile web add dsh-web-kimi
安裝後，插件會自動選擇 kimi-coding 作爲搜索提供者，kimi-coding-fetch 作爲獲取提供者。
配置與使用¶
GUI 配置¶
在 DSH 的圖形界面中，打開 Settings → Web Search (Kimi)，可以完成基礎配置：
- API Key：輸入 Kimi Coding 的 API 密鑰。該值會被存儲在 DSH 的憑證服務中。
- Base URL：配置 API 的基礎地址（默認爲
https://api.kimi.com/coding/v1）。 - Page Crawling：控制是否開啓頁面抓取，該設置會傳遞給搜索接口。
保存後，配置即刻生效，無需重啓 Harness。
憑證優先級¶
如果未在 GUI 中配置，插件會按照以下順序嘗試獲取憑證：
- GUI 卡片存儲的值
- 環境變量
KIMI_CODING_API_KEY - 環境變量
KIMI_API_KEY ~/.kimi/config.toml(Kimi CLI 配置文件，僅讀取)
功能說明¶
網絡搜索¶
搜索結果會映射到 DSH 的 WebSearchSource 結構。插件僅轉發和展示絕對 http(s) 開頭的 URL。搜索響應體的處理上限爲 5 MB。
網絡獲取¶
獲取功能支持服務器端 JavaScript 渲染，非常適合獲取動態加載的網頁內容。
* 限制：單次獲取的內容大小上限爲 2 MB。若超過該大小，返回結果會包含 truncated 標誌，表示內容已被截斷。
* 工具門控：web_fetch 工具本身默認處於禁用狀態，受 dsh-tool-web 門控。這是出於 SSRF（服務器端請求僞造）安全風險的考慮。只有在啓用該工具後，獲取操作纔會生效。
注意事項¶
- 配置文件安全：該插件絕不會向
~/.kimi/config.toml寫入任何數據。它僅讀取該文件作爲回退憑證。 - 憑證類型：請確保使用的是 Kimi Coding API Key，而非普通的 Chat API Key 或平臺密鑰。
- 服務權限：若出現 403 錯誤，可能是當前使用的 coding-plan 訂閱未開通搜索/獲取服務，需在 Kimi 控制台確認服務已啓用。
總結¶
dsh-web-kimi 提供了一個統一的入口，讓 DeepSeek Harness 能夠直接利用 Kimi Coding 的訂閱來執行搜索和獲取任務。它通過服務端渲染和合理的限制策略，在獲取動態內容的同時控制了風險。
- GitHub 倉庫: https://github.com/kenny2077/dsh-web-kimi
- 生態目錄: https://www.skillhub.cn/plugins/kenny2077/dsh-web-kimi
