在 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