dsh-zhihu-search

dsh-zhihu-search

赋予 DeepSeek Harness 检索知乎社区的能力

Empowering DeepSeek Harness with Zhihu Insights

各版本改动 → Releases（与 npm 版本一一对应）

简体中文 · English

---

> [!NOTE]

> 基于知乎开放平台官方 API 构建，非爬虫抓取。所有检索结果均附带可引用的原始链接，知乎站内结果另附点赞数，让模型的每一次回答都有据可查。搜索结果为文字摘要，不含正文图片。

搜索不幻觉，引用有出处。给 DSH 装上知乎：站内检索、全网检索与直答三个工具，返回可引用的来源列表，而不是一段无法核对的摘要。

在侧边栏 插件（Plugins） →「已安装（Installed）」组里点「知乎检索」进详情页（标题下方那行代码体是技术名 dsh-zhihu-search），

Access Secret 就地填写、立即生效。

工具一览

装上后模型多出三个工具：

| 工具 | 一句话说明 | 适用场景 |

|---|---|---|

| zhihu_search | 知乎站内问答与文章搜索，支持按点赞/评论/时间排序 | 中文经验、产品评测、行业讨论、技术实践 |

| zhihu_global_search | 知乎全网索引搜索，可按域名和时间过滤；结果会混入知乎站内内容 | 查找特定网站上的公开资料 |

| zhihu_zhida | 知乎直答，成体系的综合性回答 | 需要「先检索再总结」的复杂中文问题 |

下面三个小节是每个工具的完整参数与能力边界。模型只看到下表中的语义化参数，看不到知乎的原始查询语法。

zhihu_search —— 站内检索

| 参数 | 类型 | 默认 | 说明 |

|---|---|---|---|

| query | string | 必填 | 搜索关键词，中文效果最好。 |

| count | integer | 5 | 返回条数，1–10。 |

| sortField | enum | default | default 沿用相关性排序；voteUpCount 点赞数 · commentCount 评论数 · editTime 时间（发布或最后编辑）。 |

| order | enum | desc | desc 降序 · asc 升序。仅在指定了 sortField 时生效。 |

| minValue | number | — | 排序字段的下限（含），必须配合 sortField，取非负整数。只筛本次检索到的候选：达标项少时返回条数会少于 count，不代表知乎没有高赞内容。 |

| publishedAfter | string | — | 只要该日期之后发布的内容，格式 YYYY-MM-DD。 |

| publishedBefore | string | — | 只要该日期之前发布的内容，格式 YYYY-MM-DD。 |

边界：不支持按站点域名过滤——站内结果本来就全来自知乎，要按站点找资料请用 zhihu_global_search。minValue 与非默认 order 必须配合 sortField，否则会被拒绝并提示改法。没有翻页：要更多结果请换关键词或换排序。下限是候选内筛选：筛少时结果里会说明，空结果不代表知乎没有高赞内容。

zhihu_global_search —— 全网索引检索

| 参数 | 类型 | 默认 | 说明 |

|---|---|---|---|

| query | string | 必填 | 搜索关键词。 |

| count | integer | 8 | 返回条数，1–20，比站内宽。 |

| site | string | — | 只搜该域名，例如 github.com。传完整 URL 会被剥成主机名并去掉开头的 www.。 |

| publishedAfter | string | — | 只要该日期之后发布的内容，格式 YYYY-MM-DD。 |

| publishedBefore | string | — | 只要该日期之前发布的内容，格式 YYYY-MM-DD。 |

| searchDb | enum | all | all 全部 · realtime 偏最新 · static 偏长期收录。 |

边界：域名是精确匹配，子站要单独写（qq.com 取不到 news.qq.com 的页面），且不接受知乎域名。没有排序参数（该端点忽略排序），也没有翻页参数。结果里会混入知乎站内内容；要专搜知乎的问答和文章，用 zhihu_search。

zhihu_zhida —— 直答

| 参数 | 类型 | 默认 | 说明 |

|---|---|---|---|

| question | string | 必填 | 要提问的问题，中文描述越具体越好。 |

| mode | enum | thinking | fast 快速回答 · thinking 深度思考 · agent 智能体多步检索。 |

| includeReasoning | boolean | false | 是否把推理过程一并返回。默认关闭以节省上下文，核对答案可靠性时可打开。 |

边界：它不是搜索——返回的是一段生成回答，不是来源列表。答案由知乎生成，可能有误，重要结论请自行核对。思维链默认不返回。

能力

• 三个工具职责不重叠：站内捞经验、全网捞资料、直答做综合，模型按问题类型自行选择。
• 搜索返回结构化来源条目（标题 / 链接 / 摘要 / 作者 / 点赞数 / 评论数 / 时间），每条都带 URL，可直接引用核对。
• 结果文本自带边界说明：返回条数触达单次上限、来源里混有外站页面、筛选条件筛掉多数候选时，都会在正文里写明 —— 不把工具的边界说成结果的边界。
• 结果同时渲染为来源卡片与纯 Markdown，任何界面都能读。

安装

前置

• DSH 的区间见 [package.json](package.json) 的 engines.dsh —— 那是唯一真源，它与全部 @deepseek-ai/dsh-* 声明逐字相同（不同形状时使用者装到的宿主可能缺接缝，而接缝缺席是静默的：配置界面不出现、宿主不报错）。声明面同时承诺了不止一族宿主版本，装哪一族由它说了算。本文件与 [README_en.md](README_en.md) 都不抄那个会漂的值。
• Node >= 20

装宿主时要显式指定版本线：本家族的 latest 标签不可靠（多数 @deepseek-ai/dsh-* 包上它指向很早的版本），按默认方式装可能落在声明范围之外 —— 现查 npm view @deepseek-ai/dsh dist-tags。

npm install -g @deepseek-ai/dsh@next    # 本插件承诺支持的线

兼容性不是推断出来的：每周由 [compat.yml](.github/workflows/compat.yml) 对 next（承诺线）与 alpha（已低于我们声明的下限，只作记录）两条线换包实跑一遍现有测试。当前结论与红了怎么办见 [docs/PUBLISHING.md](docs/PUBLISHING.md) 的「兼容性」。

从 npm 安装

dsh plugin --profile web add dsh-zhihu-search