前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過擴展工具豐富模型的能力邊界。在中文語境的信息檢索中，知乎社區積累了大量的經驗分享、產品評測和技術實踐。dsh-zhihu-search 插件通過接入知乎開放平臺官方 API，爲 DSH 提供了檢索知乎站內內容、全網索引以及“知乎直答”的能力。結果附帶引用鏈接，非爬蟲實現，確保信息的可溯源性。
功能概覽¶
安裝該插件後，模型將獲得三個主要工具：
- 站內檢索：針對知乎社區內部進行搜索，支持按點贊數、評論數或時間排序。
- 全網索引檢索：利用知乎的全網索引進行搜索，支持按域名和時間過濾。
- 知乎直答：基於模型進行綜合性回答，提供成體系的答覆。
安裝¶
在安裝前，請確保環境滿足以下要求：
* Node.js：版本需大於等於 20。
* DeepSeek Harness (DSH)：版本需在 >=0.1.7-alpha.1 且 <0.3.0 之間（例如 0.1.7-rc.2 或更高）。
安裝命令如下：
dsh plugin --profile web add dsh-zhihu-search
使用說明¶
安裝成功後，模型即可調用以下函數。參數詳情如下：
站內檢索 (zhihu_search)¶
用於檢索知乎站內的問答與文章，支持多維度排序。
zhihu_search(query, count, sortField, order, minValue, publishedAfter, publishedBefore)
- query (string, 必填)：搜索關鍵詞，中文效果最佳。
- count (integer)：返回條數，默認 5，範圍 1-10。
- sortField (enum)：排序字段，默認
default。可選值包括voteUpCount（點贊）、commentCount（評論）、editTime（時間）。 - order (enum)：排序方向，默認
desc。僅在指定sortField時生效，可選asc或desc。 - minValue (number)：排序字段的下限（含），必須配合
sortField使用。注意：此參數僅篩本次檢索到的候選，不代表知乎沒有更高贊內容。 - publishedAfter (string)：只要該日期之後發佈的內容，格式
YYYY-MM-DD。 - publishedBefore (string)：只要該日期之前發佈的內容，格式
YYYY-MM-DD。
全網索引檢索 (zhihu_global_search)¶
利用知乎的全網索引進行搜索，結果會混入知乎站內內容。
zhihu_global_search(query, count, site, searchDb)
- query (string, 必填)：搜索關鍵詞。
- count (integer)：返回條數，默認 8，範圍 1-20。
- site (string)：指定域名進行搜索，例如
github.com。域名匹配爲精確匹配，子站（如news.qq.com）需單獨搜索，且不支持知乎域名。 - searchDb (enum)：索引庫類型，默認
all。可選值包括all（全部）、realtime（偏最新）、static（偏長期收錄）。
知乎直答 (zhihu_zhida)¶
提供綜合性的回答，而非簡單的搜索結果列表。
zhihu_zhida(question, mode, includeReasoning)
- question (string, 必填)：要提問的問題，中文描述越具體越好。
- mode (enum)：回答模式，默認
thinking。可選值包括fast（快速回答）、thinking（深度思考）、agent（智能體多步檢索）。 - includeReasoning (boolean)：是否返回推理過程，默認
false。
配置與注意事項¶
配置 Access Secret¶
插件使用知乎開放平臺 API，需要配置密鑰才能工作。
- 在 DSH 的側邊欄進入 插件 → 已安裝 組。
- 找到並點擊 知乎檢索 進入詳情頁。
- 在配置區填寫 Access Secret。
- Access Secret 保存在 DSH 的憑據存儲中，不寫入配置文件，安全係數較高。
注意事項¶
- 版本兼容性：如果 DSH 版本低於
0.1.7-alpha.1，插件頁可能不顯示配置入口，但功能仍可正常工作。 - 結果邊界：
- 搜索結果爲文字摘要，不包含 HTML 標籤，也不包含正文圖片。
minValue參數僅限制當前返回結果集，不代表知乎沒有更高贊內容。- 全網檢索的
site參數爲精確匹配，無法通過模糊匹配獲取子站內容。
- 直答風險：
zhihu_zhida返回的是生成內容，可能存在錯誤，重要結論建議自行覈對。
生態背景¶
DeepSeek Harness 的插件生態強調“一切皆插件”，旨在讓開發者通過組合工具構建智能體。本插件由社區開發者維護，並非 DeepSeek 官方應用商店的收錄項目，但遵循開源協議（MIT）。更多插件詳情可查閱 SkillHub。
