@objectivex666/dsh-settings-search 1.5.0 → 1.6.0

package/README.en.md

@@ -15,6 +15,7 @@
 - 🔍 **Live search** — a search box at the top of the settings panel's left navigation filters every registered settings page (`settings.section`) and general item (`settings.general.item`) as you type.
 - 📂 **In-page option search (v1.2.0)** — search beyond pages and reach the specific options inside them: Plugins-page tabs (`settings.plugins.tab`), Web UI plugin cards (`web-ui.plugin.item`), general rows, and more, each shown with a "page › option" breadcrumb.
 - 🔤 **Pinyin association search (v1.5.0)** — type initials (`sz`) or full pinyin (`shezhi`) to surface Chinese settings items; navigate with `↑`/`↓`, confirm with `Enter`, dismiss with `Esc`, and matched text is highlighted.
+- 🧠 **Intent search (v1.6.0)** — describe the goal in Chinese (e.g. 「太亮了」 "too bright", 「字太小」 "text too small") to surface matching settings without knowing their names, shown in a "You may want" group.
 - 🧭 **Click-to-jump** — selecting a result clicks the matching left-nav entry to open its section; for tab options it also opens the tab and flashes the target row. A manual-path hint appears if automatic navigation is not possible.
 - 🌱 **Progressive indexing** — self-drawing settings rows are harvested from the rendered DOM (via their `[data-slot]` anchors) the first time their page is visited, then stay searchable.
 - 🛠 **Built-in settings page (v1.4.0)** — a "Settings Search" page in the left navigation shows the current version and checks npm for a newer release on demand; when one exists it hands you a copy-ready `dsh plugin update` command.

package/README.md

@@ -15,6 +15,7 @@
 - 🔍 **实时搜索**：在设置面板左侧导航顶部嵌入搜索框，输入关键词立即过滤所有已注册的设置页（`settings.section`）与通用设置项（`settings.general.item`）。
 - 📂 **页内选项搜索（v1.2.0）**：不只搜页面，还能直达每个设置页内部的具体选项——插件页的标签页（`settings.plugins.tab`）、Web UI 插件的卡片（`web-ui.plugin.item`）、通用设置行等，结果以「页面 › 选项」面包屑展示。
 - 🔤 **拼音联想搜索（v1.5.0）**：输入拼音首字母（如 `sz`）或全拼（如 `shezhi`）即可联想中文设置项；支持 `↑`/`↓` 选择、`Enter` 跳转、`Esc` 关闭，命中的文字自动高亮。
+- 🧠 **意图联想搜索（v1.6.0）**：直接描述想做的事（如「太亮了」「字太小」「忘记密码」），无需知道选项名即可联想真实设置项，结果在「猜你想找」分组展示。
 - 🧭 **点击即达**：选中结果后自动点击对应的左侧导航项打开所在分区；若是页内标签页会继续点开对应标签，并高亮闪烁目标选项行。无法自动跳转时显示手动路径提示。
 - 🌱 **渐进索引**：自绘界面的设置行会在其所在页面首次被访问时从渲染 DOM 中收割标题并加入索引（此后始终可搜）。
 - 🛠 **自带设置页（v1.4.0）**：左侧导航新增「设置搜索」页——展示当前版本，一键检查 npm 注册表上的最新版本；有更新时直接给出复制就用的 `dsh plugin update` 命令。

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.5.0'
+    const PKG_VERSION = '1.6.0'
     const NPM_NAME = '@objectivex666/dsh-settings-search'
     const zh = {
       title: '设置',
@@ -38,6 +38,7 @@ window.__ModuleLoader__.load({
       empty: '没有匹配的设置',
       pages: '设置页',
       options: '页内选项',
+      guess: '猜你想找',
       page: '页面',
       option: '选项',
       jumpFail: '未能自动跳转，请手动打开：{path}',
@@ -60,6 +61,7 @@ window.__ModuleLoader__.load({
       empty: 'No matching settings',
       pages: 'Settings pages',
       options: 'In-page options',
+      guess: 'You may want',
       page: 'Page',
       option: 'Option',
       jumpFail: 'Could not navigate automatically — open it here: {path}',
@@ -114,6 +116,10 @@ window.__ModuleLoader__.load({
       中zhong 英ying 韩han 法fa 德de 西xi 俄e 翻fan 译yi 简jian 繁fan 历li 史shi 聊liao
       天tian 消xiao 息xi 醒xing 静jing 震zhen 红hong 点dian 角jiao 未wei 读du 部bu
       为wei 已yi 好 hao 坏huai 多duo 少shao
+      太tai 刺ci 眼yan 夜ye 暗an 护hu 不bu 调tiao 吵chao 没mei 勿wu 想xiang 被bei 忘wang
+      资zi 料liao 解jie 垃la 圾ji 占zhan 缓huan 卡ka 顿dun 慢man 断duan 代dai 理li 别bie
+      闭bi 省sheng 耗hao 耐nai 注zhu 退tui 款kuan 到dao 取qu 回hui 送song 按an 短duan
+      长chang 收shou 我wo 了le 足zu 烦fan 像xiang 住zhu
     `
     const PINYIN = new Map(
       PINYIN_TABLE.split(/\s+/).filter(Boolean).map((pair) => [pair[0], pair.slice(1)])
@@ -167,6 +173,56 @@ window.__ModuleLoader__.load({
       return consumed
     }
 
+    /**
+     * Intent table for "describe the goal" search: users who know what they
+     * want to change but not which option does it. Format: 描述>联想词,逗号分隔.
+     * A query token matching a phrase (text or pinyin) additionally matches
+     * every listed keyword; expanded-only hits surface in the guess group.
+     */
+    const INTENT_TABLE = `
+      太亮>深色,主题,亮度,护眼 太暗>亮度,主题,显示 刺眼>深色,主题,亮度 夜间>深色,主题,护眼
+      护眼>深色,主题,亮度 看不清>字体,大小,缩放 字太小>字体,大小,缩放 字太大>字体,大小
+      调字体>字体,大小 太吵>声音,提示音,静音,音量 没声音>声音,音量,提示音 静音>声音,提示音,音量
+      声音太>声音,音量,提示音 提示音>声音,通知 免打扰>通知,免打扰,提醒 勿扰>通知,免打扰
+      不想被打扰>通知,免打扰,提醒 提醒>通知,消息 忘记密码>密码,安全,验证,账户 改密码>密码,安全,账户
+      密码忘了>密码,安全,验证 换头像>头像,账户,资料 换手机号>手机,绑定,账户 换邮箱>邮箱,绑定,账户
+      解绑>绑定,账户 清垃圾>缓存,清除,存储 占空间>缓存,存储,清除 空间不足>存储,缓存,清除
+      太卡>缓存,速度,网络 卡顿>缓存,速度 加载慢>网络,速度 太慢>速度,网络
+      断网>网络,连接 连不上>网络,连接,代理 换语言>语言 英文界面>语言,英文
+      中文界面>语言,中文 切换语言>语言 换设备>同步,备份,账户 新手机>同步,备份,账户
+      备份数据>备份,导出,数据 导出聊天>聊天,导出,备份,历史 聊天记录>聊天,历史,备份 不想被推荐>推荐,个性化,隐私
+      推荐太烦>推荐,个性化 隐私保护>隐私,安全 别人看到>隐私,安全 自动更新>更新,自动
+      关闭更新>更新,自动 省电>电池,节能,省电 耗电>电池,节能 电池不耐用>电池,节能
+      注销账号>注销,账户,删除 删除账号>注销,删除,账户 退出登录>登录,注销,账户 退款>支付,退款
+      会员到期>会员,订阅,支付 取消订阅>订阅,会员,支付 回车发送>发送,回车,enter,输入,快捷键 按回车>回车,enter,发送,输入
+      打字>输入,回车,发送 换行>换行,输入 没有记忆>记忆,上下文,对话 记不住>记忆,上下文
+      上下文太短>上下文,记忆,长度 消息不提醒>通知,消息,提醒,声音 收不到通知>通知,提醒,消息 看不到消息>消息,通知,提醒
+      主题>外观,皮肤,颜色,深色 换肤>皮肤,外观 颜色>皮肤,外观,主题
+      看不懂>语言,中文,英文 翻译>语言,中文,英文 乱改文件>权限,确认 权限太松>权限,确认
+      发图片>视觉,识图,自动,图片 看图>视觉,识图,图片 聊天记录>归档,会话,历史,聊天 删会话>会话,删除,归档
+    `
+    const INTENTS = INTENT_TABLE.split(/\s+/).filter(Boolean).map((entry) => {
+      const at = entry.indexOf('>')
+      const phrase = entry.slice(0, at)
+      return { phrase, keywords: entry.slice(at + 1).split(','), keys: pinyinKeys(phrase) }
+    })
+
+    /** Keywords a query token should additionally search after an intent hit. */
+    const intentKeywords = (tok) => {
+      const hits = []
+      for (const intent of INTENTS) {
+        const phraseHit = intent.phrase.includes(tok) || tok.includes(intent.phrase) ||
+          (intent.keys !== null &&
+            (intent.keys.full.startsWith(tok) || intent.keys.initials === tok))
+        if (phraseHit) {
+          for (const kw of intent.keywords) {
+            if (!hits.includes(kw)) hits.push(kw)
+          }
+        }
+      }
+      return hits
+    }
+
     const CSS = `
       .sss-wrap { position: relative; display: flex; flex-direction: column; gap: 8px; }
       .sss-title { font-size: 16px; font-weight: 600; line-height: 24px; color: var(--dsw-alias-label-primary); }
@@ -188,6 +244,7 @@ window.__ModuleLoader__.load({
       .sss-item-label mark { background: transparent; color: inherit; font-weight: 600; }
       .sss-item-path { font-size: 10px; line-height: 14px; color: var(--dsw-alias-label-secondary); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
       .sss-item-kind { flex-shrink: 0; font-size: 10px; color: var(--dsw-alias-label-secondary); border: 1px solid var(--dsw-alias-border-l2); border-radius: 4px; padding: 1px 5px; }
+      .sss-item-kind.sss-via { color: var(--dsw-alias-label-primary); background: var(--dsw-alias-interactive-bg-hover); }
       .sss-empty { margin: 0; padding: 10px 8px; color: var(--dsw-alias-label-secondary); font-size: 13px; }
       .sss-guide { padding: 7px 10px; border-radius: 8px; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l1); color: var(--dsw-alias-label-primary); font-size: 12px; line-height: 18px; }
       @keyframes sssFlashBg { 0% { background-color: var(--dsw-alias-interactive-bg-hover); } 100% { background-color: transparent; } }
@@ -508,20 +565,49 @@ window.__ModuleLoader__.load({
 
         const sections = model.readSections()
         const deeps = q !== '' ? model.readDeep() : []
-        const matchItem = (item, haystackLower) =>
+        const expandedKeywords = new Map(tokens.map((tok) => [tok, intentKeywords(tok)]))
+        const directMatch = (item, haystackLower) =>
           tokens.every((tok) => tokenMatch(haystackLower, item.keys, tok) !== null)
-        const shownPages = q !== ''
-          ? sections
-              .map((s) => ({ ...s, keys: pinyinKeys(s.label) }))
-              .filter((s) => matchItem(s, `${s.label} ${s.id}`.toLowerCase()))
-          : []
-        const shownOptions = q !== ''
-          ? deeps
-              .map((o) => ({ ...o, keys: pinyinKeys(`${o.label} ${o.parentLabel}`) }))
-              .filter((o) => matchItem(o, `${o.hay} ${o.parentLabel} ${o.id} ${o.slot}`.toLowerCase()))
-          : []
-        const none = q !== '' && shownPages.length === 0 && shownOptions.length === 0
-        const results = [...shownPages, ...shownOptions]
+        const kwMatch = (item, haystackLower, kw) => {
+          if (/^[\x00-\x7f]+$/.test(kw)) {
+            if (new RegExp(`\\b${kw.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`).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
+            }
+          }
+          return null
+        }
+        const mappedSections = q === '' ? [] : sections.map((s) => ({
+          ...s,
+          keys: pinyinKeys(s.label),
+          hay: `${s.label} ${s.id}`.toLowerCase(),
+        }))
+        const mappedOptions = q === '' ? [] : deeps.map((o) => ({
+          ...o,
+          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 related = [
+          ...mappedSections
+            .map((s) => ({ item: s, kind: 'page', via: relatedKeyword(s, s.hay) }))
+            .filter((r) => r.via !== null),
+          ...mappedOptions
+            .map((o) => ({ item: o, kind: 'option', via: relatedKeyword(o, o.hay) }))
+            .filter((r) => r.via !== null),
+        ].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 [hint, setHint] = React.useState(null)
         const [active, setActive] = React.useState(0)
@@ -579,16 +665,20 @@ window.__ModuleLoader__.load({
           return [label]
         }
 
-        const renderPage = (item, flatIndex) => React.createElement('li', {
+        const kindBadge = (via, fallback) => React.createElement('span', {
+          className: 'sss-item-kind' + (via ? ' sss-via' : ''),
+        }, via ?? fallback)
+
+        const renderPage = (item, flatIndex, via) => React.createElement('li', {
           key: 'page:' + item.id,
           className: 'sss-item' + (flatIndex === activeIndex ? ' is-active' : ''),
           onMouseDown: () => pick(item),
           onMouseEnter: () => setActive(flatIndex),
         }, [
           React.createElement('span', { className: 'sss-item-label' }, highlightLabel(item)),
-          React.createElement('span', { className: 'sss-item-kind' }, t('page')),
+          kindBadge(via, t('page')),
         ])
-        const renderOption = (item, flatIndex) => React.createElement('li', {
+        const renderOption = (item, flatIndex, via) => React.createElement('li', {
           key: item.key,
           className: 'sss-item' + (flatIndex === activeIndex ? ' is-active' : ''),
           onMouseDown: () => pick(item),
@@ -598,7 +688,7 @@ window.__ModuleLoader__.load({
             React.createElement('span', { className: 'sss-item-label' }, highlightLabel(item)),
             React.createElement('span', { className: 'sss-item-path' }, item.parentLabel),
           ]),
-          React.createElement('span', { className: 'sss-item-kind' }, t('option')),
+          kindBadge(via, t('option')),
         ])
 
         return React.createElement('div', { className: 'sss-wrap' }, [
@@ -648,6 +738,13 @@ window.__ModuleLoader__.load({
                     React.createElement('ul', { className: 'sss-list' },
                       shownOptions.map((item, i) => renderOption(item, shownPages.length + i))),
                   ]) : null,
+                  related.length > 0 ? React.createElement('div', { className: 'sss-group' }, [
+                    React.createElement('div', { className: 'sss-group-title' }, t('guess')),
+                    React.createElement('ul', { className: 'sss-list' },
+                      related.map((r, i) => r.kind === 'page'
+                        ? renderPage(r.item, shownPages.length + shownOptions.length + i, r.via)
+                        : renderOption(r.item, shownPages.length + shownOptions.length + i, r.via))),
+                  ]) : null,
                 ]),
           ]) : null,
           hint !== null

package/package.json

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