dsh-command-palette 0.1.1 → 0.1.3

package/README.en.md

@@ -78,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

@@ -78,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

@@ -6,6 +6,7 @@ window.__ModuleLoader__.load({
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
     const React = require('react')
     const ReactDOM = require('react-dom')
+    const { useStore } = require('@deepseek-ai/dsh-client-runtime')
 
     const GROUP_ORDER = ['features', 'settings', 'browser', 'workspaces', 'sessions']
     const GROUP_LABELS = { features: '功能', settings: '设置', browser: '浏览器', workspaces: '工作区', sessions: '会话', recent: '最近会话' }
@@ -36,7 +37,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 +49,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) }
@@ -227,9 +249,9 @@ window.__ModuleLoader__.load({
     }
 
     function Palette({ useSessions, useWorkspaces, useCommandSettings, saveCustomCommands, openSession, startSession, runCustomCommand, paletteService }) {
-      const sessions = useSessions((value) => value)
-      const workspaces = useWorkspaces((value) => value)
-      const commandSettings = useCommandSettings((value) => value)
+      const sessions = useStore(useSessions)
+      const workspaces = useStore(useWorkspaces)
+      const commandSettings = useStore(useCommandSettings)
       const customCommands = normalizeCustomCommands(commandSettings.value?.commands)
       const [open, setOpen] = React.useState(paletteService.isOpen())
       const [query, setQuery] = React.useState('')
@@ -347,9 +369,9 @@ window.__ModuleLoader__.load({
     }
 
     function ShortcutSettings({ useWorkspaces, useCommandSettings, saveCustomCommands }) {
-      const commandSettings = useCommandSettings((value) => value)
+      const commandSettings = useStore(useCommandSettings)
       const commands = normalizeCustomCommands(commandSettings.value?.commands)
-      const workspaceState = typeof useWorkspaces === 'function' ? useWorkspaces((value) => value) : { items: [] }
+      const workspaceState = useStore(useWorkspaces)
       const workspaces = workspaceState?.items || []
       const emptyDraft = { name: '', prompt: '', sticky: true, workspaceId: '' }
       const [draft, setDraft] = React.useState(emptyDraft)

package/package.json

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