dsh-free-search 0.4.29 → 0.4.30

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 脱敏显示"已配置"）+ 中英文切换
+- **网页设置页** —— 引擎切换 + API key 配置（UI 中 key 脱敏显示"已配置"）+ 中英文切换；DSH 0.1.6-alpha.2+ 入口在左侧「插件」页的组件行配置，旧版在「设置 → 插件 → 可配置」
 - **弹出式切换命令** —— 聊天框输入 `/free-search-engine`，弹出引擎选择窗口，点选即切换（等效设置页 + 保存）
 - **引擎测试** —— `free_search_test` 工具让 agent 一键测试所有引擎；设置页也有"测试引擎"按钮（直测当前引擎，不走回退链，付费引擎无 key 会明确报错）
 - **统一引擎回退** —— 任何引擎失败（付费/免费，缺 key/401/限流/网络）自动轮流尝试下一个引擎：首选引擎 → 其他引擎（exa/tavily/keenable/firecrawl 无 key 也会尝试，因为它们自带 keyless 免费额度）→ 剩余免费引擎，搜索永不直接失败；结果顶部注明实际生效的引擎（如 `Note: perplexity unavailable or failed, using exa.`）
@@ -113,7 +113,12 @@ dsh web
 
 #### 网页设置（推荐）
 
-安装后，打开 **设置 → 插件 → 可配置** 标签页 → **Free Search** 卡片（官方设置页）：
+安装后按 DSH 版本打开配置页：
+
+- **DSH 0.1.6-alpha.2 及以上**：左侧 **插件** 页 → **已安装** 分组 → `free-search` → 点击组件行 `web-search-free`（行内"配置"入口）
+- **DSH 0.1.5 及更早**：**设置 → 插件 → 可配置** 标签页 → **Free Search** 卡片
+
+配置页提供：
 
 - **Search engine**：下拉框切换引擎，保存即生效
 - **API keys**：为 Exa / Tavily / Keenable / Firecrawl / Parallel / Perplexity / DeepSeek 填写 key（密码框，保存后只显示"已配置"）
@@ -294,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
+- **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
 - **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 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.
@@ -377,7 +382,12 @@ This plugin intentionally specifies `@deepseek-ai/dsh-settings` and `@deepseek-a
 
 #### Web Settings (Recommended)
 
-After installation, navigate to **Settings → Plugins → Configurable** tab → **Free Search** card (the official settings page):
+After installation, open the config page according to your DSH version:
+
+- **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
+
+The config page provides:
 
 - **Search engine**: Select an engine from the dropdown; changes take effect immediately upon saving.
 - **API keys**: Enter keys for Exa / Tavily / Keenable / Firecrawl / Parallel / Perplexity / DeepSeek (password fields; displayed as "configured" once saved).

package/cordis.patch.yml

@@ -1,8 +1,10 @@
 # dsh-free-search — free web search providers (no API key needed)
 # Registers the free-search plugin into ctx.web + a settings bridge
 # (/api/dsh-free-search-settings) that serves the "free-search" namespace.
-# The engine (ddg / ddg-lite / bing) is chosen from the web Settings page
-# (Settings > Plugins > Web UI plugins > Free Search) or settings.yaml:
+# The engine (ddg / ddg-lite / bing) is chosen from the web Settings page:
+#   DSH 0.1.6-alpha.2+: sidebar Plugins page -> Installed -> free-search -> row config
+#   DSH 0.1.5 and earlier: Settings > Plugins > Configurable > Free Search
+# or from settings.yaml:
 #   free-search:
 #     provider: bing
 #     region: cn-zh        # DuckDuckGo region

package/lib/client.js

@@ -13,6 +13,10 @@ window.__ModuleLoader__.load({
       ".dshfs-cardOpen{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}",
       ".dshfs-header{width:100%;color:inherit;cursor:pointer;text-align:left;font:inherit;background:0 0;border:0;align-items:center;gap:8px;padding:10px 14px;display:flex}",
       ".dshfs-header:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}",
+      // 插件页 page 模式：页面自带标题，卡片固定展开、表头不可折叠
+      ".dshfs-pageMode>.dshfs-header{cursor:default}",
+      ".dshfs-pageMode>.dshfs-header:hover{background:0 0}",
+      ".dshfs-pageMode .dshfs-chevron{display:none}",
       ".dshfs-headText{flex-direction:column;flex:1;gap:2px;min-width:0;display:flex;overflow:hidden}",
       ".dshfs-name{color:var(--dsw-alias-label-primary);white-space:nowrap;text-overflow:ellipsis;font-weight:600;overflow:hidden}",
       ".dshfs-description{color:var(--dsw-alias-label-tertiary);white-space:nowrap;text-overflow:ellipsis;font-size:12px;overflow:hidden}",
@@ -298,6 +302,14 @@ window.__ModuleLoader__.load({
       return response.json();
     }
 
+    // 插件页行配置的摘要文案（bundle 页每行显示；不触发 bridge 读取）
+    function summaryText() {
+      const primary = typeof navigator === "undefined" ? "zh" : String((navigator.languages && navigator.languages[0]) || navigator.language || "zh").toLowerCase();
+      return primary.startsWith("en")
+        ? "13 engines · time filtering · platform search · web_fetch"
+        : "13 个搜索引擎 · 时间筛选 · 平台搜索 · web_fetch";
+    }
+
     function FreeSearchCard(props) {
       // 检测应用主题深浅（读 body 的 --dsw-alias-bg-base 变量亮度），用于锁定原生下拉配色
       const isDarkScheme = react.useMemo(() => {
@@ -319,7 +331,10 @@ window.__ModuleLoader__.load({
         return typeof matchMedia === "function" ? matchMedia("(prefers-color-scheme: dark)").matches : false;
       }, []);
       const selectColorScheme = isDarkScheme ? "dark" : "light";
-      const [open, setOpen] = react.useState(false);
+      // 插件页（0.1.6-alpha.2+ 的 plugins.row.config）以 page 模式复用本卡片：
+      // 页面自带标题/面包屑，卡片固定展开、表头不再可折叠。
+      const pageMode = !!(props && props.page);
+      const [open, setOpen] = react.useState(pageMode);
       const [state, setState] = react.useState({ status: "loading" });
       const [provider, setProvider] = react.useState("bing");
       const [safeSearch, setSafeSearch] = react.useState("off");
@@ -566,13 +581,13 @@ window.__ModuleLoader__.load({
       };
 
       return react_jsx_runtime.jsx("li", {
-        className: open ? "dshfs-card dshfs-cardOpen" : "dshfs-card",
+        className: (open ? "dshfs-card dshfs-cardOpen" : "dshfs-card") + (pageMode ? " dshfs-pageMode" : ""),
         children: [
           react_jsx_runtime.jsx("button", {
             type: "button",
             className: "dshfs-header",
-            "aria-expanded": open,
-            onClick: () => setOpen(!open),
+            "aria-expanded": pageMode ? void 0 : open,
+            onClick: pageMode ? void 0 : () => setOpen(!open),
             children: [
                       react_jsx_runtime.jsx("span", { className: "dshfs-headText", children: [
                   react_jsx_runtime.jsx("span", { className: "dshfs-name", children: title }),
@@ -1069,6 +1084,20 @@ react_jsx_runtime.jsx("div", {
           FreeSearchCard
         )
       );
+      // 挂 0.1.6-alpha.2+ 的插件页 slot：侧栏 插件 → 已安装 → free-search → 行配置页。
+      // key 规则见 ui-plugin-manager 的 rowConfigKey：<包名>#<patch 里声明的行 id>。
+      ctx.slots.inject("plugins.row.config", () =>
+        ctx.slots.register(
+          {
+            name: "plugins.row.config",
+            key: "dsh-free-search#web-search-free",
+          },
+          (slotProps) =>
+            slotProps && slotProps.view === "summary"
+              ? summaryText()
+              : react_jsx_runtime.jsx(FreeSearchCard, { page: true })
+        )
+      );
       // /free-search-engine 弹出式命令：输入 "/" 选中后弹出引擎列表，点选即切换。
       // 等效于设置页切换引擎+保存；命令只改 provider 配置，搜索仍走回退链。
       // description 必须传函数：ui-commands 读回的是 contribution.description()，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-free-search",
-  "version": "0.4.29",
+  "version": "0.4.30",
   "description": "Free web search for DeepSeek Harness: 13 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable/Firecrawl keyless; Parallel/Perplexity/SerpBase/DeepSeek with key) + time filtering + platform search + web_fetch, with web settings UI.",
   "type": "module",
   "main": "lib/index.js",