dsh-free-search 0.4.10 → 0.4.12

package/README.md

@@ -36,11 +36,11 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
 - **统一引擎回退** —— 任何引擎失败（付费/免费，缺 key/401/限流/网络）自动轮流尝试下一个引擎：首选引擎 → 其他引擎（exa/tavily/keenable 无 key 也会尝试，因为它们自带 keyless 免费额度）→ 剩余免费引擎，搜索永不直接失败；结果顶部注明实际生效的引擎（如 `Note: perplexity unavailable or failed, using exa.`）
 - **时间过滤** —— `advanced_search` 工具支持 `timeRange`：固定档、自定义相对值、绝对日期三种形式（详见下方逻辑说明）
 - **系统提示词注入** —— agent 知道当前用哪个引擎、哪些需要 key
-- **版本号 + 检查更新** —— 设置卡片显示当前版本（v0.4.10），"检查更新"按钮直连 npm registry 对比最新版，有新版本时提示并可一键跳转
+- **版本号 + 检查更新** —— 设置卡片显示当前版本（v0.4.12），"检查更新"按钮直连 npm registry 对比最新版，有新版本时提示并可一键跳转
 - **结果缓存** —— 相同查询（含引擎/时间过滤参数）5 分钟内命中缓存（LRU 50 条），防免费引擎限流、省付费额度；时长可在设置页 0-5 分钟自由配置（0 关闭）
 - **免费标注** —— 设置页中免费引擎带绿色 `FREE` 徽章，付费引擎带橙色 `API KEY` 徽章
 - **网页抓取（web_fetch）** —— 让 agent 抓取网页内容（官方 `dsh-web-fetch-http` provider，纯 JS，零额外依赖）
-- **平台搜索（platform_search）** —— 搜 GitHub / V2EX / B站（公开 API，零依赖）
+- **平台搜索（platform_search）** —— 搜 GitHub / V2EX / B站 / Reddit / Hacker News / Stack Overflow / 维基百科 / npm（公开 API，零依赖）
 - **干净集成** —— 实现官方 `WebSearchProvider` seam 接口，与官方插件共存
 
 ### 引擎列表
@@ -205,8 +205,13 @@ Search engine test:
 | `github` | GitHub 仓库搜索（API，免费无 key） |
 | `v2ex` | V2EX 热门/相关主题 |
 | `bilibili` | B站视频/内容搜索（公开接口） |
+| `reddit` | Reddit 帖子/讨论搜索（公开 JSON API；部分网络环境可能被 Reddit 反爬拦截） |
+| `hn` | Hacker News 技术社区讨论（Algolia 官方 API） |
+| `stackoverflow` | Stack Overflow 技术问答（Stack Exchange 官方公开 API） |
+| `wikipedia` | 维基百科词条（中文环境用 zh.wikipedia.org，`lang: en` 时切换 en.wikipedia.org） |
+| `npm` | npm 包搜索（registry 官方 API） |
 
-全部走公开 API，零外部依赖，开箱即用。
+全部走公开 API，零外部依赖、无需任何 key，开箱即用。
 
 ### 本地引擎切换工具（tools/）
 
@@ -271,11 +276,11 @@ This plugin provides multiple free search engines with automatic fallback, compl
 - **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 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.
 - **Time Filtering** — The `advanced_search` tool supports `timeRange`: fixed tiers, custom relative values, or an absolute date (details below)
 - **System Prompt Injection** — The agent is aware of the currently active engine and which engines require API keys
-- **Version + Update Check** — The settings card shows the current version (v0.4.10), and a "Check update" button queries the npm registry to compare against the latest release, prompting a one-click jump when a newer version exists
+- **Version + Update Check** — The settings card shows the current version (v0.4.12), and a "Check update" button queries the npm registry to compare against the latest release, prompting a one-click jump when a newer version exists
 - **Result Caching** — Identical queries (same engine / time-filter args) hit an LRU cache (50 entries) for up to 5 minutes, protecting free engines from rate-limiting and saving paid quota; the TTL is configurable from 0-5 minutes in the settings UI (0 disables caching)
 - **Visual Badges** — Free engines feature a green `FREE` badge, while paid engines show an orange `API KEY` badge in the settings UI
 - **Webpage Fetching (`web_fetch`)** — Allows the agent to read full webpage contents (official `dsh-web-fetch-http` provider, pure JS, zero extra dependencies)
-- **Platform Search (`platform_search`)** — Search GitHub / V2EX / Bilibili (public APIs, zero extra dependencies)
+- **Platform Search (`platform_search`)** — Search GitHub / V2EX / Bilibili / Reddit / Hacker News / Stack Overflow / Wikipedia / npm (public APIs, zero extra dependencies)
 - **Clean Integration** — Implements the official `WebSearchProvider` seam interface, coexisting seamlessly with official plugins
 
 ### Supported Engines
@@ -336,7 +341,7 @@ After installation, navigate to **Settings → Plugins → Configurable** tab
 - **API keys**: Enter keys for Exa / Tavily / Keenable / Perplexity / DeepSeek (password fields; displayed as "configured" once saved).
 - **Test engine**: Tests the selected engine directly (no fallback chain; paid engines without a key report an explicit error).
 - **Use Bing default**: stage a switch back to the stable free Bing engine; `Discard` only cancels unsaved edits
-- **Platform search**: check GitHub / V2EX / Bilibili to enable them for the `platform_search` tool (disabled platforms are skipped).
+- **Platform search**: check platforms (GitHub / V2EX / Bilibili / Reddit / HN / Stack Overflow / Wikipedia / npm) to enable them for the `platform_search` tool (disabled platforms are skipped).
 - **EN / 中文**: toggle the interface language (default Chinese).
 
 <table align="center" style="border: none; border-collapse: collapse;">
@@ -440,8 +445,13 @@ Ask the agent to search specific platforms (e.g., *"Search GitHub for deepseek h
 | `github` | GitHub repository search (public API, free, no key required) |
 | `v2ex` | V2EX hot / relevant topics |
 | `bilibili` | Bilibili video / content search (public API) |
+| `reddit` | Reddit posts / discussions (public JSON API; may be blocked by Reddit anti-bot in some network environments) |
+| `hn` | Hacker News tech community discussions (official Algolia API) |
+| `stackoverflow` | Stack Overflow Q&A (official public Stack Exchange API) |
+| `wikipedia` | Wikipedia articles (zh.wikipedia.org for Chinese; switches to en.wikipedia.org when `lang: en`) |
+| `npm` | npm package search (registry official API) |
 
-All platform searches rely on public endpoints with zero external dependencies and work out of the box.
+All platform searches rely on public endpoints with zero external dependencies and no API keys — they work out of the box.
 
 ### Local Engine Switcher (`tools/`)
 

package/cordis.patch.yml

@@ -15,3 +15,7 @@
       config:
         provider: bing
         bingMarket: zh-CN
+# 自动接管默认搜索：让 harness 的 web_search 直接用本插件的 provider（内部含全部引擎）
+- id: web
+  config:
+    searchProvider: ddg

package/lib/client.js

@@ -45,6 +45,9 @@ window.__ModuleLoader__.load({
       ".dshfs-save{border:1px solid var(--dsw-alias-button-info-fill);background:var(--dsw-alias-button-info-fill);color:var(--dsw-alias-label-primary-foreground)}",
       ".dshfs-save:hover:not(:disabled){border-color:var(--dsw-alias-button-info-hover);background:var(--dsw-alias-button-info-hover)}",
       ".dshfs-save:disabled{opacity:.5;cursor:default}",
+      ".dshfs-upgrade{border:1px solid rgba(80,200,120,.4);background:rgba(80,200,120,.15);color:#7ddb9c}",
+      ".dshfs-upgrade:hover:not(:disabled){background:rgba(80,200,120,.28)}",
+      ".dshfs-upgrade:disabled{opacity:.5;cursor:default}",
       ".dshfs-badge{background:var(--dsw-alias-interactive-bg-hover-accent);color:var(--dsw-alias-state-business-primary);white-space:nowrap;border-radius:999px;flex:none;padding:1px 6px;font-size:11px}",
       ".dshfs-badgeFree{background:rgba(80,200,120,.15);color:#7ddb9c;border:1px solid rgba(80,200,120,.3);white-space:nowrap;border-radius:999px;flex:none;padding:1px 6px;font-size:11px}",
       ".dshfs-badgeKey{background:rgba(240,170,80,.15);color:#f0b060;border:1px solid rgba(240,170,80,.3);white-space:nowrap;border-radius:999px;flex:none;padding:1px 6px;font-size:11px}",
@@ -102,6 +105,11 @@ window.__ModuleLoader__.load({
         updateLatest: (c) => `已是最新版本 v${c}`,
         updateCheckFailed: "检查更新失败（无法访问 npm registry）",
         updateView: "查看 →",
+        upgrade: "升级",
+        upgrading: "升级中…",
+        upgradeLinkMode: "（本地开发模式，升级请用 git pull）",
+        upgradeDone: (l) => `升级到 v${l} 完成，重启 dsh 后生效`,
+        upgradeFailed: (m) => `升级失败：${m}`,
       },
       en: {
         description: "Free web search — no API key needed (Bing / DuckDuckGo / AnySearch / Exa / Tavily / Keenable)",
@@ -135,14 +143,19 @@ window.__ModuleLoader__.load({
         checkUpdate: "Check update",
         checkingUpdate: "Checking…",
         updateAvailable: (c, l) => `New version v${l} available (current v${c})`,
-        updateLatest: (c) => `You are up to date (v${c})`,
+        updateLatest: (c) => `You're on the latest version v${c}`,
         updateCheckFailed: "Update check failed (cannot reach npm registry)",
         updateView: "View →",
+        upgrade: "Upgrade",
+        upgrading: "Upgrading…",
+        upgradeLinkMode: "(local dev install - use git pull to update)",
+        upgradeDone: (l) => `Upgraded to v${l} - restart dsh to apply`,
+        upgradeFailed: (m) => `Upgrade failed: ${m}`,
       },
     };
     const tt = (lang) => I18N[lang === "en" ? "en" : "zh"];
     // 当前插件版本（与 lib/index.js 的 PLUGIN_VERSION 保持一致）
-    const PLUGIN_VERSION = "0.4.10";
+    const PLUGIN_VERSION = "0.4.12";
     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" },
@@ -201,7 +214,7 @@ window.__ModuleLoader__.load({
       const [keenableKey, setKeenableKey] = react.useState("");
       const [perplexityKey, setPerplexityKey] = react.useState("");
       const [deepseekKey, setDeepseekKey] = react.useState("");
-      const [platforms, setPlatforms] = react.useState(["github", "v2ex", "bilibili", "reddit"]);
+      const [platforms, setPlatforms] = react.useState(["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]);
       const [cacheTtl, setCacheTtl] = react.useState(5);
       const [keysConfigured, setKeysConfigured] = react.useState({});
       const [lang, setLang] = react.useState("zh");
@@ -211,6 +224,7 @@ window.__ModuleLoader__.load({
       const [testing, setTesting] = react.useState(false);
       const [testResult, setTestResult] = react.useState(null);
       const [checkingUpdate, setCheckingUpdate] = react.useState(false);
+      const [upgrading, setUpgrading] = react.useState(false);
       const [updateInfo, setUpdateInfo] = react.useState(null);
 
       const load = react.useCallback(async () => {
@@ -227,7 +241,7 @@ window.__ModuleLoader__.load({
               setKeenableKey(v.keenableApiKey ?? "");
               setPerplexityKey(v.perplexityApiKey ?? "");
               setDeepseekKey(v.deepseekApiKey ?? "");
-              setPlatforms(Array.isArray(v.platforms) && v.platforms.length > 0 ? v.platforms : ["github", "v2ex", "bilibili", "reddit"]);
+              setPlatforms(Array.isArray(v.platforms) && v.platforms.length > 0 ? v.platforms : ["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]);
               setCacheTtl(v.cacheTtl === undefined ? 5 : Math.min(Math.max(Number(v.cacheTtl) ?? 5, 0), 5));
               // secrets 字段标记哪些 key 已配置（值被脱敏，仅显示"已配置"）
               const configured = {};
@@ -346,6 +360,29 @@ window.__ModuleLoader__.load({
         }
       };
 
+      const runUpdate = async () => {
+        setUpgrading(true);
+        setUpdateInfo(null);
+        setFailed(false);
+        try {
+          const response = await fetch(`${BRIDGE_PREFIX}/update`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: "{}",
+          });
+          const result = await response.json();
+          if (result.ok) {
+            setUpdateInfo({ ok: true, hasUpdate: false, upgraded: true, message: result.value.message, latest: result.value.latest });
+          } else {
+            setUpdateInfo({ ok: false, upgradeFailed: result.message ?? "upgrade failed" });
+          }
+        } catch {
+          setUpdateInfo({ ok: false, upgradeFailed: "request failed" });
+        } finally {
+          setUpgrading(false);
+        }
+      };
+
       if (state.status === "loading") return null;
       const ready = state.status === "ready";
       const t = tt(lang);
@@ -516,6 +553,7 @@ react_jsx_runtime.jsx("div", {
                         className: "dshfs-platforms",
                         children: [
                           ["github", "GitHub"], ["v2ex", "V2EX"], ["bilibili", "Bilibili"], ["reddit", "Reddit"],
+                          ["hn", "Hacker News"], ["stackoverflow", "Stack Overflow"], ["wikipedia", "Wikipedia"], ["npm", "npm"],
                         ].map(([id, label]) =>
                           react_jsx_runtime.jsx("label", {
                             className: "dshfs-platform",
@@ -605,29 +643,43 @@ react_jsx_runtime.jsx("div", {
                             children: checkingUpdate ? t.checkingUpdate : t.checkUpdate,
                           }),
                           updateInfo && updateInfo.ok
-                            ? updateInfo.hasUpdate
+                            ? updateInfo.upgraded
                               ? react_jsx_runtime.jsx("span", {
-                                  className: "dshfs-update",
-                                  children: [
-                                    t.updateAvailable(updateInfo.current, updateInfo.latest),
-                                    " ",
-                                    react_jsx_runtime.jsx("a", {
-                                      className: "dshfs-link",
-                                      href: updateInfo.updateUrl,
-                                      target: "_blank",
-                                      rel: "noopener noreferrer",
-                                      children: t.updateView,
-                                    }),
-                                  ],
-                                })
-                              : react_jsx_runtime.jsx("span", {
                                   className: "dshfs-updateOk",
-                                  children: t.updateLatest(updateInfo.current),
+                                  children: t.upgradeDone(updateInfo.latest),
                                 })
+                              : updateInfo.hasUpdate
+                                ? react_jsx_runtime.jsx("span", {
+                                    className: "dshfs-update",
+                                    children: [
+                                      t.updateAvailable(updateInfo.current, updateInfo.latest),
+                                      " ",
+                                      updateInfo.installable
+                                        ? react_jsx_runtime.jsx("button", {
+                                            className: "dshfs-btn dshfs-upgrade",
+                                            type: "button",
+                                            onClick: runUpdate,
+                                            disabled: upgrading || saving || !ready,
+                                            children: upgrading ? t.upgrading : t.upgrade,
+                                          })
+                                        : react_jsx_runtime.jsx("a", {
+                                            className: "dshfs-link",
+                                            href: updateInfo.updateUrl,
+                                            target: "_blank",
+                                            rel: "noopener noreferrer",
+                                            children: t.updateView,
+                                          }),
+                                      updateInfo.installable ? null : " " + t.upgradeLinkMode,
+                                    ],
+                                  })
+                                : react_jsx_runtime.jsx("span", {
+                                    className: "dshfs-updateOk",
+                                    children: t.updateLatest(updateInfo.current),
+                                  })
                             : updateInfo && !updateInfo.ok
                               ? react_jsx_runtime.jsx("span", {
                                   className: "dshfs-failed",
-                                  children: t.updateCheckFailed,
+                                  children: updateInfo.upgradeFailed ? t.upgradeFailed(updateInfo.upgradeFailed) : t.updateCheckFailed,
                                 })
                               : null,
                         ],

package/lib/index.js

@@ -1,6 +1,9 @@
 import { SettingsConflictError, installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import z from "@deepseek-ai/schemastery";
+import fs from "node:fs";
+import path from "node:path";
+import { exec } from "node:child_process";
 
 const DDG_HTML_URL = "https://html.duckduckgo.com/html/";
 const DDG_LITE_URL = "https://lite.duckduckgo.com/lite/";
@@ -18,7 +21,7 @@ const FREE_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch"];
 const ALL_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch", "exa", "tavily", "keenable", "perplexity", "deepseek-official"];
 
 // 当前插件版本（发布时与 package.json 同步）
-const PLUGIN_VERSION = "0.4.10";
+const PLUGIN_VERSION = "0.4.12";
 // 检查更新的 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";
@@ -57,6 +60,26 @@ function compareVersions(a, b) {
   return 0;
 }
 
+// 检测插件的安装模式：遍历 profiles/*/node_modules/dsh-free-search，
+// symlink（link: 本地开发）→ isLink=true；npm 真安装 → isLink=false；找不到 → null
+function detectInstallMode() {
+  const profilesDir = path.join(process.cwd(), "profiles");
+  let found = null;
+  try {
+    for (const name of fs.readdirSync(profilesDir)) {
+      const pkgPath = path.join(profilesDir, name, "node_modules", "dsh-free-search");
+      if (!fs.existsSync(pkgPath)) continue;
+      let isLink = false;
+      try {
+        isLink = fs.lstatSync(pkgPath).isSymbolicLink();
+      } catch {}
+      found = { profileDir: path.join(profilesDir, name), isLink };
+      break;
+    }
+  } catch {}
+  return found;
+}
+
 // time_range 支持：固定档 day/week/month/year，或自定义（相对 12h/3d/2mo/1y、绝对 YYYY-MM-DD）
 const TIME_RANGES = ["day", "week", "month", "year"];
 const DAYS_BY_RANGE = { day: 1, week: 7, month: 30, year: 365 };
@@ -465,12 +488,16 @@ async function searchExaMCP(query, maxResults, signal) {
 }
 //#endregion
 
-//#region platform search (GitHub / V2EX / Bilibili / Reddit)
+//#region platform search (GitHub / V2EX / Bilibili / Reddit / HN / StackOverflow / Wikipedia / npm)
 const PLATFORMS = {
   github: { name: "GitHub" },
   v2ex: { name: "V2EX" },
   bilibili: { name: "Bilibili" },
   reddit: { name: "Reddit" },
+  hn: { name: "Hacker News" },
+  stackoverflow: { name: "Stack Overflow" },
+  wikipedia: { name: "Wikipedia" },
+  npm: { name: "npm" },
 };
 
 async function searchGithub(query, maxResults, signal) {
@@ -567,7 +594,102 @@ async function searchReddit(query, maxResults, signal) {
   };
 }
 
-async function searchPlatform(platform, query, maxResults, signal) {
+async function searchHackerNews(query, maxResults, signal) {
+  const response = await fetch(
+    `https://hn.algolia.com/api/v1/search?query=${encodeURIComponent(query)}&hitsPerPage=${maxResults ?? 5}`,
+    {
+      headers: { "user-agent": USER_AGENT, accept: "application/json" },
+      ...(signal !== undefined ? { signal } : {}),
+    }
+  );
+  if (!response.ok) throw new Error(`Hacker News API error (HTTP ${response.status})`);
+  const data = await response.json();
+  return {
+    sources: (data.hits ?? [])
+      .filter((h) => h.title || h.story_title)
+      .map((h) => ({
+        // 有外链用外链，纯讨论帖用 HN 讨论页
+        url: h.url ?? `https://news.ycombinator.com/item?id=${h.objectID}`,
+        title: h.title ?? h.story_title,
+        ...((h.points !== undefined && h.points !== null) || (h.num_comments !== undefined && h.num_comments !== null)
+          ? { snippet: `HN discussion · ${h.points ?? 0} points · ${h.num_comments ?? 0} comments` }
+          : {}),
+      })),
+    truncated: false,
+  };
+}
+
+async function searchStackOverflow(query, maxResults, signal) {
+  const response = await fetch(
+    `https://api.stackexchange.com/2.3/search/advanced?order=desc&sort=relevance&q=${encodeURIComponent(query)}&site=stackoverflow&pagesize=${maxResults ?? 5}&filter=!nNPvSNVZJS`,
+    {
+      headers: { "user-agent": USER_AGENT, accept: "application/json" },
+      ...(signal !== undefined ? { signal } : {}),
+    }
+  );
+  if (!response.ok) throw new Error(`Stack Exchange API error (HTTP ${response.status})`);
+  const data = await response.json();
+  if (data.error_message) throw new Error(`Stack Exchange API error: ${data.error_message}`);
+  return {
+    sources: (data.items ?? []).map((it) => ({
+      url: it.link,
+      title: it.title,
+      ...(it.score !== undefined || it.answer_count !== undefined
+        ? { snippet: `${it.is_answered ? "✓ answered" : "unanswered"} · score ${it.score ?? 0} · ${it.answer_count ?? 0} answers` }
+        : {}),
+    })),
+    truncated: false,
+  };
+}
+
+async function searchWikipedia(query, maxResults, signal, lang) {
+  const host = lang === "en" ? "en.wikipedia.org" : "zh.wikipedia.org";
+  const response = await fetch(
+    `https://${host}/w/api.php?action=query&list=search&srsearch=${encodeURIComponent(query)}&format=json&srlimit=${maxResults ?? 5}`,
+    {
+      headers: { "user-agent": USER_AGENT, accept: "application/json" },
+      ...(signal !== undefined ? { signal } : {}),
+    }
+  );
+  if (!response.ok) throw new Error(`Wikipedia API error (HTTP ${response.status})`);
+  const data = await response.json();
+  return {
+    sources: (data.query?.search ?? []).map((s) => ({
+      url: `https://${host}/wiki/${encodeURIComponent(String(s.title).replace(/ /g, "_"))}`,
+      title: s.title,
+      // snippet 含 <span class="searchmatch"> 高亮标签，剥掉
+      ...(s.snippet ? { snippet: stripTags(s.snippet).slice(0, 200) } : {}),
+    })),
+    truncated: false,
+  };
+}
+
+async function searchNpm(query, maxResults, signal) {
+  const response = await fetch(
+    `https://registry.npmjs.com/-/v1/search?text=${encodeURIComponent(query)}&size=${maxResults ?? 5}`,
+    {
+      headers: { "user-agent": USER_AGENT, accept: "application/json" },
+      ...(signal !== undefined ? { signal } : {}),
+    }
+  );
+  if (!response.ok) throw new Error(`npm registry API error (HTTP ${response.status})`);
+  const data = await response.json();
+  return {
+    sources: (data.objects ?? [])
+      .map((o) => o.package)
+      .filter((p) => p && p.name)
+      .map((p) => ({
+        url: p.links?.npm ?? `https://www.npmjs.com/package/${p.name}`,
+        title: p.name,
+        ...((p.description || p.version)
+          ? { snippet: `v${p.version ?? "?"}${p.description ? ` — ${String(p.description).slice(0, 160)}` : ""}` }
+          : {}),
+      })),
+    truncated: false,
+  };
+}
+
+async function searchPlatform(platform, query, maxResults, signal, lang) {
   switch (platform) {
     case "github":
       return searchGithub(query, maxResults, signal);
@@ -577,6 +699,14 @@ async function searchPlatform(platform, query, maxResults, signal) {
       return searchBilibili(query, maxResults, signal);
     case "reddit":
       return searchReddit(query, maxResults, signal);
+    case "hn":
+      return searchHackerNews(query, maxResults, signal);
+    case "stackoverflow":
+      return searchStackOverflow(query, maxResults, signal);
+    case "wikipedia":
+      return searchWikipedia(query, maxResults, signal, lang);
+    case "npm":
+      return searchNpm(query, maxResults, signal);
     default:
       throw new Error(`unknown platform: ${platform}`);
   }
@@ -983,6 +1113,7 @@ function makeBridgeRoutes(settings, search, testEngine) {
         };
       }
       const cmp = compareVersions(latest, PLUGIN_VERSION);
+      const mode = detectInstallMode();
       return {
         ok: true,
         value: {
@@ -991,9 +1122,46 @@ function makeBridgeRoutes(settings, search, testEngine) {
           hasUpdate: cmp > 0,
           updateUrl: PLUGIN_NPM_URL,
           repoUrl: PLUGIN_REPO_URL,
+          // 可一键升级：npm 真安装时 true；本地 link 开发模式 false（升级请 git pull 源码）
+          installable: mode !== null && !mode.isLink,
+          installMode: mode?.isLink ? "link" : mode !== null ? "registry" : "unknown",
         },
       };
     },
+    // 一键升级：仅在 npm 真安装模式下执行 pnpm 升级；link 模式拒绝（避免破坏本地开发链路）
+    async updatePlugin() {
+      const mode = detectInstallMode();
+      if (mode === null) {
+        return { ok: false, code: "install-not-found", message: "could not locate dsh-free-search in any profile" };
+      }
+      if (mode.isLink) {
+        return {
+          ok: false,
+          code: "local-link-mode",
+          message: "local development install (symlink) - update the source repo instead (git pull), then restart dsh",
+        };
+      }
+      try {
+        const result = await new Promise((resolve, reject) => {
+          exec("pnpm add dsh-free-search@latest", { cwd: mode.profileDir, timeout: 120000 }, (error, stdout, stderr) => {
+            if (error) reject(new Error(`upgrade failed: ${(stderr || stdout || error.message).trim().slice(0, 300)}`));
+            else resolve(stdout);
+          });
+        });
+        const latest = await fetchLatestVersion();
+        return {
+          ok: true,
+          value: {
+            updated: true,
+            latest: latest ?? "unknown",
+            message: `upgraded to latest - restart dsh to apply`,
+            output: String(result).trim().slice(0, 200),
+          },
+        };
+      } catch (error) {
+        return { ok: false, code: "upgrade-failed", message: error instanceof Error ? error.message : String(error) };
+      }
+    },
     async rawSearch(request) {
       if (request === null || typeof request !== "object" || typeof request.query !== "string" || request.query.length === 0) {
         return { ok: false, code: "search-rejected", message: "malformed bridge search request (query is required)" };
@@ -1124,6 +1292,14 @@ function makeBridgeRoutes(settings, search, testEngine) {
         writeJson(res, 200, await handlers.checkUpdate());
       },
     },
+    {
+      kind: "exact",
+      path: `${BRIDGE_PREFIX}/update`,
+      handler: async (req, res) => {
+        if (!guard(req, res)) return;
+        writeJson(res, 200, await handlers.updatePlugin());
+      },
+    },
     {
       kind: "exact",
       path: `${BRIDGE_PREFIX}/raw-search`,
@@ -1152,7 +1328,7 @@ const Config = z.object({
   region: z.string(),
   bingMarket: z.string().default("zh-CN"),
   searxngInstances: z.array(z.string()),
-  platforms: z.array(z.string()).default(["github", "v2ex", "bilibili", "reddit"]),
+  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"),
@@ -1389,6 +1565,15 @@ function apply(ctx, config) {
 
   ctx.web.registerSearchProvider(provider);
 
+  // 运行时兜底：DSH 0.1.1+ 中 profile patch 的 config 会整体覆盖 bundle patch 的 config，
+  // 用户的 `- id: web` patch（如只设 fetchProvider）会静默抹掉 searchProvider，导致回退 DeepSeek 官方搜索。
+  // 这里在 provider 注册后检查：未指向任何 provider（undefined）时自动接管为本插件；
+  // 用户显式配置了其他 provider 则不动。
+  if (!ctx.web.searchProviderId) {
+    ctx.web.searchProviderId = provider.id;
+    logger.info(`free-search: web.searchProvider was unset (patch override or missing config), taking over as "${provider.id}"`);
+  }
+
   // 测试工具：让 agent 逐个测试所有搜索引擎，报告可用性
   const runEngineTest = async (engine, query, timeRange) => {
     const cfg = current();
@@ -1547,11 +1732,11 @@ function apply(ctx, config) {
         defineTool({
           name: "platform_search",
           description:
-            "Search a specific platform (GitHub / V2EX / Bilibili / Reddit) for a query. Returns source URLs with titles and snippets. Use this when the user asks about repos, code, forum threads, videos, or discussions.",
+            "Search a specific platform (GitHub / V2EX / Bilibili / Reddit / Hacker News / Stack Overflow / Wikipedia / npm) for a query. Returns source URLs with titles and snippets. Use this when the user asks about repos, code, forum threads, videos, discussions, Q&A, encyclopedia entries, or packages.",
           parameters: {
             platform: {
               type: "string",
-              description: "Platform to search: github, v2ex, bilibili, reddit",
+              description: "Platform to search: github, v2ex, bilibili, reddit, hn, stackoverflow, wikipedia, npm",
             },
             query: {
               type: "string",
@@ -1593,14 +1778,14 @@ function apply(ctx, config) {
               throw new Error(`unknown platform "${platform}" - use one of: ${Object.keys(PLATFORMS).join(", ")}`);
             }
             // 平台开关：settings 里禁用某平台时，工具明确告知
-            const enabled = current().platforms ?? ["github", "v2ex", "bilibili", "reddit"];
+            const enabled = current().platforms ?? ["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"];
             if (!enabled.includes(platform)) {
               throw new Error(
                 `platform "${platform}" is disabled in Free Search settings - enable it in Settings > Plugins > Free Search to use it`
               );
             }
             const limit = Math.min(args.maxResults ?? 5, 10);
-            const result = await searchPlatform(platform, args.query, limit);
+            const result = await searchPlatform(platform, args.query, limit, undefined, current().lang);
             // lossless JSON 不允许 undefined 字段：剔除缺失字段
             const sources = (result.sources ?? []).map((s) => {
               const source = {};
@@ -1752,7 +1937,7 @@ function apply(ctx, config) {
           "",
           "When the user wants results from a specific time window (e.g. 'last week', 'this month', 'last 3 days'), use the advanced_search tool with timeRange. Fixed tiers: day|week|month|year. Custom: 12h, 3d, 2mo, 1y, or an absolute date like 2026-07-01.",
           "",
-          "For platform-specific searches (GitHub repos, V2EX threads, Bilibili videos), use the platform_search tool with platform: github|v2ex|bilibili.",
+          "For platform-specific searches (GitHub repos, V2EX threads, Bilibili videos, Reddit posts, Hacker News discussions, Stack Overflow questions, Wikipedia articles, npm packages), use the platform_search tool with platform: github|v2ex|bilibili|reddit|hn|stackoverflow|wikipedia|npm.",
           "",
           "The user can switch the search engine themselves by typing /free-search-engine in the chat — it opens a picker to choose an engine, just like the settings page. This changes the preferred engine; search still falls back to other engines automatically if it fails. You should not switch engines on your own; let the user decide.",
         ].join("\n"),
@@ -1799,13 +1984,17 @@ export {
   searchExa,
   searchExaMCP,
   searchGithub,
+  searchHackerNews,
   searchKeenable,
   searchKeenableMCP,
   searchKeenableREST,
+  searchNpm,
   searchPerplexity,
   searchPlatform,
   searchReddit,
   searchSearxng,
+  searchStackOverflow,
   searchTavily,
   searchV2ex,
+  searchWikipedia,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-free-search",
-    "version":  "0.4.10",
+    "version":  "0.4.12",
     "description":  "Free web search for DeepSeek Harness: 10 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable keyless) + time filtering + platform search + web_fetch, with web settings UI.",
     "type":  "module",
     "main":  "lib/index.js",