@objectivex666/dsh-settings-search 1.6.0 → 1.7.0

package/README.en.md

@@ -16,6 +16,8 @@
 - 📂 **In-page option search (v1.2.0)** — search beyond pages and reach the specific options inside them: Plugins-page tabs (`settings.plugins.tab`), Web UI plugin cards (`web-ui.plugin.item`), general rows, and more, each shown with a "page › option" breadcrumb.
 - 🔤 **Pinyin association search (v1.5.0)** — type initials (`sz`) or full pinyin (`shezhi`) to surface Chinese settings items; navigate with `↑`/`↓`, confirm with `Enter`, dismiss with `Esc`, and matched text is highlighted.
 - 🧠 **Intent search (v1.6.0)** — describe the goal in Chinese (e.g. 「太亮了」 "too bright", 「字太小」 "text too small") to surface matching settings without knowing their names, shown in a "You may want" group.
+- 🤖 **AI-assisted search (v1.7.0)** — when nothing matches locally, your own model (OpenAI-compatible or Anthropic: Base URL / model / API key) understands your search intent and suggests settings. Off by default; configure it on the plugin's settings page.
+- 🧾 **Logging & export (v1.7.0)** — records key plugin actions, searches, and AI requests; export, copy, or clear them from the plugin's settings page for troubleshooting. API keys are never logged.
 - 🧭 **Click-to-jump** — selecting a result clicks the matching left-nav entry to open its section; for tab options it also opens the tab and flashes the target row. A manual-path hint appears if automatic navigation is not possible.
 - 🌱 **Progressive indexing** — self-drawing settings rows are harvested from the rendered DOM (via their `[data-slot]` anchors) the first time their page is visited, then stay searchable.
 - 🛠 **Built-in settings page (v1.4.0)** — a "Settings Search" page in the left navigation shows the current version and checks npm for a newer release on demand; when one exists it hands you a copy-ready `dsh plugin update` command.
@@ -94,3 +96,14 @@ npm test   # validates the host half, the dsh.client manifest, and the client bu
 > in-session `cordis_define` dynamic-plugin source). Because keeping it in
 > sync with the shipping package kept drifting silently, it was removed in
 > v1.4.1; retrieve it from git history (tag `v1.4.0`) if you need a reference.
+
+## Changelog & releases
+
+Every version bump keeps git tags and GitHub Releases in sync, with a bilingual body that lists both new features and fixes:
+
+- Update [CHANGELOG.md](./CHANGELOG.md) (Chinese) and [CHANGELOG.en.md](./CHANGELOG.en.md) (English), each with `### ✨ Features` and `### 🐛 Fixes` sections.
+- Bump the version in `package.json` and the README, then tag and push as `vX.Y.Z`; GitHub Actions publishes to npm (`npm-publish.yml`) and creates a bilingual GitHub Release (`release.yml`).
+- Preview the release body locally: `node scripts/release.mjs --version <ver>`
+- Tag and publish for real: `node scripts/release.mjs --version <ver> --publish` (requires `gh` CLI, logged in)
+
+> Without `--publish` the script only validates and prints the release body; it does not create a tag, push, or release.

package/README.md

@@ -16,6 +16,8 @@
 - 📂 **页内选项搜索（v1.2.0）**：不只搜页面，还能直达每个设置页内部的具体选项——插件页的标签页（`settings.plugins.tab`）、Web UI 插件的卡片（`web-ui.plugin.item`）、通用设置行等，结果以「页面 › 选项」面包屑展示。
 - 🔤 **拼音联想搜索（v1.5.0）**：输入拼音首字母（如 `sz`）或全拼（如 `shezhi`）即可联想中文设置项；支持 `↑`/`↓` 选择、`Enter` 跳转、`Esc` 关闭，命中的文字自动高亮。
 - 🧠 **意图联想搜索（v1.6.0）**：直接描述想做的事（如「太亮了」「字太小」「忘记密码」），无需知道选项名即可联想真实设置项，结果在「猜你想找」分组展示。
+- 🤖 **AI 联想搜索（v1.7.0）**：没有本地匹配时，用你配置的模型（OpenAI 兼容或 Anthropic：Base URL / 模型名 / API Key）理解搜索意图并推荐设置项。默认关闭，可在「设置搜索」页开启并配置。
+- 🧾 **日志与导出（v1.7.0）**：记录插件运行、搜索与 AI 请求的关键动作，可在「设置搜索」页一键导出、复制或清空，便于排查问题。不会记录 API Key。
 - 🧭 **点击即达**：选中结果后自动点击对应的左侧导航项打开所在分区；若是页内标签页会继续点开对应标签，并高亮闪烁目标选项行。无法自动跳转时显示手动路径提示。
 - 🌱 **渐进索引**：自绘界面的设置行会在其所在页面首次被访问时从渲染 DOM 中收割标题并加入索引（此后始终可搜）。
 - 🛠 **自带设置页（v1.4.0）**：左侧导航新增「设置搜索」页——展示当前版本，一键检查 npm 注册表上的最新版本；有更新时直接给出复制就用的 `dsh plugin update` 命令。
@@ -95,3 +97,14 @@ npm test   # 校验 host 半、dsh.client 清单、client bundle handoff
 > 历史说明：v1.1 及之前仓库曾附带 `dsh-settings-search.js`（会话内
 > `cordis_define` 动态插件源）。因与正式包代码长期双份维护漂移，已于 v1.4.1
 > 移除；如需动态用法可从 git 历史（tag `v1.4.0`）取回参考。
+
+## 更新日志与发布
+
+每次版本更新需同时更新 GitHub Release 与 git tag，正文为双语，并写明「新功能」与「修复」：
+
+- 更新 [CHANGELOG.md](./CHANGELOG.md)（中文）与 [CHANGELOG.en.md](./CHANGELOG.en.md)（英文），两者各含 `### ✨ 新功能 / Features` 与 `### 🐛 修复 / Fixes`。
+- 同步 `package.json` 与 README 的版本号，按 `vX.Y.Z` 打 tag 并推送；GitHub Actions 会同时发布到 npm（`npm-publish.yml`）并创建双语 GitHub Release（`release.yml`）。
+- 本地预览 release 正文：`node scripts/release.mjs --version <ver>`
+- 实际打 tag 并发布：`node scripts/release.mjs --version <ver> --publish`（需 `gh` CLI 且已登录）
+
+> 未带 `--publish` 时脚本只校验并打印 release 正文，不会创建 tag、推送或发布。

package/lib/client.js

@@ -30,7 +30,7 @@ window.__ModuleLoader__.load({
 
     const NS = 'settings-search-v5'
     /** Single source of truth is package.json — scripts/check.mjs asserts this matches. */
-    const PKG_VERSION = '1.6.0'
+    const PKG_VERSION = '1.7.0'
     const NPM_NAME = '@objectivex666/dsh-settings-search'
     const zh = {
       title: '设置',
@@ -54,6 +54,36 @@ window.__ModuleLoader__.load({
       updCopy: '复制命令',
       updCopied: '已复制 ✓',
       updCopyFail: '复制失败，请长按上方命令手动复制。',
+      updCLI: 'DSH CLI',
+      updNpx: 'npx',
+      updRelease: '查看 release notes',
+      updRestart: '更新完成后重启 DSH，新版本才会生效。',
+      aiSearch: 'AI 联想搜索',
+      aiDesc: '没有直接匹配时，用你配置的模型（OpenAI 兼容或 Anthropic）理解目标并推荐设置项。',
+      aiPrivacy: 'AI 请求会发送到你配置的模型服务；API Key 仅保存在本机浏览器。',
+      aiOn: '已开启',
+      aiOff: '已关闭',
+      aiThinking: '正在用 AI 理解搜索意图…',
+      aiUnavailable: 'AI 联想暂不可用',
+      aiNeedConfig: '请先在「设置搜索」页配置 Base URL、模型名与 API Key。',
+      aiProvider: '接口类型',
+      aiOpenAI: 'OpenAI 兼容',
+      aiAnthropic: 'Anthropic',
+      aiBaseUrl: 'Base URL',
+      aiModel: '模型名',
+      aiApiKey: 'API Key',
+      aiConfigSave: '保存配置',
+      aiConfigSaved: '已保存 ✓',
+      logTitle: '日志',
+      logDesc: '记录插件运行、搜索与 AI 请求的关键动作，便于排查问题。',
+      logEmpty: '暂无日志',
+      logExport: '导出日志',
+      logCopy: '复制日志',
+      logCopied: '已复制 ✓',
+      logCopyFail: '复制失败，请稍后重试。',
+      logClear: '清空日志',
+      logCleared: '已清空',
+      logExportFail: '导出失败，请重试。',
     }
     const en = {
       title: 'Settings',
@@ -77,6 +107,36 @@ window.__ModuleLoader__.load({
       updCopy: 'Copy command',
       updCopied: 'Copied ✓',
       updCopyFail: 'Copy failed — please long-press the command above.',
+      updCLI: 'DSH CLI',
+      updNpx: 'npx',
+      updRelease: 'View release notes',
+      updRestart: 'Restart DSH after updating for the new version to take effect.',
+      aiSearch: 'AI-assisted search',
+      aiDesc: 'When no direct match exists, your own model (OpenAI-compatible or Anthropic) understands your goal and suggests settings.',
+      aiPrivacy: 'AI requests are sent to the model service you configure; the API key stays only in your browser.',
+      aiOn: 'On',
+      aiOff: 'Off',
+      aiThinking: 'Understanding your intent with AI…',
+      aiUnavailable: 'AI suggestions are unavailable',
+      aiNeedConfig: 'Configure Base URL, model, and API key in the Settings Search panel first.',
+      aiProvider: 'API type',
+      aiOpenAI: 'OpenAI-compatible',
+      aiAnthropic: 'Anthropic',
+      aiBaseUrl: 'Base URL',
+      aiModel: 'Model',
+      aiApiKey: 'API Key',
+      aiConfigSave: 'Save config',
+      aiConfigSaved: 'Saved ✓',
+      logTitle: 'Logs',
+      logDesc: 'Logs key plugin actions, searches, and AI requests to help troubleshoot.',
+      logEmpty: 'No logs yet',
+      logExport: 'Export logs',
+      logCopy: 'Copy logs',
+      logCopied: 'Copied ✓',
+      logCopyFail: 'Copy failed. Please try again.',
+      logClear: 'Clear logs',
+      logCleared: 'Cleared',
+      logExportFail: 'Export failed. Please try again.',
     }
 
     /** Inner-row slots that represent specific options inside one page. */
@@ -223,6 +283,162 @@ window.__ModuleLoader__.load({
       return hits
     }
 
+    const AI_TOGGLE_EVENT = 'dsh-settings-search:ai-toggle'
+    const AI_CONFIG_EVENT = 'dsh-settings-search:ai-config'
+    /** Simple in-memory log ring used by the settings panel's export/log UI. */
+    const LOG_EVENT = 'dsh-settings-search:log'
+    const LOG_MAX = 500
+    const LOGS = []
+    const log = (level, msg, meta) => {
+      if (typeof window === 'undefined') return
+      LOGS.push({ time: new Date().toISOString(), level, msg, meta })
+      if (LOGS.length > LOG_MAX) LOGS.splice(0, LOGS.length - LOG_MAX)
+      try { window.dispatchEvent(new CustomEvent(LOG_EVENT, { detail: LOGS.length })) } catch {}
+    }
+    const formatLogs = (logs) => {
+      const lines = [
+        'dsh-settings-search log',
+        `version: ${PKG_VERSION}`,
+        `exported: ${new Date().toISOString()}`,
+        `count: ${logs.length}`,
+        '',
+      ]
+      for (const entry of logs) {
+        lines.push(`[${entry.time}] [${entry.level}] ${entry.msg}${entry.meta ? ' ' + JSON.stringify(entry.meta) : ''}`)
+      }
+      return lines.join('\n')
+    }
+    const AI_CACHE = new Map()
+    const AI_STORAGE_KEY = 'dsh-settings-search:ai-enabled'
+    const AI_PROVIDER_KEY = 'dsh-settings-search:ai-provider'
+    const AI_BASE_URL_KEY = 'dsh-settings-search:ai-base-url'
+    const AI_MODEL_KEY = 'dsh-settings-search:ai-model'
+    const AI_API_KEY_KEY = 'dsh-settings-search:ai-api-key'
+    const aiSearchEnabled = () => {
+      if (typeof localStorage === 'undefined') return false
+      return localStorage.getItem(AI_STORAGE_KEY) === '1'
+    }
+    const setAiSearchEnabled = (enabled) => {
+      if (typeof localStorage === 'undefined') return
+      localStorage.setItem(AI_STORAGE_KEY, enabled ? '1' : '0')
+      window.dispatchEvent(new CustomEvent(AI_TOGGLE_EVENT, { detail: enabled }))
+    }
+    const aiConfig = () => {
+      if (typeof localStorage === 'undefined') return { provider: 'openai', baseUrl: '', model: '', apiKey: '' }
+      const providerRaw = (localStorage.getItem(AI_PROVIDER_KEY) ?? 'openai').trim()
+      return {
+        provider: providerRaw === 'anthropic' ? 'anthropic' : 'openai',
+        baseUrl: (localStorage.getItem(AI_BASE_URL_KEY) ?? '').trim(),
+        model: (localStorage.getItem(AI_MODEL_KEY) ?? '').trim(),
+        apiKey: (localStorage.getItem(AI_API_KEY_KEY) ?? '').trim(),
+      }
+    }
+    const setAiConfig = (cfg) => {
+      if (typeof localStorage === 'undefined') return
+      localStorage.setItem(AI_PROVIDER_KEY, cfg.provider === 'anthropic' ? 'anthropic' : 'openai')
+      localStorage.setItem(AI_BASE_URL_KEY, cfg.baseUrl ?? '')
+      localStorage.setItem(AI_MODEL_KEY, cfg.model ?? '')
+      localStorage.setItem(AI_API_KEY_KEY, cfg.apiKey ?? '')
+      window.dispatchEvent(new CustomEvent(AI_CONFIG_EVENT))
+    }
+    const extractAiKeywords = (raw) => {
+      const text = String(raw ?? '').replace(/^```(?:json)?/i, '').replace(/```$/, '').trim()
+      const start = text.indexOf('{')
+      const end = text.lastIndexOf('}')
+      if (start === -1 || end <= start) return []
+      const parsed = JSON.parse(text.slice(start, end + 1))
+      const values = Array.isArray(parsed) ? parsed : parsed?.keywords
+      if (!Array.isArray(values)) return []
+      return [...new Set(values
+        .filter((value) => typeof value === 'string')
+        .map((value) => value.trim().slice(0, 24))
+        .filter(Boolean))]
+        .slice(0, 6)
+    }
+    const AI_PROMPT = '你是设置搜索助手。只输出 JSON 对象，格式为 {"keywords":["..."]}。keywords 最多 6 个，每个最多 12 个字符，只能从用户提供的设置索引中选择或提取核心词，不要解释。'
+    const chatCompletionsUrl = (baseUrl) => {
+      const trimmed = String(baseUrl).trim().replace(/\/+$/, '')
+      return /\/chat\/completions$/i.test(trimmed) ? trimmed : `${trimmed}/chat/completions`
+    }
+    const anthropicMessagesUrl = (baseUrl) => {
+      const trimmed = String(baseUrl).trim().replace(/\/+$/, '')
+      if (/\/v1\/messages$/i.test(trimmed)) return trimmed
+      return /\/v1$/i.test(trimmed) ? `${trimmed}/messages` : `${trimmed}/v1/messages`
+    }
+    const requestUserAi = async (query, labels, signal) => {
+      const { provider, baseUrl, model, apiKey } = aiConfig()
+      if (!baseUrl || !model || !apiKey) return []
+      const isAnthropic = provider === 'anthropic'
+      const startedAt = Date.now()
+      log('info', 'AI 请求', { provider, model, query: String(query).slice(0, 50) })
+      let timer
+      const deadline = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+          const error = new Error('AI request timed out')
+          error.name = 'AI_TIMEOUT'
+          reject(error)
+        }, 12000)
+      })
+      const work = (async () => {
+        const userContent = `用户目标：${query}\n设置索引：\n${labels}`
+        const headers = {
+          'content-type': 'application/json',
+          ...(isAnthropic
+            ? { 'x-api-key': apiKey, 'anthropic-version': '2023-06-01', 'anthropic-dangerous-direct-browser-access': 'true' }
+            : { authorization: `Bearer ${apiKey}` }),
+        }
+        const body = isAnthropic
+          ? {
+              model,
+              max_tokens: 1024,
+              system: AI_PROMPT,
+              messages: [{ role: 'user', content: userContent }],
+              temperature: 0,
+            }
+          : {
+              model,
+              messages: [
+                { role: 'system', content: AI_PROMPT },
+                { role: 'user', content: userContent },
+              ],
+              temperature: 0,
+            }
+        const response = await fetch(isAnthropic ? anthropicMessagesUrl(baseUrl) : chatCompletionsUrl(baseUrl), {
+          method: 'POST',
+          headers,
+          signal,
+          body: JSON.stringify(body),
+        })
+        if (!response.ok) throw new Error(`HTTP ${response.status}`)
+        const data = await response.json()
+        const content = isAnthropic
+          ? (data?.content ?? []).filter((block) => block?.type === 'text').map((block) => block.text).join('')
+          : data?.choices?.[0]?.message?.content ?? ''
+        return extractAiKeywords(content)
+      })()
+      try {
+        const keywords = await Promise.race([work, deadline])
+        log('info', 'AI 结果', { count: keywords.length, duration: Date.now() - startedAt })
+        return keywords
+      } catch (error) {
+        if (error.name === 'AbortError') {
+          log('warn', 'AI 请求取消', { duration: Date.now() - startedAt })
+          throw error
+        }
+        log('error', 'AI 请求失败', { message: String(error?.message ?? error).slice(0, 160), duration: Date.now() - startedAt })
+        throw error
+      } finally {
+        clearTimeout(timer)
+      }
+    }
+    const requestAiKeywords = async (query, labels, signal) => {
+      const cacheKey = query.toLowerCase()
+      if (AI_CACHE.has(cacheKey)) return AI_CACHE.get(cacheKey)
+      const keywords = await requestUserAi(query, labels, signal)
+      if (keywords.length > 0) AI_CACHE.set(cacheKey, keywords)
+      return keywords
+    }
+
     const CSS = `
       .sss-wrap { position: relative; display: flex; flex-direction: column; gap: 8px; }
       .sss-title { font-size: 16px; font-weight: 600; line-height: 24px; color: var(--dsw-alias-label-primary); }
@@ -245,23 +461,54 @@ window.__ModuleLoader__.load({
       .sss-item-path { font-size: 10px; line-height: 14px; color: var(--dsw-alias-label-secondary); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
       .sss-item-kind { flex-shrink: 0; font-size: 10px; color: var(--dsw-alias-label-secondary); border: 1px solid var(--dsw-alias-border-l2); border-radius: 4px; padding: 1px 5px; }
       .sss-item-kind.sss-via { color: var(--dsw-alias-label-primary); background: var(--dsw-alias-interactive-bg-hover); }
+      .sss-ai-note { margin: 0; padding: 6px 8px; color: var(--dsw-alias-label-secondary); font-size: 12px; line-height: 18px; }
       .sss-empty { margin: 0; padding: 10px 8px; color: var(--dsw-alias-label-secondary); font-size: 13px; }
       .sss-guide { padding: 7px 10px; border-radius: 8px; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l1); color: var(--dsw-alias-label-primary); font-size: 12px; line-height: 18px; }
       @keyframes sssFlashBg { 0% { background-color: var(--dsw-alias-interactive-bg-hover); } 100% { background-color: transparent; } }
       .sss-flash { animation: sssFlashBg 1.8s ease-out; border-radius: 8px; }
-      .sss-upd { display: flex; flex-direction: column; gap: 12px; padding: 16px; max-width: 560px; }
-      .sss-upd-title { font-size: 15px; font-weight: 600; line-height: 22px; color: var(--dsw-alias-label-primary); margin: 0; }
-      .sss-upd-desc { margin: 0; font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-secondary); }
-      .sss-upd-card { display: flex; flex-direction: column; gap: 10px; padding: 14px; border: 1px solid var(--dsw-alias-border-l2); border-radius: 10px; background: var(--dsw-alias-bg-layer-1); }
-      .sss-upd-row { display: flex; align-items: center; gap: 8px; font-size: 13px; line-height: 20px; }
-      .sss-upd-key { flex-shrink: 0; width: 88px; color: var(--dsw-alias-label-secondary); }
-      .sss-upd-val { color: var(--dsw-alias-label-primary); }
-      .sss-upd-badge { flex-shrink: 0; padding: 1px 7px; border-radius: 999px; border: 1px solid var(--dsw-alias-border-l2); background: var(--dsw-alias-bg-layer-1); color: var(--dsw-alias-label-secondary); font-size: 11px; line-height: 18px; }
-      .sss-btn { height: 28px; padding: 0 12px; border-radius: 7px; border: 1px solid var(--dsw-alias-border-l2); background: var(--dsw-alias-bg-layer-1); color: var(--dsw-alias-label-primary); font-size: 12px; cursor: pointer; }
-      .sss-btn:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover); }
-      .sss-btn:disabled { opacity: .55; cursor: default; }
-      .sss-cmd { user-select: all; font-family: ui-monospace, Consolas, 'Courier New', monospace; font-size: 11.5px; line-height: 20px; color: var(--dsw-alias-label-primary); background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l2); border-radius: 6px; padding: 4px 8px; word-break: break-all; }
-      .sss-upd-note { margin: 0; font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-secondary); }
+      .sss-vr { list-style: none; border: 1px solid var(--dsw-alias-border-l2); background: var(--dsw-alias-bg-layer-3); border-radius: 12px; max-width: 780px; width: 100%; box-sizing: border-box; transition: border-color .16s, background .16s; }
+      .sss-vr:hover { border-color: var(--dsw-alias-label-dimmed); }
+      .sss-vr-open { background: var(--dsw-alias-bg-layer-2); border-color: var(--dsw-alias-label-dimmed); }
+      .sss-vr-header { appearance: none; width: 100%; font: inherit; color: inherit; text-align: left; cursor: pointer; background: 0 0; border: 0; border-radius: 12px; align-items: center; gap: 12px; padding: 14px 16px; display: flex; }
+      .sss-vr-header:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: -2px; }
+      .sss-vr-headText { flex-direction: column; flex: 1; gap: 4px; min-width: 0; display: flex; }
+      .sss-vr-name { color: var(--dsw-alias-label-primary); font-size: 15px; font-weight: 600; line-height: 1.4; }
+      .sss-vr-desc { color: var(--dsw-alias-label-tertiary); font-size: 13px; line-height: 1.5; }
+      .sss-vr-chevron { color: var(--dsw-alias-label-tertiary); flex: none; transition: transform .16s; font-size: 12px; line-height: 1; }
+      .sss-vr-chevron-open { transform: rotate(180deg); }
+      .sss-vr-body { border-top: 1px solid var(--dsw-alias-border-l2); margin: 0 16px; padding-bottom: 8px; }
+      .sss-vr-field { content-visibility: auto; contain-intrinsic-size: auto 96px; flex-direction: column; gap: 6px; padding: 12px 0; display: flex; }
+      .sss-vr-field + .sss-vr-field { border-top: 1px solid var(--dsw-alias-border-l2); }
+      .sss-vr-form { gap: 6px; }
+      .sss-vr-field-head { align-items: center; gap: 8px; display: flex; }
+      .sss-vr-label { min-width: 0; color: var(--dsw-alias-label-primary); flex: 1; font-size: 13px; font-weight: 500; line-height: 1.5; }
+      .sss-vr-hint { color: var(--dsw-alias-label-tertiary); margin: 0; font-size: 12px; line-height: 1.5; }
+      .sss-vr-value { color: var(--dsw-alias-label-primary); font-size: 13px; font-weight: 500; line-height: 1.5; }
+      .sss-vr-input { border: 1px solid var(--dsw-alias-border-l2); background: var(--dsw-alias-bg-layer-3); min-height: 34px; font: inherit; color: var(--dsw-alias-label-primary); border-radius: 8px; padding: 6px 12px; font-size: 13px; line-height: 1.5; width: 100%; box-sizing: border-box; }
+      .sss-vr-input:focus-visible { border-color: var(--dsw-alias-brand-primary); outline: none; }
+      .sss-vr-input::placeholder { color: var(--dsw-alias-label-dimmed); }
+      .sss-vr-select { cursor: pointer; }
+      .sss-vr-check { width: 16px; height: 16px; accent-color: var(--dsw-alias-brand-primary); cursor: pointer; margin: 0; }
+      .sss-vr-btn { appearance: none; font: inherit; cursor: pointer; border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; padding: 5px 14px; font-size: 13px; line-height: 1.5; color: var(--dsw-alias-label-secondary); background: 0 0; }
+      .sss-vr-btn:hover:not(:disabled) { color: var(--dsw-alias-label-primary); border-color: var(--dsw-alias-label-dimmed); }
+      .sss-vr-btn:disabled { opacity: .4; cursor: default; }
+      .sss-vr-btn:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 1px; }
+      .sss-vr-primary { background: var(--dsw-alias-label-primary); color: var(--dsw-alias-bg-layer-3); border-color: transparent; }
+      .sss-vr-primary:hover:not(:disabled) { color: var(--dsw-alias-bg-layer-3); border-color: transparent; }
+      .sss-vr-badge { white-space: nowrap; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-secondary); border-radius: 999px; padding: 1px 8px; font-size: 11px; font-weight: 500; line-height: 17px; }
+      .sss-vr-code { user-select: all; display: block; width: 100%; box-sizing: border-box; overflow-x: auto; white-space: pre; padding: 9px 11px; border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; background: var(--dsw-alias-bg-layer-3); color: var(--dsw-alias-label-primary); font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; font-size: 12px; line-height: 1.55; }
+      .sss-vr-note { color: var(--dsw-alias-label-tertiary); margin: 0; font-size: 12px; line-height: 1.5; }
+      .sss-vr-row { display: flex; align-items: center; gap: 8px; font-size: 13px; line-height: 20px; flex-wrap: wrap; }
+      .sss-vr-rowname { color: var(--dsw-alias-label-tertiary); font-size: 13px; line-height: 1.5; }
+      .sss-vr-actions { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; padding-top: 1px; }
+      .sss-vr-update { width: 100%; box-sizing: border-box; border: 1px solid var(--dsw-alias-border-l2); border-radius: 10px; background: var(--dsw-alias-bg-module-platform); padding: 12px 14px; display: flex; flex-direction: column; gap: 10px; margin-top: 6px; }
+      .sss-vr-update-title { font-size: 13px; font-weight: 650; color: var(--dsw-alias-label-primary); line-height: 1.5; }
+      .sss-vr-update-command { display: flex; flex-direction: column; gap: 5px; min-width: 0; }
+      .sss-vr-update-command-label { font-size: 11px; font-weight: 500; color: var(--dsw-alias-label-tertiary); line-height: 1.4; }
+      .sss-vr-update-note { margin: 0; padding: 7px 9px; border-left: 2px solid var(--dsw-alias-label-dimmed); background: var(--dsw-alias-bg-layer-3); border-radius: 0 7px 7px 0; color: var(--dsw-alias-label-tertiary); font-size: 11px; line-height: 1.55; }
+      .sss-vr-update-actions { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; padding-top: 1px; }
+      .sss-vr-link { appearance: none; font: inherit; cursor: pointer; border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; padding: 5px 14px; font-size: 13px; line-height: 1.5; color: var(--dsw-alias-label-secondary); background: 0 0; text-decoration: none; display: inline-flex; align-items: center; }
+      .sss-vr-link:hover { color: var(--dsw-alias-label-primary); border-color: var(--dsw-alias-label-dimmed); }
     `
     let stylesInstalled = false
     function installStyles() {
@@ -504,6 +751,7 @@ window.__ModuleLoader__.load({
     }
 
     function apply(ctx) {
+      log('info', '应用装载', { version: PKG_VERSION })
       ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'settings-search: dictionaries')
       const t = ctx.locale.bind(NS)
       ctx.effect(() => {
@@ -538,6 +786,10 @@ window.__ModuleLoader__.load({
         const [tick, setTick] = React.useState(0)
         const [, forceTick] = React.useReducer((x) => x + 1, 0)
         void tick
+        const [aiEnabled, setAiEnabled] = React.useState(aiSearchEnabled)
+        const [aiKeywords, setAiKeywords] = React.useState([])
+        const [aiStatus, setAiStatus] = React.useState('idle')
+        const aiAbortRef = React.useRef(null)
 
         React.useEffect(() => {
           const watched = ['settings.section', ...DEEP_SLOTS.map((c) => c.slot)]
@@ -560,6 +812,18 @@ window.__ModuleLoader__.load({
           }
         }, [])
 
+        React.useEffect(() => {
+          const sync = () => setAiEnabled(aiSearchEnabled())
+          const onConfig = () => forceTick()
+          window.addEventListener(AI_TOGGLE_EVENT, sync)
+          window.addEventListener(AI_CONFIG_EVENT, onConfig)
+          return () => {
+            window.removeEventListener(AI_TOGGLE_EVENT, sync)
+            window.removeEventListener(AI_CONFIG_EVENT, onConfig)
+            aiAbortRef.current?.abort()
+          }
+        }, [])
+
         const q = query.trim().toLowerCase()
         const tokens = q.split(/\s+/).filter(Boolean)
 
@@ -584,6 +848,9 @@ window.__ModuleLoader__.load({
               if (kwMatch(item, haystackLower, kw)) return kw
             }
           }
+          for (const kw of aiKeywords) {
+            if (kwMatch(item, haystackLower, kw)) return `AI · ${kw}`
+          }
           return null
         }
         const mappedSections = q === '' ? [] : sections.map((s) => ({
@@ -598,6 +865,8 @@ window.__ModuleLoader__.load({
         }))
         const shownPages = mappedSections.filter((s) => directMatch(s, s.hay))
         const shownOptions = mappedOptions.filter((o) => directMatch(o, o.hay))
+        const noLocalMatch = shownPages.length === 0 && shownOptions.length === 0 &&
+          tokens.every((tok) => (expandedKeywords.get(tok) ?? []).length === 0)
         const related = [
           ...mappedSections
             .map((s) => ({ item: s, kind: 'page', via: relatedKeyword(s, s.hay) }))
@@ -609,6 +878,50 @@ window.__ModuleLoader__.load({
         const none = q !== '' && shownPages.length === 0 && shownOptions.length === 0 && related.length === 0
         const results = [...shownPages, ...shownOptions, ...related.map((r) => r.item)]
 
+        const cfg = aiConfig()
+        const aiConfigured = Boolean(cfg.baseUrl && cfg.model && cfg.apiKey)
+        const aiReady = aiEnabled && aiConfigured && q.length >= 2 && noLocalMatch
+        React.useEffect(() => {
+          if (!aiReady) return
+          setAiKeywords([])
+          setAiStatus('idle')
+          let alive = true
+          const controller = new AbortController()
+          const timer = setTimeout(() => {
+            aiAbortRef.current?.abort()
+            aiAbortRef.current = controller
+            setAiStatus('loading')
+            const labels = [...new Set([
+              ...sections.map((item) => item.label),
+              ...deeps.map((item) => `${item.parentLabel} ${item.label}`),
+            ].map((label) => label.trim()).filter(Boolean))].slice(0, 48).join('\n')
+            requestAiKeywords(q, labels, controller.signal).then((keywords) => {
+              if (!alive) return
+              setAiKeywords(keywords)
+              setAiStatus(keywords.length > 0 ? 'ready' : 'idle')
+            }).catch((error) => {
+              if (!alive || error.name === 'AbortError') return
+              setAiKeywords([])
+              setAiStatus('error')
+            }).finally(() => {
+              if (aiAbortRef.current === controller) aiAbortRef.current = null
+            })
+          }, 700)
+          return () => {
+            alive = false
+            clearTimeout(timer)
+            controller.abort()
+          }
+        }, [aiReady, aiEnabled, q])
+
+        const loggedQueryRef = React.useRef('')
+        React.useEffect(() => {
+          if (q === '') return
+          if (loggedQueryRef.current === q) return
+          loggedQueryRef.current = q
+          log('info', '搜索', { query: query.slice(0, 50), pages: shownPages.length, options: shownOptions.length, related: related.length })
+        }, [q, shownPages.length, shownOptions.length, related.length])
+
         const [hint, setHint] = React.useState(null)
         const [active, setActive] = React.useState(0)
         const popRef = React.useRef(null)
@@ -621,6 +934,7 @@ window.__ModuleLoader__.load({
         }, [activeIndex, q])
         const pick = (item) => {
           setOpen(false)
+          log('info', '打开设置', { kind: item.kind, id: item.id || item.key || '', label: String(item.label).slice(0, 60) })
           const jumped = item.kind === 'page'
             ? navigator.jumpToPage(item)
             : navigator.jumpToOption(item)
@@ -726,7 +1040,13 @@ window.__ModuleLoader__.load({
           ]),
           open && q !== '' ? React.createElement('div', { className: 'sss-pop', ref: popRef }, [
             none
-              ? React.createElement('p', { className: 'sss-empty' }, t('empty'))
+              ? (aiStatus === 'loading'
+                  ? React.createElement('p', { className: 'sss-ai-note' }, t('aiThinking'))
+                  : aiStatus === 'error'
+                    ? React.createElement('p', { className: 'sss-ai-note' }, t('aiUnavailable'))
+                    : (aiEnabled && !aiConfigured)
+                      ? React.createElement('p', { className: 'sss-ai-note' }, t('aiNeedConfig'))
+                      : React.createElement('p', { className: 'sss-empty' }, t('empty')))
               : React.createElement('div', { className: 'sss-groups' }, [
                   shownPages.length > 0 ? React.createElement('div', { className: 'sss-group' }, [
                     React.createElement('div', { className: 'sss-group-title' }, t('pages')),
@@ -763,10 +1083,29 @@ window.__ModuleLoader__.load({
       }
 
       function UpdatePanel() {
+        const [open, setOpen] = React.useState(true)
         const [state, setState] = React.useState('idle') // idle | loading | newest | outdated | error
         const [latest, setLatest] = React.useState('')
         const [copied, setCopied] = React.useState(false)
         const [copyFailed, setCopyFailed] = React.useState(false)
+        const [aiOn, setAiOn] = React.useState(aiSearchEnabled)
+        const cfg = aiConfig()
+        const [provider, setProvider] = React.useState(cfg.provider)
+        const [baseUrl, setBaseUrl] = React.useState(cfg.baseUrl)
+        const [model, setModel] = React.useState(cfg.model)
+        const [apiKey, setApiKey] = React.useState(cfg.apiKey)
+        const [aiSaved, setAiSaved] = React.useState(false)
+        const [, setLogVersion] = React.useState(0)
+        const [logCopied, setLogCopied] = React.useState(false)
+        const [logCopyFail, setLogCopyFail] = React.useState(false)
+        const [logExportFail, setLogExportFail] = React.useState(false)
+        const [logCleared, setLogCleared] = React.useState(false)
+
+        React.useEffect(() => {
+          const sync = () => setAiOn(aiSearchEnabled())
+          window.addEventListener(AI_TOGGLE_EVENT, sync)
+          return () => window.removeEventListener(AI_TOGGLE_EVENT, sync)
+        }, [])
 
         React.useEffect(() => {
           if (!copied) return
@@ -774,6 +1113,80 @@ window.__ModuleLoader__.load({
           return () => clearTimeout(off)
         }, [copied])
 
+        React.useEffect(() => {
+          if (!aiSaved) return
+          const off = setTimeout(() => setAiSaved(false), 1600)
+          return () => clearTimeout(off)
+        }, [aiSaved])
+
+        React.useEffect(() => {
+          const sync = () => setLogVersion((v) => v + 1)
+          window.addEventListener(LOG_EVENT, sync)
+          return () => window.removeEventListener(LOG_EVENT, sync)
+        }, [])
+
+        React.useEffect(() => {
+          if (!logCopied) return
+          const off = setTimeout(() => setLogCopied(false), 1600)
+          return () => clearTimeout(off)
+        }, [logCopied])
+
+        React.useEffect(() => {
+          if (!logCleared) return
+          const off = setTimeout(() => setLogCleared(false), 1600)
+          return () => clearTimeout(off)
+        }, [logCleared])
+
+        React.useEffect(() => {
+          if (!logExportFail) return
+          const off = setTimeout(() => setLogExportFail(false), 1600)
+          return () => clearTimeout(off)
+        }, [logExportFail])
+
+        const saveAi = () => {
+          setAiConfig({
+            provider,
+            baseUrl: baseUrl.trim(),
+            model: model.trim(),
+            apiKey: apiKey.trim(),
+          })
+          setAiSaved(true)
+          log('info', '保存 AI 配置', { provider, model: model.trim() })
+        }
+
+        const exportLogs = () => {
+          setLogExportFail(false)
+          try {
+            const blob = new Blob([formatLogs(LOGS)], { type: 'text/plain;charset=utf-8' })
+            const url = URL.createObjectURL(blob)
+            const a = document.createElement('a')
+            a.href = url
+            a.download = `dsh-settings-search-${Date.now()}.log`
+            document.body.appendChild(a)
+            a.click()
+            a.remove()
+            URL.revokeObjectURL(url)
+          } catch {
+            setLogExportFail(true)
+          }
+        }
+
+        const copyLogs = async () => {
+          try {
+            await navigator.clipboard.writeText(formatLogs(LOGS))
+            setLogCopied(true)
+            setLogCopyFail(false)
+          } catch {
+            setLogCopyFail(true)
+          }
+        }
+
+        const clearLogs = () => {
+          LOGS.length = 0
+          setLogVersion((v) => v + 1)
+          setLogCleared(true)
+        }
+
         const check = async () => {
           setState('loading')
           setCopied(false)
@@ -785,54 +1198,164 @@ window.__ModuleLoader__.load({
             const ver = typeof data?.version === 'string' ? data.version : ''
             if (ver === '') throw new Error('no version in registry response')
             setLatest(ver)
-            setState(compareSemver(ver, PKG_VERSION) > 0 ? 'outdated' : 'newest')
+            const newer = compareSemver(ver, PKG_VERSION) > 0
+            setState(newer ? 'outdated' : 'newest')
+            log('info', '检查更新', { result: newer ? 'outdated' : 'newest', latest: ver })
           } catch {
             setState('error')
+            log('error', '检查更新失败', {})
           }
         }
 
+        const updateCommand = latest ? `dsh plugin --profile web add ${NPM_NAME}@${latest}` : ''
+        const npxUpdateCommand = latest ? `npx @deepseek-ai/dsh plugin --profile web add ${NPM_NAME}@${latest}` : ''
+        const releasesUrl = latest
+          ? `https://github.com/objectivex666/dsh-settings-search/releases/tag/v${latest}`
+          : 'https://github.com/objectivex666/dsh-settings-search/releases/latest'
+        const commandBlock = (label, command) => React.createElement('div', { className: 'sss-vr-update-command', key: command }, [
+          React.createElement('div', { className: 'sss-vr-update-command-label' }, label),
+          React.createElement('code', { className: 'sss-vr-code' }, command),
+        ])
         const copyCmd = async () => {
-          const cmd = `dsh plugin --profile web update ${NPM_NAME}`
-          try { await navigator.clipboard.writeText(cmd); setCopied(true); setCopyFailed(false) } catch { setCopyFailed(true) }
+          try { await navigator.clipboard.writeText(updateCommand); setCopied(true); setCopyFailed(false) } catch { setCopyFailed(true) }
         }
 
-        const statusNode = {
-          idle: React.createElement('span', { className: 'sss-upd-val' }, '—'),
-          loading: React.createElement('span', { className: 'sss-upd-val' }, t('updChecking')),
-          newest: React.createElement('span', { className: 'sss-upd-val' }, t('updNewest')),
-          error: React.createElement('span', { className: 'sss-upd-val' }, t('updErr')),
-          outdated: latest === '' ? null : React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 8 } }, [
-            React.createElement('p', { className: 'sss-upd-note' }, t('updFound').replace('{ver}', `v${latest}`)),
-            React.createElement('code', { className: 'sss-cmd' }, `dsh plugin --profile web update ${NPM_NAME}`),
-            React.createElement('div', null,
-              React.createElement('button', { className: 'sss-btn', type: 'button', onClick: () => { void copyCmd() } },
-                copied ? t('updCopied') : t('updCopy')),
-            copyFailed ? React.createElement('p', { className: 'sss-upd-note', style: { color: 'var(--dsw-alias-label-danger)' } }, t('updCopyFail')) : null),
-          ]),
-        }
+        // Mirror Vision Router: check for updates automatically when the panel opens.
+        React.useEffect(() => {
+          if (state === 'idle') void check()
+        }, [state]) // eslint-disable-line react-hooks/exhaustive-deps
 
-        return React.createElement('div', { className: 'sss-upd' }, [
-          React.createElement('h3', { className: 'sss-upd-title' }, `${t('updn')} v${PKG_VERSION}`),
-          React.createElement('p', { className: 'sss-upd-desc' }, t('updDesc')),
-          React.createElement('div', { className: 'sss-upd-card' }, [
-            React.createElement('div', { className: 'sss-upd-row' }, [
-              React.createElement('span', { className: 'sss-upd-key' }, t('updCurrent')),
-              React.createElement('code', { className: 'sss-cmd' }, PKG_VERSION),
-              state === 'newest' ? React.createElement('span', { className: 'sss-upd-badge' }, 'npm ✓') : null,
+        return React.createElement('div', { className: 'sss-vr' + (open ? ' sss-vr-open' : '') }, [
+          React.createElement('button', {
+            type: 'button',
+            className: 'sss-vr-header',
+            'aria-expanded': open,
+            onClick: () => setOpen(!open),
+          }, [
+            React.createElement('span', { className: 'sss-vr-headText' }, [
+              React.createElement('span', { className: 'sss-vr-name' }, t('updn')),
+              React.createElement('span', { className: 'sss-vr-desc' }, t('updDesc')),
             ]),
-            state === 'outdated' || state === 'loading'
-              ? React.createElement('div', { className: 'sss-upd-row' }, [
-                  React.createElement('span', { className: 'sss-upd-key' }, t('updLatestKnown')),
-                  state === 'loading' ? React.createElement('span', { className: 'sss-upd-val' }, '…') : React.createElement('code', { className: 'sss-cmd' }, latest),
-                ])
-              : null,
-            state === 'outdated' || state === 'loading' || state === 'error' || state === 'idle' || state === 'newest'
-              ? (state === 'outdated' ? statusNode.outdated : statusNode[state])
-              : null,
-            React.createElement('div', { className: 'sss-upd-row' },
-              React.createElement('button', { className: 'sss-btn', type: 'button', disabled: state === 'loading', onClick: () => { void check() } },
-                state === 'loading' ? t('updChecking') : t('updCheck'))),
+            React.createElement('span', { className: 'sss-vr-chevron' + (open ? ' sss-vr-chevron-open' : '') }, '▾'),
           ]),
+          open ? React.createElement('div', { className: 'sss-vr-body' }, [
+            React.createElement('div', { className: 'sss-vr-field' }, [
+              React.createElement('div', { className: 'sss-vr-field-head' }, [
+                React.createElement('span', { className: 'sss-vr-label' }, t('aiSearch')),
+                React.createElement('input', {
+                  className: 'sss-vr-check',
+                  type: 'checkbox',
+                  checked: aiOn,
+                  onChange: (event) => {
+                    const next = event.target.checked
+                    setAiSearchEnabled(next)
+                    setAiOn(next)
+                  },
+                }),
+              ]),
+              React.createElement('p', { className: 'sss-vr-hint' }, t('aiDesc')),
+              React.createElement('p', { className: 'sss-vr-hint' }, t('aiPrivacy')),
+            ]),
+            React.createElement('div', { className: 'sss-vr-field sss-vr-form' }, [
+              React.createElement('div', { className: 'sss-vr-field-head' }, [
+                React.createElement('label', { className: 'sss-vr-label' }, t('aiProvider')),
+              ]),
+              React.createElement('select', {
+                className: 'sss-vr-input sss-vr-select',
+                value: provider,
+                onChange: (event) => setProvider(event.target.value),
+              }, [
+                React.createElement('option', { value: 'openai' }, t('aiOpenAI')),
+                React.createElement('option', { value: 'anthropic' }, t('aiAnthropic')),
+              ]),
+              React.createElement('div', { className: 'sss-vr-field-head' }, [
+                React.createElement('label', { className: 'sss-vr-label' }, t('aiBaseUrl')),
+              ]),
+              React.createElement('input', {
+                className: 'sss-vr-input',
+                type: 'url',
+                value: baseUrl,
+                placeholder: provider === 'anthropic' ? 'https://api.anthropic.com' : 'https://api.openai.com/v1',
+                spellCheck: false,
+                onChange: (event) => setBaseUrl(event.target.value),
+              }),
+              React.createElement('div', { className: 'sss-vr-field-head' }, [
+                React.createElement('label', { className: 'sss-vr-label' }, t('aiModel')),
+              ]),
+              React.createElement('input', {
+                className: 'sss-vr-input',
+                type: 'text',
+                value: model,
+                placeholder: provider === 'anthropic' ? 'claude-sonnet-4-20250514' : 'gpt-4o-mini',
+                spellCheck: false,
+                onChange: (event) => setModel(event.target.value),
+              }),
+              React.createElement('div', { className: 'sss-vr-field-head' }, [
+                React.createElement('label', { className: 'sss-vr-label' }, t('aiApiKey')),
+              ]),
+              React.createElement('input', {
+                className: 'sss-vr-input',
+                type: 'password',
+                value: apiKey,
+                placeholder: 'sk-…',
+                spellCheck: false,
+                autoComplete: 'off',
+                onChange: (event) => setApiKey(event.target.value),
+              }),
+              React.createElement('div', { className: 'sss-vr-actions' },
+                React.createElement('button', { className: 'sss-vr-btn sss-vr-primary', type: 'button', onClick: () => { void saveAi() } },
+                  aiSaved ? t('aiConfigSaved') : t('aiConfigSave'))),
+            ]),
+            React.createElement('div', { className: 'sss-vr-field' }, [
+              React.createElement('div', { className: 'sss-vr-row' }, [
+                React.createElement('span', { className: 'sss-vr-rowname' }, t('updCurrent')),
+                React.createElement('span', { className: 'sss-vr-value' }, PKG_VERSION),
+                state === 'newest' ? React.createElement('span', { className: 'sss-vr-badge' }, 'npm ✓') : null,
+              ]),
+              state === 'loading'
+                ? React.createElement('p', { className: 'sss-vr-note' }, t('updChecking'))
+                : null,
+              state === 'error'
+                ? React.createElement('p', { className: 'sss-vr-note' }, t('updErr'))
+                : null,
+              state === 'outdated'
+                ? React.createElement('div', { className: 'sss-vr-update' }, [
+                    React.createElement('div', { className: 'sss-vr-update-title' }, t('updFound').replace('{ver}', `v${latest}`)),
+                    commandBlock(t('updCLI'), updateCommand),
+                    commandBlock(t('updNpx'), npxUpdateCommand),
+                    React.createElement('p', { className: 'sss-vr-update-note' }, t('updRestart')),
+                    React.createElement('div', { className: 'sss-vr-update-actions' }, [
+                      React.createElement('button', { className: 'sss-vr-btn', type: 'button', onClick: () => { void copyCmd() } },
+                        copied ? t('updCopied') : t('updCopy')),
+                      React.createElement('a', { className: 'sss-vr-link', href: releasesUrl, target: '_blank', rel: 'noopener noreferrer' }, t('updRelease')),
+                    ]),
+                    copyFailed ? React.createElement('p', { className: 'sss-vr-note', style: { color: 'var(--dsw-alias-label-danger)' } }, t('updCopyFail')) : null,
+                  ])
+                : null,
+              React.createElement('div', { className: 'sss-vr-actions' },
+                React.createElement('button', { className: 'sss-vr-btn', type: 'button', disabled: state === 'loading', onClick: () => { void check() } },
+                  state === 'loading' ? t('updChecking') : t('updCheck'))),
+            ]),
+            React.createElement('div', { className: 'sss-vr-field' }, [
+              React.createElement('div', { className: 'sss-vr-field-head' }, [
+                React.createElement('span', { className: 'sss-vr-label' }, t('logTitle')),
+                LOGS.length > 0 ? React.createElement('span', { className: 'sss-vr-badge' }, String(LOGS.length)) : null,
+              ]),
+              React.createElement('p', { className: 'sss-vr-hint' }, t('logDesc')),
+              LOGS.length === 0
+                ? React.createElement('p', { className: 'sss-vr-note' }, t('logEmpty'))
+                : null,
+              React.createElement('div', { className: 'sss-vr-actions' }, [
+                React.createElement('button', { className: 'sss-vr-btn', type: 'button', onClick: () => { void exportLogs() } }, t('logExport')),
+                React.createElement('button', { className: 'sss-vr-btn', type: 'button', onClick: () => { void copyLogs() } },
+                  logCopied ? t('logCopied') : t('logCopy')),
+                React.createElement('button', { className: 'sss-vr-btn', type: 'button', onClick: () => { void clearLogs() } },
+                  logCleared ? t('logCleared') : t('logClear')),
+              ]),
+              logCopyFail ? React.createElement('p', { className: 'sss-vr-note', style: { color: 'var(--dsw-alias-label-danger)' } }, t('logCopyFail')) : null,
+              logExportFail ? React.createElement('p', { className: 'sss-vr-note', style: { color: 'var(--dsw-alias-label-danger)' } }, t('logExportFail')) : null,
+            ]),
+          ]) : null,
         ])
       }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectivex666/dsh-settings-search",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "DSH settings panel search plugin – instantly filter setting sections and general items with navigation guidance. Installable via `dsh plugin add`.",
   "keywords": [
     "dsh",

package/scripts/release.mjs

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * dsh-settings-search release helper.
+ *
+ * Keeps git tags and GitHub Releases in sync on every version bump, with a
+ * bilingual (Chinese / English) body built from CHANGELOG.md + CHANGELOG.en.md.
+ * Always include both "新功能 / Features" and "修复 / Fixes" sections.
+ *
+ * Usage:
+ *   node scripts/release.mjs --version 1.8.0            # validate + print preview
+ *   node scripts/release.mjs --version 1.8.0 --publish  # tag + push + gh release
+ *   node scripts/release.mjs --version 1.8.0 --dry-run  # same as default, explicit
+ *
+ * --publish requires `gh` CLI and a git remote named `origin`.
+ */
+import { readFileSync, writeFileSync, mkdtempSync, rmSync } from 'node:fs'
+import { execFileSync } from 'node:child_process'
+import { resolve, dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { tmpdir } from 'node:os'
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+
+function arg(name) {
+  const at = process.argv.indexOf(name)
+  return at >= 0 ? process.argv[at + 1] : undefined
+}
+
+const version = process.argv.includes('--version') ? arg('--version') : undefined
+const publish = process.argv.includes('--publish')
+const dryRun = process.argv.includes('--dry-run')
+
+const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'))
+const target = version ?? pkg.version
+if (pkg.version !== target) {
+  console.error(`version mismatch: package.json=${pkg.version}, requested=${target}`)
+  process.exit(1)
+}
+const tag = `v${target}`
+const repo = pkg.repository?.url?.replace(/^git\+/, '').replace(/\.git$/, '') ?? 'https://github.com/objectivex666/dsh-settings-search'
+
+function section(file, version) {
+  const text = readFileSync(join(ROOT, file), 'utf8')
+  const target = `## v${version}`
+  const lines = text.split(/\r?\n/)
+  let start = -1
+  for (let i = 0; i < lines.length; i += 1) {
+    if (lines[i].trim() === target) { start = i; break }
+  }
+  if (start === -1) return ''
+  const out = []
+  for (let i = start + 1; i < lines.length; i += 1) {
+    const line = lines[i]
+    if (/^## v/.test(line) || line.trim() === '---') break
+    out.push(line)
+  }
+  return out.join('\n').trim()
+}
+
+const zh = section('CHANGELOG.md', target)
+const en = section('CHANGELOG.en.md', target)
+if (!zh || !en) {
+  console.error(`missing changelog section for v${target} in CHANGELOG.md / CHANGELOG.en.md`)
+  process.exit(1)
+}
+if (!/新功能|修复/.test(zh) || !/Features|Fixes/.test(en)) {
+  console.error('changelog must include both Features and Fixes sections (新功能/修复, Features/Fixes)')
+  process.exit(1)
+}
+
+const body = [
+  `# v${target}`,
+  '',
+  `> ${repo}`,
+  '',
+  zh,
+  '',
+  '---',
+  '',
+  en,
+  '',
+].join('\n')
+
+console.log('===== release body =====')
+console.log(body)
+console.log('========================')
+
+function run(cmd, args) {
+  if (!publish || dryRun) {
+    console.log(`[preview] ${cmd} ${args.join(' ')} (not executed)`)
+    return undefined
+  }
+  console.log(`+ ${cmd} ${args.join(' ')}`)
+  return execFileSync(cmd, args, { cwd: ROOT, stdio: 'inherit' })
+}
+
+let tagExists = false
+try {
+  const out = execFileSync('git', ['tag', '--list', tag], { cwd: ROOT, encoding: 'utf8' })
+  tagExists = out.split('\n').map((line) => line.trim()).includes(tag)
+} catch {}
+if (!tagExists) {
+  run('git', ['tag', tag])
+} else {
+  console.log(`tag ${tag} already exists`)
+}
+
+if (publish && !dryRun) {
+  if (!tagExists) run('git', ['push', 'origin', tag])
+  const notes = join(mkdtempSync(join(tmpdir(), 'sss-release-')), 'notes.md')
+  writeFileSync(notes, body, 'utf8')
+  run('gh', ['release', 'create', tag, '--title', `v${target}`, '--notes-file', notes])
+  rmSync(dirname(notes), { recursive: true, force: true })
+} else if (!publish) {
+  console.log('\n(no --publish: nothing was created/pushed. Re-run with --publish to tag + release.)')
+}
+
+console.log(`ok: release preview for ${tag} (tagExists=${tagExists}, publish=${publish})`)