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