dsh-zhihu-search 1.2.1 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/lib/types.d.ts +10 -7
  2. package/package.json +1 -1
package/lib/types.d.ts CHANGED
@@ -25,10 +25,12 @@ export interface ZhihuApiResponse<T> {
25
25
  Data: T;
26
26
  }
27
27
  /**
28
- * 站内搜索(`GET /api/v1/content/zhihu_search`)的 `Data` 载荷。
28
+ * 搜索端点(`GET /api/v1/content/zhihu_search` 与 `.../global_search`)的 `Data` 载荷。
29
29
  *
30
- * 该接口在官方文档中**只接受 `Query` 与 `Count` 两个请求参数**——
31
- * 没有 SortBy,也没有 Filter。分页/排序过滤属于全网搜索(global_search),见 ARCHITECTURE。
30
+ * ⚠ 官方文档称站内搜索只接受 `Query` 与 `Count`,**实测不成立**:
31
+ * 它同样识别 `SortBy` 与 `Filter`(`Filter` 限 `publish_time`),
32
+ * 只是文档没写。两个端点的 `Filter` 语法互不兼容——
33
+ * 完整偏差见 ARCHITECTURE 的「与知乎官方文档的偏差」。
32
34
  */
33
35
  export interface ZhihuSearchData {
34
36
  /**
@@ -70,11 +72,12 @@ export interface ZhihuSearchItem {
70
72
  /** 秒级时间戳(发布时间或更新时间)。 */
71
73
  EditTime: number;
72
74
  /**
73
- * ⚠ 类型待确认:官方文档在 zhihu_search 一节标注为 String,
74
- * 在 global_search 一节又按 1/2/3/4 描述。此处暂按原设计保留 number。
75
- * 该字段不进入 Canonical Output,故即便类型不符也不会污染模型上下文。
75
+ * ⚠ 取实测与文档的并集:站内搜索**实测返回字符串**(`"4"`),
76
+ * 官方文档又按 1/2/3/4 描述,全网搜索一侧尚未实测。
77
+ * 该字段不进入 Canonical Output,宽类型不会污染模型上下文;
78
+ * 将来若要读它,先对两个端点各测一次再收窄。
76
79
  */
77
- AuthorityLevel: number;
80
+ AuthorityLevel: string | number;
78
81
  }
79
82
  /**
80
83
  * 知乎直答(OpenAI 兼容)错误结构。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-zhihu-search",
3
- "version": "1.2.1",
3
+ "version": "1.2.2",
4
4
  "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.",
5
5
  "keywords": [
6
6
  "dsh",