@objectivex666/dsh-settings-search 1.7.0 → 1.7.2

package/README.en.md

@@ -21,6 +21,7 @@
 - 🧭 **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.
+- 🧭 **View release notes (v1.7.1)** — the "Settings Search" page has a "View changelog" button next to "Check for updates"; it fetches the GitHub release notes and shows them inline, opening the release page if fetching fails.
 - 🌐 **i18n** — built-in Chinese/English dictionaries that follow the DSH localization system and are easy to extend.
 - 🎨 **Theme-aware** — styled entirely with CSS variables, automatically following the DSH theme (light/dark).
 - ⚡ **Reactive** — subscribes to settings entries being added, removed, or changed, and refreshes results automatically.
@@ -97,6 +98,21 @@ npm test   # validates the host half, the dsh.client manifest, and the client bu
 > sync with the shipping package kept drifting silently, it was removed in
 > v1.4.1; retrieve it from git history (tag `v1.4.0`) if you need a reference.
 
+## Feedback & contributions
+
+Issues are welcome — please report bugs, suggest features, or ask questions in
+[GitHub Issues](https://github.com/objectivex666/dsh-settings-search/issues).
+Pull requests are equally welcome via
+[GitHub Pull Requests](https://github.com/objectivex666/dsh-settings-search/pulls).
+
+When submitting an issue, please include as much of the following as possible so we can locate and reproduce it:
+
+- **Problem description**: what you expected vs. what actually happened.
+- **Reproduction steps**: a step-by-step walkthrough, including the triggering keywords and the settings page involved.
+- **Logs**: export the recent search/runtime logs from the plugin's "Logging & export" page and paste them (API keys are never logged, so it is safe to share); include any console errors as well.
+- **Environment**: DSH version, Node.js version, plugin version (shown on the "Settings Search" page), OS, and browser.
+- **Screenshots / screen recording**: helpful for UI-related issues.
+
 ## Changelog & releases
 
 Every version bump keeps git tags and GitHub Releases in sync, with a bilingual body that lists both new features and fixes:

package/README.md

@@ -21,6 +21,7 @@
 - 🧭 **点击即达**：选中结果后自动点击对应的左侧导航项打开所在分区；若是页内标签页会继续点开对应标签，并高亮闪烁目标选项行。无法自动跳转时显示手动路径提示。
 - 🌱 **渐进索引**：自绘界面的设置行会在其所在页面首次被访问时从渲染 DOM 中收割标题并加入索引（此后始终可搜）。
 - 🛠 **自带设置页（v1.4.0）**：左侧导航新增「设置搜索」页——展示当前版本，一键检查 npm 注册表上的最新版本；有更新时直接给出复制就用的 `dsh plugin update` 命令。
+- 🧭 **更新说明查看（v1.7.1）**：在「设置搜索」页「检查更新」旁新增「查看更新说明」按钮，可拉取 GitHub Release 更新内容并就地展示；拉取失败时自动跳转 Release 页面。
 - 🌐 **多语言支持**：内置中英文国际化，可跟随 DSH 本地化系统扩展。
 - 🎨 **主题适配**：完全使用 CSS 变量，自动跟随 DSH 主题（亮/暗）。
 - ⚡ **动态响应**：实时订阅设置项的新增/删除/变更，搜索结果自动刷新。
@@ -98,6 +99,20 @@ npm test   # 校验 host 半、dsh.client 清单、client bundle handoff
 > `cordis_define` 动态插件源）。因与正式包代码长期双份维护漂移，已于 v1.4.1
 > 移除；如需动态用法可从 git 历史（tag `v1.4.0`）取回参考。
 
+## 反馈与贡献
+
+欢迎提交 **Issue** 反馈 Bug、功能建议或使用疑问：
+[GitHub Issues](https://github.com/objectivex666/dsh-settings-search/issues)，
+也欢迎直接发起 [Pull Request](https://github.com/objectivex666/dsh-settings-search/pulls)。
+
+提交 Issue 时，请尽量完整地提供以下信息，便于定位与复现：
+
+- **问题描述**：期望的行为与实际发生的情况。
+- **复现步骤**：一步步说明如何复现，包括触发关键词、所在设置页等。
+- **日志**：在「设置搜索」页的「日志与导出」中导出最近的搜索/运行日志并粘贴（API Key 不会被记录，可放心提供）；控制台报错也请一并附上。
+- **环境信息**：DSH 版本、Node.js 版本、插件版本（可在「设置搜索」页查看）、操作系统与浏览器。
+- **截图/录屏**：涉及界面表现时，附上截图或录屏更有帮助。
+
 ## 更新日志与发布
 
 每次版本更新需同时更新 GitHub Release 与 git tag，正文为双语，并写明「新功能」与「修复」：

package/lib/client.js

@@ -30,7 +30,7 @@ window.__ModuleLoader__.load({
 
     const NS = 'settings-search-v5'
     /** Single source of truth is package.json — scripts/check.mjs asserts this matches. */
-    const PKG_VERSION = '1.7.0'
+    const PKG_VERSION = '1.7.2'
     const NPM_NAME = '@objectivex666/dsh-settings-search'
     const zh = {
       title: '设置',
@@ -57,6 +57,8 @@ window.__ModuleLoader__.load({
       updCLI: 'DSH CLI',
       updNpx: 'npx',
       updRelease: '查看 release notes',
+      updReleaseNotes: '查看更新说明',
+      updFetchingNotes: '正在获取…',
       updRestart: '更新完成后重启 DSH，新版本才会生效。',
       aiSearch: 'AI 联想搜索',
       aiDesc: '没有直接匹配时，用你配置的模型（OpenAI 兼容或 Anthropic）理解目标并推荐设置项。',
@@ -110,6 +112,8 @@ window.__ModuleLoader__.load({
       updCLI: 'DSH CLI',
       updNpx: 'npx',
       updRelease: 'View release notes',
+      updReleaseNotes: 'View changelog',
+      updFetchingNotes: 'Fetching…',
       updRestart: 'Restart DSH after updating for the new version to take effect.',
       aiSearch: 'AI-assisted search',
       aiDesc: 'When no direct match exists, your own model (OpenAI-compatible or Anthropic) understands your goal and suggests settings.',
@@ -509,6 +513,7 @@ window.__ModuleLoader__.load({
       .sss-vr-update-actions { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; padding-top: 1px; }
       .sss-vr-link { appearance: none; font: inherit; cursor: pointer; border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; padding: 5px 14px; font-size: 13px; line-height: 1.5; color: var(--dsw-alias-label-secondary); background: 0 0; text-decoration: none; display: inline-flex; align-items: center; }
       .sss-vr-link:hover { color: var(--dsw-alias-label-primary); border-color: var(--dsw-alias-label-dimmed); }
+      .sss-vr-notes { box-sizing: border-box; border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; background: var(--dsw-alias-bg-layer-3); color: var(--dsw-alias-label-primary); padding: 10px 12px; font-size: 12px; line-height: 1.6; white-space: pre-wrap; word-break: break-word; max-height: 240px; overflow-y: auto; margin-top: 8px; }
     `
     let stylesInstalled = false
     function installStyles() {
@@ -1088,6 +1093,8 @@ window.__ModuleLoader__.load({
         const [latest, setLatest] = React.useState('')
         const [copied, setCopied] = React.useState(false)
         const [copyFailed, setCopyFailed] = React.useState(false)
+        const [notesState, setNotesState] = React.useState('idle') // idle | loading | loaded
+        const [notesBody, setNotesBody] = React.useState('')
         const [aiOn, setAiOn] = React.useState(aiSearchEnabled)
         const cfg = aiConfig()
         const [provider, setProvider] = React.useState(cfg.provider)
@@ -1212,6 +1219,28 @@ window.__ModuleLoader__.load({
         const releasesUrl = latest
           ? `https://github.com/objectivex666/dsh-settings-search/releases/tag/v${latest}`
           : 'https://github.com/objectivex666/dsh-settings-search/releases/latest'
+        const fetchNotes = async () => {
+          setNotesState('loading')
+          setNotesBody('')
+          try {
+            const res = await fetch('https://api.github.com/repos/objectivex666/dsh-settings-search/releases/latest', {
+              headers: { Accept: 'application/vnd.github+json', 'User-Agent': 'dsh-settings-search' },
+            })
+            if (!res.ok) throw new Error(`HTTP ${res.status}`)
+            const data = await res.json()
+            const body = typeof data?.body === 'string' ? data.body.trim() : ''
+            if (body === '') throw new Error('empty release body')
+            setNotesBody(body)
+            setNotesState('loaded')
+            log('info', '查看更新说明', { ok: true, tag: typeof data?.tag_name === 'string' ? data.tag_name : '' })
+          } catch {
+            setNotesState('idle')
+            setNotesBody('')
+            log('error', '查看更新说明失败（跳转 release）', {})
+            const opened = window.open(releasesUrl, '_blank', 'noopener,noreferrer')
+            if (!opened) window.location.href = releasesUrl
+          }
+        }
         const commandBlock = (label, command) => React.createElement('div', { className: 'sss-vr-update-command', key: command }, [
           React.createElement('div', { className: 'sss-vr-update-command-label' }, label),
           React.createElement('code', { className: 'sss-vr-code' }, command),
@@ -1332,9 +1361,15 @@ window.__ModuleLoader__.load({
                     copyFailed ? React.createElement('p', { className: 'sss-vr-note', style: { color: 'var(--dsw-alias-label-danger)' } }, t('updCopyFail')) : null,
                   ])
                 : null,
-              React.createElement('div', { className: 'sss-vr-actions' },
-                React.createElement('button', { className: 'sss-vr-btn', type: 'button', disabled: state === 'loading', onClick: () => { void check() } },
-                  state === 'loading' ? t('updChecking') : t('updCheck'))),
+              React.createElement('div', { className: 'sss-vr-actions' }, [
+                React.createElement('button', { className: 'sss-vr-btn sss-vr-primary', type: 'button', disabled: state === 'loading', onClick: () => { void check() } },
+                  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')),
+              ]),
+              notesState === 'loaded'
+                ? React.createElement('div', { className: 'sss-vr-notes' }, notesBody)
+                : null,
             ]),
             React.createElement('div', { className: 'sss-vr-field' }, [
               React.createElement('div', { className: 'sss-vr-field-head' }, [

package/package.json

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