@objectivex666/dsh-settings-search 1.14.0 → 1.14.1

package/README.en.md

@@ -7,6 +7,8 @@
 [![node](https://img.shields.io/node/v/@objectivex666/dsh-settings-search)](https://nodejs.org)
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/objectivex666/dsh-settings-search)
+[![dshbase 实测可装](https://dshbase.com/badges/dsh-settings-search-plugin.svg)](https://dshbase.com/zh/plugins/dsh-settings-search-plugin/)
+[![dshfind](https://dshfind.com/api/card/objectivex666/dsh-settings-search?lang=zh)](https://dshfind.com/zh/plugins/objectivex666/dsh-settings-search?ref=badge)
 
 **English** · [中文](./README.md)
 
@@ -43,7 +45,7 @@ The commands below target a command-line profile. The desktop app manages its ow
 
 ### Prerequisites
 
-- **DeepSeek Harness (DSH)** — DSH 0.2 stable (desktop and `dsh web`) and earlier 0.1 builds; the plugin picks the API the running release offers. Verified against **0.2.1-rc.2** item by item (`npm run compat`); behaviour on 0.2.0 and earlier is unchanged.
+- **DeepSeek Harness (DSH)** — DSH 0.2 stable (desktop and `dsh web`) and earlier 0.1 builds; the plugin picks the API the running release offers. Verified against **0.2.2-rc.3** item by item (`npm run compat`); behaviour on 0.2.1 and earlier is unchanged.
 - **Node.js** >= 18 (LTS recommended).
 
 ### From npm (recommended)

package/README.md

@@ -7,6 +7,8 @@
 [![node](https://img.shields.io/node/v/@objectivex666/dsh-settings-search)](https://nodejs.org)
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/objectivex666/dsh-settings-search)
+[![dshbase 实测可装](https://dshbase.com/badges/dsh-settings-search-plugin.svg)](https://dshbase.com/zh/plugins/dsh-settings-search-plugin/)
+[![dshfind](https://dshfind.com/api/card/objectivex666/dsh-settings-search?lang=zh)](https://dshfind.com/zh/plugins/objectivex666/dsh-settings-search?ref=badge)
 
 **中文** · [English](./README.en.md)
 
@@ -45,7 +47,7 @@ DSH 的设置项散落在各个分区和插件页里，找一个开关往往要
 
 ### 前置要求
 
-- **DeepSeek Harness (DSH)**。DSH 0.2 正式版（桌面版与 `dsh web`）和更早的 0.1 版本都可以，插件会按运行中的版本自动选择对应接口。当前已在 **0.2.1-rc.2** 上逐项核对过（`npm run compat`），0.2.0 及之前的行为保持不变。
+- **DeepSeek Harness (DSH)**。DSH 0.2 正式版（桌面版与 `dsh web`）和更早的 0.1 版本都可以，插件会按运行中的版本自动选择对应接口。当前已在 **0.2.2-rc.3** 上逐项核对过（`npm run compat`），0.2.1 及更早版本的行为保持不变。
 - **Node.js**。18 或更高，推荐 LTS。
 
 ### 通过 npm 安装（推荐）

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.14.0'
+    const PKG_VERSION = '1.14.1'
     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'
@@ -384,11 +384,13 @@ window.__ModuleLoader__.load({
     )
     const CJK_RE = /[\u4e00-\u9fff]/
     const ALNUM_RE = /[a-zA-Z0-9]/
+    const PINYIN_UNKNOWN = '\u0000'
 
     /**
      * Transliterate a label into full-pinyin and initial-letter keys for
-     * association search. Returns null when any CJK character is outside
-     * the built-in table (then only substring matching applies).
+     * association search. Characters outside the compact table become segment
+     * boundaries, so one unknown character does not disable every known pinyin
+     * segment in the same label.
      *
      * Results are memoized: the same labels and intent keywords are
      * re-transliterated on every keystroke's re-filter, and this CJK loop
@@ -405,8 +407,9 @@ window.__ModuleLoader__.load({
         if (CJK_RE.test(ch)) {
           const py = PINYIN.get(ch)
           if (py === undefined) {
-            PINYIN_KEY_CACHE.set(text, null)
-            return null
+            full += PINYIN_UNKNOWN
+            initials += PINYIN_UNKNOWN
+            continue
           }
           full += py
           initials += py[0]
@@ -416,7 +419,11 @@ window.__ModuleLoader__.load({
           initials += lower
         }
       }
-      const keys = full === '' ? null : { full, initials }
+      const segments = full.split(PINYIN_UNKNOWN).filter(Boolean)
+      const initialSegments = initials.split(PINYIN_UNKNOWN).filter(Boolean)
+      const keys = segments.length === 0
+        ? null
+        : { full, initials, segments, initialSegments }
       PINYIN_KEY_CACHE.set(text, keys)
       return keys
     }
@@ -426,7 +433,7 @@ window.__ModuleLoader__.load({
       if (haystackLower.includes(token)) return 'text'
       if (keys !== null) {
         if (keys.full.includes(token)) return 'pinyin'
-        if (keys.initials.startsWith(token)) return 'initials'
+        if (keys.initialSegments.some((segment) => segment.startsWith(token))) return 'initials'
       }
       return null
     }
@@ -500,9 +507,11 @@ window.__ModuleLoader__.load({
       if (cached !== undefined) return cached
       const hits = []
       for (const intent of INTENTS) {
-        const phraseHit = intent.phrase.includes(tok) || tok.includes(intent.phrase) ||
+        const phraseHit = intent.phrase === tok ||
+          (tok.length >= 2 && (intent.phrase.startsWith(tok) || tok.includes(intent.phrase))) ||
           (intent.keys !== null &&
-            (intent.keys.full.startsWith(tok) || intent.keys.initials === tok))
+            (intent.keys.initials === tok ||
+              (tok.length >= 2 && intent.keys.full.startsWith(tok))))
         if (phraseHit) {
           for (const kw of intent.keywords) {
             if (!hits.includes(kw)) hits.push(kw)
@@ -513,6 +522,47 @@ window.__ModuleLoader__.load({
       return hits
     }
 
+    /** Match every whitespace-separated query token against one setting. */
+    const directMatch = (item, haystackLower, tokens) =>
+      tokens.every((tok) => tokenMatch(haystackLower, item.keys, tok) !== null)
+
+    const kwMatch = (_item, haystackLower, kw) => {
+      if (/^[\x00-\x7f]+$/.test(kw)) {
+        if (wordBoundaryRegex(kw).test(haystackLower)) return true
+      } else if (haystackLower.includes(kw)) return true
+      return false
+    }
+
+    /**
+     * Local intent expansion keeps the same AND semantics as direct search:
+     * every query token must match literally or through that token's own intent
+     * keywords. This stops an unrelated extra token from being ignored.
+     */
+    const localRelatedKeyword = (item, haystackLower, tokens, expandedKeywords) => {
+      if (directMatch(item, haystackLower, tokens)) return null
+      let via = null
+      for (const tok of tokens) {
+        if (tokenMatch(haystackLower, item.keys, tok) !== null) continue
+        let tokenVia = null
+        for (const kw of expandedKeywords.get(tok) ?? []) {
+          if (kwMatch(item, haystackLower, kw)) {
+            tokenVia = kw
+            break
+          }
+        }
+        if (tokenVia === null) return null
+        if (via === null) via = tokenVia
+      }
+      return via
+    }
+
+    const aiRelatedKeyword = (item, haystackLower, aiKeywords) => {
+      for (const kw of aiKeywords) {
+        if (kwMatch(item, haystackLower, kw)) return `AI · ${kw}`
+      }
+      return null
+    }
+
     const AI_TOGGLE_EVENT = 'dsh-settings-search:ai-toggle'
     const AI_CONFIG_EVENT = 'dsh-settings-search:ai-config'
     /**
@@ -713,6 +763,8 @@ window.__ModuleLoader__.load({
       return lines.join('\n')
     }
     const AI_CACHE = new Map()
+    /** Bound untrusted provider bodies before decoding/parsing them. */
+    const AI_RESPONSE_MAX_BYTES = 1024 * 1024
     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'
@@ -732,6 +784,63 @@ window.__ModuleLoader__.load({
       const { provider, baseUrl, model, apiKey } = normalizeAiConfig(cfg)
       return Boolean(baseUrl && model && (provider === 'ollama' || apiKey))
     }
+    const aiBadResponse = (message) => {
+      const error = new Error(message)
+      error.name = 'AI_BAD_RESPONSE'
+      return error
+    }
+    /**
+     * Parse a provider response with a byte ceiling. A configured provider is
+     * still an untrusted network peer, so its response must not become an
+     * unbounded browser allocation merely because it is valid JSON.
+     */
+    const readAiJson = async (response) => {
+      const declared = Number(response.headers?.get?.('content-length'))
+      if (Number.isFinite(declared) && declared > AI_RESPONSE_MAX_BYTES) {
+        try { await response.body?.cancel?.() } catch {}
+        throw aiBadResponse('AI response too large')
+      }
+      const parse = (text) => {
+        try { return JSON.parse(text) } catch {
+          throw aiBadResponse('Invalid AI JSON response')
+        }
+      }
+      if (response.body !== null && typeof response.body?.getReader === 'function') {
+        const reader = response.body.getReader()
+        const chunks = []
+        let bytes = 0
+        try {
+          while (true) {
+            const { done, value } = await reader.read()
+            if (done) break
+            if (!ArrayBuffer.isView(value) || value.BYTES_PER_ELEMENT !== 1) {
+              throw aiBadResponse('Invalid AI response body')
+            }
+            bytes += value.byteLength
+            if (bytes > AI_RESPONSE_MAX_BYTES) {
+              try { await reader.cancel() } catch {}
+              throw aiBadResponse('AI response too large')
+            }
+            chunks.push(value)
+          }
+        } finally {
+          try { reader.releaseLock() } catch {}
+        }
+        const merged = new Uint8Array(bytes)
+        let offset = 0
+        for (const chunk of chunks) {
+          merged.set(chunk, offset)
+          offset += chunk.byteLength
+        }
+        return parse(new TextDecoder().decode(merged))
+      }
+      if (typeof response.text !== 'function') throw aiBadResponse('Invalid AI response')
+      const text = await response.text()
+      if (new TextEncoder().encode(text).byteLength > AI_RESPONSE_MAX_BYTES) {
+        throw aiBadResponse('AI response too large')
+      }
+      return parse(text)
+    }
     /** Session-only API key storage avoids durable browser storage exposure. */
     const readApiKey = () => {
       const legacy = typeof localStorage !== 'undefined' ? (localStorage.getItem(AI_API_KEY_KEY) ?? '').trim() : ''
@@ -788,13 +897,14 @@ window.__ModuleLoader__.load({
     const SEARCH_SHORTCUT_EVENT = 'dsh-settings-search:shortcut-change'
     /**
      * Persisted index schema. Bumped whenever the harvest gains entries an old
-     * cache cannot contain (v2: in-page group titles such as 会话插件/全局插件),
-     * so an upgrade rebuilds instead of serving a stale index.
+     * cache cannot contain (v3: the settings-search page, merged inline options,
+     * and controls revealed by plugin cards), so an upgrade rebuilds instead of
+     * serving a stale index.
      */
-    const INDEX_STORAGE_VERSION = 2
-    const INDEX_STORAGE_KEY = 'dsh-settings-search:index:v2'
+    const INDEX_STORAGE_VERSION = 3
+    const INDEX_STORAGE_KEY = 'dsh-settings-search:index:v3'
     /** Older schema keys, removed when the index is written again. */
-    const LEGACY_INDEX_STORAGE_KEYS = ['dsh-settings-search:index:v1']
+    const LEGACY_INDEX_STORAGE_KEYS = ['dsh-settings-search:index:v2', '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'
@@ -958,10 +1068,7 @@ window.__ModuleLoader__.load({
               error.status = response.status
               throw error
             }
-            const data = await response.json().catch((error) => {
-              if (error.name === 'AbortError') throw error
-              return null
-            })
+            const data = await readAiJson(response)
             if (data?.error) {
               const error = new Error('Unexpected model list response')
               error.name = 'AI_BAD_RESPONSE'
@@ -1048,10 +1155,7 @@ window.__ModuleLoader__.load({
           error.status = response.status
           throw error
         }
-        const data = await response.json().catch((error) => {
-          if (error.name === 'AbortError') throw error
-          return null
-        })
+        const data = await readAiJson(response)
         if (data?.error || typeof aiResponseContent(provider, data) !== 'string') {
           const error = new Error('Unexpected AI response')
           error.name = 'AI_BAD_RESPONSE'
@@ -1479,7 +1583,7 @@ window.__ModuleLoader__.load({
           // Structural headings go first: the Plugins page can render dozens
           // of card titles before its next group title, and `out` is capped
           // below. Shallower matches are the page/group headings.
-          const heads = [...node.querySelectorAll('h1,h2,h3,h4,h5,label,[class*="title" i],[class*="heading" i],[class*="label" i]')]
+          const heads = [...node.querySelectorAll('h1,h2,h3,h4,h5,label,li,[role="listitem"],[class*="title" i],[class*="heading" i],[class*="label" i]')]
             .filter((el) => !isPageFilter(el))
             .sort((a, b) => depthOf(a) - depthOf(b))
           for (const h of heads) {
@@ -1497,12 +1601,28 @@ window.__ModuleLoader__.load({
             push(bestTitle(row), row)
           }
           for (const h of node.querySelectorAll('[class*="name" i]')) push(bestTitle(h) || titleOf(h), h)
-          return out.slice(0, 24)
+          return out.slice(0, 64)
         } catch {
           return []
         }
       }
 
+      /**
+       * Keep options discovered while visiting other tabs/cards and merge any
+       * controls revealed by a later DOM pass. Replacing the list would either
+       * forget previously visited tabs or fail to add a freshly expanded card.
+       */
+      const mergeInnerOptions = (previous, incoming) => {
+        const merged = []
+        const seen = new Set()
+        for (const option of [...(Array.isArray(incoming) ? incoming : []), ...(Array.isArray(previous) ? previous : [])]) {
+          if (!option || typeof option.label !== 'string' || option.label === '' || seen.has(option.label)) continue
+          seen.add(option.label)
+          merged.push(option)
+        }
+        return merged
+      }
+
 
       const runHarvest = () => {
         let grew = false
@@ -1566,10 +1686,17 @@ window.__ModuleLoader__.load({
                 if (!rec) {
                   map.set(active.id, { title: active.label, idx: 0, text, inner })
                   grew = true
-                } else if ((rec.inner?.length ?? 0) === 0 && inner.length > 0) {
-                  rec.inner = inner
-                  rec.text = text
-                  grew = true
+                } else {
+                  const mergedInner = mergeInnerOptions(rec.inner, inner)
+                  const nextText = text.length > (rec.text?.length ?? 0) ? text : rec.text
+                  if (JSON.stringify(mergedInner) !== JSON.stringify(rec.inner ?? []) ||
+                    nextText !== rec.text ||
+                    rec.title !== active.label) {
+                    rec.title = active.label
+                    rec.inner = mergedInner
+                    rec.text = nextText
+                    grew = true
+                  }
                 }
               }
             }
@@ -1596,7 +1723,6 @@ window.__ModuleLoader__.load({
       }
 
       const readSections = () => sortEntries(entriesOf('settings.section'))
-        .filter((e) => e.options?.id !== 'settings-search')
         .map((e) => ({
           kind: 'page',
           id: String(e.options?.id ?? ''),
@@ -1801,6 +1927,40 @@ window.__ModuleLoader__.load({
       return true
     }
     const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+    const settingSectionRoot = () => {
+      const root = panelRoot()
+      if (root === null) return null
+      return root.querySelector('[data-slot="settings.section"]')
+    }
+    /**
+     * DSH plugin settings are often rendered inside collapsed disclosure cards.
+     * Their controls do not exist in the DOM until the card is expanded, so the
+     * indexer must reveal them before harvesting.
+     */
+    const collapsedSettingCards = () => {
+      const section = settingSectionRoot()
+      if (section === null) return []
+      return [...section.querySelectorAll('button[aria-expanded="false"]')].filter((button) => {
+        const label = `${button.getAttribute?.('aria-label') ?? ''} ${button.textContent ?? ''}`
+        return /展开|expand/i.test(label)
+      })
+    }
+    const expandSettingCards = async () => {
+      const buttons = collapsedSettingCards()
+      for (const button of buttons) {
+        button.click()
+        await delay(90)
+      }
+      return buttons
+    }
+    const restoreSettingCards = async (buttons) => {
+      for (const button of [...buttons].reverse()) {
+        if (button?.isConnected !== false && button?.getAttribute?.('aria-expanded') === 'true') {
+          button.click()
+          await delay(60)
+        }
+      }
+    }
     /** Label of the currently-active first-level settings nav item. */
     const activeSectionLabel = () => {
       const root = panelRoot()
@@ -1831,7 +1991,9 @@ window.__ModuleLoader__.load({
         for (const sec of sections.slice(0, 40)) {
           if (!clickNavButton(sec.label)) continue
           await delay(180)
+          const expanded = await expandSettingCards()
           model.runHarvest()
+          await restoreSettingCards(expanded)
           visited += 1
         }
         if (clickNavButton(original)) {
@@ -1848,20 +2010,44 @@ window.__ModuleLoader__.load({
     }
 
     function createNavigator(ctx) {
+      const waitForActiveSection = async (label) => {
+        for (let attempt = 0; attempt < 5; attempt += 1) {
+          if (activeSectionLabel() === label) return true
+          await delay(80)
+        }
+        return false
+      }
       /** Jump to a page result; falls back to showing a manual hint. */
-      const jumpToPage = async (item) => clickNavButton(item.label)
+      const jumpToPage = async (item) => {
+        if (!clickNavButton(item.label)) return false
+        return waitForActiveSection(String(item.label ?? '').trim())
+      }
       /** Jump to an in-page option: open its page, select its tab, flash its row. */
       const jumpToOption = async (item) => {
-        const opened = clickNavButton(item.pageLabel ?? item.parentLabel)
-        if (opened !== true) { flashOptionRow(item); return false }
-        await delay(160)
+        const pageLabel = String(item.pageLabel ?? item.parentLabel ?? '').trim()
+        if (!clickNavButton(pageLabel)) return false
+        if (!await waitForActiveSection(pageLabel)) return false
         const label = item.label
         const buttons = panelButtons()
         const tab = buttons.find((b) =>
           b.getAttribute('role') === 'tab' && (b.textContent ?? '').trim() === label)
         if (tab) { tab.click(); await delay(120) }
-        flashOptionRow(item)
-        return opened
+        const waitForRow = async () => {
+          for (let attempt = 0; attempt < 4; attempt += 1) {
+            if (flashOptionRow(item)) return true
+            await delay(80)
+          }
+          return false
+        }
+        if (await waitForRow()) return true
+        // Plugin settings can live inside a collapsed disclosure card. Reveal
+        // cards one at a time until the indexed row exists, then flash it.
+        for (const button of collapsedSettingCards()) {
+          button.click()
+          await delay(110)
+          if (await waitForRow()) return true
+        }
+        return false
       }
       /** Highlight the rendered row card for one indexed option. */
       const flashOptionRow = (item) => {
@@ -1896,13 +2082,16 @@ window.__ModuleLoader__.load({
               target = card
             }
           }
-          if (!target) return
+          if (!target) return false
           target.scrollIntoView({ block: 'nearest' })
           target.classList.remove('sss-flash')
           void target.offsetWidth // restart animation if re-flashed
           target.classList.add('sss-flash')
           setTimeout(() => target.classList.remove('sss-flash'), 1900)
-        } catch { /* visual nicety only */ }
+          return true
+        } catch {
+          return false
+        }
       }
       void ctx
       return { jumpToPage, jumpToOption }
@@ -2388,29 +2577,6 @@ window.__ModuleLoader__.load({
         const sections = model.readSections()
         const deeps = q !== '' ? model.readDeep() : []
         const expandedKeywords = new Map(tokens.map((tok) => [tok, intentKeywords(tok)]))
-        const directMatch = (item, haystackLower) =>
-          tokens.every((tok) => tokenMatch(haystackLower, item.keys, tok) !== null)
-        const kwMatch = (item, haystackLower, kw) => {
-          if (/^[\x00-\x7f]+$/.test(kw)) {
-            if (wordBoundaryRegex(kw).test(haystackLower)) return true
-          } else if (haystackLower.includes(kw)) return true
-          if (item.keys === null) return false
-          const kwKeys = pinyinKeys(kw)
-          if (kwKeys === null) return false
-          return item.keys.full.includes(kwKeys.full) || item.keys.initials.startsWith(kwKeys.initials)
-        }
-        const relatedKeyword = (item, haystackLower) => {
-          if (directMatch(item, haystackLower)) return null
-          for (const tok of tokens) {
-            for (const kw of expandedKeywords.get(tok) ?? []) {
-              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) => ({
           ...s,
           keys: pinyinKeys(s.label),
@@ -2421,24 +2587,34 @@ window.__ModuleLoader__.load({
           keys: pinyinKeys(`${o.label} ${o.parentLabel}`),
           hay: `${o.hay} ${o.parentLabel} ${o.id} ${o.slot}`.toLowerCase(),
         }))
-        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 = [
+        const shownPages = mappedSections.filter((s) => directMatch(s, s.hay, tokens))
+        const shownOptions = mappedOptions.filter((o) => directMatch(o, o.hay, tokens))
+        const intentRelated = [
           ...mappedSections
-            .map((s) => ({ item: s, kind: 'page', via: relatedKeyword(s, s.hay) }))
+            .map((s) => ({ item: s, kind: 'page', via: localRelatedKeyword(s, s.hay, tokens, expandedKeywords) }))
             .filter((r) => r.via !== null),
           ...mappedOptions
-            .map((o) => ({ item: o, kind: 'option', via: relatedKeyword(o, o.hay) }))
+            .map((o) => ({ item: o, kind: 'option', via: localRelatedKeyword(o, o.hay, tokens, expandedKeywords) }))
             .filter((r) => r.via !== null),
-        ].slice(0, 8)
+        ]
+        const localResultsEmpty = shownPages.length === 0 && shownOptions.length === 0 && intentRelated.length === 0
+        const aiRelated = localResultsEmpty
+          ? [
+              ...mappedSections
+                .map((s) => ({ item: s, kind: 'page', via: aiRelatedKeyword(s, s.hay, aiKeywords) }))
+                .filter((r) => r.via !== null),
+              ...mappedOptions
+                .map((o) => ({ item: o, kind: 'option', via: aiRelatedKeyword(o, o.hay, aiKeywords) }))
+                .filter((r) => r.via !== null),
+            ]
+          : []
+        const related = [...intentRelated, ...aiRelated].slice(0, 8)
         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 = aiConfigReady(cfg)
-        const aiReady = aiEnabled && aiConfigured && q.length >= 2 && noLocalMatch
+        const aiReady = aiEnabled && aiConfigured && q.length >= 2 && localResultsEmpty
         React.useEffect(() => {
           setAiKeywords([])
           setAiStatus('idle')

package/lib/index.js

@@ -60,6 +60,7 @@ const TAIL_BYTES = 256 * 1024
 const MAX_LINE_LENGTH = 1000
 const MAX_LINES_PER_REQUEST = 200
 const MAX_REQUEST_BYTES = 256 * 1024
+const COUNT_CHUNK_BYTES = 64 * 1024
 /** How long a folder launcher may run before it counts as launched. */
 const LAUNCH_WATCH_MS = 1500
 
@@ -262,14 +263,27 @@ export function createLogStore(options = {}) {
     }
   }
   const countLines = (path) => {
+    let fd
     try {
       if (!existsSync(path)) return 0
-      const text = readFileSync(path, 'utf8')
+      fd = io.openSync(path, 'r')
+      const buffer = Buffer.alloc(COUNT_CHUNK_BYTES)
       let lines = 0
-      for (let i = 0; i < text.length; i += 1) if (text.charCodeAt(i) === 10) lines += 1
+      let position = 0
+      while (true) {
+        const readBytes = io.readSync(fd, buffer, 0, buffer.length, position)
+        if (!Number.isFinite(readBytes) || readBytes <= 0) break
+        const filled = Math.min(readBytes, buffer.length)
+        for (let i = 0; i < filled; i += 1) if (buffer[i] === 10) lines += 1
+        position += filled
+      }
       return lines
     } catch {
       return 0
+    } finally {
+      if (fd !== undefined) {
+        try { io.closeSync(fd) } catch {}
+      }
     }
   }
   // The host is a file's only writer, so its entry count is tracked in memory
@@ -379,11 +393,36 @@ export function createLogStore(options = {}) {
   }
 }
 
+/** Read one request body without buffering past the route's size budget. */
+const readLimitedBody = async (request) => {
+  if (request.body === null) return ''
+  const reader = request.body.getReader()
+  const chunks = []
+  let bytes = 0
+  try {
+    while (true) {
+      const { done, value } = await reader.read()
+      if (done) return Buffer.concat(chunks, bytes).toString('utf8')
+      if (!(value instanceof Uint8Array)) return null
+      bytes += value.byteLength
+      if (bytes > MAX_REQUEST_BYTES) {
+        try { await reader.cancel() } catch {}
+        return null
+      }
+      chunks.push(value)
+    }
+  } catch {
+    return null
+  } finally {
+    try { reader.releaseLock() } catch {}
+  }
+}
+
 /** Parse one JSON request body within the route's own size budget. */
 const readJsonBody = async (request) => {
   try {
-    const text = await request.text()
-    if (text === '' || text.length > MAX_REQUEST_BYTES) return null
+    const text = await readLimitedBody(request)
+    if (text === null || text === '') return null
     const parsed = JSON.parse(text)
     return parsed !== null && typeof parsed === 'object' ? parsed : null
   } catch {
@@ -405,7 +444,7 @@ export function createLogRoute(store) {
   return {
     path: ROUTE_PATH,
     methods: ['GET', 'POST'],
-    requestBody: 'buffered',
+    requestBody: 'streaming',
     fetch: async (request) => {
       try {
         if (request.method === 'GET') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectivex666/dsh-settings-search",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "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

@@ -14,6 +14,8 @@ const instrumented = source.replace(hook, `
       modelsUrl, fetchAiModels,
       readIndexCache, serializeHarvest,
       readDshModelConfig, otherPluginFingerprint, DEEP_SLOTS,
+      pinyinKeys, tokenMatch, intentKeywords, directMatch,
+      localRelatedKeyword, aiRelatedKeyword,
       log, flushLogs, discardPendingLogs, sessionLogText, logTarget, readLogCount,
     })
 ${hook}`)
@@ -25,11 +27,17 @@ const storage = () => {
     removeItem: (key) => values.delete(key),
   }
 }
-const json = (data, status = 200) => ({
-  ok: status >= 200 && status < 300,
-  status,
-  json: async () => data,
-})
+const json = (data, status = 200) => {
+  const text = JSON.stringify(data)
+  return {
+    ok: status >= 200 && status < 300,
+    status,
+    headers: { get: () => String(new TextEncoder().encode(text).byteLength) },
+    body: null,
+    text: async () => text,
+    json: async () => data,
+  }
+}
 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' }
@@ -151,9 +159,15 @@ const pluginsPageDom = () => {
         el('span', { class: 'RotMhW_visuallyHidden', text: '搜索插件' }),
         el('input', { attr: { type: 'search' } }),
       ]),
-      // More card titles than the 24-entry cap, so a DOM-order harvest would
+      el('ul', { class: 'RotMhW_plainPluginList' }, [
+        el('li', {}, [
+          el('strong', { text: 'PowerShell 命令工具' }),
+          el('span', { text: 'tool-pwsh' }),
+        ]),
+      ]),
+      // More card titles than the 64-entry cap, so a DOM-order harvest would
       // truncate the second group title before seeing it.
-      group('preset', '会话插件', 30),
+      group('preset', '会话插件', 70),
       group('global', '全局插件'),
     ]),
   ])
@@ -191,6 +205,8 @@ function load(fetchImpl = async () => json(reply('ollama'))) {
     CustomEvent: class { constructor(type) { this.type = type } },
     URL,
     AbortController,
+    TextEncoder,
+    TextDecoder,
     setTimeout,
     clearTimeout,
     fetch: async (url, options) => {
@@ -214,8 +230,8 @@ test('persistent settings index reuses matching fingerprints and drops invalid r
     },
   }
   assert.equal(Object.keys(api.serializeHarvest(new Map())).length, 0)
-  sandbox.localStorage.setItem('dsh-settings-search:index:v2', JSON.stringify({
-    version: 2,
+  sandbox.localStorage.setItem('dsh-settings-search:index:v3', JSON.stringify({
+    version: 3,
     fingerprint: 'manager:test',
     updatedAt: 1,
     harvest: records,
@@ -255,9 +271,10 @@ test('persistent settings index reuses matching fingerprints and drops invalid r
 
 test('readIndexCache rejects malformed and legacy persisted index payloads', () => {
   const { api, sandbox } = load()
-  const legacy = JSON.stringify({ version: 1, fingerprint: 'manager:old', updatedAt: 1, harvest: {} })
-  for (const value of ['{', '{"version":2}', 'null', legacy]) {
-    sandbox.localStorage.setItem('dsh-settings-search:index:v2', value)
+  const legacyV2 = JSON.stringify({ version: 2, fingerprint: 'manager:v2', updatedAt: 1, harvest: {} })
+  const legacyV1 = JSON.stringify({ version: 1, fingerprint: 'manager:old', updatedAt: 1, harvest: {} })
+  for (const value of ['{', '{"version":3}', 'null', legacyV2, legacyV1]) {
+    sandbox.localStorage.setItem('dsh-settings-search:index:v3', value)
     assert.equal(api.readIndexCache(), null)
   }
 })
@@ -267,6 +284,7 @@ test('writing the index uses the current schema and drops the legacy cache key',
   const records = { 'settings.general.item': { row1: { title: 'Row', idx: 0, text: '', inner: [] } } }
   sandbox.localStorage.setItem('dsh-settings-search:index:v1', JSON.stringify({ version: 1, fingerprint: 'manager:old', updatedAt: 1, harvest: records }))
   sandbox.localStorage.setItem('dsh-settings-search:index:v2', JSON.stringify({ version: 2, fingerprint: 'manager:test', updatedAt: 1, harvest: records }))
+  sandbox.localStorage.setItem('dsh-settings-search:index:v3', JSON.stringify({ version: 3, fingerprint: 'manager:test', updatedAt: 1, harvest: records }))
   api.apply({
     effect: (fn) => fn(),
     get: () => null,
@@ -282,8 +300,9 @@ test('writing the index uses the current schema and drops the legacy cache key',
   const model = api.__indexTestModel
   assert.equal(model.persistIndex('manager:next'), true)
   assert.equal(sandbox.localStorage.getItem('dsh-settings-search:index:v1'), null)
-  const raw = JSON.parse(sandbox.localStorage.getItem('dsh-settings-search:index:v2'))
-  assert.equal(raw.version, 2)
+  assert.equal(sandbox.localStorage.getItem('dsh-settings-search:index:v2'), null)
+  const raw = JSON.parse(sandbox.localStorage.getItem('dsh-settings-search:index:v3'))
+  assert.equal(raw.version, 3)
   assert.equal(raw.fingerprint, 'manager:next')
 })
 
@@ -299,6 +318,7 @@ test('in-page group titles on the Plugins page are harvested and searchable', ()
   const labels = options.map((item) => item.label)
   assert.ok(labels.includes('会话插件'), `会话插件 missing from ${JSON.stringify(labels)}`)
   assert.ok(labels.includes('全局插件'), `全局插件 missing from ${JSON.stringify(labels)}`)
+  assert.ok(labels.includes('PowerShell 命令工具'), `plain plugin-list row missing from ${JSON.stringify(labels)}`)
   for (const label of ['会话插件', '全局插件']) {
     const option = options.find((item) => item.label === label)
     assert.equal(option.kind, 'option')
@@ -310,6 +330,95 @@ test('in-page group titles on the Plugins page are harvested and searchable', ()
   assert.ok(!labels.includes('搜索插件'), `the page filter leaked into the index: ${JSON.stringify(labels)}`)
 })
 
+test('the settings-search page and its .sss-vr-label controls stay indexed', () => {
+  const { api, sandbox } = load()
+  const label = (text) => el('span', { class: 'sss-vr-label', text })
+  const page = el('div', { class: 'sss-vr' }, [
+    el('span', { class: 'sss-vr-name', text: '设置搜索' }),
+    el('div', { class: 'sss-vr-field' }, [label('搜索框样式')]),
+  ])
+  const dialog = el('div', { attr: { role: 'dialog' } }, [
+    el('div', { class: 'settings-nav' }, [
+      el('button', { attr: { 'aria-current': 'true' }, text: '设置搜索' }),
+    ]),
+    el('div', { attr: { 'data-slot': 'settings.section' } }, [page]),
+  ])
+  sandbox.document = fakeDocument(dialog)
+  const ctx = pluginsPageCtx()
+  ctx.slots.entries = (slot) => slot === 'settings.section'
+    ? [{ options: { id: 'settings-search', order: 1600, label: '设置搜索' } }]
+    : []
+  api.apply(ctx)
+  const model = api.__indexTestModel
+
+  assert.ok(model.readSections().some((section) => section.id === 'settings-search'))
+  model.runHarvest()
+  let options = model.readDeep().filter((item) => item.parentLabel === '设置搜索')
+  assert.deepEqual(plain(options.map((item) => item.label)), ['搜索框样式'])
+
+  // Expanding the page adds controls after the first non-empty harvest. They
+  // must merge into the existing record rather than being ignored.
+  for (const text of ['AI 联想搜索', '设置索引']) {
+    const field = el('div', { class: 'sss-vr-field' }, [label(text)])
+    field.parentElement = page
+    page.children.push(field)
+  }
+  model.runHarvest()
+  options = model.readDeep().filter((item) => item.parentLabel === '设置搜索')
+  const labels = options.map((item) => item.label)
+  for (const expected of ['搜索框样式', 'AI 联想搜索', '设置索引']) {
+    assert.ok(labels.includes(expected), `${expected} missing from ${JSON.stringify(labels)}`)
+  }
+  for (const option of options) {
+    assert.equal(option.slot, 'settings.section')
+    assert.equal(option.pageLabel, '设置搜索')
+  }
+})
+
+test('pinyin keeps known segments after an unknown character', () => {
+  const { api } = load()
+  const keys = api.pinyinKeys('知演功能')
+  assert.ok(keys, 'known pinyin segments must survive an unknown character')
+  assert.equal(keys.full, 'zhi\u0000gongneng')
+  assert.ok(keys.initialSegments.includes('gn'))
+  assert.ok(api.tokenMatch('知演功能', keys, 'gn'))
+  assert.equal(api.tokenMatch('知演功能', keys, 'zhign'), null, 'matching must not cross the unknown character')
+})
+
+test('intent expansion rejects one-character and internal substring noise', () => {
+  const { api } = load()
+  assert.deepEqual(plain(api.intentKeywords('文件')), [])
+  assert.deepEqual(plain(api.intentKeywords('文')), [])
+  const cancel = api.intentKeywords('取消')
+  assert.ok(cancel.includes('订阅'))
+  assert.ok(api.intentKeywords('我想取消订阅').includes('订阅'))
+})
+
+test('local intent suggestions require every query token', () => {
+  const { api } = load()
+  const language = {
+    keys: api.pinyinKeys('语言'),
+    hay: '语言',
+  }
+  const expanded = new Map([
+    ['中文', ['语言']],
+    ['外观', []],
+  ])
+  assert.equal(api.localRelatedKeyword(language, language.hay, ['中文'], expanded), '语言')
+  assert.equal(
+    api.localRelatedKeyword(language, language.hay, ['外观', '中文'], expanded),
+    null,
+    'an unmatched token must not be ignored',
+  )
+  const theme = { keys: api.pinyinKeys('主题'), hay: '主题' }
+  const themeExpanded = new Map([
+    ['太亮', ['主题']],
+    ['主题', []],
+  ])
+  assert.equal(api.localRelatedKeyword(theme, theme.hay, ['太亮', '主题'], themeExpanded), '主题')
+  assert.equal(api.aiRelatedKeyword(language, language.hay, ['语言']), 'AI · 语言')
+})
+
 test('Ollama configuration persists and requires a model but no key', () => {
   const { api, sandbox } = load()
   api.setAiConfig({ ...ollama, model: ' local-model:7b ' })
@@ -491,10 +600,52 @@ test('malformed responses and native error payloads cannot pass connectivity che
     const { api } = load(async () => json(data))
     assert.equal((await api.testAiService(ollama)).code, 'bad-response')
   }
-  const { api } = load(async () => ({ ok: true, json: async () => { throw new SyntaxError('invalid JSON') } }))
+  const { api } = load(async () => ({ ok: true, status: 200, headers: { get: () => null }, body: null, text: async () => '{' }))
   assert.equal((await api.testAiService(ollama)).code, 'bad-response')
 })
 
+test('oversized provider responses are rejected without an unbounded read', async () => {
+  let cancelled = false
+  const { api } = load(async () => ({
+    ok: true,
+    status: 200,
+    headers: { get: () => String(1024 * 1024 + 1) },
+    body: { cancel: async () => { cancelled = true } },
+    text: async () => { throw new Error('must not read declared-oversized body') },
+  }))
+  assert.equal((await api.fetchAiModels(openai)).code, 'bad-response')
+  assert.equal(cancelled, true)
+  api.setAiConfig(openai)
+  await assert.rejects(api.requestUserAi('intent', 'Language'), { name: 'AI_BAD_RESPONSE' })
+})
+
+test('streamed provider responses stop at the byte ceiling', async () => {
+  let cancelled = false
+  const chunk = new Uint8Array(1024 * 1024 + 1)
+  const { api } = load(async () => ({
+    ok: true,
+    status: 200,
+    headers: { get: () => null },
+    body: {
+      getReader: () => {
+        let sent = false
+        return {
+          read: async () => {
+            if (sent) return { done: true, value: undefined }
+            sent = true
+            return { done: false, value: chunk }
+          },
+          cancel: async () => { cancelled = true },
+          releaseLock: () => {},
+        }
+      },
+    },
+    text: async () => { throw new Error('stream must be used') },
+  }))
+  assert.equal((await api.fetchAiModels(openai)).code, 'bad-response')
+  assert.equal(cancelled, true)
+})
+
 test('network failure is reported without claiming connection success', async () => {
   const { api } = load(async () => { throw new TypeError('Failed to fetch') })
   assert.equal((await api.testAiService(ollama)).code, 'network')

package/scripts/compat.mjs

@@ -122,6 +122,15 @@ const mustInclude = (text, needle, message) => {
   if (!text.includes(needle)) throw new Error(message ?? `missing ${JSON.stringify(needle)}`)
 }
 
+/**
+ * Assert one pattern. Bundled client code is minified and re-emitted by every
+ * release, so it may quote a string with `"`, `'`, or a template literal
+ * without any behavioural change — match the code, not the quoting.
+ */
+const mustMatch = (text, pattern, message) => {
+  if (!pattern.test(text)) throw new Error(message ?? `missing ${pattern}`)
+}
+
 const main = () => {
   const archivePath = resolveAsar()
   const archive = openAsar(archivePath)
@@ -133,13 +142,17 @@ const main = () => {
     console.log(`Version: ${connectionManifest.version}\n`)
 
     check('client connection service is provided', () => {
-      mustInclude(clientSourceOf(archive, 'dsh-client-connection', cache), 'provide("connection"', 'the connection handle is gone')
+      mustMatch(
+        clientSourceOf(archive, 'dsh-client-connection', cache),
+        /provide\(\s*(['"`])connection\1/,
+        'the connection handle is gone',
+      )
       return 'ctx.connection'
     })
 
     check('Remote namespaces live at remote.<namespace>', () => {
       const gateway = clientSourceOf(archive, 'dsh-api-gateway', cache)
-      mustInclude(gateway, 'super(ctx, "remote")', 'the `remote` service is gone')
+      mustMatch(gateway, /super\(\s*ctx\s*,\s*(['"`])remote\1\s*\)/, 'the `remote` service is gone')
       mustInclude(gateway, 'remote.${namespace}', 'namespace service keys changed')
       return 'remote.<ns>'
     })
@@ -181,6 +194,7 @@ const main = () => {
     check('host connection still owns the exact-Fetch route registry', () => {
       const host = archive.read('dsh/node_modules/@deepseek-ai/dsh-client-connection/lib/index.js')
       mustInclude(host, 'registerFetchRoute', 'the host fetch registry is gone')
+      mustInclude(host, 'bodyMode === "streaming"', 'streaming exact routes are no longer supported')
       const segment = /const ENDPOINT_SEGMENT_PATTERN = \/\^\[([^\]]+)\]/.exec(host)
       if (segment === null) throw new Error('endpoint validation pattern not found')
       const sample = 'settings-search-log'

package/scripts/log.test.mjs

@@ -8,7 +8,10 @@
  * that never deletes the active file, and a tail that never starts mid-line.
  */
 import assert from 'node:assert/strict'
-import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs'
+import {
+  closeSync, existsSync, mkdtempSync, openSync, readFileSync, readSync, readdirSync,
+  rmSync, statSync, writeFileSync,
+} from 'node:fs'
 import { basename, join } from 'node:path'
 import { tmpdir } from 'node:os'
 import test from 'node:test'
@@ -228,6 +231,31 @@ test('a fresh store reads the count of a file written by an earlier run', () =>
   }
 })
 
+test('a persisted log is counted in bounded chunks instead of one large allocation', () => {
+  const { dir, cleanup } = withStore({ now: () => day('2026-10-06') })
+  try {
+    const file = join(dir, 'settings-search-2026-10-06.log')
+    writeFileSync(file, 'entry\n'.repeat(20000), 'utf8')
+    let largestRequest = 0
+    let reads = 0
+    const io = {
+      openSync,
+      closeSync,
+      readSync(fd, buffer, offset, length, position) {
+        largestRequest = Math.max(largestRequest, length)
+        reads += 1
+        return readSync(fd, buffer, offset, length, position)
+      },
+    }
+    const reopened = createLogStore({ dir, now: () => day('2026-10-06'), io })
+    assert.equal(reopened.count(), 20000)
+    assert.ok(largestRequest <= 64 * 1024, `requested ${largestRequest} bytes`)
+    assert.ok(reads > 1, 'the file must be streamed across multiple reads')
+  } finally {
+    cleanup()
+  }
+})
+
 const send = async (route, method, body, query = '') => {
   const request = new Request(`http://dsh.internal${route.path}${query}`, {
     method,
@@ -268,7 +296,7 @@ test('the log route serves the tail and accepts append/clear only', async () =>
   try {
     assert.equal(route.path, '/api/settings-search-log')
     assert.deepEqual(route.methods, ['GET', 'POST'])
-    assert.equal(route.requestBody, 'buffered')
+    assert.equal(route.requestBody, 'streaming')
 
     const appended = await send(route, 'POST', { action: 'append', lines: ['hello'] })
     assert.equal(appended.status, 200)
@@ -290,6 +318,28 @@ test('the log route serves the tail and accepts append/clear only', async () =>
   }
 })
 
+test('an over-budget request body is rejected before any action runs', async () => {
+  let actions = 0
+  const route = createLogRoute({
+    dir: 'unused',
+    file: 'unused',
+    ensure() {},
+    append() { actions += 1; return 0 },
+    count() { actions += 1; return 0 },
+    clear() { actions += 1; return true },
+    open() { actions += 1; return { failure: undefined, command: 'test' } },
+    read() { actions += 1; return { text: '', size: 0, truncated: false } },
+  })
+  const request = new Request('http://dsh.internal/api/settings-search-log', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ action: 'append', lines: ['x'.repeat(257 * 1024)] }),
+  })
+  const response = await route.fetch(request)
+  assert.equal(response.status, 400)
+  assert.equal(actions, 0)
+})
+
 test('the folder launcher uses the OS shell open verb, never a hidden file manager', () => {
   const win = folderLaunchCommand('win32', 'C:\\logs\\dsh-settings-search')
   assert.equal(win.command, 'cmd.exe')