dsh-zhihu-search 1.2.5 → 1.2.7

package/README.md

@@ -27,7 +27,7 @@
 ---
 
 > [!NOTE]
-> **基于知乎开放平台官方 API 构建**，非爬虫抓取。所有检索结果均附带可引用的原始链接，知乎站内结果另附点赞数，让模型的每一次回答都有据可查。
+> **基于知乎开放平台官方 API 构建**，非爬虫抓取。所有检索结果均附带可引用的原始链接，知乎站内结果另附点赞数，让模型的每一次回答都有据可查。搜索结果为文字摘要，不含正文图片。
 
 给 DSH 装上知乎：站内检索、全网检索与直答三个工具，返回可引用的来源列表，而不是一段无法核对的摘要。
 

package/README_en.md

@@ -27,7 +27,7 @@
 ---
 
 > [!NOTE]
-> **Built on the official Zhihu Open Platform API**, not web scraping. All search results include citable original links, and Zhihu's own results also carry their upvote counts, ensuring every model response is verifiable.
+> **Built on the official Zhihu Open Platform API**, not web scraping. All search results include citable original links, and Zhihu's own results also carry their upvote counts, ensuring every model response is verifiable. Search results are text summaries only and do not include article images.
 
 Equips DSH with three Zhihu tools: in-site search, global web search, and Zhida direct answers — returning a list of citable sources instead of an unverifiable summary.
 

package/lib/present/search.js

@@ -42,8 +42,10 @@ export function renderSearch(value) {
     for (const item of value.items) {
         lines.push(`### [${escapeLinkText(item.title)}](${item.url})`);
         const meta = [`**作者**: ${item.author || '匿名'}`];
-        // 点赞数缺失时整段省略：写 `**点赞**: 0` 会把「不知道」说成「没人赞」。
-        if (item.voteUpCount !== undefined)
+        // 点赞段只对知乎内容渲染。
+        // 全网搜索会混进第三方网页：外站没有「知乎点赞」这回事，上游对它恒报 0，
+        // 渲染出来就是把「不适用」说成「没人赞」——所以连同缺失一起整段省略。
+        if (item.contentType !== '' && item.voteUpCount !== undefined)
             meta.push(`**点赞**: ${String(item.voteUpCount)}`);
         // 类型缺失时整段省略，而不是渲染成空的「类型: 」。
         if (item.contentType !== '')

package/lib/tools/global-search.js

@@ -39,11 +39,12 @@ function projectItem(item) {
         url,
         snippet: sanitizeSnippet(typeof item.ContentText === 'string' ? item.ContentText : ''),
         author: sanitizeSnippet(typeof item.AuthorName === 'string' ? item.AuthorName : '', 60),
-        // 上游没报点赞数时整个键省略，不兜底成 0：全网的第三方网页没有这个字段，
-        // 写 0 等于告诉模型「这个页面没人赞」，而事实是「不知道」。
+        // 上游没报点赞数时整个键省略，不兜底成 0 —— 写 0 等于告诉模型「没人赞」。
+        // 注意实测结论：上游**从未省略**该字段，外站网页也有这个键、值是占位的 0。
+        // 省略分支是防伪造的兜底；外站那个 0 由渲染层决定不展示（present/search.ts）。
         ...(typeof item.VoteUpCount === 'number' && Number.isFinite(item.VoteUpCount) ? { voteUpCount: item.VoteUpCount } : {}),
-        // ContentType 缺失时留空，不编造标签：实测第三方网页（如接单平台）就没有这个字段，
-        // 兜底成 'Article' 会让模型把广告页当成知乎文章。
+        // ContentType 缺失时留空，不编造标签：实测第三方网页（如接单平台）的类型是**空串**
+        // （字段在、值为空），兜底成 'Article' 会让模型把广告页当成知乎文章。
         contentType: typeof item.ContentType === 'string' ? item.ContentType : '',
     };
 }
@@ -58,7 +59,8 @@ export function createZhihuGlobalSearchTool(deps) {
         name: ZHIHU_GLOBAL_SEARCH_TOOL,
         description: '知乎全网索引搜索：检索知乎索引收录的公开网页，结果里会混入部分知乎站内内容。' +
             '适合按站点域名或发布时间找资料；要专搜知乎的问答和文章、且要更贴题的排序，用 zhihu_search。' +
-            `单次最多 ${String(MAX_COUNT)} 条且没有翻页参数；域名过滤不接受知乎域名。`,
+            `单次最多 ${String(MAX_COUNT)} 条且没有翻页参数；域名过滤不接受知乎域名。` +
+            '只返回文字摘要与原始链接，结果不含图片。',
         parameters: {
             query: { type: 'string', required: true, description: '搜索关键词。' },
             count: { type: 'integer', description: `返回条数，1–${String(MAX_COUNT)}，默认 ${String(DEFAULT_COUNT)}。`, default: DEFAULT_COUNT },

package/lib/tools/search.js

@@ -41,10 +41,11 @@ function projectItem(item) {
         url,
         snippet: sanitizeSnippet(typeof item.ContentText === 'string' ? item.ContentText : ''),
         author: sanitizeSnippet(typeof item.AuthorName === 'string' ? item.AuthorName : '', 60),
-        // 上游没报点赞数时整个键省略，不兜底成 0：全网的第三方网页没有这个字段，
-        // 写 0 等于告诉模型「这个页面没人赞」，而事实是「不知道」。
+        // 上游没报点赞数时整个键省略，不兜底成 0 —— 写 0 等于告诉模型「没人赞」。
+        // 注意实测结论：上游**从未省略**该字段，外站网页也有这个键、值是占位的 0。
+        // 省略分支是防伪造的兜底；外站那个 0 由渲染层决定不展示（present/search.ts）。
         ...(typeof item.VoteUpCount === 'number' && Number.isFinite(item.VoteUpCount) ? { voteUpCount: item.VoteUpCount } : {}),
-        // ContentType 缺失时留空，不编造标签：实测外部网页根本没有这个字段，
+        // ContentType 缺失时留空，不编造标签：实测外站网页的类型是**空串**（字段在、值为空），
         // 兜底成 'Answer' 会让模型把一个陌生网页当成知乎回答。
         contentType: typeof item.ContentType === 'string' ? item.ContentType : '',
     };
@@ -60,7 +61,8 @@ export function createZhihuSearchTool(deps) {
         name: ZHIHU_SEARCH_TOOL,
         description: '知乎站内搜索：检索知乎的问答与文章，可筛出高赞、多评论或近期更新的内容，也支持限定发布时间。' +
             '适合中文经验、产品评测、行业讨论、技术实践。' +
-            '要搜知乎站外某个网站上的资料改用 zhihu_global_search；要一段成体系的解释而不是来源列表改用 zhihu_zhida。',
+            '要搜知乎站外某个网站上的资料改用 zhihu_global_search；要一段成体系的解释而不是来源列表改用 zhihu_zhida。' +
+            '只返回文字摘要与原始链接，结果不含图片。',
         // 语义化参数：模型永远不会看到 SortBy / Filter 的字符串语法。
         parameters: {
             query: { type: 'string', required: true, description: '搜索关键词，中文效果最好。' },

package/lib/types.d.ts

@@ -115,8 +115,10 @@ export interface SearchOutput {
         snippet: string;
         author: string;
         /**
-         * 点赞数。上游没报该字段时**整个键省略**，不兜底成 0 ——
-         * 全网的第三方网页就不带这个字段，「0 赞」与「不知道」是两回事。
+         * 点赞数。上游没报该字段时**整个键省略**，不兜底成 0。
+         *
+         * 实测（30 条样本）上游**从未省略**该字段：外站网页也有这个键，值是占位的 `0`，
+         * 它不代表「没人赞」。省略分支是防伪造的兜底，外站那个 0 不在渲染层展示。
          */
         voteUpCount?: number;
         contentType: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-zhihu-search",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "description": "DSH plugin: Zhihu in-site search, global web search, and Zhida over the official Zhihu Open Platform API — with a native settings card and source-cited results.",
   "keywords": [
     "dsh",