dsh-zhihu-search 2.0.0 → 2.0.2

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="icon.svg" alt="dsh-zhihu-search" width="80" height="80">
+</p>
+
 <p align="center">
   <h1 align="center">dsh-zhihu-search</h1>
 </p>
@@ -101,16 +105,16 @@
 
 ### 前置
 
-- **DSH `0.1.7-alpha.1` 或更高，且低于 `0.2.0`** —— 即 [package.json](package.json) 里 `engines.dsh` 与全部 `@deepseek-ai/dsh-*` 共同声明的那条区间（两处**同形状**是硬要求：接缝缺席时配置界面会静默不出现）。
+- **DSH `0.1.7-rc.2` 或更高，且低于 `0.2.0`** —— 即 [package.json](package.json) 里 `engines.dsh` 与全部 `@deepseek-ai/dsh-*` 共同声明的那条区间（两处**同形状**是硬要求：接缝缺席时配置界面会静默不出现）。
 - Node `>= 20`
 
 装宿主时**要显式指定版本线**：本家族的 `latest` 标签不可靠（多数 `@deepseek-ai/dsh-*` 包上它指向很早的版本），按默认方式装可能落在声明范围之外 —— 现查 `npm view @deepseek-ai/dsh dist-tags`。
 
 ```bash
-npm install -g @deepseek-ai/dsh@alpha    # 本插件承诺支持的线
+npm install -g @deepseek-ai/dsh@next    # 本插件承诺支持的线
 ```
 
-兼容性不是推断出来的：每周由 [compat.yml](.github/workflows/compat.yml) 对 `alpha`（承诺线）与 `next`（**已低于我们声明的下限，只作记录**）两条线换包实跑一遍现有测试。当前结论与红了怎么办见 [docs/PUBLISHING.md](docs/PUBLISHING.md) 的「兼容性」。
+兼容性不是推断出来的：每周由 [compat.yml](.github/workflows/compat.yml) 对 `next`（承诺线）与 `alpha`（**已低于我们声明的下限，只作记录**）两条线换包实跑一遍现有测试。当前结论与红了怎么办见 [docs/PUBLISHING.md](docs/PUBLISHING.md) 的「兼容性」。
 
 ### 从源码安装
 

package/README_en.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="icon.svg" alt="dsh-zhihu-search" width="80" height="80">
+</p>
+
 <p align="center">
   <h1 align="center">dsh-zhihu-search</h1>
 </p>
@@ -101,16 +105,16 @@ The three sections below are each tool's full parameter set and limits. The mode
 
 ### Requirements
 
-- **DSH `0.1.7-alpha.1` or newer, below `0.2.0`** — the single range that [package.json](package.json) declares in both `engines.dsh` and every `@deepseek-ai/dsh-*` entry (the two must stay the same shape: a missing host seam makes the configuration UI disappear silently).
+- **DSH `0.1.7-rc.2` or newer, below `0.2.0`** — the single range that [package.json](package.json) declares in both `engines.dsh` and every `@deepseek-ai/dsh-*` entry (the two must stay the same shape: a missing host seam makes the configuration UI disappear silently).
 - Node `>= 20`
 
 Install the Host from an **explicit dist-tag**: `latest` is not trustworthy across this family (on most `@deepseek-ai/dsh-*` packages it points at a much older version), so a default install can land outside the declared range — check it live with `npm view @deepseek-ai/dsh dist-tags`.
 
 ```bash
-npm install -g @deepseek-ai/dsh@alpha    # the line this plugin commits to
+npm install -g @deepseek-ai/dsh@next    # the line this plugin commits to
 ```
 
-Compatibility is measured, not inferred: [compat.yml](.github/workflows/compat.yml) swaps the DSH packages onto the `alpha` line (the committed one) and the `next` line (now **below our declared floor**, kept as a record only) every week, and runs the existing suite. Current results and what to do when a line breaks: [docs/PUBLISHING.md](docs/PUBLISHING.md).
+Compatibility is measured, not inferred: [compat.yml](.github/workflows/compat.yml) swaps the DSH packages onto the `next` line (the committed one) and the `alpha` line (now **below our declared floor**, kept as a record only) every week, and runs the existing suite. Current results and what to do when a line breaks: [docs/PUBLISHING.md](docs/PUBLISHING.md).
 
 ### From source
 

package/lib/client.js

@@ -145,35 +145,30 @@ function asRecord(value) {
 }
 var S = {
   form: { display: "flex", flexDirection: "column" },
-  readOnly: { margin: "12px 0 0", fontSize: 12, lineHeight: 1.5, color: "var(--dsw-alias-label-tertiary)" },
-  field: { display: "flex", flexDirection: "column", gap: 6, padding: "12px 0" },
-  fieldDivider: { display: "flex", flexDirection: "column", gap: 6, padding: "12px 0", borderTop: "0.5px solid var(--dsw-alias-border-l2)" },
-  head: { display: "flex", alignItems: "center", gap: 8 },
-  label: { flex: 1, minWidth: 0, fontSize: 13, fontWeight: 500, lineHeight: 1.5, color: "var(--dsw-alias-label-primary)" },
-  badges: { display: "inline-flex", alignItems: "center", gap: 8 },
-  reset: {
-    border: "none",
-    background: "none",
-    padding: 0,
-    font: "inherit",
+  readOnly: {
+    margin: "12px 0 0",
     fontSize: 12,
     lineHeight: 1.5,
-    color: "var(--dsw-alias-label-secondary)",
-    cursor: "pointer"
+    color: "var(--dsw-alias-label-tertiary)"
+  },
+  field: { display: "flex", flexDirection: "column", gap: 6, padding: "12px 0" },
+  fieldDivider: {
+    display: "flex",
+    flexDirection: "column",
+    gap: 6,
+    padding: "12px 0",
+    borderTop: "0.5px solid var(--dsw-alias-border-l2)"
   },
-  input: {
-    height: 34,
-    padding: "0 12px",
-    border: "0.5px solid var(--dsw-alias-border-l4)",
-    borderRadius: 8,
-    background: "var(--dsw-alias-bg-layer-3)",
-    font: "inherit",
+  head: { display: "flex", alignItems: "center", gap: 8 },
+  label: {
+    flex: 1,
+    minWidth: 0,
     fontSize: 13,
+    fontWeight: 500,
     lineHeight: 1.5,
-    color: "var(--dsw-alias-label-primary)",
-    boxSizing: "border-box",
-    width: "100%"
+    color: "var(--dsw-alias-label-primary)"
   },
+  badges: { display: "inline-flex", alignItems: "center", gap: 8 },
   hint: { margin: 0, fontSize: 12, lineHeight: 1.5, color: "var(--dsw-alias-label-tertiary)" },
   // 开关行：逐条对齐官方 SubagentModelSelectionCard.module.css 的 .toggleRow / .toggleLabel，
   // 右侧放原生 `Switch`（同一个 ui-primitives 包），因此外观与官方卡片一致。
@@ -188,7 +183,12 @@ var S = {
   },
   toggleLabel: { flex: 1, minWidth: 0, fontSize: 13, lineHeight: 1.5 },
   // 状态行：比说明行重一档（secondary 对 tertiary），一行说清开关当前的含义。
-  stateNote: { margin: 0, fontSize: 12, lineHeight: 1.5, color: "var(--dsw-alias-label-secondary)" },
+  stateNote: {
+    margin: 0,
+    fontSize: 12,
+    lineHeight: 1.5,
+    color: "var(--dsw-alias-label-secondary)"
+  },
   // 说明句里的外链：只用卡片既有的语义令牌，颜色取自 ui-theme 的 --dsw-alias-link。
   // 卡片是纯内联样式、无法写 :hover，所以常驻下划线作为静态可点提示。
   link: {
@@ -204,23 +204,15 @@ var S = {
     paddingTop: 16
   },
   // 错误色用有定义的那个令牌：原生照抄来的那一个在 harness 里从未定义，写了不会生效（见 [AGENTS.md](./AGENTS.md)）。
-  failed: { flex: 1, minWidth: 0, margin: 0, fontSize: 12, lineHeight: 1.5, color: "var(--dsw-alias-state-error-primary)" },
-  save: {
-    appearance: "none",
-    border: "1px solid transparent",
-    borderRadius: 8,
-    padding: "5px 14px",
-    font: "inherit",
-    fontSize: 13,
+  failed: {
+    flex: 1,
+    minWidth: 0,
+    margin: 0,
+    fontSize: 12,
     lineHeight: 1.5,
-    cursor: "pointer",
-    background: "var(--dsw-alias-label-primary)",
-    color: "var(--dsw-alias-bg-layer-3)"
+    color: "var(--dsw-alias-state-error-primary)"
   }
 };
-function dimStyle(base, disabled) {
-  return disabled ? { ...base, opacity: 0.4, cursor: "default" } : base;
-}
 function unrefTimer(timer) {
   const candidate = timer;
   if (typeof candidate === "object" && candidate !== null && "unref" in candidate && typeof candidate.unref === "function") {
@@ -268,7 +260,9 @@ function ZhihuCard({ form, store, trackSavedRef, t }) {
     try {
       const ops = [];
       if (refDirty) {
-        ops.push(refText === "" ? { op: "unset", path: [REF_FIELD] } : { op: "set", path: [REF_FIELD], value: refText });
+        ops.push(
+          refText === "" ? { op: "unset", path: [REF_FIELD] } : { op: "set", path: [REF_FIELD], value: refText }
+        );
       }
       if (hideDirty) ops.push({ op: "set", path: [HIDE_FIELD], value: hideText });
       if (ops.length > 0) {
@@ -292,10 +286,9 @@ function ZhihuCard({ form, store, trackSavedRef, t }) {
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: S.badges, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Tag, { tone: credential.configured ? "neutral" : "quiet", children: credential.configured ? t("secretConfigured") : t("secretMissing") }) })
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "input",
+        import_dsh_client_ui_primitives.Input,
         {
           id: "zhihu-access-secret",
-          style: S.input,
           type: "password",
           autoComplete: "off",
           value: secret,
@@ -307,16 +300,7 @@ function ZhihuCard({ form, store, trackSavedRef, t }) {
       ),
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", { style: S.hint, children: [
         t("secretHintBefore"),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-          "a",
-          {
-            style: S.link,
-            href: PROFILE_URL,
-            target: "_blank",
-            rel: "noopener noreferrer",
-            children: t("secretHintLink")
-          }
-        ),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("a", { style: S.link, href: PROFILE_URL, target: "_blank", rel: "noopener noreferrer", children: t("secretHintLink") }),
         t("secretHintAfter")
       ] }),
       credential.writable ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: S.hint, children: t("secretShadowed") })
@@ -327,10 +311,11 @@ function ZhihuCard({ form, store, trackSavedRef, t }) {
         refOverridden ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: S.badges, children: [
           /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Tag, { tone: "neutral", children: t("refOverridden") }),
           /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-            "button",
+            import_dsh_client_ui_primitives.Button,
             {
               type: "button",
-              style: dimStyle(S.reset, disabled),
+              variant: "ghost",
+              size: "sm",
               disabled,
               onClick: () => {
                 setRefDraft("");
@@ -341,10 +326,9 @@ function ZhihuCard({ form, store, trackSavedRef, t }) {
         ] }) : null
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "input",
+        import_dsh_client_ui_primitives.Input,
         {
           id: "zhihu-access-secret-ref",
-          style: S.input,
           type: "text",
           spellCheck: false,
           value: refText,
@@ -377,10 +361,10 @@ function ZhihuCard({ form, store, trackSavedRef, t }) {
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: S.footer, children: [
       failed !== "" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: S.failed, role: "status", children: failed }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "button",
+        import_dsh_client_ui_primitives.Button,
         {
           type: "button",
-          style: dimStyle(S.save, blocked),
+          variant: "primary",
           disabled: blocked,
           onClick: () => {
             void save();
@@ -397,7 +381,10 @@ function apply(ctx) {
   const trackSavedRef = (ref) => {
     savedRef = ref;
   };
-  const store = createCredentialStore(() => remote.credentials, () => savedRef);
+  const store = createCredentialStore(
+    () => remote.credentials,
+    () => savedRef
+  );
   ctx.effect(
     () => ctx.locale.register(LOCALE_NS, ZHIHU_LOCALES),
     "zhihu-search: card dictionaries"
@@ -438,7 +425,12 @@ function apply(ctx) {
   }, "zhihu-search: configuration service probe");
   let slotProbe;
   ctx.effect(() => {
-    slotProbe = armProbe(SLOT_MISSING_WARNING, SLOT_LATE_INFO, () => slotDeclared, () => serviceDeclared);
+    slotProbe = armProbe(
+      SLOT_MISSING_WARNING,
+      SLOT_LATE_INFO,
+      () => slotDeclared,
+      () => serviceDeclared
+    );
     return () => {
       if (slotProbe?.timer !== void 0) clearTimeout(slotProbe.timer);
       slotProbe = void 0;

package/lib/index.js

@@ -9,9 +9,9 @@
  * 由返回的 disposer 释放。模块顶层**不持有任何可变状态** ——
  * 否则 HMR 重载后会留下两代插件共用缓存与限流桶的幽灵故障。
  */
-import { credentialRef, isCredentialRefName } from '@deepseek-ai/dsh-credentials';
+import { credentialRef, isCredentialRefName, } from '@deepseek-ai/dsh-credentials';
 import z from '@deepseek-ai/schemastery';
-import { DEFAULT_STREAM_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, ZHIHU_BASE_URL, ZhihuClient } from './transport.js';
+import { DEFAULT_STREAM_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, ZHIHU_BASE_URL, ZhihuClient, } from './transport.js';
 import { resolveAccessSecret as resolveAccessSecretFrom } from './credentials.js';
 import { migrateLegacySecret } from './migrate.js';
 import { createState } from './state.js';

package/lib/present/search.js

@@ -55,7 +55,10 @@ function formatDate(seconds) {
  * 不转义会把 `### [标题](url)` 撕成非法 Markdown，模型读到的结构就错位了。
  */
 function escapeLinkText(input) {
-    return input.replace(/[\r\n]+/g, ' ').replace(/([\[\]])/g, '\\$1').trim();
+    return input
+        .replace(/[\r\n]+/g, ' ')
+        .replace(/([[\]])/g, '\\$1')
+        .trim();
 }
 /**
  * 渲染模型可见的 Markdown。
@@ -140,7 +143,11 @@ export function renderSearch(value, context = {}) {
  */
 export function searchMetaFromValue(value) {
     return {
-        sources: value.items.map((item) => ({ url: item.url, title: item.title, snippet: item.snippet })),
+        sources: value.items.map((item) => ({
+            url: item.url,
+            title: item.title,
+            snippet: item.snippet,
+        })),
         truncated: value.hasMore,
     };
 }
@@ -167,8 +174,8 @@ export function searchMetaFromResult(meta) {
             continue;
         results.push({
             url: raw.url,
-            ...(('title' in raw && typeof raw.title === 'string') ? { title: raw.title } : {}),
-            ...(('snippet' in raw && typeof raw.snippet === 'string') ? { snippet: raw.snippet } : {}),
+            ...('title' in raw && typeof raw.title === 'string' ? { title: raw.title } : {}),
+            ...('snippet' in raw && typeof raw.snippet === 'string' ? { snippet: raw.snippet } : {}),
         });
     }
     return { sources: results, truncated: 'truncated' in meta && meta.truncated === true };

package/lib/tools/global-search.js

@@ -11,9 +11,9 @@
  */
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import { compileFilter } from '../utils/compiler.js';
-import { presentSearchCall, presentSearchResult, renderSearch, searchMetaFromValue } from '../present/search.js';
+import { presentSearchCall, presentSearchResult, renderSearch, searchMetaFromValue, } from '../present/search.js';
 import { GLOBAL_SEARCH_MAX_COUNT } from '../transport.js';
-import { executeSearch, rawRequestedCount, resolveRequestedCount, SEARCH_OUTPUT_SCHEMA } from './search-shared.js';
+import { executeSearch, rawRequestedCount, resolveRequestedCount, SEARCH_OUTPUT_SCHEMA, } from './search-shared.js';
 /** 工具名。 */
 export const ZHIHU_GLOBAL_SEARCH_TOOL = 'zhihu_global_search';
 /**
@@ -31,7 +31,14 @@ const DEFAULT_COUNT = 8;
  * 未知键会被静默丢弃 —— 模型传 `page=2` 会拿到第一页却以为翻页成功。
  * 与参数定义的一致性由 `test/tool.test.ts` 断言守着。
  */
-const PARAM_NAMES = ['query', 'count', 'site', 'publishedAfter', 'publishedBefore', 'searchDb'];
+const PARAM_NAMES = [
+    'query',
+    'count',
+    'site',
+    'publishedAfter',
+    'publishedBefore',
+    'searchDb',
+];
 /** 协作式超时预算。 */
 const TIMEOUT_MS = 20_000;
 /**
@@ -50,14 +57,29 @@ export function createZhihuGlobalSearchTool(deps) {
             '结果含标题、链接、摘要、作者与时间，知乎来源另带点赞数与评论数，不含图片；没有翻页参数。',
         parameters: {
             query: { type: 'string', required: true, description: '搜索关键词。' },
-            count: { type: 'integer', description: `返回条数，1–${String(MAX_COUNT)}，默认 ${String(DEFAULT_COUNT)}。`, default: DEFAULT_COUNT },
+            count: {
+                type: 'integer',
+                description: `返回条数，1–${String(MAX_COUNT)}，默认 ${String(DEFAULT_COUNT)}。`,
+                default: DEFAULT_COUNT,
+            },
             site: {
                 type: 'string',
                 description: '只搜索该域名，例如 github.com；传完整 URL 会被剥成主机名并去掉开头的 www.。域名是精确匹配（子站要单独写），不支持知乎域名。',
             },
-            publishedAfter: { type: 'string', description: '只要该日期之后发布的内容，格式 YYYY-MM-DD。' },
-            publishedBefore: { type: 'string', description: '只要该日期之前发布的内容，格式 YYYY-MM-DD。' },
-            searchDb: { type: 'string', enum: ['all', 'realtime', 'static'], description: '索引库，默认 all。realtime 偏最新，static 偏长期收录。', default: 'all' },
+            publishedAfter: {
+                type: 'string',
+                description: '只要该日期之后发布的内容，格式 YYYY-MM-DD。',
+            },
+            publishedBefore: {
+                type: 'string',
+                description: '只要该日期之前发布的内容，格式 YYYY-MM-DD。',
+            },
+            searchDb: {
+                type: 'string',
+                enum: ['all', 'realtime', 'static'],
+                description: '索引库，默认 all。realtime 偏最新，static 偏长期收录。',
+                default: 'all',
+            },
         },
         output: {
             schema: SEARCH_OUTPUT_SCHEMA,
@@ -85,12 +107,17 @@ export function createZhihuGlobalSearchTool(deps) {
                 toolName: ZHIHU_GLOBAL_SEARCH_TOOL,
                 signal: exec.signal,
                 plan: (query) => {
-                    const count = resolveRequestedCount(args.count, { max: MAX_COUNT, fallback: DEFAULT_COUNT });
+                    const count = resolveRequestedCount(args.count, {
+                        max: MAX_COUNT,
+                        fallback: DEFAULT_COUNT,
+                    });
                     // 全网作用域：允许 host；编译器会拦下知乎域名并给出「请用站内搜索」的提示。
                     const filter = compileFilter({
                         ...(args.site === undefined ? {} : { site: args.site }),
                         ...(args.publishedAfter === undefined ? {} : { publishedAfter: args.publishedAfter }),
-                        ...(args.publishedBefore === undefined ? {} : { publishedBefore: args.publishedBefore }),
+                        ...(args.publishedBefore === undefined
+                            ? {}
+                            : { publishedBefore: args.publishedBefore }),
                     }, 'global');
                     const searchDb = args.searchDb ?? 'all';
                     return {

package/lib/tools/search-shared.js

@@ -95,10 +95,16 @@ export function projectItem(item) {
         // 上游没报点赞数时整个键省略，不兜底成 0 —— 写 0 等于告诉模型「没人赞」。
         // 注意实测结论：上游**从未省略**该字段，外站网页也有这个键、值是占位的 0。
         // 省略分支是防伪造的兜底；外站那个 0 由渲染层决定不展示（present/search.ts）。
-        ...(typeof item.VoteUpCount === 'number' && Number.isFinite(item.VoteUpCount) ? { voteUpCount: item.VoteUpCount } : {}),
+        ...(typeof item.VoteUpCount === 'number' && Number.isFinite(item.VoteUpCount)
+            ? { voteUpCount: item.VoteUpCount }
+            : {}),
         // 投影规则同上：上游没报就省略，绝不兜底成 0（外站那个 0 是占位值，由渲染层决定不展示）。
-        ...(typeof item.CommentCount === 'number' && Number.isFinite(item.CommentCount) ? { commentCount: item.CommentCount } : {}),
-        ...(typeof item.EditTime === 'number' && Number.isFinite(item.EditTime) ? { editTime: item.EditTime } : {}),
+        ...(typeof item.CommentCount === 'number' && Number.isFinite(item.CommentCount)
+            ? { commentCount: item.CommentCount }
+            : {}),
+        ...(typeof item.EditTime === 'number' && Number.isFinite(item.EditTime)
+            ? { editTime: item.EditTime }
+            : {}),
         // ContentType 缺失时留空，不编造标签：实测站内与网页链接的平台各自返回**空串**（字段在、值为空），
         // 兜底成 'Answer'（站内）或 'Article'（全网）都会让模型把陌生网页当成知乎内容。
         contentType: typeof item.ContentType === 'string' ? item.ContentType : '',

package/lib/tools/search.js

@@ -10,9 +10,9 @@
  */
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import { compileFilter, compileSortBy, SORT_FIELDS } from '../utils/compiler.js';
-import { presentSearchCall, presentSearchResult, renderSearch, searchMetaFromValue } from '../present/search.js';
+import { presentSearchCall, presentSearchResult, renderSearch, searchMetaFromValue, } from '../present/search.js';
 import { ZHIHU_SEARCH_MAX_COUNT } from '../transport.js';
-import { executeSearch, rawRequestedCount, resolveRequestedCount, SEARCH_OUTPUT_SCHEMA } from './search-shared.js';
+import { executeSearch, rawRequestedCount, resolveRequestedCount, SEARCH_OUTPUT_SCHEMA, } from './search-shared.js';
 /** 工具名。 */
 export const ZHIHU_SEARCH_TOOL = 'zhihu_search';
 /**
@@ -45,7 +45,9 @@ const FILTERED_CANDIDATE_COUNT = MAX_COUNT;
  * @returns 条目数不超过 `requestedCount` 的结果。
  */
 function sliceItems(value, requestedCount) {
-    return value.items.length <= requestedCount ? value : { ...value, items: value.items.slice(0, requestedCount) };
+    return value.items.length <= requestedCount
+        ? value
+        : { ...value, items: value.items.slice(0, requestedCount) };
 }
 /**
  * 参数白名单。
@@ -55,7 +57,15 @@ function sliceItems(value, requestedCount) {
  * 会拿到第一页却以为翻页成功。校验放本地，schema 里不加散文。
  * 与参数定义的一致性由 `test/tool.test.ts` 断言守着，避免两处漂移。
  */
-const PARAM_NAMES = ['query', 'count', 'sortField', 'order', 'minValue', 'publishedAfter', 'publishedBefore'];
+const PARAM_NAMES = [
+    'query',
+    'count',
+    'sortField',
+    'order',
+    'minValue',
+    'publishedAfter',
+    'publishedBefore',
+];
 /** 协作式超时预算；超时必须早于 DSH 的外层截断，才能返回结构化错误。 */
 const TIMEOUT_MS = 15_000;
 /**
@@ -76,7 +86,11 @@ export function createZhihuSearchTool(deps) {
         // 语义化参数：模型永远不会看到 SortBy / Filter 的字符串语法。
         parameters: {
             query: { type: 'string', required: true, description: '搜索关键词，中文效果最好。' },
-            count: { type: 'integer', description: `返回条数，1–${String(MAX_COUNT)}，默认 ${String(DEFAULT_COUNT)}。`, default: DEFAULT_COUNT },
+            count: {
+                type: 'integer',
+                description: `返回条数，1–${String(MAX_COUNT)}，默认 ${String(DEFAULT_COUNT)}。`,
+                default: DEFAULT_COUNT,
+            },
             sortField: {
                 type: 'string',
                 enum: SORT_FIELDS,
@@ -96,8 +110,14 @@ export function createZhihuSearchTool(deps) {
                 type: 'number',
                 description: '[依赖 sortField] 排序字段的下限（含）。它只筛本次检索到的候选，不是全库过滤：达标项不足时返回条数会少于 count —— 放宽下限或换关键词，不要据此断定知乎没有高赞内容。',
             },
-            publishedAfter: { type: 'string', description: '只要该日期之后发布的内容，格式 YYYY-MM-DD。' },
-            publishedBefore: { type: 'string', description: '只要该日期之前发布的内容，格式 YYYY-MM-DD。' },
+            publishedAfter: {
+                type: 'string',
+                description: '只要该日期之后发布的内容，格式 YYYY-MM-DD。',
+            },
+            publishedBefore: {
+                type: 'string',
+                description: '只要该日期之前发布的内容，格式 YYYY-MM-DD。',
+            },
         },
         output: {
             schema: SEARCH_OUTPUT_SCHEMA,
@@ -106,7 +126,9 @@ export function createZhihuSearchTool(deps) {
                 requestedCount: rawRequestedCount(args.count, DEFAULT_COUNT),
                 minValue: args.minValue,
                 maxCount: MAX_COUNT,
-                filtered: args.minValue !== undefined || args.publishedAfter !== undefined || args.publishedBefore !== undefined,
+                filtered: args.minValue !== undefined ||
+                    args.publishedAfter !== undefined ||
+                    args.publishedBefore !== undefined,
                 scope: 'zhihu',
             }),
             presentationMeta: (_args, value) => searchMetaFromValue(value),
@@ -124,7 +146,10 @@ export function createZhihuSearchTool(deps) {
                 toolName: ZHIHU_SEARCH_TOOL,
                 signal: exec.signal,
                 plan: (query) => {
-                    const requestedCount = resolveRequestedCount(args.count, { max: MAX_COUNT, fallback: DEFAULT_COUNT });
+                    const requestedCount = resolveRequestedCount(args.count, {
+                        max: MAX_COUNT,
+                        fallback: DEFAULT_COUNT,
+                    });
                     const sortField = args.sortField ?? 'default';
                     const order = args.order ?? 'desc';
                     const minValue = args.minValue;
@@ -136,15 +161,24 @@ export function createZhihuSearchTool(deps) {
                     // 站内搜索作用域：只允许 publish_time，site 会被编译器拒绝。
                     const filter = compileFilter({
                         ...(args.publishedAfter === undefined ? {} : { publishedAfter: args.publishedAfter }),
-                        ...(args.publishedBefore === undefined ? {} : { publishedBefore: args.publishedBefore }),
+                        ...(args.publishedBefore === undefined
+                            ? {}
+                            : { publishedBefore: args.publishedBefore }),
                     }, 'zhihu');
                     // 有下限时把候选池取满（理由见 FILTERED_CANDIDATE_COUNT）。
-                    const poolCount = minValue === undefined ? requestedCount : Math.max(requestedCount, FILTERED_CANDIDATE_COUNT);
+                    const poolCount = minValue === undefined
+                        ? requestedCount
+                        : Math.max(requestedCount, FILTERED_CANDIDATE_COUNT);
                     // 缓存键必须用**归一化后**的参数，且必须用候选池大小：
                     // 否则 count=3 与 count=10 会各占一个键，却发出两个内容相同的请求。
                     return {
                         cacheArgs: { query, count: poolCount, sortBy, filter },
-                        fetch: (signal) => deps.client.searchZhihu({ query, count: poolCount, ...(sortBy === undefined ? {} : { sortBy }), ...(filter === undefined ? {} : { filter }) }, signal),
+                        fetch: (signal) => deps.client.searchZhihu({
+                            query,
+                            count: poolCount,
+                            ...(sortBy === undefined ? {} : { sortBy }),
+                            ...(filter === undefined ? {} : { filter }),
+                        }, signal),
                         // 缓存完整池子，返回按本次条数截断 —— 顺序不可颠倒。
                         onReturn: (value) => sliceItems(value, requestedCount),
                     };

package/lib/tools/zhida.js

@@ -45,7 +45,11 @@ export function createZhihuZhidaTool(deps) {
             '与两个搜索工具的区别：搜索返回可点开的来源列表，直答返回一段成体系的回答——要来源用搜索，要解释用直答。' +
             '答案由知乎生成，可能有误，重要结论请自行核对。',
         parameters: {
-            question: { type: 'string', required: true, description: '要提问的问题，中文描述越具体越好。' },
+            question: {
+                type: 'string',
+                required: true,
+                description: '要提问的问题，中文描述越具体越好。',
+            },
             mode: {
                 type: 'string',
                 enum: ZHIDA_MODELS,
@@ -125,7 +129,14 @@ export function createZhihuZhidaTool(deps) {
                 return { ...stored, reasoning: includeReasoning ? stored.reasoning : '' };
             }
             catch (error) {
-                return { ok: false, question, model: model ?? '', answer: '', reasoning: '', error: mapError(error) };
+                return {
+                    ok: false,
+                    question,
+                    model: model ?? '',
+                    answer: '',
+                    reasoning: '',
+                    error: mapError(error),
+                };
             }
         },
     });

package/lib/transport.js

@@ -98,10 +98,7 @@ function mapPlatformError(code, message) {
 }
 /** 判断异常是否为 AbortSignal 触发的中断。 */
 function isAbortError(error) {
-    return (typeof error === 'object' &&
-        error !== null &&
-        'name' in error &&
-        error.name === 'AbortError');
+    return (typeof error === 'object' && error !== null && 'name' in error && error.name === 'AbortError');
 }
 /** 把任意异常归一化为 {@link ZhihuClientError}，保留取消语义。 */
 function toClientError(error, signal) {
@@ -161,17 +158,15 @@ function sleep(ms, signal) {
             reject(new ZhihuClientError('aborted', '请求已被取消。'));
             return;
         }
-        let timer;
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
         const onAbort = () => {
-            if (timer !== undefined)
-                clearTimeout(timer);
+            clearTimeout(timer);
             signal?.removeEventListener('abort', onAbort);
             reject(new ZhihuClientError('aborted', '请求已被取消。'));
         };
-        timer = setTimeout(() => {
-            signal?.removeEventListener('abort', onAbort);
-            resolve();
-        }, ms);
         signal?.addEventListener('abort', onAbort, { once: true });
     });
 }
@@ -305,7 +300,9 @@ export function classifyChatFailure(failure, status) {
             hint: '知乎直答触发频率限制。稍等片刻再试，或降低调用频率。',
         });
     }
-    if (status === 401 || status === 403 || /unauthor|authentication|forbidden|invalid.?api.?key|20001/.test(hay)) {
+    if (status === 401 ||
+        status === 403 ||
+        /unauthor|authentication|forbidden|invalid.?api.?key|20001/.test(hay)) {
         return new ZhihuClientError('auth', message, {
             ...codeField,
             hint: '鉴权失败。若 Secret 正确，请检查本机系统时间（知乎要求时间差 < 10 分钟）。',
@@ -319,7 +316,8 @@ export function classifyChatFailure(failure, status) {
             hint: '请求不被知乎直答接受。若与档位有关，换成 fast 或 thinking 再试；档位是否可用取决于账号授权。',
         });
     }
-    if ((status ?? 0) >= 500 || /server_error|internal|overload|unavailable|temporar|90001/.test(hay)) {
+    if ((status ?? 0) >= 500 ||
+        /server_error|internal|overload|unavailable|temporar|90001/.test(hay)) {
         return new ZhihuClientError('server', message, {
             ...codeField,
             hint: '知乎服务端错误，请稍后重试。',
@@ -372,10 +370,14 @@ export function deltaFromPayload(payload) {
             : undefined);
     const chunk = {};
     if (typeof delta === 'object' && delta !== null) {
-        const content = 'content' in delta && typeof delta.content === 'string' && delta.content !== '' ? delta.content : undefined;
+        const content = 'content' in delta && typeof delta.content === 'string' && delta.content !== ''
+            ? delta.content
+            : undefined;
         if (content !== undefined)
             chunk.content = content;
-        const reasoning = 'reasoning_content' in delta && typeof delta.reasoning_content === 'string' && delta.reasoning_content !== ''
+        const reasoning = 'reasoning_content' in delta &&
+            typeof delta.reasoning_content === 'string' &&
+            delta.reasoning_content !== ''
             ? delta.reasoning_content
             : undefined;
         if (reasoning !== undefined)
@@ -392,7 +394,7 @@ function isEnvelope(value) {
     if (typeof value !== 'object' || value === null)
         return false;
     const record = value;
-    return typeof record['Code'] === 'number' && typeof record['Message'] === 'string' && 'Data' in record;
+    return (typeof record['Code'] === 'number' && typeof record['Message'] === 'string' && 'Data' in record);
 }
 /**
  * 知乎开放平台客户端。
@@ -541,7 +543,11 @@ export class ZhihuClient {
      */
     async searchZhihu(request, signal) {
         const data = await this.#requestJson(this.#searchPath(ENDPOINT_ZHIHU_SEARCH, request, ZHIHU_SEARCH_MAX_COUNT), { method: 'GET' }, signal, 1);
-        return { HasMore: data?.HasMore ?? false, Items: data?.Items ?? [], SearchHashId: data?.SearchHashId };
+        return {
+            HasMore: data?.HasMore ?? false,
+            Items: data?.Items ?? [],
+            SearchHashId: data?.SearchHashId,
+        };
     }
     /**
      * 知乎全网搜索。
@@ -551,7 +557,11 @@ export class ZhihuClient {
      */
     async searchGlobal(request, signal) {
         const data = await this.#requestJson(this.#searchPath(ENDPOINT_GLOBAL_SEARCH, request, GLOBAL_SEARCH_MAX_COUNT), { method: 'GET' }, signal, 1);
-        return { HasMore: data?.HasMore ?? false, Items: data?.Items ?? [], SearchHashId: data?.SearchHashId };
+        return {
+            HasMore: data?.HasMore ?? false,
+            Items: data?.Items ?? [],
+            SearchHashId: data?.SearchHashId,
+        };
     }
     /** 查询每日额度；实测不消耗业务额度，可用于自检。 */
     async quota(signal) {
@@ -632,7 +642,9 @@ export class ZhihuClient {
         catch {
             // 落到下面的通用分支。
         }
-        return new ZhihuClientError('parse', `知乎直答未返回事件流（HTTP ${status}）。`, { hint: text.slice(0, 200) });
+        return new ZhihuClientError('parse', `知乎直答未返回事件流（HTTP ${status}）。`, {
+            hint: text.slice(0, 200),
+        });
     }
     /**
      * 执行一次直答并拼接完整回答。

package/lib/types/client/index.d.ts

@@ -4,7 +4,7 @@
  *
  * 挂载点是插件管理页声明的 `plugins.bundle.config` 槽，key 是**包名**。
  * 这个槽**只渲染 `view: 'page'`，且座位里没有任何 `form`**（DSH `slot-contract.ts:12-16`
- * 「Bundle configuration renders only `page`」；`PluginManagerPage.tsx:584` 只递 `view` 与
+ * 「Bundle configuration renders only `page`」；`PluginManagerPage.tsx:579` 只递 `view` 与
  * `entryKey`）—— 表单因此由卡片自己向 `ctx.configForms.get(<loader entry id>)` 取，
  * 这也是该槽唯一的官方取表单路径。
  *
@@ -28,9 +28,9 @@
  * 与官方 web 搜索卡片同一套做法。配置里只留引用名，因此活动 profile 的 Cordis patch
  * 被截图或上传时不泄任何凭据。
  *
- * 复用 `@deepseek-ai/dsh-client-ui-primitives` 的 `Tag` 与 `Switch`：那是公共基础库，
- * 不是别的插件 —— 被 bundle-purity gate 禁止的是跨插件值导入。
- * 其余控件按官方 CSS 自带样式，取值只用 `--dsw-alias-*` 语义令牌。
+ * 复用 `@deepseek-ai/dsh-client-ui-primitives` 的 `Input`、`Button`、`Switch` 与 `Tag`：
+ * 那是公共基础库，不是别的插件 —— 被 bundle-purity gate 禁止的是跨插件值导入。
+ * 行布局（label / badge / hint 的排布）仍是内联样式，取值只用 `--dsw-alias-*` 语义令牌。
  */
 import type { Context } from '@deepseek-ai/cordis';
 /**

package/lib/utils/text.js

@@ -68,6 +68,8 @@ export function stripTrackingParams(input) {
     for (const key of keys)
         parsed.searchParams.delete(key);
     // 参数被清空后会留下一个孤立的 '?'，Markdown 链接里很难看。
-    return parsed.search === '' && input.includes('?') ? `${parsed.origin}${parsed.pathname}${parsed.hash}` : parsed.toString();
+    return parsed.search === '' && input.includes('?')
+        ? `${parsed.origin}${parsed.pathname}${parsed.hash}`
+        : parsed.toString();
 }
 //# sourceMappingURL=text.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-zhihu-search",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Zhihu in-site search, global web search, and Zhida answers for the model, over the official Zhihu Open Platform API.",
   "keywords": [
     "dsh",
@@ -48,7 +48,7 @@
   ],
   "engines": {
     "node": ">=20",
-    "dsh": ">=0.1.7-alpha.1 <0.2.0"
+    "dsh": ">=0.1.7-alpha.1 <0.3.0"
   },
   "dsh": {
     "bundle": {
@@ -67,20 +67,23 @@
     "test": "npm run build && vitest run",
     "test:watch": "vitest",
     "test:contract": "vitest run --config vitest.contract.config.ts",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "check:release": "node scripts/check-release.mjs",
     "prepare": "npm run build"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-util-values": ">=0.1.7-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-util-values": ">=0.1.7-alpha.1 <0.3.0",
     "@deepseek-ai/schemastery": "^3.18.2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
@@ -88,32 +91,38 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.4",
-    "@deepseek-ai/dsh-agent": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-invariants": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-scope": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-session": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-session-projection": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-system-prompt": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-user-approval": ">=0.1.7-alpha.1 <0.2.0",
-    "@deepseek-ai/dsh-util-values": ">=0.1.7-alpha.1 <0.2.0",
+    "@deepseek-ai/dsh-agent": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-invariants": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-scope": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-session": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-session-projection": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.7-alpha.1 <0.3.0",
+    "@deepseek-ai/dsh-util-values": ">=0.1.7-alpha.1 <0.3.0",
     "@deepseek-ai/schemastery": "^3.18.2",
+    "@eslint/js": "^10.0.1",
     "@types/node": "^20.0.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.1",
     "esbuild": "^0.21.5",
+    "eslint": "^10.11.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.12.0",
+    "prettier": "^3.9.9",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "typescript": "^5.4.0",
+    "typescript-eslint": "^8.70.1",
     "vitest": "^2.0.0"
   }
 }