@240xu/dsh-websearch 2.7.2 → 2.7.3

package/README.md

@@ -115,6 +115,14 @@ pnpm install
 
 环境变量兜底：未在 credentials 配置时回退读同名环境变量；`DSH_UNIFIED_SEARCH_BACKENDS` 可逗号分隔强制指定启用集合。
 
+## v2.7.3 兼容修复 | What's new in v2.7.3
+
+- **DSH 0.1.7 客户端兼容（P0）**：settingsScope 客户端服务在 0.1.7 被移除；现改为 feature-detect——0.1.5（或装 dsh-settings-scope-shim）行为不变，0.1.7 无 shim 时设置卡片优雅停用（console.warn 指引），客户端不再静默全死。
+- **DSH 0.1.7 服务端（P1）**：SettingsForms 无 installSection，原 typeof 守卫静默跳过；现输出一次性 console.warn（搜索功能经 cordis config 不受影响），SettingsForms 迁移已立牌。
+- **engines**：声明 `node >= 20.3`（AbortSignal.any 实测需求，Node 18/20.0-20.2 首次搜索即 TypeError）。
+- description 瘦身（版本历史移回本文件/CHANGELOG.md）。
+- **Windows 双端（P2）**：缓存/历史目录回退改用 `os.homedir()`（此前 `process.env.HOME` 在 Windows 通常未设 → 相对路径 → 缓存静默失效）。
+
 ## v2.7.2 补丁 | What's new in v2.7.2
 
 - 设置项 label：6 个新设置项在 schema 层挂用户语言 label（含单位尾注，如「缓存有效期（秒）」），宿主渲染不再回退 camelCase 键名；description 同步以人话名称开头（真机渲染行为归视觉待办 V5）。

package/lib/client.js

@@ -543,10 +543,23 @@ window.__ModuleLoader__.load({
 			] });
 		}
 
-		/** Plugin entry: register the card into the settings plugins page. */
+		/**
+		 * Plugin entry: register the card into the settings plugins page.
+		 * Compatibility (compat-audit P0): the settingsScope client service was
+		 * removed in DSH 0.1.7. It stays in `inject` so the fiber still
+		 * activates when the shim supplies it; every access is feature-detected.
+		 */
 		const inject = ["slots", "locale", "connection", "remote", "settingsScope"];
 		function apply(ctx) {
 			ctx.effect(() => ctx.locale.register(NS, { zh, en }), "websearch: copy dictionaries");
+			const hasSettingsScope = ctx.get("settingsScope") !== undefined && typeof ctx.settingsScope?.bind === "function";
+			if (!hasSettingsScope) {
+				// DSH >= 0.1.7 without dsh-settings-scope-shim: the settings card
+				// cannot bind its scope. Stop wiring the card instead of hard-
+				// crashing the client fiber; the breadcrumb aids diagnosis.
+				console.warn("[dsh-websearch] settingsScope service unavailable (DSH >= 0.1.7); unified-search settings card disabled. Configure via server settings/cordis config or install dsh-settings-scope-shim.");
+				return;
+			}
 			const controller = new UnifiedSearchCardController(
 				ctx.settingsScope.bind({ namespace: PLUGIN_NS }),
 				ctx.get("connection"),

package/lib/index.js

@@ -38,6 +38,7 @@ import { registerHealthRoute } from "./health.js";
 import { createSearchCache, CACHE_DEFAULTS } from "./cache.js";
 import { createHistoryStore, registerHistoryRoutes, HISTORY_MAX_ENTRIES } from "./history.js";
 import { BREAKER_DEFAULTS } from "./breaker.js";
+import os from "node:os";
 import path from "node:path";
 
 /** Cordis plugin name used by loader diagnostics. */
@@ -334,6 +335,19 @@ export function resolveOptions(ctx, config) {
   };
 }
 
+/**
+ * Resolve the plugin's persistent store directory (cache + history).
+ * Pure and exported for tests: precedence is DSH_HOME > <home>/.dsh, where
+ * home falls back to os.homedir() — NOT process.env.HOME, which is usually
+ * unset on Windows and would silently disable cache/history (compat-audit
+ * P2-7).
+ * @param {{DSH_HOME?: string, HOME?: string}} env
+ * @param {string} [fallbackHome] injected os.homedir() for tests
+ */
+export function resolveStoreDir(env = process.env, fallbackHome = os.homedir()) {
+  return path.join(env.DSH_HOME || path.join(fallbackHome, ".dsh"), "cache", "websearch");
+}
+
 /**
  * Register the unified search provider with ctx.web. Installs a settings
  * section so users can configure enabled backends / numResults / base URLs /
@@ -343,22 +357,35 @@ export function apply(ctx, config) {
   let current = () => config;
 
   ctx.inject(["settings"], (settingsCtx) => {
-    if (typeof settingsCtx.settings?.installSection !== "function") return;
-    settingsCtx.settings.installSection(ctx, NAMESPACE, Config, config, {
-      setSource: (source) => {
-        current = source;
-      },
-      onChange: () => {},
-    });
+    const settings = settingsCtx.settings;
+    if (typeof settings?.installSection === "function") {
+      settings.installSection(ctx, NAMESPACE, Config, config, {
+        setSource: (source) => {
+          current = source;
+        },
+        onChange: () => {},
+      });
+      return;
+    }
+    // DSH 0.1.7+: the settings service is SettingsForms and has no
+    // installSection. The Config schema still resolves through cordis config
+    // (this file reads `current()`), so search keeps working; surface the gap
+    // once instead of silently swallowing it (compat-audit P1).
+    console.warn(
+      "[dsh-websearch] settings service has no installSection (DSH >= 0.1.7 SettingsForms line); " +
+      "the Settings panel section is not installed. Configure the unified-search namespace via cordis config " +
+      "or the client settings card; migration to the SettingsForms API is tracked for a future release.",
+    );
   });
 
   // v2.7.0 stores: disk cache + append-only search history, both under
   // DSH_HOME/cache/websearch (created lazily; every fs error is swallowed so
   // a broken store never breaks a search).
-  const storeDir = path.join(
-    process.env.DSH_HOME || path.join(process.env.HOME || "", ".dsh"),
-    "cache", "websearch",
-  );
+  // DSH_HOME wins when set; otherwise the OS home directory. os.homedir()
+  // (not process.env.HOME) is the cross-platform fallback — HOME is usually
+  // unset on Windows, which previously made storeDir relative to the current
+  // working directory and silently disabled cache/history (compat-audit P2-7).
+  const storeDir = resolveStoreDir();
   const searchCache = createSearchCache({
     dir: path.join(storeDir, "results"),
     ttlMs: () => resolveOptions(ctx, current()).cacheTtlS * 1000,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@240xu/dsh-websearch",
-  "version": "2.7.2",
-  "description": "Unified web search provider for DeepSeek Harness (ctx.web): 11 backends — Exa + Parallel + DDG + SearXNG (keyless), DeepSeek + Anthropic + OpenAI + Brave + Tavily + Serper + Mojeek (key-gated via Settings credentials). Registers provider id \"unified\" for zero-config web_search tool. v2.7.0: disk result cache, per-backend circuit breaker, append-only search history API. v2.7.1 review fixes: cache key includes enabledBackends, scheme whitelist on cache-hit path, serialized history writes, trust fence on /api/websearch/* routes, cooldownMs=0 disables breaker window, user-language settings labels.",
+  "version": "2.7.3",
+  "description": "Unified web search provider for DeepSeek Harness (ctx.web): 11 backends — Exa + Parallel + DDG + SearXNG (keyless), DeepSeek + Anthropic + OpenAI + Brave + Tavily + Serper + Mojeek (key-gated via Settings credentials). Registers provider id \"unified\" for zero-config web_search. 统一网页搜索聚合：11 后端并发扇出、去重合并，零依赖。See CHANGELOG.md for version history.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -66,5 +66,8 @@
       ],
       "platform": "web"
     }
+  },
+  "engines": {
+    "node": ">=20.3"
   }
 }