dsh-free-search 0.4.36 → 0.4.38

package/README.md

@@ -30,7 +30,7 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
 
 - **零成本** —— 多个免费引擎，无需 key、无需注册
 - **多引擎可选**：DuckDuckGo（html/lite）、Bing、SearXNG（元搜索，支持自定义实例）、AnySearch、Exa、Tavily、Keenable、Firecrawl、Parallel、Perplexity、SerpBase、DeepSeek 官方
-- **网页设置页** —— 引擎切换 + API key 配置（UI 中 key 脱敏显示"已配置"）+ 中英文切换；DSH 0.1.6-alpha.2+ 入口在左侧「插件」页的组件行配置，旧版在「设置 → 插件 → 可配置」
+- **网页设置页** —— 引擎切换 + API key 配置（UI 中 key 脱敏显示"已配置"）+ 中英文切换；入口在左侧「插件」页的组件行配置（`plugins.row.config`，DSH 0.1.7-rc.1+）
 - **弹出式切换命令** —— 聊天框输入 `/free-search-engine`，弹出引擎选择窗口，点选即切换（等效设置页 + 保存）
 - **引擎测试** —— `free_search_test` 工具让 agent 一键测试所有引擎；设置页也有"测试引擎"按钮（直测当前引擎，不走回退链，付费引擎无 key 会明确报错）
 - **统一引擎回退** —— 任何引擎失败（付费/免费，缺 key/401/限流/网络）自动轮流尝试下一个引擎：首选引擎 → 其他引擎（exa/tavily/keenable/firecrawl/parallel 无 key 也会尝试，因为它们自带 keyless 免费额度）→ 剩余免费引擎，搜索永不直接失败；结果顶部注明实际生效的引擎（如 `Note: perplexity unavailable or failed, using exa.`）
@@ -114,10 +114,9 @@ dsh web
 
 #### 网页设置（推荐）
 
-安装后按 DSH 版本打开配置页：
+安装后打开配置页（DSH 0.1.7-rc.1+）：
 
-- **DSH 0.1.6-alpha.2 及以上**：左侧 **插件** 页 → **已安装** 分组 → `free-search` → 点击组件行 `web-search-free`（行内"配置"入口）
-- **DSH 0.1.5 及更早**：**设置 → 插件 → 可配置** 标签页 → **Free Search** 卡片
+- 左侧 **插件** 页 → **已安装** 分组 → `free-search` → 点击组件行 `web-search-free`（行内"配置"入口）
 
 配置页提供：
 
@@ -156,24 +155,24 @@ dsh web
 
 #### 配置文件
 
-配置存在 `~/.dsh/settings.yaml`：
+DSH 0.1.7-rc.1 起，配置跟随 profile 的插件条目保存：设置页与 `/free-search-engine` 都会写入当前 profile 的 `cordis.patch.yml` 中 `web-search-free`（`dsh-free-search`）条目的 `config`。旧版 `~/.dsh/settings.yaml` 的 `free-search:` 段只会在启动时自动导入一次，随后原文件被重命名为 `settings.yaml.imported`。
 
 ```yaml
-free-search:
-  provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official
-  lang: zh                    # 设置页界面语言（zh / en）
-  bingMarket: zh-CN           # Bing 市场
-  region: cn-zh               # DuckDuckGo 区域（可选）
-  searxngInstances:           # 自定义 SearXNG 实例（可选）
-    - https://your-instance.example
-  exaApiKey: ...              # 或通过设置页填写
-  tavilyApiKey: ...           # 或通过设置页填写
-  keenableApiKey: ...         # 或通过设置页填写
-  firecrawlApiKey: ...        # 或通过设置页填写
-  parallelApiKey: ...         # 或通过设置页填写
-  perplexityApiKey: ...
-  serpbaseApiKey: ...         # 或通过设置页填写
-  deepseekApiKey: ...
+# profiles/<profile>/cordis.patch.yml 中该条目的 config：
+provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official
+lang: zh                    # 设置页界面语言（zh / en）
+bingMarket: zh-CN           # Bing 市场
+region: cn-zh               # DuckDuckGo 区域（可选）
+searxngInstances:           # 自定义 SearXNG 实例（可选）
+  - https://your-instance.example
+exaApiKey: ...              # 或通过设置页填写
+tavilyApiKey: ...           # 或通过设置页填写
+keenableApiKey: ...         # 或通过设置页填写
+firecrawlApiKey: ...        # 或通过设置页填写
+parallelApiKey: ...         # 或通过设置页填写
+perplexityApiKey: ...
+serpbaseApiKey: ...         # 或通过设置页填写
+deepseekApiKey: ...
 ```
 
 #### 让 agent 测试所有引擎
@@ -254,7 +253,7 @@ Search engine test:
 
 切换后重启 `dsh web` 生效。
 
-> 配置卡片挂在官方设置页的 `settings.plugin.item` 插槽（dsh 自带），配置读写走插件自建 bridge，**不依赖 dsh-web-ui**，插件可独立使用。
+> 配置卡片挂在左侧「插件」页的 `plugins.row.config` 行配置插槽（dsh 自带），配置读写走插件自建 bridge，**不依赖 dsh-web-ui**，插件可独立使用。
 
 ### 代理说明（国内用户）
 
@@ -270,8 +269,8 @@ Windows 用户：桌面快捷方式已内置此配置（`set NODE_USE_ENV_PROXY=
 
 ### 工作原理
 
-- `lib/index.js`：host 端。实现 `WebSearchProvider`（`id` / `available()` / `search()`），统一引擎路由 + 自动回退（付费引擎优先，免费兜底）；解析 `timeRange`（固定档/相对值/绝对日期）并透传给各引擎；注册 `free-search` settings namespace；提供 `/api/dsh-free-search-settings` 读写桥 + `raw-search` 调试接口；注册 `free_search_test`、`platform_search`、`advanced_search` 工具；动态注入引擎清单到系统提示词（设置变更时自动刷新）。
-- `lib/client.js`：浏览器端。React 配置卡片（引擎选择 + key 输入 + 连通测试 + 中英切换），挂载到官方设置页的 `settings.plugin.item` 插槽；注册 `/free-search-engine` 弹出式切换命令（`commandUi` popupSelect，与 `/model` 同机制）。
+- `lib/index.js`：host 端。实现 `WebSearchProvider`（`id` / `available()` / `search()`），统一引擎路由 + 自动回退（付费引擎优先，免费兜底）；解析 `timeRange`（固定档/相对值/绝对日期）并透传给各引擎；在 `web-search-free` 条目上声明可编辑配置（`.volatile()`）并自带设置页（`plugins.row.config`）；提供 `/api/dsh-free-search-settings` 读写桥 + `raw-search` 调试接口；注册 `free_search_test`、`platform_search`、`advanced_search` 工具；动态注入引擎清单到系统提示词（设置变更时自动刷新）。
+- `lib/client.js`：浏览器端。React 配置卡片（引擎选择 + key 输入 + 连通测试 + 中英切换），挂载到左侧「插件」页的 `plugins.row.config` 行配置插槽；注册 `/free-search-engine` 弹出式切换命令（`commandUi` popupSelect，与 `/model` 同机制）。
 - `cordis.patch.yml`：插件 loader 配置。
 
 ---
@@ -300,7 +299,7 @@ This plugin provides multiple free search engines with automatic fallback, compl
 
 - **Zero Cost** — Multiple free engines with no API key or registration required
 - **Multi-Engine Support** — DuckDuckGo (HTML / Lite), Bing, AnySearch AI, SearXNG (meta-search with custom instances), Exa, Tavily, Keenable, Firecrawl, Parallel, Perplexity, SerpBase, and DeepSeek Official
-- **Web Settings UI** — Engine switching, API key configuration (keys masked as "configured" in the UI), and a Chinese/English toggle; on DSH 0.1.6-alpha.2+ the entry is the component-row config on the sidebar Plugins page, on older versions Settings → Plugins → Configurable
+- **Web Settings UI** — Engine switching, API key configuration (keys masked as "configured" in the UI), and a Chinese/English toggle; the entry is the component-row config (`plugins.row.config`) on the sidebar Plugins page (DSH 0.1.7-rc.1+)
 - **Popup Switch Command** — Type `/free-search-engine` in the chat: a picker opens with all engines; click one to switch (equivalent to the settings page + save)
 - **Engine Testing** — `free_search_test` for the agent to check all engines in one call; the settings UI also has a "Test engine" button that tests the selected engine directly (no fallback chain; paid engines without a key report an explicit error)
 - **Unified Engine Fallback** — Any engine failure (paid or free, missing key, 401, rate limit, network error) automatically tries the next engine: the configured engine first, then other engines (exa/tavily/keenable/firecrawl/parallel are tried even without a key because they have built-in keyless quota), then the remaining free engines (Bing/AnySearch etc.) — with a note attached to the results naming the engine that actually served them (e.g. `Note: perplexity unavailable or failed, using exa.`). Search never fails outright.
@@ -384,10 +383,9 @@ This plugin intentionally specifies `@deepseek-ai/dsh-settings` and `@deepseek-a
 
 #### Web Settings (Recommended)
 
-After installation, open the config page according to your DSH version:
+After installation, open the config page (DSH 0.1.7-rc.1+):
 
-- **DSH 0.1.6-alpha.2 and later**: sidebar **Plugins** page → **Installed** group → `free-search` → click the `web-search-free` component row (the row's "configure" entry)
-- **DSH 0.1.5 and earlier**: **Settings → Plugins → Configurable** tab → **Free Search** card
+- Sidebar **Plugins** page → **Installed** group → `free-search` → click the `web-search-free` component row (the row's "configure" entry)
 
 The config page provides:
 
@@ -426,24 +424,24 @@ The command only changes the preferred engine; search still goes through `web_se
 
 #### Configuration File
 
-Configuration is stored in `~/.dsh/settings.yaml`:
+Since DSH 0.1.7-rc.1 the configuration is stored with the profile's plugin entry: the settings page and `/free-search-engine` both write the `config` of the `web-search-free` (`dsh-free-search`) entry in the active profile's `cordis.patch.yml`. The old `free-search:` section of `~/.dsh/settings.yaml` is imported once at startup; the file is then renamed to `settings.yaml.imported`.
 
 ```yaml
-free-search:
-  provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official
-  lang: zh                    # settings UI language (zh / en)
-  bingMarket: zh-CN           # Bing market
-  region: cn-zh               # DuckDuckGo region (optional)
-  searxngInstances:           # Custom SearXNG instances (optional)
-    - https://your-instance.example
-  exaApiKey: ...              # Or configure via the web settings UI
-  tavilyApiKey: ...           # Or configure via the web settings UI
-  keenableApiKey: ...         # Or configure via the web settings UI
-  firecrawlApiKey: ...        # Or configure via the web settings UI
-  parallelApiKey: ...         # Or configure via the web settings UI
-  perplexityApiKey: ...
-  serpbaseApiKey: ...         # Or configure via the web settings UI
-  deepseekApiKey: ...
+# config of that entry in profiles/<profile>/cordis.patch.yml:
+provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official
+lang: zh                    # settings UI language (zh / en)
+bingMarket: zh-CN           # Bing market
+region: cn-zh               # DuckDuckGo region (optional)
+searxngInstances:           # Custom SearXNG instances (optional)
+  - https://your-instance.example
+exaApiKey: ...              # Or configure via the web settings UI
+tavilyApiKey: ...           # Or configure via the web settings UI
+keenableApiKey: ...         # Or configure via the web settings UI
+firecrawlApiKey: ...        # Or configure via the web settings UI
+parallelApiKey: ...         # Or configure via the web settings UI
+perplexityApiKey: ...
+serpbaseApiKey: ...         # Or configure via the web settings UI
+deepseekApiKey: ...
 ```
 
 #### Asking the Agent to Test All Engines
@@ -524,7 +522,7 @@ The `tools/` directory includes a lightweight, zero-dependency switcher:
 
 Restart `dsh web` after switching to apply changes.
 
-> The settings card mounts into the official `settings.plugin.item` slot (built into DSH), and configuration reads/writes go through the plugin's own bridge. **No `dsh-web-ui` dependency — the plugin can be used standalone.**
+> The settings card mounts into the official `plugins.row.config` component-row slot on the sidebar Plugins page (built into DSH), and configuration reads/writes go through the plugin's own bridge. **No `dsh-web-ui` dependency — the plugin can be used standalone.**
 
 ### Proxy Note (for Users in Mainland China)
 
@@ -540,8 +538,8 @@ Windows users: The desktop shortcut already includes this configuration (`set NO
 
 ### How It Works
 
-- `lib/index.js`: Host side. Implements `WebSearchProvider` (`id` / `available()` / `search()`), unified engine routing + auto-fallback (paid engines first, free as fallback); parses `timeRange` (fixed tiers / relative values / absolute dates) and forwards it to each engine; registers the `free-search` settings namespace; provides the `/api/dsh-free-search-settings` read/write bridge + `raw-search` debug endpoint; registers the `free_search_test`, `platform_search`, and `advanced_search` tools; dynamically injects the engine list into system prompts (auto-refreshes on settings change).
-- `lib/client.js`: Browser side. React configuration card (engine select, key inputs, connectivity test, and Chinese/English toggle), mounted into the official `settings.plugin.item` slot; registers the `/free-search-engine` popup switch command (`commandUi` popupSelect, the same mechanism as `/model`).
+- `lib/index.js`: Host side. Implements `WebSearchProvider` (`id` / `available()` / `search()`), unified engine routing + auto-fallback (paid engines first, free as fallback); parses `timeRange` (fixed tiers / relative values / absolute dates) and forwards it to each engine; declares its editable config as volatile fields on the `web-search-free` composition entry and ships its own settings page (`plugins.row.config`); provides the `/api/dsh-free-search-settings` read/write bridge + `raw-search` debug endpoint; registers the `free_search_test`, `platform_search`, and `advanced_search` tools; dynamically injects the engine list into system prompts (auto-refreshes on settings change).
+- `lib/client.js`: Browser side. React configuration card (engine select, key inputs, connectivity test, and Chinese/English toggle), mounted into the official `plugins.row.config` component-row slot on the sidebar Plugins page; registers the `/free-search-engine` popup switch command (`commandUi` popupSelect, the same mechanism as `/model`).
 - `cordis.patch.yml`: Plugin loader configuration.
 
 ### License

package/lib/client.js

@@ -83,7 +83,10 @@ window.__ModuleLoader__.load({
     //#endregion
 
     const BRIDGE_PREFIX = "/api/dsh-free-search-settings";
-    const NS = "free-search";
+    // rc.1: the settings namespace is the profile composition entry id (the
+    // `web-search-free` row declared by cordis.patch.yml), not the old `free-search`
+    // section name. Keep in sync with FREE_SEARCH_NS in lib/index.js.
+    const NS = "web-search-free";
     const I18N = {
       zh: {
         description: "免费搜索 —— 无需 API key（Bing / DuckDuckGo / AnySearch / Exa / Tavily / Keenable / Firecrawl / Parallel）",
@@ -106,13 +109,14 @@ window.__ModuleLoader__.load({
         keyStorageCred: "凭据中心（推荐）",
         keyStorageSettings: "设置页（兼容）",
         keyStorageCredHint: (c) => `保存后写入 ~/.dsh/.credentials.yaml（最高优先级）。当前已配置：${["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "无"}`,
-        keyStorageSettingsHint: "保存后写入 settings.yaml（向后兼容路径，优先级低于凭据中心）。",
+        keyStorageSettingsHint: "保存后写入当前 profile 的插件条目 config（cordis.patch.yml，优先级低于凭据中心）。",
         platformSearch: "平台搜索（platform_search 工具）",
         platformHint: "为 agent 的 platform_search 工具启用平台。禁用的平台会被跳过。",
         cacheTtl: "结果缓存时长（分钟）",
         cacheTtlHint: "0 关闭缓存，最长 5 分钟。缩短可加快时效，延长可防限流、省额度。",
         unavailable: "设置不可用 —— free-search 桥接未暴露。",
         saveFailed: "保存失败",
+        saveFailedDetail: (d) => `保存失败：${d}`,
         testing: "测试中…",
         testEngine: "测试引擎",
         useBing: "恢复 Bing 默认",
@@ -173,13 +177,14 @@ window.__ModuleLoader__.load({
         keyStorageCred: "Credential center (recommended)",
         keyStorageSettings: "Settings page (legacy)",
         keyStorageCredHint: (c) => `Saved to ~/.dsh/.credentials.yaml (highest priority). Currently configured: ${["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "none"}`,
-        keyStorageSettingsHint: "Saved to settings.yaml (backward-compatible path; lower priority than the credential center).",
+        keyStorageSettingsHint: "Saved to the active profile plugin entry config (cordis.patch.yml; lower priority than the credential center).",
         platformSearch: "Platform search (platform_search tool)",
         platformHint: "Enable platforms for the agent's platform_search tool. Disabled platforms are skipped.",
         cacheTtl: "Result cache TTL (minutes)",
         cacheTtlHint: "0 disables caching, max 5 minutes. Lower = fresher results, higher = less rate-limiting / fewer credits used.",
         unavailable: "Settings unavailable — the free-search bridge is not exposed.",
         saveFailed: "save failed",
+        saveFailedDetail: (d) => `save failed: ${d}`,
         testing: "Testing…",
         testEngine: "Test engine",
         useBing: "Use Bing default",
@@ -222,7 +227,7 @@ window.__ModuleLoader__.load({
     };
     const tt = (lang) => I18N[lang === "en" ? "en" : "zh"];
     // 当前插件版本（与 lib/index.js 的 PLUGIN_VERSION 保持一致）
-    const PLUGIN_VERSION = "0.4.36";
+    const PLUGIN_VERSION = "0.4.38";
     const ENGINES = [
       { id: "ddg", label: "DuckDuckGo · HTML", badge: "FREE", link: "https://duckduckgo.com" },
       { id: "ddg-lite", label: "DuckDuckGo · Lite", badge: "FREE", link: "https://duckduckgo.com" },
@@ -358,6 +363,8 @@ window.__ModuleLoader__.load({
       const [dirty, setDirty] = react.useState(false);
       const [saving, setSaving] = react.useState(false);
       const [failed, setFailed] = react.useState(false);
+      // 保存失败明细（credentials-set / mutate 的 code+message），成功或改表单时清空
+      const [saveError, setSaveError] = react.useState("");
       const [testing, setTesting] = react.useState(false);
       const [testResult, setTestResult] = react.useState(null);
       const [checkingUpdate, setCheckingUpdate] = react.useState(false);
@@ -435,11 +442,14 @@ window.__ModuleLoader__.load({
         setProvider(value);
         setDirty(true);
         setFailed(false);
+        setSaveError("");
       };
 
       const save = async () => {
         setSaving(true);
         setFailed(false);
+        setSaveError("");
+        const errors = [];
         try {
           // key 存储分流：凭据中心（默认）走 credentials-set；设置页走 settings mutate（兼容）
           const keyFields = [
@@ -452,12 +462,15 @@ window.__ModuleLoader__.load({
             ["deepseekApiKey", deepseekKey],
             ["serpbaseApiKey", serpbaseKey],
           ];
-          let credFailed = false;
           if (keyStorage === "credentials") {
             for (const [field, value] of keyFields) {
               if (!value.trim()) continue;
               const r = await bridgeCredentialsSet(field, value.trim());
-              if (!r.ok) credFailed = true;
+              if (!r || !r.ok) {
+                const code = (r && r.code) || "error";
+                const msg = (r && r.message) || "";
+                errors.push(`credentials-set ${field}: ${code}${msg ? " — " + msg : ""}`);
+              }
             }
           }
           const ops = [{ op: "set", path: ["provider"], value: provider }];
@@ -466,7 +479,7 @@ window.__ModuleLoader__.load({
           ops.push({ op: "set", path: ["safeSearch"], value: safeSearch });
           ops.push({ op: "set", path: ["bingMarket"], value: bingMarket });
           if (keyStorage !== "credentials") {
-            // settings 模式：key 仍写 settings.yaml（旧行为）
+            // settings 模式：key 写入当前 profile 的插件条目 config（cordis.patch.yml）
             for (const [field, value] of keyFields) {
               if (value.trim()) ops.push({ op: "set", path: [field], value: value.trim() });
             }
@@ -474,16 +487,28 @@ window.__ModuleLoader__.load({
           ops.push({ op: "set", path: ["platforms"], value: platforms });
           ops.push({ op: "set", path: ["cacheTtl"], value: Math.min(Math.max(Number(cacheTtl) ?? 5, 0), 5) });
           const result = await bridgeMutate({ ns: NS, ops });
-          if (result.ok && !credFailed) {
+          if (!result || !result.ok) {
+            const code = (result && result.code) || "error";
+            const msg = (result && result.message) || "";
+            errors.push(`mutate: ${code}${msg ? " — " + msg : ""}`);
+          }
+          if (errors.length === 0) {
             setDirty(false);
             setProvider(result.value.value.provider ?? provider);
             setFailed(false);
+            setSaveError("");
             load();
           } else {
+            const detail = errors.join("; ");
             setFailed(true);
+            setSaveError(detail);
+            console.error("[dsh-free-search] save failed:", detail);
           }
-        } catch {
+        } catch (e) {
+          const msg = e && e.message ? e.message : String(e);
           setFailed(true);
+          setSaveError(`exception: ${msg}`);
+          console.error("[dsh-free-search] save exception:", e);
         } finally {
           setSaving(false);
         }
@@ -493,12 +518,14 @@ window.__ModuleLoader__.load({
         load();
         setDirty(false);
         setFailed(false);
+        setSaveError("");
       };
 
       const runTest = async () => {
         setTesting(true);
         setTestResult(null);
         setFailed(false);
+        setSaveError("");
         try {
           const result = await bridgeRawSearch({
             query: "DeepSeek Harness",
@@ -528,6 +555,7 @@ window.__ModuleLoader__.load({
         setCheckingUpdate(true);
         setUpdateInfo(null);
         setFailed(false);
+        setSaveError("");
         try {
           const result = await bridgeCheckUpdate();
           if (result.ok) {
@@ -546,6 +574,7 @@ window.__ModuleLoader__.load({
         setUpgrading(true);
         setUpdateInfo(null);
         setFailed(false);
+        setSaveError("");
         try {
           const response = await fetch(`${BRIDGE_PREFIX}/update`, {
             method: "POST",
@@ -578,6 +607,7 @@ window.__ModuleLoader__.load({
         setLang((prev) => (prev === "en" ? "zh" : "en"));
         setDirty(true);
         setFailed(false);
+        setSaveError("");
       };
 
       return react_jsx_runtime.jsx("li", {
@@ -726,6 +756,7 @@ react_jsx_runtime.jsx("div", {
                           setExaKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("input", {
@@ -738,6 +769,7 @@ react_jsx_runtime.jsx("div", {
                           setTavilyKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("input", {
@@ -750,6 +782,7 @@ react_jsx_runtime.jsx("div", {
                           setKeenableKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("input", {
@@ -762,6 +795,7 @@ react_jsx_runtime.jsx("div", {
                           setFirecrawlKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("input", {
@@ -774,6 +808,7 @@ react_jsx_runtime.jsx("div", {
                           setParallelKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("input", {
@@ -786,6 +821,7 @@ react_jsx_runtime.jsx("div", {
                           setPerplexityKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("input", {
@@ -798,6 +834,7 @@ react_jsx_runtime.jsx("div", {
                           setSerpbaseKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("input", {
@@ -810,6 +847,7 @@ react_jsx_runtime.jsx("div", {
                           setDeepseekKey(e.target.value);
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("p", {
@@ -832,6 +870,7 @@ react_jsx_runtime.jsx("div", {
                               setKeyStorage(e.target.value);
                               setDirty(true);
                               setFailed(false);
+                              setSaveError("");
                             },
                             children: [
                               react_jsx_runtime.jsx("option", { value: "credentials", children: t.keyStorageCred }),
@@ -872,6 +911,7 @@ react_jsx_runtime.jsx("div", {
                                   );
                                   setDirty(true);
                                   setFailed(false);
+                                  setSaveError("");
                                 },
                               }),
                               label,
@@ -904,6 +944,7 @@ react_jsx_runtime.jsx("div", {
                           setCacheTtl(Number(e.target.value));
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                       }),
                       react_jsx_runtime.jsx("p", {
@@ -915,7 +956,12 @@ react_jsx_runtime.jsx("div", {
                   react_jsx_runtime.jsx("div", {
                     className: "dshfs-resultRow",
                     children: [
-                      failed ? react_jsx_runtime.jsx("span", { className: "dshfs-failed", children: t.saveFailed }) : null,
+                      failed
+                        ? react_jsx_runtime.jsx("span", {
+                            className: "dshfs-failed",
+                            children: saveError ? t.saveFailedDetail(saveError) : t.saveFailed,
+                          })
+                        : null,
                       testResult
                         ? react_jsx_runtime.jsx("span", {
                             className: testResult.ok ? "dshfs-testOk" : "dshfs-failed",
@@ -1038,6 +1084,7 @@ react_jsx_runtime.jsx("div", {
                           setProvider("bing");
                           setDirty(true);
                           setFailed(false);
+                          setSaveError("");
                         },
                         disabled: saving || !ready || provider === "bing",
                         children: t.useBing,
@@ -1070,22 +1117,10 @@ react_jsx_runtime.jsx("div", {
     const inject = ["slots", "commandUi"];
 
     function apply(ctx) {
-      // 挂官方插槽 settings.plugin.item（设置 → 插件 → 可配置标签页）。
-      // 不依赖 dsh-web-ui：配置读写走自建 bridge（/api/dsh-free-search-settings）。
-      ctx.slots.inject("settings.plugin.item", () =>
-        ctx.slots.register(
-          {
-            name: "settings.plugin.item",
-            key: "free-search",
-            id: "dsh-free-search",
-            order: 120,
-            inject: () => ({}),
-          },
-          FreeSearchCard
-        )
-      );
-      // 挂 0.1.6-alpha.2+ 的插件页 slot：侧栏 插件 → 已安装 → free-search → 行配置页。
+      // 挂插件页 slot：侧栏 插件 → 已安装 → free-search → 行配置页。
+      // rc.1 废弃了旧版设置页的插件配置 slot，只保留 plugins.row.config；
       // key 规则见 ui-plugin-manager 的 rowConfigKey：<包名>#<patch 里声明的行 id>。
+      // 配置读写走自建 bridge（/api/dsh-free-search-settings），不依赖 dsh-web-ui。
       ctx.slots.inject("plugins.row.config", () =>
         ctx.slots.register(
           {

package/lib/index.js

@@ -46,13 +46,16 @@ const MARKET_TO_LANG = {
   "ko-KR": "ko-KR,ko;q=0.9,en;q=0.8",
 };
 
-const FREE_SEARCH_NS = "free-search";
+// rc.1: settings moved into the profile-owned plugin Config. The namespace is the
+// composition entry id (the `web-search-free` row the bundle's cordis.patch.yml
+// declares), not the old `$DSH_HOME/settings.yaml` section name.
+const FREE_SEARCH_NS = "web-search-free";
 const BRIDGE_PREFIX = "/api/dsh-free-search-settings";
 const FREE_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch"];
 const ALL_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek-official"];
 
 // 当前插件版本（发布时与 package.json 同步）
-const PLUGIN_VERSION = "0.4.36";
+const PLUGIN_VERSION = "0.4.38";
 // 检查更新的 npm registry 元数据地址（dsh-free-search 是 npmjs 上的公开包）
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/dsh-free-search/latest";
 const PLUGIN_NPM_URL = "https://www.npmjs.com/package/dsh-free-search";
@@ -1785,29 +1788,44 @@ const KEY_REF_MAP = {
   deepseekApiKey: "DEEPSEEK_API_KEY",
 };
 
+// rc.1 declares editable fields `.volatile()`: the Loader hands `apply` live
+// references and commits profile edits in place without remounting. `resolveConfig`
+// unwraps those references so every read sees the latest accepted value.
+// `.volatile()` requires the scoped `@deepseek-ai/schemastery` (>= 3.18.2).
 const Config = z.object({
-  provider: z.string().default("bing"),
-  cache: z.boolean().default(true), // 单 query 结果缓存开关（防限流/省额度）
-  cacheTtl: z.number().default(5), // 缓存时长（分钟），0-5 可配置（使用处再 clamp）
-  keyStorage: z.string().default("credentials"), // key 存储位置：credentials（凭据中心）| settings（设置页）
-  lang: z.string().default("zh"),
-  region: z.string(),
-  bingMarket: z.string().default("zh-CN"),
-  safeSearch: z.string().default("off"),
-  searxngInstances: z.array(z.string()),
-  platforms: z.array(z.string()).default(["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]),
-  exaApiKey: z.string().role("secret"),
-  tavilyApiKey: z.string().role("secret"),
-  keenableApiKey: z.string().role("secret"),
-  firecrawlApiKey: z.string().role("secret"),
-  parallelApiKey: z.string().role("secret"),
-  perplexityApiKey: z.string().role("secret"),
-  serpbaseApiKey: z.string().role("secret"),
-  deepseekApiKey: z.string().role("secret"),
+  provider: z.string().default("bing").volatile(),
+  cache: z.boolean().default(true).volatile(), // 单 query 结果缓存开关（防限流/省额度）
+  cacheTtl: z.number().default(5).volatile(), // 缓存时长（分钟），0-5 可配置（使用处再 clamp）
+  keyStorage: z.string().default("credentials").volatile(), // key 存储位置：credentials（凭据中心）| settings（设置页）
+  lang: z.string().default("zh").volatile(),
+  region: z.string().volatile(),
+  bingMarket: z.string().default("zh-CN").volatile(),
+  safeSearch: z.string().default("off").volatile(),
+  searxngInstances: z.array(z.string()).volatile(),
+  platforms: z.array(z.string()).default(["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]).volatile(),
+  exaApiKey: z.string().role("secret").volatile(),
+  tavilyApiKey: z.string().role("secret").volatile(),
+  keenableApiKey: z.string().role("secret").volatile(),
+  firecrawlApiKey: z.string().role("secret").volatile(),
+  parallelApiKey: z.string().role("secret").volatile(),
+  perplexityApiKey: z.string().role("secret").volatile(),
+  serpbaseApiKey: z.string().role("secret").volatile(),
+  deepseekApiKey: z.string().role("secret").volatile(),
 });
 
+// Unwrap the live `Volatile<T>` references the Loader passes for `.volatile()`
+// fields into a plain object, once per read.
+function resolveConfig(config) {
+  if (config === null || typeof config !== "object") return {};
+  const out = {};
+  for (const [key, value] of Object.entries(config)) {
+    out[key] = value !== null && typeof value === "object" && typeof value.get === "function" ? value.get() : value;
+  }
+  return out;
+}
+
 function apply(ctx, config) {
-  let current = () => config ?? {};
+  const current = () => resolveConfig(config);
   const logger = ctx.logger;
   // credentials 服务可能晚于本插件挂载（跨 bundle 顺序），运行期动态获取而不是 apply 时缓存
   const getCredentials = () => ctx.get("credentials");
@@ -2035,37 +2053,16 @@ function apply(ctx, config) {
   };
 
   ctx.inject(["settings"], (sctx) => {
-    // alpha.2+（SettingsProvider 有 installSection 方法）与 rc.2（模块级 installSettingsSection）双兼容：
-    // 特性检测优先用 alpha 方法；缺失时动态 import 旧 API 注册（rc.2 环境，不会触发 alpha 的缺失导出报错）。
-    if (typeof sctx.settings.installSection === "function") {
-      sctx.settings.installSection(ctx, FREE_SEARCH_NS, Config, config ?? {}, {
-        setSource: (source) => {
-          current = source;
-        },
-        onChange: () => {
-          // settings 变更时刷新系统提示词（显示最新引擎）
-          if (typeof refreshPrompt === "function") refreshPrompt();
-        },
-      });
-    } else {
-      void (async () => {
-        const legacy = await import("@deepseek-ai/dsh-settings");
-        if (typeof legacy.installSettingsSection === "function" && legacy.settingsNamespace) {
-          const legacyNs = legacy.settingsNamespace(FREE_SEARCH_NS);
-          legacy.installSettingsSection(ctx, legacyNs, Config, config ?? {}, {
-            setSource: (source) => {
-              current = source;
-            },
-            onChange: () => {
-              if (typeof refreshPrompt === "function") refreshPrompt();
-            },
-          });
-        } else {
-          sctx.logger?.warn?.("free-search: dsh-settings 无可用注册 API（installSection/installSettingsSection 均缺失）");
-          return;
-        }
-      })();
-    }
+    // rc.1 moved plugin configuration into the profile-owned Config, so the old
+    // namespace-registration API is gone. Editable fields are declared `.volatile()`
+    // on `Config` (above); this only records that the plugin ships its own settings
+    // page (`auto: false`) so the host does not also generate a schema form. Values
+    // persist per profile in `cordis.patch.yml` under this entry (`FREE_SEARCH_NS`).
+    sctx.effect(() => sctx.settings.configure({ auto: false }, ctx.fiber));
+    // Re-render the dynamic system-prompt engine list whenever this entry's config changes.
+    sctx.on("settings/document-updated", (ns) => {
+      if (String(ns) === FREE_SEARCH_NS && typeof refreshPrompt === "function") refreshPrompt();
+    });
   });
 
   ctx.inject(["webServer", "settings"], (sctx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-free-search",
-  "version": "0.4.36",
+  "version": "0.4.38",
   "description": "Free web search for DeepSeek Harness: 13 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable/Firecrawl/Parallel keyless; Perplexity/SerpBase/DeepSeek with key) + time filtering + platform search + web_fetch, with web settings UI.",
   "type": "module",
   "main": "lib/index.js",
@@ -43,15 +43,47 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7 || ^0.1.1-rc.2 || ^0.1.2-alpha.2 || ^0.1.3-alpha.2 || ^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7 || ^0.1.1-rc.2 || ^0.1.2-alpha.2 || ^0.1.3-alpha.2 || ^0.1.5-alpha.1"
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-commands": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-plugin-manager": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-renderer": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.7",
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.7"
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.1"
   },
   "dsh": {
     "bundle": {
@@ -59,27 +91,18 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime"
+        "@deepseek-ai/dsh-client-ui-commands",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
+        "@deepseek-ai/dsh-client-ui-renderer"
       ],
       "platform": "web"
     },
     "engines": {
-      "dsh": ">=0.1.1-rc.1"
+      "dsh": ">=0.1.7-rc.1"
     },
     "compatibility": {
       "dshReleases": {
-        "rc.7": "unknown",
-        "rc.8": "unknown",
-        "0.1.1-rc.1": "compatible",
-        "0.1.1-rc.2": "compatible",
-        "0.1.2-alpha.1": "unknown",
-        "0.1.2-alpha.2": "compatible",
-        "0.1.2-alpha.3": "compatible",
-        "0.1.2-alpha.4": "compatible",
-        "0.1.2-alpha.5": "unknown",
-        "0.1.2-rc.1": "compatible",
-        "0.1.5-rc.1": "compatible",
-        "0.1.5-rc.2": "compatible"
+        "0.1.7-rc.1": "compatible"
       }
     }
   }