前言¶
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
