dsh-command-palette 0.1.1 → 0.1.2

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

@@ -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) }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-command-palette",
-  "version": "0.1.1",
+  "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",