@objectivex666/dsh-settings-search 1.11.0 → 1.12.0

package/README.en.md

@@ -23,6 +23,7 @@
 - 🔤 **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** — when nothing matches locally, your OpenAI-compatible, Anthropic, or local Ollama model understands your search intent and suggests settings. Off by default; configure it on the plugin's settings page. Ollama needs no API key.
+- 💾 **Persistent settings index (v1.12.0)** — the first harvested settings index is stored locally. It rebuilds only on first use or after another plugin is installed or updated, and can be rebuilt manually from the Settings Search 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.
 - 🌱 **Auto-index on startup (v1.8.0)** — the first time the settings panel opens, the plugin automatically visits every settings section, silently reads in-page options (e.g. "Enable Workshop card") into the search index, then restores your current section, so all section options are searchable without having to open each page manually. A "Importing section options…" hint shows under the search box and clears when done.
@@ -89,7 +90,7 @@ The package ships its own `cordis.patch.yml` (that exact content), which `dsh pl
 Enable "AI-assisted search" on the Settings Search page and select "Ollama (local)" as the API type:
 
 - **Base URL**: defaults to `http://127.0.0.1:11434`; custom ports are supported. Accepts the root URL, `/api`, `/api/chat`, or `/v1`.
-- **Model**: enter the full name, including its tag, of an installed model. Use `ollama list` to see installed models.
+- **Model**: choose one returned by "Get models", or enter the full name, including its tag, of an installed model. Use `ollama list` to see installed models.
 - **API key**: not required. Ollama requests never send an existing cloud API key.
 
 Save the configuration and use "Test API" to check connectivity. Ollama requests allow 120 seconds for cold starts; cancelling a search aborts the request.

package/README.md

@@ -23,6 +23,7 @@
 - 🔤 **拼音联想搜索（v1.5.0）**：输入拼音首字母（如 `sz`）或全拼（如 `shezhi`）即可联想中文设置项；支持 `↑`/`↓` 选择、`Enter` 跳转、`Esc` 关闭，命中的文字自动高亮。
 - 🧠 **意图联想搜索（v1.6.0）**：直接描述想做的事（如「太亮了」「字太小」「忘记密码」），无需知道选项名即可联想真实设置项，结果在「猜你想找」分组展示。
 - 🤖 **AI 联想搜索**：没有本地匹配时，用你配置的 OpenAI 兼容、Anthropic 或本机 Ollama 模型理解搜索意图并推荐设置项。默认关闭，可在「设置搜索」页开启并配置；Ollama 无需 API Key。
+- 💾 **持久设置索引（v1.12.0）**：首次采集后的设置索引保存在本机浏览器；只在首次安装、其它插件安装或更新时重建，也可在「设置搜索」页手动重建。
 - 🧾 **日志与导出（v1.7.0）**：记录插件运行、搜索与 AI 请求的关键动作，可在「设置搜索」页一键导出、复制或清空，便于排查问题。不会记录 API Key。
 - 🧭 **点击即达**：选中结果后自动点击对应的左侧导航项打开所在分区；若是页内标签页会继续点开对应标签，并高亮闪烁目标选项行。无法自动跳转时显示手动路径提示。
 - 🌱 **启动自动索引（v1.8.0）**：首次打开设置面板时自动遍历各设置分区，静默读取分区内选项（如「启用创意工坊卡片」）并导入搜索索引；此后分区选项无需逐页手动打开即可直接搜索，读取完成后自动恢复当前所在分区，导入过程搜索框下方会显示提示，完成后自动消失。
@@ -89,7 +90,7 @@ dsh plugin --profile web add /path/to/dsh-settings-search
 在「设置搜索」页开启「AI 联想搜索」，将「接口类型」选为「Ollama（本机）」：
 
 - **Base URL**：默认 `http://127.0.0.1:11434`，也可填写自定义端口；支持根地址、`/api`、`/api/chat` 和 `/v1`。
-- **模型名**：填写本机已安装的完整模型名（包括标签），可用 `ollama list` 查看。
+- **模型名**：点「获取模型」从服务返回的模型中选择，或手动输入完整模型名（包括标签），可用 `ollama list` 查看。
 - **API Key**：无需填写，Ollama 请求不会携带原有云端密钥。
 
 保存后可用「测试接口」检查连接。本地模型首次加载可能较慢，Ollama 请求的超时时间为 120 秒；取消搜索会中止请求。

package/lib/client.js

@@ -30,8 +30,10 @@ 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.11.0'
+    const PKG_VERSION = '1.12.0'
     const NPM_NAME = '@objectivex666/dsh-settings-search'
+    const REPO_URL = 'https://github.com/objectivex666/dsh-settings-search'
+    const ISSUES_URL = 'https://github.com/objectivex666/dsh-settings-search/issues/new/choose'
     const zh = {
       title: '设置',
       placeholder: '搜索设置…',
@@ -44,6 +46,11 @@ window.__ModuleLoader__.load({
       openSearch: '打开搜索',
       shortcutTitle: 'Ctrl+F / ⌘F 快捷键',
       shortcutHint: '在设置面板内按 Ctrl+F 或 ⌘F 聚焦搜索框；关闭后保留浏览器默认查找。',
+      indexTitle: '设置索引',
+      indexDesc: '索引保存在本机浏览器；只在首次安装或更新其它插件后重建，也可以手动重建。',
+      indexRebuild: '手动重建索引',
+      indexRebuilding: '正在重建索引…',
+      indexDone: '索引已重建 ✓',
       warming: '正在导入各分区选项…',
       empty: '没有匹配的设置',
       pages: '设置页',
@@ -69,6 +76,7 @@ window.__ModuleLoader__.load({
       updNpx: 'npx',
       updRelease: '查看 release notes',
       updReleaseNotes: '查看更新说明',
+      updRepo: 'GitHub 仓库',
       updFetchingNotes: '正在获取…',
       updRestart: '更新完成后重启 DSH，新版本才会生效。',
       aiSearch: 'AI 联想搜索',
@@ -86,6 +94,13 @@ window.__ModuleLoader__.load({
       aiBaseUrl: 'Base URL',
       aiBaseUrlHint: '仅支持 http(s) 地址；非本机地址必须使用 https，以免泄露 API Key。',
       aiModel: '模型名',
+      aiModelHint: '从接口返回的模型中选择，或手动输入完整模型名。',
+      aiModelsLoad: '获取模型',
+      aiModelsLoading: '获取中…',
+      aiModelsLoaded: '已获取 {count} 个模型，可直接选择。',
+      aiModelsEmpty: '服务未返回模型，可手动输入。',
+      aiModelsFail: '获取模型失败：{hint}{detail}',
+      aiModelsNeedConfig: '先填写有效接口地址；云端接口还需 API Key。',
       aiApiKey: 'API Key',
       aiDshImport: '导入 DSH 模型配置',
       aiDshImporting: '正在导入…',
@@ -120,6 +135,7 @@ window.__ModuleLoader__.load({
       logDesc: '记录插件运行、搜索与 AI 请求的关键动作，便于排查问题。',
       logEmpty: '暂无日志',
       logExport: '导出日志',
+      logIssues: '反馈问题',
       logCopy: '复制日志',
       logCopied: '已复制 ✓',
       logCopyFail: '复制失败，请稍后重试。',
@@ -160,6 +176,11 @@ window.__ModuleLoader__.load({
       shortcutTitle: 'Ctrl+F / ⌘F shortcut',
       shortcutHint: 'Focus the search box with Ctrl+F or ⌘F inside the settings panel; turn it off to keep the browser default.',
       warming: 'Importing section options…',
+      indexTitle: 'Settings index',
+      indexDesc: 'The index is stored locally; it rebuilds only after another plugin is installed or updated. You can also rebuild it manually.',
+      indexRebuild: 'Rebuild index',
+      indexRebuilding: 'Rebuilding…',
+      indexDone: 'Index rebuilt ✓',
       empty: 'No matching settings',
       pages: 'Settings pages',
       options: 'In-page options',
@@ -184,6 +205,7 @@ window.__ModuleLoader__.load({
       updNpx: 'npx',
       updRelease: 'View release notes',
       updReleaseNotes: 'View changelog',
+      updRepo: 'GitHub repository',
       updFetchingNotes: 'Fetching…',
       updRestart: 'Restart DSH after updating for the new version to take effect.',
       aiSearch: 'AI-assisted search',
@@ -201,6 +223,13 @@ window.__ModuleLoader__.load({
       aiBaseUrl: 'Base URL',
       aiBaseUrlHint: 'Only http(s) URLs are allowed; remote hosts must use https to avoid exposing your API key.',
       aiModel: 'Model',
+      aiModelHint: 'Choose a model returned by the API, or enter a complete model name.',
+      aiModelsLoad: 'Get models',
+      aiModelsLoading: 'Loading…',
+      aiModelsLoaded: 'Loaded {count} models; choose one below.',
+      aiModelsEmpty: 'The service returned no models; enter one manually.',
+      aiModelsFail: 'Failed to load models: {hint}{detail}',
+      aiModelsNeedConfig: 'Enter a valid base URL first; cloud APIs also need an API key.',
       aiApiKey: 'API Key',
       aiDshImport: 'Import DSH model config',
       aiDshImporting: 'Importing…',
@@ -235,6 +264,7 @@ window.__ModuleLoader__.load({
       logDesc: 'Logs key plugin actions, searches, and AI requests to help troubleshoot.',
       logEmpty: 'No logs yet',
       logExport: 'Export logs',
+      logIssues: 'Report issue',
       logCopy: 'Copy logs',
       logCopied: 'Copied ✓',
       logCopyFail: 'Copy failed. Please try again.',
@@ -539,6 +569,10 @@ window.__ModuleLoader__.load({
     const SEARCH_STYLE_EVENT = 'dsh-settings-search:style-change'
     const SEARCH_SHORTCUT_KEY = 'dsh-settings-search:shortcut-enabled'
     const SEARCH_SHORTCUT_EVENT = 'dsh-settings-search:shortcut-change'
+    const INDEX_STORAGE_KEY = 'dsh-settings-search:index:v1'
+    const INDEX_INVALID_EVENT = 'dsh-settings-search:index-invalid'
+    const INDEX_REBUILD_EVENT = 'dsh-settings-search:index-rebuild'
+    const INDEX_REBUILD_DONE_EVENT = 'dsh-settings-search:index-rebuild-done'
     const SEARCH_STYLES = ['sidebar', 'top', 'page']
     const readSearchStyle = () => {
       if (typeof localStorage === 'undefined') return 'sidebar'
@@ -628,6 +662,101 @@ window.__ModuleLoader__.load({
       // Accept the base URL used by Ollama's OpenAI-compatible endpoint too.
       return `${safe.replace(/\/v1(?:\/chat\/completions)?$/i, '')}/api/chat`
     }
+    const ollamaModelsUrl = (baseUrl) => {
+      const safe = safeBaseUrl(baseUrl)
+      if (!safe) return ''
+      const root = safe.replace(/\/v1(?:\/models|\/chat\/completions)?$/i, '').replace(/\/api(?:\/tags|\/chat)?$/i, '')
+      return `${root}/api/tags`
+    }
+    const chatModelsUrl = (baseUrl) => {
+      const safe = safeBaseUrl(baseUrl)
+      if (!safe) return ''
+      const root = safe.replace(/\/(?:models|chat\/completions)$/i, '')
+      return /\/v1$/i.test(root) ? `${root}/models` : `${root}/v1/models`
+    }
+    const anthropicModelsUrl = (baseUrl) => {
+      const safe = safeBaseUrl(baseUrl)
+      if (!safe) return ''
+      const root = safe.replace(/\/v1\/(?:models|messages)$/i, '')
+      return `${root}/v1/models`
+    }
+    const modelsUrl = (provider, baseUrl) => provider === 'ollama'
+      ? ollamaModelsUrl(baseUrl)
+      : provider === 'anthropic' ? anthropicModelsUrl(baseUrl) : chatModelsUrl(baseUrl)
+    const extractAiModels = (provider, data) => {
+      const rows = provider === 'ollama'
+        ? (Array.isArray(data?.models) ? data.models : [])
+        : (Array.isArray(data?.data) ? data.data : Array.isArray(data?.models) ? data.models : [])
+      return [...new Set(rows
+        .map((row) => typeof row === 'string' ? row : row?.id ?? row?.name ?? row?.model)
+        .filter((value) => typeof value === 'string')
+        .map((value) => value.trim())
+        .filter(Boolean))].slice(0, 500)
+    }
+    const fetchAiModels = async (cfg, signal) => {
+      cfg = normalizeAiConfig(cfg)
+      const { provider, baseUrl, apiKey } = cfg
+      const url = modelsUrl(provider, baseUrl)
+      if (!url) return { ok: false, code: 'unsafe-url', models: [], detail: '' }
+      if (provider !== 'ollama' && !apiKey) return { ok: false, code: 'need-config', models: [], detail: '' }
+      const headers = provider === 'anthropic'
+        ? {
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+            'anthropic-dangerous-direct-browser-access': 'true',
+          }
+        : provider === 'openai' ? { authorization: `Bearer ${apiKey}` } : {}
+      const controller = new AbortController()
+      const abort = () => controller.abort()
+      if (signal?.aborted) abort()
+      else signal?.addEventListener('abort', abort, { once: true })
+      let timer
+      const deadline = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+          const error = new Error('AI model list timed out')
+          error.name = 'AI_TIMEOUT'
+          reject(error)
+          controller.abort()
+        }, 12000)
+      })
+      try {
+        const models = await Promise.race([
+          (async () => {
+            const response = await fetch(url, {
+              method: 'GET',
+              headers,
+              signal: controller.signal,
+              redirect: 'error',
+            })
+            if (!response.ok) {
+              const error = new Error(`HTTP ${response.status}`)
+              error.status = response.status
+              throw error
+            }
+            const data = await response.json().catch((error) => {
+              if (error.name === 'AbortError') throw error
+              return null
+            })
+            if (data?.error) {
+              const error = new Error('Unexpected model list response')
+              error.name = 'AI_BAD_RESPONSE'
+              throw error
+            }
+            return extractAiModels(provider, data)
+          })(),
+          deadline,
+        ])
+        return { ok: true, models, code: models.length === 0 ? 'empty' : 'ok', detail: '' }
+      } catch (error) {
+        if (error.name === 'AbortError') return { ok: false, code: 'cancelled', models: [], detail: '' }
+        if (error.name === 'AI_TIMEOUT') return { ok: false, code: 'timeout', models: [], detail: '' }
+        const code = error.status ? testHttpCode(error.status) : error.name === 'AI_BAD_RESPONSE' ? 'bad-response' : 'network'
+        return { ok: false, code, models: [], detail: String(error?.message ?? error).slice(0, 160) }
+      } finally {
+        clearTimeout(timer)
+        signal?.removeEventListener('abort', abort)
+      }
+    }
     const aiRequest = (cfg, userContent, testing = false) => {
       const { provider, baseUrl, model, apiKey } = normalizeAiConfig(cfg)
       const messages = [{ role: 'user', content: userContent }]
@@ -830,7 +959,7 @@ window.__ModuleLoader__.load({
       .sss-trigger { display: flex; align-items: center; gap: 8px; width: 100%; box-sizing: border-box; height: 32px; padding: 0 9px; border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; background: var(--dsw-alias-bg-layer-1); color: var(--dsw-alias-label-dimmed); font: inherit; font-size: 14px; line-height: 22px; cursor: pointer; text-align: left; }
       .sss-trigger:hover { border-color: var(--dsw-alias-label-dimmed); color: var(--dsw-alias-label-secondary); }
       .sss-trigger:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: -2px; }
-      .sss-page-overlay { position: fixed; inset: 0; z-index: 900; display: flex; align-items: flex-start; justify-content: center; padding: 72px 20px 32px; background: var(--dsw-alias-bg-mask, rgb(0 0 0 / 36%)); }
+      .sss-page-overlay { position: fixed; inset: 0; z-index: 1000; display: flex; align-items: flex-start; justify-content: center; padding: 72px 20px 32px; background: var(--dsw-alias-bg-mask, rgb(0 0 0 / 36%)); }
       .sss-page { display: flex; flex-direction: column; width: min(760px, 100%); max-height: min(680px, calc(100vh - 104px)); overflow: hidden; background: var(--dsw-alias-bg-layer-3); border: 1px solid var(--dsw-alias-border-l1); border-radius: 14px; box-shadow: var(--dsw-shadow-lv3); }
       .sss-page-head { flex: none; display: flex; align-items: center; gap: 8px; height: 52px; padding: 0 10px; border-bottom: 1px solid var(--dsw-alias-border-l1); }
       .sss-page-input { flex: 1; min-width: 0; height: 38px; padding: 0 6px; border: none; outline: none; background: transparent; font-size: 16px; line-height: 24px; color: var(--dsw-alias-label-primary); }
@@ -951,9 +1080,69 @@ window.__ModuleLoader__.load({
       return typeof value === 'string' ? value : ''
     }
 
+    const serializeHarvest = (harvest) => {
+      const raw = {}
+      for (const [slot, map] of harvest) {
+        if (!(map instanceof Map) || map.size === 0) continue
+        raw[slot] = Object.fromEntries([...map].filter(([, record]) => record && typeof record.title === 'string' && record.title !== ''))
+      }
+      return raw
+    }
+    const deserializeHarvest = (raw) => {
+      const harvest = new Map()
+      if (!raw || typeof raw !== 'object') return harvest
+      for (const [slot, slotValue] of Object.entries(raw)) {
+        if (!slotValue || typeof slotValue !== 'object') continue
+        const map = new Map()
+        for (const [key, record] of Object.entries(slotValue)) {
+          if (!record || typeof record !== 'object' || typeof record.title !== 'string' || record.title === '') continue
+          const inner = Array.isArray(record.inner)
+            ? record.inner.filter((op) => op && typeof op.label === 'string').map((op) => ({ label: op.label, text: typeof op.text === 'string' ? op.text : '' }))
+            : []
+          map.set(key, {
+            title: record.title,
+            idx: Number.isFinite(record.idx) ? record.idx : 0,
+            text: typeof record.text === 'string' ? record.text : '',
+            inner,
+          })
+        }
+        if (map.size > 0) harvest.set(slot, map)
+      }
+      return harvest
+    }
+
+    const readIndexCache = () => {
+      if (typeof localStorage === 'undefined') return null
+      try {
+        const raw = JSON.parse(localStorage.getItem(INDEX_STORAGE_KEY) ?? 'null')
+        if (!raw || raw.version !== 1 || typeof raw.fingerprint !== 'string' || raw.fingerprint === '') return null
+        return {
+          fingerprint: typeof raw.fingerprint === 'string' ? raw.fingerprint : null,
+          harvest: deserializeHarvest(raw.harvest),
+        }
+      } catch {
+        return null
+      }
+    }
+
+    const otherPluginFingerprint = (plugins) => {
+      const rows = Array.isArray(plugins) ? plugins : []
+      const isSelf = (row) => [
+        row?.id, row?.name, row?.npm, row?.package, row?.packageName,
+      ].some((value) => typeof value === 'string' && value.includes(NPM_NAME))
+      return JSON.stringify(rows.filter((row) => row && !isSelf(row)).map((row) => [
+        String(row.id ?? row.name ?? ''),
+        String(row.npm ?? row.package ?? row.packageName ?? ''),
+        String(row.version ?? ''),
+      ].sort()).sort())
+    }
+
     function createModel(ctx) {
+      const initialCache = readIndexCache()
+      const cachedFingerprint = initialCache?.fingerprint ?? null
       /** id → harvested visible title, per slot. */
-      const harvest = new Map()
+      const harvest = initialCache?.harvest ?? new Map()
+      let fingerprint = cachedFingerprint
 
       const entriesOf = (slot) => {
         try { return ctx.slots.entries(slot) ?? [] } catch { return [] }
@@ -1264,7 +1453,53 @@ window.__ModuleLoader__.load({
           : a.order - b.order)
       }
 
-      return { readSections, readDeep, runHarvest }
+      const slotsFingerprint = () => otherPluginFingerprint([
+        ...sortEntries(entriesOf('settings.plugin.item')).map((entry) => ({
+          id: String(entry.options?.id ?? entry.options?.key ?? ''),
+          name: optionLabel(entry.options?.label),
+          locale: String(entry.options?.locale ?? ''),
+        })),
+        ...sortEntries(entriesOf('web-ui.plugin.item')).map((entry) => ({
+          id: String(entry.options?.id ?? entry.options?.key ?? ''),
+          name: optionLabel(entry.options?.label),
+          locale: String(entry.options?.locale ?? ''),
+        })),
+      ])
+
+      const resetHarvest = () => { harvest.clear(); warmed = false }
+
+      const persistIndex = (nextFingerprint = fingerprint) => {
+        if (typeof nextFingerprint !== 'string' || nextFingerprint === '' || harvest.size === 0) return false
+        fingerprint = nextFingerprint
+        if (typeof localStorage === 'undefined') return false
+        try {
+          localStorage.setItem(INDEX_STORAGE_KEY, JSON.stringify({
+            version: 1,
+            fingerprint,
+            updatedAt: Date.now(),
+            harvest: serializeHarvest(harvest),
+          }))
+          return true
+        } catch {
+          return false
+        }
+      }
+
+      const indexFingerprintReady = () => typeof fingerprint === 'string' && fingerprint !== ''
+
+      const applyIndexFingerprint = (nextFingerprint) => {
+        if (typeof nextFingerprint !== 'string' || nextFingerprint === '') return false
+        if (nextFingerprint === fingerprint) {
+          if (nextFingerprint === cachedFingerprint) warmed = true
+          return false
+        }
+        const wasPopulated = harvest.size > 0
+        fingerprint = nextFingerprint
+        resetHarvest()
+        return wasPopulated
+      }
+
+      return { readSections, readDeep, runHarvest, persistIndex, applyIndexFingerprint, resetHarvest, slotsFingerprint, indexFingerprintReady }
     }
 
     /* ---------- DOM-level navigation into the settings shell ---------- */
@@ -1316,7 +1551,7 @@ window.__ModuleLoader__.load({
     const warmAllSections = async (model, onStart, onDone) => {
       if (warmed || typeof document === 'undefined') return true
       const sections = model.readSections()
-      if (sections.length === 0) return true
+      if (sections.length === 0) return false
       const original = activeSectionLabel()
       if (original === '') return false // settings panel not open yet; retry on next mount
       warmed = true
@@ -1336,6 +1571,8 @@ window.__ModuleLoader__.load({
       } finally {
         if (typeof onDone === 'function') onDone()
       }
+      if (visited === 0) return false
+      model.persistIndex()
       log('info', '预载设置索引', { total: sections.length, visited })
       return true
     }
@@ -1411,7 +1648,35 @@ window.__ModuleLoader__.load({
       }, 'settings-search: styles')
 
       const model = createModel(ctx)
+      const indexControls = { resetHarvest: model.resetHarvest, persistIndex: model.persistIndex }
       const navigator = createNavigator(ctx)
+      let pluginManagerSyncToken = 0
+
+      const syncPluginManagerIndex = async (face) => {
+        if (face === null || !face.isLoopback) return
+        const token = ++pluginManagerSyncToken
+        try {
+          const rows = await face.list()
+          if (token !== pluginManagerSyncToken) return
+          if (model.applyIndexFingerprint('manager:' + otherPluginFingerprint(rows))) {
+            window.dispatchEvent(new CustomEvent(INDEX_INVALID_EVENT))
+            log('info', '检测到其它插件变化，将重建设置索引', {})
+          }
+        } catch {
+          // Keep the last trusted fingerprint when manager inspection fails.
+        }
+      }
+
+      ctx.inject(['pluginManager'], (inner) => {
+        const face = inner.pluginManager ?? null
+        const sync = () => { void syncPluginManagerIndex(face) }
+        sync()
+        const unsubscribe = typeof face?.onChange === 'function' ? face.onChange(sync) : null
+        return () => {
+          pluginManagerSyncToken += 1
+          if (typeof unsubscribe === 'function') unsubscribe()
+        }
+      }, 'settings-search: plugin manager index fingerprint')
 
       /** Read the model fields from DSH; credentials are never requested. */
       const readDshModelConfig = async () => {
@@ -1597,6 +1862,24 @@ window.__ModuleLoader__.load({
           }
         }, [])
 
+        React.useEffect(() => {
+          // If no plugin manager is present, the slot registrations are the
+          // only available change signal. Waiting briefly avoids racing the
+          // optional manager during startup.
+          const fallback = setTimeout(() => {
+            if (model.indexFingerprintReady()) return
+            if (model.applyIndexFingerprint(model.slotsFingerprint())) {
+              window.dispatchEvent(new CustomEvent(INDEX_INVALID_EVENT))
+            }
+          }, 3000)
+          const onInvalid = () => { setWarming(false); setTick((value) => value + 1) }
+          window.addEventListener(INDEX_INVALID_EVENT, onInvalid)
+          return () => {
+            clearTimeout(fallback)
+            window.removeEventListener(INDEX_INVALID_EVENT, onInvalid)
+          }
+        }, [])
+
         React.useEffect(() => {
           const onWelcome = (event) => { if (event?.detail === true) setShowWelcome(true) }
           window.addEventListener(WELCOME_EVENT, onWelcome)
@@ -1924,7 +2207,6 @@ window.__ModuleLoader__.load({
                 ? React.createElement(Welcome, { t, onClose: dismissWelcome, onOpenPanel: openPanelFromWelcome })
                 : null,
             ]),
-            React.createElement('div', { className: 'sss-wrap sss-top' }, [pageTriggerButton]),
             React.createElement('div', {
               className: 'sss-page-overlay',
               onMouseDown: (event) => { if (event.target === event.currentTarget) setPageOpen(false) },
@@ -2065,9 +2347,13 @@ window.__ModuleLoader__.load({
         const [apiKey, setApiKey] = React.useState(cfg.apiKey)
         const providerDrafts = React.useRef({})
         const testAbortRef = React.useRef(null)
+        const modelsAbortRef = React.useRef(null)
         const [aiSaved, setAiSaved] = React.useState(false)
         const [testState, setTestState] = React.useState('idle') // idle | loading | ok | fail
         const [testMsg, setTestMsg] = React.useState('')
+        const [aiModels, setAiModels] = React.useState([])
+        const [modelsState, setModelsState] = React.useState('idle') // idle | loading | ready | fail
+        const [modelsMsg, setModelsMsg] = React.useState('')
         const [dshImportState, setDshImportState] = React.useState('idle') // idle | loading | ok | fail
         const [dshImportMsg, setDshImportMsg] = React.useState('')
         const [, setLogVersion] = React.useState(0)
@@ -2075,6 +2361,8 @@ window.__ModuleLoader__.load({
         const [logCopyFail, setLogCopyFail] = React.useState(false)
         const [logExportFail, setLogExportFail] = React.useState(false)
         const [logCleared, setLogCleared] = React.useState(false)
+        const [indexState, setIndexState] = React.useState('idle')
+        const [warming, setWarming] = React.useState(false)
         const [confirmClear, setConfirmClear] = React.useState(false)
         const [confirmClearAi, setConfirmClearAi] = React.useState(false)
 
@@ -2106,6 +2394,8 @@ window.__ModuleLoader__.load({
           return () => testAbortRef.current?.abort()
         }, [provider, baseUrl, model, apiKey])
 
+        React.useEffect(() => () => modelsAbortRef.current?.abort(), [provider, baseUrl, apiKey])
+
         React.useEffect(() => {
           const sync = () => setLogVersion((v) => v + 1)
           window.addEventListener(LOG_EVENT, sync)
@@ -2122,6 +2412,68 @@ window.__ModuleLoader__.load({
           setProvider(next)
           setBaseUrl(draft?.baseUrl ?? (next === 'ollama' ? OLLAMA_BASE_URL : ''))
           setModel(draft?.model ?? '')
+          resetModelList()
+        }
+
+        const resetModelList = () => {
+          modelsAbortRef.current?.abort()
+          setAiModels([])
+          setModelsState('idle')
+          setModelsMsg('')
+        }
+
+        const modelsErrorHint = (code) => {
+          if (code === 'need-config') return t('aiModelsNeedConfig')
+          const cloudKeys = {
+            auth: 'aiTestErrAuth',
+            forbidden: 'aiTestErrForbidden',
+            'not-found': 'aiTestErrNotFound',
+            'rate-limit': 'aiTestErrRateLimit',
+            'bad-request': 'aiTestErrBadRequest',
+            server: 'aiTestErrServer',
+            timeout: 'aiTestErrTimeout',
+            network: 'aiTestErrNetwork',
+            'bad-response': 'aiTestErrBadResponse',
+            'unsafe-url': 'aiTestErrUnsafeUrl',
+          }
+          const ollamaKeys = { ...cloudKeys, network: 'aiOllamaErrNetwork', forbidden: 'aiOllamaErrForbidden', timeout: 'aiOllamaErrTimeout' }
+          return t((provider === 'ollama' ? ollamaKeys : cloudKeys)[code] ?? 'aiTestErrHttp')
+        }
+
+        const loadModels = async () => {
+          if (modelsState === 'loading') return
+          const source = normalizeAiConfig({ provider, baseUrl, model, apiKey })
+          if (!modelsUrl(source.provider, source.baseUrl) || (source.provider !== 'ollama' && !source.apiKey)) {
+            setModelsState('fail')
+            setModelsMsg(t('aiModelsFail').replace('{hint}', t('aiModelsNeedConfig')).replace('{detail}', ''))
+            return
+          }
+          const controller = new AbortController()
+          modelsAbortRef.current?.abort()
+          modelsAbortRef.current = controller
+          setModelsState('loading')
+          setModelsMsg('')
+          const startedAt = Date.now()
+          log('info', '获取 AI 模型列表', { provider: source.provider })
+          const result = await fetchAiModels(source, controller.signal)
+          if (controller.signal.aborted) return
+          if (modelsAbortRef.current !== controller) return
+          modelsAbortRef.current = null
+          if (result.ok) {
+            setAiModels(result.models)
+            setModelsState('ready')
+            setModelsMsg(result.models.length === 0
+              ? t('aiModelsEmpty')
+              : t('aiModelsLoaded').replace('{count}', String(result.models.length)))
+            log('info', '获取 AI 模型列表成功', { count: result.models.length, duration: Date.now() - startedAt })
+          } else {
+            setAiModels([])
+            setModelsState('fail')
+            const hint = modelsErrorHint(result.code)
+            const detail = result.detail ? `（${result.detail}）` : ''
+            setModelsMsg(t('aiModelsFail').replace('{hint}', hint).replace('{detail}', detail))
+            log('error', '获取 AI 模型列表失败', { code: result.code, detail: result.detail, duration: Date.now() - startedAt })
+          }
         }
 
         const saveAi = () => {
@@ -2148,6 +2500,7 @@ window.__ModuleLoader__.load({
             setProvider(imported.provider)
             setBaseUrl(imported.baseUrl)
             setModel(imported.model)
+            resetModelList()
             setDshImportState('ok')
             setDshImportMsg(t('aiDshImportOk'))
             log('info', '导入 DSH 模型配置', { provider: imported.provider, model: imported.model })
@@ -2164,6 +2517,25 @@ window.__ModuleLoader__.load({
           setSearchStyleState(style)
         }
 
+        const rebuildIndex = async () => {
+          if (indexState === 'loading' || warming) return
+          setIndexState('loading')
+          setWarming(true)
+          indexControls.resetHarvest()
+          try {
+            const done = await warmAllSections(model, () => setWarming(true), () => setWarming(false))
+            if (!done) throw new Error('index rebuild did not visit any sections')
+            indexControls.persistIndex()
+            setIndexState('done')
+            window.dispatchEvent(new CustomEvent(INDEX_REBUILD_DONE_EVENT))
+            setTimeout(() => setIndexState((state) => state === 'done' ? 'idle' : state), 2400)
+          } catch (error) {
+            setIndexState('idle')
+            setWarming(false)
+            log('error', '手动重建设置索引失败', { detail: String(error?.message ?? error).slice(0, 160) })
+          }
+        }
+
         const updateShortcutEnabled = (enabled) => {
           setSearchShortcutEnabled(enabled)
           setShortcutOn(enabled)
@@ -2180,6 +2552,7 @@ window.__ModuleLoader__.load({
           setModel('')
           setApiKey('')
           providerDrafts.current = {}
+          resetModelList()
           setAiSaved(false)
           log('info', '清除 API 配置', {})
         }
@@ -2394,6 +2767,23 @@ window.__ModuleLoader__.load({
               ]),
               React.createElement('p', { className: 'sss-vr-hint' }, t('shortcutHint')),
             ]),
+            React.createElement('div', { className: 'sss-vr-field' }, [
+              React.createElement('div', { className: 'sss-vr-field-head' }, [
+                React.createElement('span', { className: 'sss-vr-label' }, t('indexTitle')),
+              ]),
+              React.createElement('p', { className: 'sss-vr-hint' }, t('indexDesc')),
+              React.createElement('div', { className: 'sss-vr-actions' }, [
+                React.createElement('button', {
+                  className: 'sss-vr-btn',
+                  type: 'button',
+                  disabled: indexState === 'loading' || warming,
+                  onClick: () => { void rebuildIndex() },
+                }, indexState === 'loading' || warming ? t('indexRebuilding') : t('indexRebuild')),
+              ]),
+              indexState === 'done'
+                ? React.createElement('p', { className: 'sss-vr-note', style: { color: '#1e8e3e' } }, t('indexDone'))
+                : null,
+            ]),
             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')),
@@ -2428,44 +2818,56 @@ window.__ModuleLoader__.load({
                 'data-lpignore': 'true',
                 'data-1p-ignore': 'true',
                 'data-form-type': 'other',
-                onChange: (event) => setBaseUrl(event.target.value),
-              }),
-              React.createElement('p', { className: 'sss-vr-hint' }, t('aiBaseUrlHint')),
-              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',
-                name: 'dsh-settings-search-model',
-                'aria-label': t('aiModel'),
-                value: model,
-                placeholder: provider === 'ollama' ? 'qwen3:8b'
-                  : provider === 'anthropic' ? 'claude-sonnet-4-20250514' : 'gpt-4o-mini',
-                spellCheck: false,
-                autoComplete: 'off',
-                'data-lpignore': 'true',
-                'data-1p-ignore': 'true',
-                'data-form-type': 'other',
-                onChange: (event) => setModel(event.target.value),
-              }),
-              provider !== 'ollama' ? React.createElement('div', { className: 'sss-vr-field-head' }, [
-                React.createElement('label', { className: 'sss-vr-label' }, t('aiApiKey')),
-              ]) : null,
-              provider !== 'ollama' ? React.createElement('input', {
-                className: 'sss-vr-input sss-vr-mask',
-                type: 'text',
-                name: 'dsh-settings-search-api-key',
-                'aria-label': t('aiApiKey'),
-                value: apiKey,
-                placeholder: 'sk-…',
-                spellCheck: false,
-                autoComplete: 'off',
-                'data-lpignore': 'true',
-                'data-1p-ignore': 'true',
-                'data-form-type': 'other',
-                onChange: (event) => setApiKey(event.target.value),
-              }) : null,
+                 onChange: (event) => { setBaseUrl(event.target.value); resetModelList() },
+               }),
+               React.createElement('p', { className: 'sss-vr-hint' }, t('aiBaseUrlHint')),
+               React.createElement('div', { className: 'sss-vr-field-head' }, [
+                 React.createElement('label', { className: 'sss-vr-label' }, t('aiModel')),
+                 React.createElement('button', { className: 'sss-vr-btn', type: 'button', disabled: modelsState === 'loading', onClick: () => { void loadModels() } },
+                   modelsState === 'loading' ? t('aiModelsLoading') : t('aiModelsLoad')),
+               ]),
+               React.createElement('p', { className: 'sss-vr-hint' }, t('aiModelHint')),
+               React.createElement('input', {
+                 className: 'sss-vr-input',
+                 type: 'text',
+                 name: 'dsh-settings-search-model',
+                 'aria-label': t('aiModel'),
+                 value: model,
+                 list: 'dsh-settings-search-model-options',
+                 placeholder: provider === 'ollama' ? 'qwen3:8b'
+                   : provider === 'anthropic' ? 'claude-sonnet-4-20250514' : 'gpt-4o-mini',
+                 spellCheck: false,
+                 autoComplete: 'off',
+                 'data-lpignore': 'true',
+                 'data-1p-ignore': 'true',
+                 'data-form-type': 'other',
+                  onChange: (event) => setModel(event.target.value),
+                }),
+                React.createElement('datalist', { id: 'dsh-settings-search-model-options' },
+                  aiModels.map((item) => React.createElement('option', { key: item, value: item }, item))),
+                modelsMsg
+                  ? React.createElement('p', {
+                      className: modelsState === 'fail' ? 'sss-vr-note' : 'sss-vr-hint',
+                      style: modelsState === 'fail' ? { color: 'var(--dsw-alias-label-danger)' } : undefined,
+                    }, modelsMsg)
+                  : null,
+                provider !== 'ollama' ? React.createElement('div', { className: 'sss-vr-field-head' }, [
+                 React.createElement('label', { className: 'sss-vr-label' }, t('aiApiKey')),
+               ]) : null,
+               provider !== 'ollama' ? React.createElement('input', {
+                 className: 'sss-vr-input sss-vr-mask',
+                 type: 'text',
+                 name: 'dsh-settings-search-api-key',
+                 'aria-label': t('aiApiKey'),
+                 value: apiKey,
+                 placeholder: 'sk-…',
+                 spellCheck: false,
+                 autoComplete: 'off',
+                 'data-lpignore': 'true',
+                 'data-1p-ignore': 'true',
+                 'data-form-type': 'other',
+                 onChange: (event) => { setApiKey(event.target.value); resetModelList() },
+               }) : null,
               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')),
@@ -2513,6 +2915,8 @@ window.__ModuleLoader__.load({
                   state === 'loading' ? t('updChecking') : t('updCheck')),
                 React.createElement('button', { className: 'sss-vr-btn', type: 'button', disabled: notesState === 'loading', onClick: () => { void fetchNotes() } },
                   notesState === 'loading' ? t('updFetchingNotes') : t('updReleaseNotes')),
+                React.createElement('a', { className: 'sss-vr-link', href: REPO_URL, target: '_blank', rel: 'noopener noreferrer' },
+                  t('updRepo')),
               ]),
               notesState === 'loaded'
                 ? React.createElement('div', { className: 'sss-vr-notes' }, notesBody)
@@ -2529,6 +2933,8 @@ window.__ModuleLoader__.load({
                 : null,
               React.createElement('div', { className: 'sss-vr-actions' }, [
                 React.createElement('button', { className: 'sss-vr-btn', type: 'button', onClick: () => { void exportLogs() } }, t('logExport')),
+                React.createElement('a', { className: 'sss-vr-link', href: ISSUES_URL, target: '_blank', rel: 'noopener noreferrer' },
+                  t('logIssues')),
                 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', disabled: LOGS.length === 0, onClick: () => requestClear() },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectivex666/dsh-settings-search",
-  "version": "1.11.0",
+  "version": "1.12.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/ai.test.mjs

@@ -11,6 +11,8 @@ const instrumented = source.replace(hook, `
     Object.assign(exports, {
       aiConfig, setAiConfig, aiConfigReady, ollamaChatUrl,
       requestUserAi, requestAiKeywords, testAiService, LOGS,
+      modelsUrl, fetchAiModels,
+      readIndexCache, serializeHarvest,
     })
 ${hook}`)
 const storage = () => {
@@ -30,6 +32,8 @@ const plain = (value) => JSON.parse(JSON.stringify(value))
 const ollama = { provider: 'ollama', baseUrl: '', model: 'local-model:7b', apiKey: '' }
 const openai = { provider: 'openai', baseUrl: 'https://example.test/v1', model: 'cloud-model', apiKey: 'test-secret' }
 const anthropic = { ...openai, provider: 'anthropic', baseUrl: 'https://example.test' }
+const modelHook = '      const model = createModel(ctx)'
+
 const reply = (provider, content = '{"keywords":["Language"]}') => provider === 'ollama'
   ? { message: { role: 'assistant', content }, done: true }
   : provider === 'anthropic'
@@ -49,16 +53,73 @@ function load(fetchImpl = async () => json(reply('ollama'))) {
     setTimeout,
     clearTimeout,
     fetch: async (url, options) => {
-      const call = { url, ...options, body: JSON.parse(options.body) }
+      const call = { url, ...options, body: options.body ? JSON.parse(options.body) : undefined }
       calls.push(call)
       return fetchImpl(call)
     },
   }
-  vm.runInNewContext(instrumented, sandbox, { filename: 'lib/client.js' })
-  const api = handoff.factory(() => ({}))
+  const instrumentedModel = instrumented.replace(modelHook, modelHook + '\n    exports.__indexTestModel = model')
+  vm.runInNewContext(instrumentedModel, sandbox, { filename: 'lib/client.js' })
+  const api = handoff.factory(() => ({ createElement: () => null }))
   return { api, calls, sandbox }
 }
 
+test('persistent settings index reuses matching fingerprints and drops invalid rows', () => {
+  const { api, sandbox } = load()
+  const records = {
+    'settings.general.item': {
+      row1: { title: 'Enable Workshop card', idx: 1, text: 'Enable Workshop card and save.', inner: [] },
+      broken: { idx: 2 },
+    },
+  }
+  assert.equal(Object.keys(api.serializeHarvest(new Map())).length, 0)
+  sandbox.localStorage.setItem('dsh-settings-search:index:v1', JSON.stringify({
+    version: 1,
+    fingerprint: 'manager:test',
+    updatedAt: 1,
+    harvest: records,
+  }))
+  const cached = api.readIndexCache()
+  assert.equal(cached.fingerprint, 'manager:test')
+  assert.equal(cached.harvest.get('settings.general.item')?.get('row1')?.title, 'Enable Workshop card')
+  assert.equal(cached.harvest.get('settings.general.item')?.has('broken'), false)
+
+  const ctx = {
+    effect: (fn) => fn(),
+    get: () => null,
+    inject: () => {},
+    locale: {
+      register: () => {},
+      bind: () => () => '',
+      subscribe: () => () => {},
+    },
+    slots: {
+      register: (name, id, options) => ({ name, id, options }),
+      inject: (_slot, registrar) => registrar(),
+      entries: (slot) => slot === 'settings.general.item'
+        ? [{ options: { id: 'row1', order: 1 } }]
+        : [],
+      subscribe: () => () => {},
+    },
+  }
+  api.apply(ctx)
+  const model = api.__indexTestModel
+  assert.equal(model.indexFingerprintReady(), true)
+  assert.equal(model.applyIndexFingerprint('manager:test'), false)
+  assert.ok(model.readDeep().some((item) => item.label === 'Enable Workshop card'))
+  assert.equal(model.applyIndexFingerprint('manager:changed'), true)
+  assert.equal(model.readDeep().some((item) => item.label === 'Enable Workshop card'), false)
+  assert.equal(model.persistIndex('manager:changed'), false)
+})
+
+test('readIndexCache rejects malformed persisted index payloads', () => {
+  const { api, sandbox } = load()
+  for (const value of ['{', '{"version":1}', 'null']) {
+    sandbox.localStorage.setItem('dsh-settings-search:index:v1', value)
+    assert.equal(api.readIndexCache(), null)
+  }
+})
+
 test('Ollama configuration persists and requires a model but no key', () => {
   const { api, sandbox } = load()
   api.setAiConfig({ ...ollama, model: ' local-model:7b ' })
@@ -88,6 +149,59 @@ test('Ollama accepts root, native, compatibility, proxy and IPv6 base URLs', ()
   assert.equal(api.ollamaChatUrl('https://example.test/ollama/v1/'), 'https://example.test/ollama/api/chat')
 })
 
+test('users discover selectable models from each supported API type', async () => {
+  const cases = [
+    {
+      cfg: ollama,
+      payload: { models: [{ name: 'qwen3:8b' }, { name: 'llama3.1:8b' }, { name: 'qwen3:8b' }] },
+      url: 'http://127.0.0.1:11434/api/tags',
+      headers: {},
+      models: ['qwen3:8b', 'llama3.1:8b'],
+    },
+    {
+      cfg: openai,
+      payload: { data: [{ id: 'gpt-4o-mini' }, { id: 'gpt-4.1-mini' }] },
+      url: 'https://example.test/v1/models',
+      headers: { authorization: `Bearer ${openai.apiKey}` },
+      models: ['gpt-4o-mini', 'gpt-4.1-mini'],
+    },
+    {
+      cfg: anthropic,
+      payload: { data: [{ id: 'claude-sonnet-4-20250514' }] },
+      url: 'https://example.test/v1/models',
+      headers: {
+        'x-api-key': anthropic.apiKey,
+        'anthropic-version': '2023-06-01',
+        'anthropic-dangerous-direct-browser-access': 'true',
+      },
+      models: ['claude-sonnet-4-20250514'],
+    },
+  ]
+  for (const expected of cases) {
+    const { api, calls } = load(async () => json(expected.payload))
+    assert.deepEqual(plain(await api.fetchAiModels(expected.cfg)), { ok: true, models: expected.models, code: 'ok', detail: '' })
+    const [call] = calls
+    assert.equal(call.url, expected.url)
+    assert.equal(call.method, 'GET')
+    assert.equal(call.redirect, 'error')
+    assert.deepEqual(plain(call.headers), expected.headers)
+  }
+})
+
+test('model discovery rejects unsafe or incomplete sources before fetching', async () => {
+  const { api, calls } = load(async () => json({ data: [{ id: 'should-not-load' }] }))
+  assert.equal(api.modelsUrl('ollama', 'javascript:alert(1)'), '')
+  assert.deepEqual(plain(await api.fetchAiModels({ ...ollama, baseUrl: 'file:///models' })), { ok: false, code: 'unsafe-url', models: [], detail: '' })
+  assert.deepEqual(plain(await api.fetchAiModels({ ...openai, apiKey: '' })), { ok: false, code: 'need-config', models: [], detail: '' })
+  assert.equal(calls.length, 0)
+})
+
+test('model discovery reports provider failures without inventing choices', async () => {
+  const { api, calls } = load(async () => json({ error: 'denied' }, 401))
+  assert.deepEqual(plain(await api.fetchAiModels(ollama)), { ok: false, code: 'auth', models: [], detail: 'HTTP 401' })
+  assert.equal(calls.length, 1)
+})
+
 test('Ollama search uses native non-streaming JSON and never sends a stored cloud key', async () => {
   const { api, calls, sandbox } = load(async () => json(reply('ollama', '{"keywords":["Language","Language"," Theme ",42]}')))
   api.setAiConfig({ ...ollama, apiKey: 'test-secret' })