前言¶
DeepSeek Harness (DSH) 的插件系统支持 web_search 和 web_fetch 工具。通常，这些工具需要 DeepSeek 账号或 API Key 才能运行。如果运行本地模型或没有这些凭证，搜索功能会失败。keenableai/dsh-keenable 插件将 DSH 的内置工具指向 Keenable 的公共端点，无需 Key 即可使用。
插件介绍¶
该插件将 DSH 的 web_search 和 web_fetch 工具桥接到 Keenable 服务。它不添加新的工具：模型以与以往完全相同的方式提问（Query 或 URL），Keenable 负责回答。
维护者：keenableai
许可证：MIT
核心价值：在无 DeepSeek 账号或 Key 的情况下，为本地模型提供网页搜索和页面抓取能力。
核心功能¶
- web_search：返回排名后的网页结果、每个页面的摘要以及发布日期（如果已知）。
- web_fetch：将页面返回为 Markdown 格式。页面在 Keenable 服务器上获取，因此模型选择的 URL 不会从运行 Harness 的机器请求。Keenable 会拒绝私有或内部主机。
安装与启用¶
安装前请确认环境满足要求：
* DeepSeek Harness 0.1.7-rc.2 或更高版本
* Node.js 22.12 或更高版本
步骤如下：
- 在终端中执行以下命令安装插件到
web配置文件（如需 TUI 或 Headless 模式，请将web替换为对应 profile 名称）：
npx @deepseek-ai/dsh plugin --profile web add @keenable/dsh-keenable
npx @deepseek-ai/dsh web
- 重启 Harness 使插件生效。
安装完成后，直接让模型执行搜索或抓取操作，无需进一步配置。
速率限制与 API Key¶
无 Key 模式：
请求发送到 Keenable 的公共端点，限制为每秒 10 个请求，每小时每 IP 1000 个请求。搜索和抓取分别计数。同一网络下的用户共享该限制。
开启 API Key：
API Key 是可选的，仅用于提升速率限制。
1. 在 Keenable Console 创建 Key。
2. 在 Harness 启动的环境中设置环境变量 KEENABLE_API_KEY。
3. 或者在插件的 Plugins 页面设置中输入 apiKey。
配置项¶
插件提供以下配置项：
| Setting | Default | Meaning |
|---|---|---|
apiKey |
$KEENABLE_API_KEY |
可选。切换到认证端点。 |
maxSnippetChars |
500 |
每个搜索结果的摘要长度，范围 180 到 10,000 字符。 |
fetchLive |
true |
是否从源站点实时抓取页面。关闭时返回 Keenable 的索引副本（未索引的页面会失败）。 |
maxBodyChars |
100000 |
web_fetch 返回的最大字符数。超出部分会被截断并标记。 |
baseURL |
https://api.keenable.ai |
API 地址，仅支持 HTTPS。 |
注意事项¶
- 隐私：搜索查询和抓取的 URL 均发送到 Keenable 服务器。请求通过
X-Keenable-Title: dsh-keenable标头识别。返回的内容被视为不可信数据。 - 本地地址限制：Keenable 不抓取
localhost或私有地址。如需处理这些地址，请使用 Harness 的本地 HTTP 抓取提供者（参见 README）。 - 共存配置：若希望保留 Harness 的本地 HTTP 抓取提供者，仅使用 Keenable 进行搜索，需在
cordis.patch.yml中覆盖配置。
总结¶
该插件为 DSH 用户提供了无需账号的网页检索能力，适合本地模型开发场景。安装后无需额外配置即可使用，通过 API Key 可解除速率限制。
GitHub：https://github.com/keenableai/dsh-keenable
目录页：https://www.skillhub.cn/plugins/keenableai/dsh-keenable
