dsh-web-kimi:Kimi Coding 网络搜索与获取插件

在 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),可以完成基础配置:

  1. API Key:输入 Kimi Coding 的 API 密钥。该值会被存储在 DSH 的凭证服务中。
  2. Base URL:配置 API 的基础地址(默认为 https://api.kimi.com/coding/v1)。
  3. Page Crawling:控制是否开启页面抓取,该设置会传递给搜索接口。

保存后,配置即刻生效,无需重启 Harness。

凭证优先级

如果未在 GUI 中配置,插件会按照以下顺序尝试获取凭证:

  1. GUI 卡片存储的值
  2. 环境变量 KIMI_CODING_API_KEY
  3. 环境变量 KIMI_API_KEY
  4. ~/.kimi/config.toml (Kimi CLI 配置文件,仅读取)

功能说明

网络搜索

搜索结果会映射到 DSH 的 WebSearchSource 结构。插件仅转发和展示绝对 http(s) 开头的 URL。搜索响应体的处理上限为 5 MB。

网络获取

获取功能支持服务器端 JavaScript 渲染,非常适合获取动态加载的网页内容。
* 限制:单次获取的内容大小上限为 2 MB。若超过该大小,返回结果会包含 truncated 标志,表示内容已被截断。
* 工具门控:web_fetch 工具本身默认处于禁用状态,受 dsh-tool-web 门控。这是出于 SSRF(服务器端请求伪造)安全风险的考虑。只有在启用该工具后,获取操作才会生效。

注意事项

  1. 配置文件安全:该插件绝不会向 ~/.kimi/config.toml 写入任何数据。它仅读取该文件作为回退凭证。
  2. 凭证类型:请确保使用的是 Kimi Coding API Key,而非普通的 Chat API Key 或平台密钥。
  3. 服务权限:若出现 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜