dsh-zhihu-search 1.2.1 → 1.2.3

package/lib/present/search.js

@@ -41,7 +41,11 @@ export function renderSearch(value) {
     const lines = [`找到 ${String(value.items.length)} 条关于 "${value.query}" 的知乎结果：`, ''];
     for (const item of value.items) {
         lines.push(`### [${escapeLinkText(item.title)}](${item.url})`);
-        lines.push(`**作者**: ${item.author || '匿名'} | **点赞**: ${String(item.voteUpCount)} | **类型**: ${item.contentType}`);
+        const meta = [`**作者**: ${item.author || '匿名'}`, `**点赞**: ${String(item.voteUpCount)}`];
+        // 类型缺失时整段省略，而不是渲染成空的「类型: 」。
+        if (item.contentType !== '')
+            meta.push(`**类型**: ${item.contentType}`);
+        lines.push(meta.join(' | '));
         lines.push(`> ${item.snippet}`);
         lines.push('');
     }

package/lib/tools/global-search.js

@@ -40,7 +40,9 @@ function projectItem(item) {
         snippet: sanitizeSnippet(typeof item.ContentText === 'string' ? item.ContentText : ''),
         author: sanitizeSnippet(typeof item.AuthorName === 'string' ? item.AuthorName : '', 60),
         voteUpCount: typeof item.VoteUpCount === 'number' && Number.isFinite(item.VoteUpCount) ? item.VoteUpCount : 0,
-        contentType: typeof item.ContentType === 'string' && item.ContentType !== '' ? item.ContentType : 'Article',
+        // ContentType 缺失时留空，不编造标签：实测第三方网页（如接单平台）就没有这个字段，
+        // 兜底成 'Article' 会让模型把广告页当成知乎文章。
+        contentType: typeof item.ContentType === 'string' ? item.ContentType : '',
     };
 }
 /**

package/lib/tools/search.js

@@ -42,7 +42,9 @@ function projectItem(item) {
         snippet: sanitizeSnippet(typeof item.ContentText === 'string' ? item.ContentText : ''),
         author: sanitizeSnippet(typeof item.AuthorName === 'string' ? item.AuthorName : '', 60),
         voteUpCount: typeof item.VoteUpCount === 'number' && Number.isFinite(item.VoteUpCount) ? item.VoteUpCount : 0,
-        contentType: typeof item.ContentType === 'string' && item.ContentType !== '' ? item.ContentType : 'Answer',
+        // ContentType 缺失时留空，不编造标签：实测外部网页根本没有这个字段，
+        // 兜底成 'Answer' 会让模型把一个陌生网页当成知乎回答。
+        contentType: typeof item.ContentType === 'string' ? item.ContentType : '',
     };
 }
 /**

package/lib/types.d.ts

@@ -25,19 +25,23 @@ export interface ZhihuApiResponse<T> {
     Data: T;
 }
 /**
- * 站内搜索（`GET /api/v1/content/zhihu_search`）的 `Data` 载荷。
+ * 搜索端点（`GET /api/v1/content/zhihu_search` 与 `.../global_search`）的 `Data` 载荷。
  *
- * 该接口在官方文档中**只接受 `Query` 与 `Count` 两个请求参数**——
- * 没有 SortBy，也没有 Filter。分页/排序过滤属于全网搜索（global_search），见 ARCHITECTURE。
+ * ⚠ 官方文档称站内搜索只接受 `Query` 与 `Count`，**实测不成立**：
+ * 它同样识别 `SortBy` 与 `Filter`（`Filter` 限 `publish_time`），
+ * 只是文档没写。两个端点的 `Filter` 语法互不兼容——
+ * 完整偏差见 ARCHITECTURE 的「与知乎官方文档的偏差」。
  */
 export interface ZhihuSearchData {
     /**
-     * ⚠ 站内搜索当前**固定返回 false**（官方文档原文）。
-     * 因此它不能当作「还有下一页」使用，也不能据此提示模型翻页；
-     * 只有全网搜索的 HasMore 才是真实分页标识。
+     * ⚠ 站内搜索按官方文档**固定返回 false**；全网搜索在 12 个宽泛查询的实测里**也全部为 false**。
+     * 因此两个端点都不能据此翻页——全网搜索根本没有翻页参数（见 ARCHITECTURE 的防错清单）。
      */
     HasMore: boolean;
-    /** 搜索请求标识，排障用，不面向模型。 */
+    /**
+     * 搜索请求标识，排障用，不面向模型。
+     * ⚠ 实测**不是游标**：原样传回不改变结果（试过 SearchHashId / HashId / Cursor / Offset / Page / Start）。
+     */
     SearchHashId?: string;
     /** 无结果原因；有结果时为空串。 */
     EmptyReason?: string;
@@ -70,11 +74,12 @@ export interface ZhihuSearchItem {
     /** 秒级时间戳（发布时间或更新时间）。 */
     EditTime: number;
     /**
-     * ⚠ 类型待确认：官方文档在 zhihu_search 一节标注为 String，
-     * 在 global_search 一节又按 1/2/3/4 描述。此处暂按原设计保留 number。
-     * 该字段不进入 Canonical Output，故即便类型不符也不会污染模型上下文。
+     * ⚠ 取实测与文档的并集：站内搜索**实测返回字符串**（`"4"`），
+     * 官方文档又按 1/2/3/4 描述，全网搜索一侧尚未实测。
+     * 该字段不进入 Canonical Output，宽类型不会污染模型上下文；
+     * 将来若要读它，先对两个端点各测一次再收窄。
      */
-    AuthorityLevel: number;
+    AuthorityLevel: string | number;
 }
 /**
  * 知乎直答（OpenAI 兼容）错误结构。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-zhihu-search",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "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",