dsh-command-palette 0.1.0 → 0.1.2

package/README.en.md

@@ -5,7 +5,7 @@
 [![npm](https://img.shields.io/npm/v/dsh-command-palette)](https://www.npmjs.com/package/dsh-command-palette)
 [![stars](https://img.shields.io/github/stars/chenyangcun/dsh-command-palette?style=flat)](https://github.com/chenyangcun/dsh-command-palette)
 
-A keyboard-first command palette for standard DeepSeek Harness (DSH). Double-tap Shift to search and open sessions, workspaces, available features, or reusable custom commands.
+A keyboard-first command palette for standard DeepSeek Harness (DSH). Double-tap Shift to search and open sessions, workspaces, settings pages, available features, or reusable custom commands.
 
 ## Install
 
@@ -21,6 +21,7 @@ Restart the current DSH Web process after installation, then open **Settings →
 - **Recent sessions** — shows the six most recently updated valid sessions by default
 - **Session search** — searches titles, working directories, Agent presets, and session IDs
 - **Workspace switching** — starts a session in the selected workspace directly from the palette
+- **Settings navigation** — discovers registered DSH settings sections and opens the selected page directly
 - **Custom commands** — saves frequently used prompts and either creates a session each time or reuses a dedicated session
 - **Workspace binding** — chooses the workspace used when a custom command creates a session
 - **Provider API** — lets other Client plugins register commands or trigger the palette
@@ -32,6 +33,8 @@ Restart the current DSH Web process after installation, then open **Settings →
 3. Use `↑` / `↓` to select, Enter to run, and Esc to close.
 4. Add, edit, or remove custom commands under **Settings → Command Palette**.
 
+The palette reads the current settings-section registry whenever it opens, so settings pages added by other plugins automatically appear in the **Settings** group.
+
 When **Reuse dedicated session** is enabled, the first run creates and stores a session binding. Later runs continue in that session. If the bound session is archived or unavailable, the plugin creates a replacement automatically.
 
 ## Standard DSH and extension API
@@ -75,6 +78,16 @@ Service API:
 
 Provider IDs must be unique. Commands require at least `id`, `title`, and `run()`; the provider ID is automatically prefixed to the final command ID.
 
+Dynamic providers may also implement `subscribe(invalidate)`. Call `invalidate()` when external state changes to make the palette collect commands again. The disposer returned by `subscribe` runs automatically when the provider is removed:
+
+```js
+{
+  id: 'dynamic-plugin',
+  collect: () => buildCommands(currentState),
+  subscribe: (invalidate) => externalStore.subscribe(() => invalidate())
+}
+```
+
 Native Desktop browser tabs, Electron IPC, and native-view coordination are outside this package. A separate Desktop enhancement plugin can add them later through this API.
 
 ## Data storage

package/README.md

@@ -5,7 +5,7 @@
 [![npm](https://img.shields.io/npm/v/dsh-command-palette)](https://www.npmjs.com/package/dsh-command-palette)
 [![stars](https://img.shields.io/github/stars/chenyangcun/dsh-command-palette?style=flat)](https://github.com/chenyangcun/dsh-command-palette)
 
-适用于标准版 DeepSeek Harness（DSH）的键盘优先命令面板。连续快速按两次 Shift，即可搜索和打开会话、工作区、已安装功能或可复用的自定义指令。
+适用于标准版 DeepSeek Harness（DSH）的键盘优先命令面板。连续快速按两次 Shift，即可搜索和打开会话、工作区、设置页面、已安装功能或可复用的自定义指令。
 
 ## 安装
 
@@ -21,6 +21,7 @@ dsh plugin --profile web add dsh-command-palette
 - **最近会话**——默认展示最近更新的六个有效会话
 - **会话搜索**——按标题、工作目录、Agent 预设或会话 ID 搜索
 - **工作区切换**——从命令面板直接在目标工作区启动会话
+- **设置页跳转**——自动读取 DSH 已注册的设置菜单，搜索后直接打开对应设置页面
 - **自定义指令**——保存常用 Prompt，可选择每次新建会话或复用专属会话
 - **工作区绑定**——为自定义指令的新会话指定目标工作区
 - **扩展 Provider**——其他 Client 插件可以注册自己的命令或触发面板
@@ -32,6 +33,8 @@ dsh plugin --profile web add dsh-command-palette
 3. 使用 `↑` / `↓` 选择，按 Enter 执行，按 Esc 关闭。
 4. 在 **设置 → 命令面板** 中添加、编辑或删除自定义指令。
 
+插件会在每次打开面板时读取当前已注册的设置页面，因此其他插件新增的设置菜单也会自动出现在“设置”分组中。
+
 自定义指令启用“复用专属会话”后，首次执行会创建会话并保存绑定；后续执行继续向同一会话发送内容。如果绑定会话已经归档或不可用，插件会自动创建新会话。
 
 ## 标准 DSH 与扩展接口
@@ -75,6 +78,16 @@ exports.apply = (ctx) => {
 
 Provider ID 必须唯一。命令至少需要 `id`、`title` 和 `run()`；最终命令 ID 会自动加上 Provider 前缀。
 
+动态 Provider 可以额外实现 `subscribe(invalidate)`。当外部状态变化时调用 `invalidate()`，命令面板会重新收集命令；`subscribe` 返回的卸载函数会在 Provider 注销时自动执行：
+
+```js
+{
+  id: 'dynamic-plugin',
+  collect: () => buildCommands(currentState),
+  subscribe: (invalidate) => externalStore.subscribe(() => invalidate())
+}
+```
+
 Desktop 原生浏览器标签、Electron IPC 和原生视图协调不属于本包，后续可以由独立 Desktop 增强插件通过上述接口接入。
 
 ## 数据存储

package/client.js

@@ -7,8 +7,8 @@ window.__ModuleLoader__.load({
     const React = require('react')
     const ReactDOM = require('react-dom')
 
-    const GROUP_ORDER = ['features', 'browser', 'workspaces', 'sessions']
-    const GROUP_LABELS = { features: '功能', browser: '浏览器', workspaces: '工作区', sessions: '会话', recent: '最近会话' }
+    const GROUP_ORDER = ['features', 'settings', 'browser', 'workspaces', 'sessions']
+    const GROUP_LABELS = { features: '功能', settings: '设置', browser: '浏览器', workspaces: '工作区', sessions: '会话', recent: '最近会话' }
     const SUPPORTED_GROUPS = new Set(GROUP_ORDER)
 
     function normalizeCustomCommand(value) {
@@ -36,7 +36,10 @@ window.__ModuleLoader__.load({
       let revision = 0
       const emit = (reason) => {
         const snapshot = { open, revision: ++revision, reason }
-        for (const listener of listeners) listener(snapshot)
+        for (const listener of listeners) {
+          try { listener(snapshot) }
+          catch (error) { console.warn('[dsh-command-palette] subscriber failed:', error) }
+        }
       }
       return {
         registerProvider(provider) {
@@ -45,15 +48,33 @@ window.__ModuleLoader__.load({
           }
           const id = provider.id.trim()
           if (providers.has(id)) throw new Error(`Command palette provider already registered: ${id}`)
-          providers.set(id, provider)
+          const record = { provider, disposeSubscription: null }
+          providers.set(id, record)
           emit('provider-registered')
+          if (typeof provider.subscribe === 'function') {
+            try {
+              const dispose = provider.subscribe(() => emit('provider-updated'))
+              if (typeof dispose === 'function') record.disposeSubscription = dispose
+            } catch (error) {
+              console.warn(`[dsh-command-palette] provider ${id} subscription failed:`, error)
+            }
+          }
+          let removed = false
           return () => {
-            if (providers.delete(id)) emit('provider-removed')
+            if (removed) return
+            removed = true
+            const current = providers.get(id)
+            if (!current) return
+            providers.delete(id)
+            try { current.disposeSubscription?.() }
+            catch (error) { console.warn(`[dsh-command-palette] provider ${id} disposer failed:`, error) }
+            emit('provider-removed')
           }
         },
         collect(context = {}) {
           const commands = []
-          for (const [providerId, provider] of providers) {
+          for (const [providerId, record] of providers) {
+            const provider = record.provider
             const commandIds = new Set()
             let provided
             try { provided = provider.collect(context) }
@@ -106,6 +127,69 @@ window.__ModuleLoader__.load({
       return [command.title, command.subtitle, ...(command.keywords || [])].filter(Boolean).join(' ').toLocaleLowerCase()
     }
 
+    function resolveSettingsLabel(value) {
+      try {
+        const label = typeof value === 'function' ? value() : value
+        return typeof label === 'string' ? label.trim() : ''
+      } catch {
+        return ''
+      }
+    }
+
+    function findSettingsNavigationButton(label) {
+      for (const dialog of document.querySelectorAll('[role="dialog"]')) {
+        const nav = dialog.querySelector('nav')
+        if (!nav) continue
+        const button = Array.from(nav.querySelectorAll('button')).find((item) => item.textContent?.trim() === label)
+        if (button) return button
+      }
+      return null
+    }
+
+    async function openSettingsSection(label) {
+      let button = findSettingsNavigationButton(label)
+      if (!button) {
+        const trigger = document.querySelector('button[aria-haspopup="dialog"][aria-expanded]')
+        if (!trigger) throw new Error('当前 DSH 页面未提供可用的设置入口。')
+        trigger.click()
+        button = findSettingsNavigationButton(label)
+        for (let attempt = 0; !button && attempt < 4; attempt += 1) {
+          await new Promise((resolve) => requestAnimationFrame(resolve))
+          button = findSettingsNavigationButton(label)
+        }
+      }
+      if (!button) throw new Error(`无法打开设置页面：${label}`)
+      button.click()
+    }
+
+    function createSettingsProvider(ctx) {
+      return {
+        id: 'settings',
+        collect: () => {
+          let entries
+          try { entries = ctx.slots.entries('settings.section') }
+          catch { return [] }
+          return Array.from(entries || [])
+            .map((entry) => ({
+              id: typeof entry?.options?.id === 'string' ? entry.options.id.trim() : '',
+              order: typeof entry?.options?.order === 'number' ? entry.options.order : 0,
+              title: resolveSettingsLabel(entry?.options?.label)
+            }))
+            .filter(({ id, title }) => id && title)
+            .sort((left, right) => left.order - right.order)
+            .map(({ id, title }) => ({
+              id,
+              group: 'settings',
+              icon: '⚙',
+              title,
+              subtitle: '打开设置页面',
+              keywords: ['settings', '设置', id],
+              run: () => openSettingsSection(title)
+            }))
+        }
+      }
+    }
+
     function recentTimestamp(value) {
       return typeof value === 'number' ? value : Date.parse(String(value || '')) || 0
     }
@@ -358,6 +442,7 @@ window.__ModuleLoader__.load({
       const commandSettings = ctx.get('settingsScope').bind({ namespace: 'command-palette' })
       const paletteService = createCommandPaletteService()
       ctx.provide('commandPalette', paletteService)
+      const removeSettingsProvider = paletteService.registerProvider(createSettingsProvider(ctx))
       installStyles()
       const saveCustomCommands = async (next) => {
         const commands = normalizeCustomCommands(next)
@@ -399,6 +484,7 @@ window.__ModuleLoader__.load({
       ctx.slots.inject('shell.overlay', () => ctx.slots.register({ name: 'shell.overlay', id: 'dsh-command-palette', order: 220, inject: injected }, Palette))
       ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'command-palette-settings', order: 90, label: () => '命令面板', inject: injected }, ShortcutSettings))
       ctx.effect(() => () => {
+        removeSettingsProvider()
         paletteService.close()
         document.querySelector('style[data-plugin-css="dsh-command-palette"]')?.remove()
       }, 'dsh-command-palette: cleanup')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-command-palette",
-  "version": "0.1.0",
-  "description": "A keyboard-first command palette for DeepSeek Harness sessions, workspaces, features, and reusable custom commands.",
+  "version": "0.1.2",
+  "description": "A keyboard-first command palette for DeepSeek Harness sessions, workspaces, settings, features, and reusable custom commands.",
   "license": "MIT",
   "author": "chenyangcun",
   "type": "module",