dsh-command-palette 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chenyangcun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,102 @@
+# dsh-command-palette
+
+[中文](README.md) | English
+
+[![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.
+
+## Install
+
+```sh
+dsh plugin --profile web add dsh-command-palette
+```
+
+Restart the current DSH Web process after installation, then open **Settings → Command Palette** to manage custom commands.
+
+## What you get
+
+- **Double-Shift trigger** — listens only in the focused DSH Web window and does not register a system-wide shortcut
+- **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
+- **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
+
+## Use
+
+1. Double-tap Shift inside the DSH Web window.
+2. Type to filter commands.
+3. Use `↑` / `↓` to select, Enter to run, and Esc to close.
+4. Add, edit, or remove custom commands under **Settings → Command Palette**.
+
+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
+
+This package does not depend on Electron, a DSH Desktop preload, or a `window.dshDesktopCommandPalette` global. Sessions, workspaces, settings, and UI use standard DSH Client services.
+
+The plugin provides a `commandPalette` service in the Client Context. Enhancement plugins can register additional commands:
+
+```js
+exports.inject = ['commandPalette']
+
+exports.apply = (ctx) => {
+  ctx.inject(['commandPalette'], (scope) => {
+    scope.effect(() => scope.commandPalette.registerProvider({
+      id: 'my-plugin',
+      collect: () => [{
+        id: 'open-dashboard',
+        group: 'features',
+        icon: '⌘',
+        title: 'Open dashboard',
+        subtitle: 'Provided by an enhancement plugin',
+        keywords: ['dashboard'],
+        run: () => openDashboard()
+      }]
+    }))
+  })
+}
+```
+
+Service API:
+
+| Method | Purpose |
+| --- | --- |
+| `registerProvider(provider)` | Registers a command provider and returns a disposer |
+| `collect(context?)` | Collects commands from every registered provider |
+| `open()` | Opens the palette |
+| `close()` | Closes the palette |
+| `toggle()` | Toggles the palette |
+| `isOpen()` | Returns the current open state |
+| `subscribe(listener)` | Observes open-state or provider changes through `{ open, revision, reason }` snapshots |
+
+Provider IDs must be unique. Commands require at least `id`, `title`, and `run()`; the provider ID is automatically prefixed to the final command ID.
+
+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
+
+Custom commands are stored through the DSH settings system under `command-palette.commands`. The plugin creates no separate database and reads no model credentials.
+
+## Compatibility
+
+- Standard DeepSeek Harness (DSH)
+- `@deepseek-ai/dsh` `0.1.1-rc.2`
+- The standard Web Profile
+
+## Development
+
+```sh
+npm test
+npm run check
+npm pack --dry-run
+```
+
+## License
+
+[MIT](LICENSE)
+
+Bug reports and suggestions are welcome in [Issues](https://github.com/chenyangcun/dsh-command-palette/issues).

package/README.md

@@ -0,0 +1,102 @@
+# dsh-command-palette
+
+中文 | [English](README.en.md)
+
+[![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，即可搜索和打开会话、工作区、已安装功能或可复用的自定义指令。
+
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-command-palette
+```
+
+安装后重启当前 DSH Web 进程，然后打开 **设置 → 命令面板** 管理自定义指令。
+
+## 功能
+
+- **双 Shift 唤起**——只监听当前获得焦点的 DSH Web 窗口，不注册系统级全局快捷键
+- **最近会话**——默认展示最近更新的六个有效会话
+- **会话搜索**——按标题、工作目录、Agent 预设或会话 ID 搜索
+- **工作区切换**——从命令面板直接在目标工作区启动会话
+- **自定义指令**——保存常用 Prompt，可选择每次新建会话或复用专属会话
+- **工作区绑定**——为自定义指令的新会话指定目标工作区
+- **扩展 Provider**——其他 Client 插件可以注册自己的命令或触发面板
+
+## 使用
+
+1. 在 DSH Web 窗口内连续快速按两次 Shift。
+2. 输入关键词筛选命令。
+3. 使用 `↑` / `↓` 选择，按 Enter 执行，按 Esc 关闭。
+4. 在 **设置 → 命令面板** 中添加、编辑或删除自定义指令。
+
+自定义指令启用“复用专属会话”后，首次执行会创建会话并保存绑定；后续执行继续向同一会话发送内容。如果绑定会话已经归档或不可用，插件会自动创建新会话。
+
+## 标准 DSH 与扩展接口
+
+本包不依赖 Electron、DSH Desktop preload 或任何 `window.dshDesktopCommandPalette` 全局对象。会话、工作区、设置和 UI 均通过标准 DSH Client 服务实现。
+
+插件在 Client Context 中提供 `commandPalette` 服务，后续增强插件可以注册附加命令：
+
+```js
+exports.inject = ['commandPalette']
+
+exports.apply = (ctx) => {
+  ctx.inject(['commandPalette'], (scope) => {
+    scope.effect(() => scope.commandPalette.registerProvider({
+      id: 'my-plugin',
+      collect: () => [{
+        id: 'open-dashboard',
+        group: 'features',
+        icon: '⌘',
+        title: '打开控制台',
+        subtitle: '由扩展插件提供',
+        keywords: ['dashboard'],
+        run: () => openDashboard()
+      }]
+    }))
+  })
+}
+```
+
+服务接口：
+
+| 方法 | 说明 |
+| --- | --- |
+| `registerProvider(provider)` | 注册命令 Provider，返回卸载函数 |
+| `collect(context?)` | 收集当前所有扩展命令 |
+| `open()` | 打开命令面板 |
+| `close()` | 关闭命令面板 |
+| `toggle()` | 切换命令面板 |
+| `isOpen()` | 返回当前打开状态 |
+| `subscribe(listener)` | 监听打开状态或 Provider 变化，接收 `{ open, revision, reason }` 快照 |
+
+Provider ID 必须唯一。命令至少需要 `id`、`title` 和 `run()`；最终命令 ID 会自动加上 Provider 前缀。
+
+Desktop 原生浏览器标签、Electron IPC 和原生视图协调不属于本包，后续可以由独立 Desktop 增强插件通过上述接口接入。
+
+## 数据存储
+
+自定义指令通过 DSH 设置系统保存在 `command-palette.commands`，不单独创建数据库或读取模型凭据。
+
+## 兼容性
+
+- 标准版 DeepSeek Harness（DSH）
+- `@deepseek-ai/dsh` `0.1.1-rc.2`
+- 标准 Web Profile
+
+## 开发验证
+
+```sh
+npm test
+npm run check
+npm pack --dry-run
+```
+
+## 许可证
+
+[MIT](LICENSE)
+
+欢迎通过 [Issues](https://github.com/chenyangcun/dsh-command-palette/issues) 反馈问题或建议。

package/client.js

@@ -0,0 +1,412 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-command-palette',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+    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 SUPPORTED_GROUPS = new Set(GROUP_ORDER)
+
+    function normalizeCustomCommand(value) {
+      if (!value || typeof value !== 'object') return null
+      const name = typeof value.name === 'string' ? value.name.trim() : ''
+      const prompt = typeof value.prompt === 'string' ? value.prompt.trim() : ''
+      if (!name || !prompt) return null
+      return {
+        id: typeof value.id === 'string' && value.id ? value.id : crypto.randomUUID(),
+        name: name.slice(0, 80), prompt: prompt.slice(0, 12000),
+        sticky: value.sticky !== false,
+        ...(typeof value.workspaceId === 'string' && value.workspaceId ? { workspaceId: value.workspaceId } : {}),
+        ...(typeof value.stickySessionId === 'string' && value.stickySessionId ? { stickySessionId: value.stickySessionId } : {})
+      }
+    }
+
+    function normalizeCustomCommands(values) {
+      return (Array.isArray(values) ? values : []).map(normalizeCustomCommand).filter(Boolean).slice(0, 40)
+    }
+
+    function createCommandPaletteService() {
+      const providers = new Map()
+      const listeners = new Set()
+      let open = false
+      let revision = 0
+      const emit = (reason) => {
+        const snapshot = { open, revision: ++revision, reason }
+        for (const listener of listeners) listener(snapshot)
+      }
+      return {
+        registerProvider(provider) {
+          if (!provider || typeof provider.id !== 'string' || !provider.id.trim() || typeof provider.collect !== 'function') {
+            throw new TypeError('Command palette providers need a non-empty id and collect function.')
+          }
+          const id = provider.id.trim()
+          if (providers.has(id)) throw new Error(`Command palette provider already registered: ${id}`)
+          providers.set(id, provider)
+          emit('provider-registered')
+          return () => {
+            if (providers.delete(id)) emit('provider-removed')
+          }
+        },
+        collect(context = {}) {
+          const commands = []
+          for (const [providerId, provider] of providers) {
+            const commandIds = new Set()
+            let provided
+            try { provided = provider.collect(context) }
+            catch (error) {
+              console.warn(`[dsh-command-palette] provider ${providerId} failed:`, error)
+              continue
+            }
+            for (const command of Array.isArray(provided) ? provided : []) {
+              const commandId = typeof command?.id === 'string' ? command.id.trim() : ''
+              const title = typeof command?.title === 'string' ? command.title.trim() : ''
+              if (!commandId || !title || typeof command.run !== 'function' || commandIds.has(commandId)) continue
+              commandIds.add(commandId)
+              const group = SUPPORTED_GROUPS.has(command.group) ? command.group : 'features'
+              commands.push({ ...command, group, title, id: `${providerId}:${commandId}` })
+            }
+          }
+          return commands
+        },
+        subscribe(listener) {
+          listeners.add(listener)
+          return () => listeners.delete(listener)
+        },
+        open() { if (!open) { open = true; emit('open') } },
+        close() { if (open) { open = false; emit('close') } },
+        toggle() { open = !open; emit('toggle') },
+        isOpen() { return open }
+      }
+    }
+    const css = `
+      .dshPaletteLayer{position:fixed;z-index:220;inset:0;padding:12vh 16px 24px;display:flex;align-items:flex-start;justify-content:center;background:rgba(4,7,12,.38);backdrop-filter:blur(7px);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;color:var(--dsw-alias-label-primary)}
+      .dshPalettePanel{box-sizing:border-box;width:min(720px,100%);max-height:min(720px,80vh);padding-top:14px;overflow:hidden;display:flex;flex-direction:column;border:1px solid var(--dsw-alias-border-l2);border-radius:18px;background:light-dark(rgba(250,250,250,.98),rgba(17,20,27,.98));box-shadow:0 28px 90px rgba(0,0,0,.42)}
+      .dshPaletteSearchWrap{box-sizing:border-box;min-height:70px;margin:0 14px;max-height:70px;padding:0 19px;display:flex;align-items:center;gap:13px;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-1,rgba(255,255,255,.035))}
+      .dshPaletteSearchIcon{color:var(--dsw-alias-label-tertiary);font-size:20px}.dshPaletteSearch,.dshPaletteSearch:focus,.dshPaletteSearch:focus-visible{min-width:0;flex:1;border:0!important;outline:0!important;box-shadow:none!important;-webkit-appearance:none;appearance:none;background:transparent;color:inherit;font:inherit;font-size:18px}.dshPaletteKey{padding:4px 8px;border:1px solid var(--dsw-alias-border-l2);border-radius:7px;color:var(--dsw-alias-label-tertiary);font-size:12px}
+      .dshPaletteResults{padding:8px;overflow:auto}.dshPaletteGroupTitle{margin:10px 10px 5px;color:var(--dsw-alias-label-tertiary);font-size:11px;font-weight:650;letter-spacing:.04em}.dshPaletteRow{box-sizing:border-box;width:100%;min-height:49px;padding:8px 10px;border:0;border-radius:10px;background:transparent;color:inherit;display:flex;align-items:center;gap:11px;text-align:left;font:inherit;cursor:pointer}.dshPaletteRow[data-selected]{background:var(--dsw-alias-interactive-bg-hover)}.dshPaletteRow:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}.dshPaletteIcon{width:29px;height:29px;border-radius:8px;display:grid;place-items:center;background:var(--dsw-alias-bg-layer-2);font-size:14px}.dshPaletteBody{min-width:0;flex:1;display:flex;flex-direction:column;gap:2px}.dshPaletteTitle{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:14px;font-weight:600}.dshPaletteSubtitle{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-tertiary);font-size:12px}.dshPaletteState{color:var(--dsw-alias-label-tertiary);font-size:11px;white-space:nowrap}.dshPaletteState[data-kind="approval"]{color:#f59e0b}.dshPaletteState[data-kind="running"]{color:#60a5fa}.dshPaletteState[data-kind="completed"]{color:#34d399}.dshPaletteCloseTab{padding:4px 7px;border:0;border-radius:6px;background:transparent;color:var(--dsw-alias-label-tertiary);font:inherit;font-size:11px;cursor:pointer}.dshPaletteCloseTab:hover{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}
+      .dshPaletteEmpty{padding:58px 24px;text-align:center;color:var(--dsw-alias-label-tertiary);font-size:13px}.dshPaletteError{margin:0 12px 10px;padding:9px 11px;border:1px solid rgba(239,68,68,.32);border-radius:9px;background:rgba(239,68,68,.09);color:#ef4444;font-size:12px}.dshPaletteFooter{padding:8px 14px;border-top:1px solid var(--dsw-alias-border-l2);display:flex;justify-content:flex-end;gap:12px;color:var(--dsw-alias-label-tertiary);font-size:11px}
+      .dshPaletteSettings{position:relative;z-index:1;isolation:isolate;box-sizing:border-box;max-width:680px;margin:0 auto;padding:28px 30px 32px;border:1px solid var(--dsw-alias-border-l2);border-radius:18px;background:light-dark(#f8fafc,#0b1220);box-shadow:0 12px 32px rgba(0,0,0,.16);color:var(--dsw-alias-label-primary)}.dshPaletteSettings h2{position:relative;margin:0 0 9px;font-size:20px;line-height:1.35}.dshPaletteSettings p{position:relative;margin:0 0 22px;color:var(--dsw-alias-label-secondary);font-size:14px;line-height:1.6}.dshPaletteSettingCard{position:relative;padding:18px;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:light-dark(#fff,#0e1726);display:flex;flex-direction:column;gap:15px}.dshPaletteSettingLabel{font-size:12px;font-weight:650}.dshPaletteSettingInput{box-sizing:border-box;width:100%;height:38px;padding:0 11px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-base);color:inherit;font:inherit;font-size:13px;outline:none}.dshPaletteSettingInput:focus{border-color:var(--dsw-alias-brand-primary)}.dshPaletteSettingTextarea{box-sizing:border-box;min-height:90px;padding:10px 11px;resize:vertical;line-height:1.45}.dshPaletteSettingToggle{display:flex;align-items:center;gap:9px;font-size:13px}.dshPaletteSettingActions{display:flex;align-items:center;gap:10px}.dshPaletteSettingButton{height:34px;padding:0 14px;border:0;border-radius:8px;background:var(--dsw-alias-brand-primary,#4f46e5);color:#fff;font:inherit;font-size:13px;font-weight:600;cursor:pointer}.dshPaletteSettingButton[data-secondary]{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2)}.dshPaletteSettingStatus{font-size:12px;color:var(--dsw-alias-label-tertiary)}.dshPaletteSettingStatus[data-error]{color:#ef4444}.dshPaletteCustomList{display:flex;flex-direction:column;gap:8px}.dshPaletteCustomRow{display:flex;align-items:center;gap:10px;padding:10px 11px;border:1px solid var(--dsw-alias-border-l2);border-radius:9px}.dshPaletteCustomCopy{min-width:0;flex:1;display:flex;flex-direction:column;gap:3px}.dshPaletteCustomName{font-size:13px;font-weight:650}.dshPaletteCustomPrompt{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-tertiary);font-size:12px}.dshPaletteCustomTag{padding:3px 6px;border-radius:6px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);font-size:11px;white-space:nowrap}
+      @media (prefers-reduced-motion:no-preference){.dshPalettePanel{animation:dshPaletteIn .13s ease-out}@keyframes dshPaletteIn{from{opacity:0;transform:translateY(-8px) scale(.985)}to{opacity:1;transform:none}}}
+    `
+
+    function installStyles() {
+      if (document.querySelector('style[data-plugin-css="dsh-command-palette"]')) return
+      const tag = document.createElement('style')
+      tag.dataset.plugin = 'dsh-command-palette'
+      tag.dataset.pluginCss = 'dsh-command-palette'
+      tag.textContent = css
+      document.head.appendChild(tag)
+    }
+
+    function searchable(command) {
+      return [command.title, command.subtitle, ...(command.keywords || [])].filter(Boolean).join(' ').toLocaleLowerCase()
+    }
+
+    function recentTimestamp(value) {
+      return typeof value === 'number' ? value : Date.parse(String(value || '')) || 0
+    }
+
+    function commandState(item) {
+      if (item.pendingInteraction) return { text: item.pendingInteraction === 'approval' ? '等待审批' : '等待操作', kind: 'approval' }
+      if (item.running) return { text: '运行中', kind: 'running' }
+      if (item.completed) return { text: '已完成', kind: 'completed' }
+      if (item.current) return { text: '当前', kind: 'current' }
+      return null
+    }
+
+    function groupVisibleCommands(commands, hasQuery) {
+      const byGroup = (group) => commands.filter((item) => item.group === group)
+      if (hasQuery) return GROUP_ORDER.map((group) => [group, byGroup(group)]).filter(([, items]) => items.length)
+      const recentSessions = byGroup('sessions')
+        .sort((left, right) => recentTimestamp(right.updatedAt) - recentTimestamp(left.updatedAt))
+        .slice(0, 6)
+      const otherGroups = GROUP_ORDER
+        .filter((group) => group !== 'sessions')
+        .map((group) => [group, byGroup(group)])
+        .filter(([, items]) => items.length)
+      return recentSessions.length ? [['recent', recentSessions], ...otherGroups] : otherGroups
+    }
+
+    function buildCommands({ sessions, workspaces, customCommands, extensionCommands, runCustomCommand, openSession, startSession }) {
+      const commands = []
+      for (const command of customCommands) {
+        commands.push({
+          id: `custom:${command.id}`, group: 'features', icon: '⌘', title: command.name,
+          subtitle: command.sticky ? '自定义指令 · 复用专属会话' : '自定义指令 · 新建会话',
+          keywords: ['custom', '自定义指令', command.prompt],
+          run: () => runCustomCommand(command)
+        })
+      }
+      commands.push(...extensionCommands)
+      for (const workspace of workspaces?.items || []) {
+        const workspaceId = workspace.workspaceId || workspace.id
+        if (!workspaceId) continue
+        commands.push({
+          id: `workspace:${workspaceId}`, group: 'workspaces', icon: '◇', title: workspace.title || workspace.path || '工作区', subtitle: workspace.path || '', keywords: [workspaceId, workspace.path],
+          run: () => startSession(workspaceId)
+        })
+      }
+      const archived = new Set(workspaces?.archivedSessionIds || [])
+      for (const id of sessions?.ids || []) {
+        const item = sessions.byId?.[id]
+        if (!item || item.blank || item.archived === true || item.origin === 'subagent' || archived.has(id)) continue
+        commands.push({
+          id: `session:${id}`, group: 'sessions', icon: '◆', title: item.displayTitle || item.title || id, subtitle: item.cwd || '',
+          keywords: [item.agentPreset, item.cwd, id], updatedAt: item.updatedAt, current: id === sessions.current, running: item.running, pendingInteraction: item.pendingInteraction, completed: item.completed,
+          run: () => openSession(id)
+        })
+      }
+      return commands
+    }
+
+    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 customCommands = normalizeCustomCommands(commandSettings.value?.commands)
+      const [open, setOpen] = React.useState(paletteService.isOpen())
+      const [query, setQuery] = React.useState('')
+      const [selected, setSelected] = React.useState(0)
+      const [serviceRevision, setServiceRevision] = React.useState(0)
+      const [executing, setExecuting] = React.useState(false)
+      const [error, setError] = React.useState('')
+      const previousFocus = React.useRef(null)
+      const paletteOpen = React.useRef(false)
+      const lastShiftDownAt = React.useRef(null)
+      const extensionCommands = React.useMemo(() => paletteService.collect({ sessions, workspaces }), [paletteService, sessions, workspaces, serviceRevision])
+      const commands = React.useMemo(() => buildCommands({ sessions, workspaces, customCommands, extensionCommands, runCustomCommand, openSession, startSession }), [sessions, workspaces, customCommands, extensionCommands, runCustomCommand, openSession, startSession])
+      const normalizedQuery = query.trim().toLocaleLowerCase()
+      const filtered = React.useMemo(() => commands.filter((item) => !normalizedQuery || searchable(item).includes(normalizedQuery)), [commands, normalizedQuery])
+      const grouped = React.useMemo(() => groupVisibleCommands(filtered, Boolean(normalizedQuery)), [filtered, normalizedQuery])
+      const visibleCommands = React.useMemo(() => grouped.flatMap(([, items]) => items), [grouped])
+
+      const close = React.useCallback((restoreFocus = true) => {
+        paletteOpen.current = false
+        setOpen(false); setQuery(''); setSelected(0); setError(''); setExecuting(false)
+        paletteService.close()
+        if (restoreFocus) requestAnimationFrame(() => previousFocus.current?.isConnected && previousFocus.current.focus?.())
+      }, [paletteService])
+
+      const showPalette = React.useCallback(() => {
+        if (paletteOpen.current) return
+        previousFocus.current = document.activeElement
+        paletteOpen.current = true
+        setOpen(true); setQuery(''); setSelected(0); setError('')
+        paletteService.open()
+      }, [paletteService])
+
+      React.useEffect(() => {
+        const unsubscribe = paletteService.subscribe((snapshot) => {
+          setServiceRevision((value) => value + 1)
+          if (snapshot.open) showPalette()
+          else if (paletteOpen.current) {
+            paletteOpen.current = false
+            setOpen(false); setQuery(''); setSelected(0); setError(''); setExecuting(false)
+          }
+        })
+        const onFocusedWindowKeyDown = (event) => {
+          if (event.isComposing) return
+          if (event.key !== 'Shift' || event.repeat || event.altKey || event.ctrlKey || event.metaKey) {
+            lastShiftDownAt.current = null
+            return
+          }
+          const now = performance.now()
+          if (lastShiftDownAt.current !== null && now - lastShiftDownAt.current <= 400) {
+            lastShiftDownAt.current = null
+            paletteService.toggle()
+          } else {
+            lastShiftDownAt.current = now
+          }
+        }
+        window.addEventListener('keydown', onFocusedWindowKeyDown, true)
+        return () => {
+          unsubscribe?.()
+          window.removeEventListener('keydown', onFocusedWindowKeyDown, true)
+        }
+      }, [paletteService, showPalette])
+
+      React.useEffect(() => { paletteOpen.current = open }, [open])
+
+      React.useEffect(() => {
+        if (selected >= visibleCommands.length) setSelected(Math.max(0, visibleCommands.length - 1))
+      }, [visibleCommands.length, selected])
+
+      const execute = React.useCallback(async (command) => {
+        if (!command || executing) return
+        setExecuting(true); setError('')
+        try { await command.run(); close(false) }
+        catch (cause) { setExecuting(false); setError(String(cause?.message || cause || '命令执行失败')) }
+      }, [executing, close])
+
+      if (!open) return null
+      const activeId = visibleCommands[selected] ? `dsh-palette-option-${selected}` : undefined
+      const onKeyDown = (event) => {
+        if (event.isComposing) return
+        if (event.key === 'Escape') { event.preventDefault(); close(true); return }
+        if (event.key === 'ArrowDown') { event.preventDefault(); setSelected((value) => Math.min(value + 1, Math.max(0, visibleCommands.length - 1))); return }
+        if (event.key === 'ArrowUp') { event.preventDefault(); setSelected((value) => Math.max(0, value - 1)); return }
+        if (event.key === 'Enter') { event.preventDefault(); void execute(visibleCommands[selected]) }
+      }
+      let flatIndex = -1
+      return ReactDOM.createPortal(React.createElement('div', { className: 'dshPaletteLayer', onMouseDown: (event) => { if (event.target === event.currentTarget) close(true) } },
+        React.createElement('section', { className: 'dshPalettePanel', role: 'dialog', 'aria-modal': 'true', 'aria-label': '命令面板' },
+          React.createElement('div', { className: 'dshPaletteSearchWrap' },
+            React.createElement('span', { className: 'dshPaletteSearchIcon', 'aria-hidden': 'true' }, '⌕'),
+            React.createElement('input', { autoFocus: true, className: 'dshPaletteSearch', role: 'combobox', 'aria-expanded': 'true', 'aria-controls': 'dsh-palette-results', 'aria-activedescendant': activeId, placeholder: '搜索功能、工作区或会话…', value: query, onChange: (event) => { setQuery(event.target.value); setSelected(0) }, onKeyDown }),
+            React.createElement('span', { className: 'dshPaletteKey' }, 'Esc')
+          ),
+          React.createElement('div', { id: 'dsh-palette-results', className: 'dshPaletteResults', role: 'listbox' },
+            grouped.length === 0 ? React.createElement('div', { className: 'dshPaletteEmpty' }, '没有找到匹配内容') : grouped.map(([group, items]) =>
+              React.createElement(React.Fragment, { key: group },
+                React.createElement('div', { className: 'dshPaletteGroupTitle' }, GROUP_LABELS[group]),
+                items.map((item) => {
+                  flatIndex += 1; const index = flatIndex; const state = commandState(item)
+                  return React.createElement('div', { key: item.id, style: { display: 'flex', alignItems: 'center' } },
+                    React.createElement('button', { id: `dsh-palette-option-${index}`, type: 'button', className: 'dshPaletteRow', role: 'option', 'aria-selected': index === selected, 'data-selected': index === selected ? '' : undefined, onMouseEnter: () => setSelected(index), onClick: () => void execute(item) },
+                      React.createElement('span', { className: 'dshPaletteIcon', 'aria-hidden': 'true' }, item.icon),
+                      React.createElement('span', { className: 'dshPaletteBody' }, React.createElement('span', { className: 'dshPaletteTitle' }, item.title), item.subtitle ? React.createElement('span', { className: 'dshPaletteSubtitle' }, item.subtitle) : null),
+                      state ? React.createElement('span', { className: 'dshPaletteState', 'data-kind': state.kind }, state.text) : null
+                    ),
+                    item.close ? React.createElement('button', { type: 'button', className: 'dshPaletteCloseTab', title: '执行次要操作', 'aria-label': `操作${item.title}`, onClick: async (event) => { event.stopPropagation(); try { await item.close(); setServiceRevision((value) => value + 1) } catch (cause) { setError(String(cause?.message || cause)) } } }, '操作') : null
+                  )
+                })
+              )
+            )
+          ),
+          error ? React.createElement('div', { className: 'dshPaletteError', role: 'alert' }, error) : null,
+          React.createElement('footer', { className: 'dshPaletteFooter' }, React.createElement('span', null, '↑↓ 选择'), React.createElement('span', null, 'Enter 打开'))
+        )
+      ), document.body)
+    }
+
+    function ShortcutSettings({ useWorkspaces, useCommandSettings, saveCustomCommands }) {
+      const commandSettings = useCommandSettings((value) => value)
+      const commands = normalizeCustomCommands(commandSettings.value?.commands)
+      const workspaceState = typeof useWorkspaces === 'function' ? useWorkspaces((value) => value) : { items: [] }
+      const workspaces = workspaceState?.items || []
+      const emptyDraft = { name: '', prompt: '', sticky: true, workspaceId: '' }
+      const [draft, setDraft] = React.useState(emptyDraft)
+      const [editingId, setEditingId] = React.useState(null)
+      const [saveError, setSaveError] = React.useState('')
+      const save = async () => {
+        const next = normalizeCustomCommand({ ...draft, id: editingId || undefined })
+        if (!next) return
+        try {
+          if (editingId) {
+            const previous = commands.find((command) => command.id === editingId)
+            next.stickySessionId = previous?.sticky && next.sticky ? previous.stickySessionId : undefined
+            await saveCustomCommands(commands.map((command) => command.id === editingId ? next : command))
+          } else {
+            await saveCustomCommands([...commands, next])
+          }
+          setSaveError(''); setDraft(emptyDraft); setEditingId(null)
+        } catch (cause) {
+          setSaveError(String(cause?.message || cause))
+        }
+      }
+      const remove = async (id) => {
+        try { await saveCustomCommands(commands.filter((command) => command.id !== id)); setSaveError('') }
+        catch (cause) { setSaveError(String(cause?.message || cause)) }
+      }
+      const edit = (command) => {
+        setEditingId(command.id)
+        setDraft({ name: command.name, prompt: command.prompt, sticky: command.sticky, workspaceId: command.workspaceId || '' })
+      }
+      return React.createElement('div', { className: 'dshPaletteSettings' },
+        React.createElement('h2', null, '快捷键'),
+        React.createElement('p', null, '命令面板只在当前 DSH Web 窗口获得焦点时响应。'),
+        React.createElement('div', { className: 'dshPaletteSettingCard' },
+          React.createElement('div', { className: 'dshPaletteSettingLabel' }, '唤起命令面板'),
+          React.createElement('div', { className: 'dshPaletteSettingInput', role: 'status' }, '连续快速按两次 Shift'),
+          React.createElement('span', { className: 'dshPaletteSettingStatus' }, '两次按键间隔需不超过 400 毫秒；不会监听其他应用。')
+        ),
+        React.createElement('h2', { style: { marginTop: 28 } }, '自定义指令'),
+        React.createElement('p', null, '为常用任务配置名称和发送给 DSH 的内容。启用“复用专属会话”后，同一指令会持续发送到它首次创建的会话。'),
+        React.createElement('div', { className: 'dshPaletteSettingCard' },
+          React.createElement('label', null, React.createElement('div', { className: 'dshPaletteSettingLabel' }, '指令名称'), React.createElement('input', { className: 'dshPaletteSettingInput', value: draft.name, maxLength: 80, placeholder: '例如：生成每日新闻', onChange: (event) => setDraft({ ...draft, name: event.target.value }) })),
+          React.createElement('label', null, React.createElement('div', { className: 'dshPaletteSettingLabel' }, '发送给 DSH 的指令内容'), React.createElement('textarea', { className: 'dshPaletteSettingInput dshPaletteSettingTextarea', value: draft.prompt, maxLength: 12000, placeholder: '例如：生成今日的每日新闻，并保存日报。', onChange: (event) => setDraft({ ...draft, prompt: event.target.value }) })),
+          React.createElement('label', null, React.createElement('div', { className: 'dshPaletteSettingLabel' }, '新会话的目标工作区'), React.createElement('select', { className: 'dshPaletteSettingInput', value: draft.workspaceId, onChange: (event) => setDraft({ ...draft, workspaceId: event.target.value }) },
+            React.createElement('option', { value: '' }, '未分组（默认）'),
+            workspaces.map((workspace) => {
+              const workspaceId = workspace.workspaceId || workspace.id
+              return workspaceId ? React.createElement('option', { key: workspaceId, value: workspaceId }, workspace.title || workspace.path || workspaceId) : null
+            })
+          )),
+          React.createElement('span', { className: 'dshPaletteSettingStatus' }, '只在该指令创建新会话时生效；已有粘性会话不会被移动。'),
+          React.createElement('label', { className: 'dshPaletteSettingToggle' }, React.createElement('input', { type: 'checkbox', checked: draft.sticky, onChange: (event) => setDraft({ ...draft, sticky: event.target.checked }) }), React.createElement('span', null, '复用专属会话（推荐用于日报、周报等周期任务）')),
+          React.createElement('div', { className: 'dshPaletteSettingActions' },
+            React.createElement('button', { type: 'button', className: 'dshPaletteSettingButton', disabled: !draft.name.trim() || !draft.prompt.trim(), onClick: () => void save() }, editingId ? '保存修改' : '添加指令'),
+            editingId ? React.createElement('button', { type: 'button', className: 'dshPaletteSettingButton', 'data-secondary': '', onClick: () => { setDraft(emptyDraft); setEditingId(null) } }, '取消') : null
+          ),
+          saveError ? React.createElement('span', { className: 'dshPaletteSettingStatus', 'data-error': '' }, `保存失败：${saveError}`) : null,
+          commands.length ? React.createElement('div', { className: 'dshPaletteCustomList' }, commands.map((command) => React.createElement('div', { className: 'dshPaletteCustomRow', key: command.id },
+            React.createElement('div', { className: 'dshPaletteCustomCopy' }, React.createElement('span', { className: 'dshPaletteCustomName' }, command.name), React.createElement('span', { className: 'dshPaletteCustomPrompt' }, command.prompt)),
+            React.createElement('span', { className: 'dshPaletteCustomTag' }, command.sticky ? command.stickySessionId ? '已绑定会话' : '首次创建后复用' : '每次新建'),
+            React.createElement('button', { type: 'button', className: 'dshPaletteSettingButton', 'data-secondary': '', onClick: () => edit(command) }, '编辑'),
+            React.createElement('button', { type: 'button', className: 'dshPaletteSettingButton', 'data-secondary': '', onClick: () => void remove(command.id) }, '删除')
+          ))) : React.createElement('span', { className: 'dshPaletteSettingStatus' }, '尚未配置自定义指令。')
+        )
+      )
+    }
+
+    const inject = ['slots', 'sessions', 'workspaces', 'settingsScope']
+    function apply(ctx) {
+      const commandSettings = ctx.get('settingsScope').bind({ namespace: 'command-palette' })
+      const paletteService = createCommandPaletteService()
+      ctx.provide('commandPalette', paletteService)
+      installStyles()
+      const saveCustomCommands = async (next) => {
+        const commands = normalizeCustomCommands(next)
+        await commandSettings.set('commands', commands)
+        return commands
+      }
+      const runCustomCommand = async (command) => {
+        const snapshot = ctx.sessions.list.getSnapshot()
+        const archived = new Set(ctx.workspaces.list?.getSnapshot?.().archivedSessionIds || [])
+        let sessionId = command.sticky ? command.stickySessionId : undefined
+        const stickySession = sessionId ? snapshot.byId?.[sessionId] : undefined
+        if (!stickySession || stickySession.archived === true || stickySession.origin === 'subagent' || archived.has(sessionId)) {
+          const configuredWorkspace = command.workspaceId && ctx.workspaces.list.getSnapshot().items.some((workspace) => (workspace.workspaceId || workspace.id) === command.workspaceId)
+            ? command.workspaceId
+            : undefined
+          sessionId = configuredWorkspace ? await ctx.sessions.create({ workspaceId: configuredWorkspace }) : await ctx.sessions.create()
+          if (command.sticky) {
+            const current = normalizeCustomCommands(commandSettings.getSnapshot().value?.commands)
+            await saveCustomCommands(current.map((item) => item.id === command.id ? { ...item, stickySessionId: sessionId } : item))
+          }
+        }
+        ctx.sessions.open(sessionId)
+        const sessionContext = ctx.sessions.scope(sessionId)
+        const session = sessionContext ? ctx.sessions.sessionOf(sessionContext) : undefined
+        if (!session) throw new Error('当前 DSH 版本无法定位自定义指令的目标会话。')
+        const result = await session.prompt([{ type: 'text', text: command.prompt }], 'queue')
+        if (!result.ok) throw new Error(`自定义指令发送失败：${result.error?.message || '未知错误'}`)
+      }
+      const injected = () => ({
+        useSessions: ctx.sessions.list,
+        useWorkspaces: ctx.workspaces.list,
+        useCommandSettings: commandSettings,
+        saveCustomCommands,
+        paletteService,
+        openSession: (sessionId) => ctx.sessions.open(sessionId),
+        startSession: (workspaceId) => ctx.workspaces.startSession(workspaceId),
+        runCustomCommand
+      })
+      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(() => () => {
+        paletteService.close()
+        document.querySelector('style[data-plugin-css="dsh-command-palette"]')?.remove()
+      }, 'dsh-command-palette: cleanup')
+    }
+
+    exports.apply = apply
+    exports.inject = inject
+    exports.__testing = { groupVisibleCommands }
+    return module.exports
+  }
+})

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-command-palette
+      name: dsh-command-palette

package/index.js

@@ -0,0 +1,24 @@
+import Schema from '@deepseek-ai/schemastery'
+
+export const name = 'command-palette'
+export const inject = ['settings']
+export const SETTINGS_NAMESPACE = 'command-palette'
+
+const CustomCommand = Schema.object({
+  id: Schema.string().required().description('Stable command identifier'),
+  name: Schema.string().required().description('Display name'),
+  prompt: Schema.string().required().description('Prompt sent to DSH'),
+  sticky: Schema.boolean().default(true).description('Reuse a dedicated session'),
+  workspaceId: Schema.string().default('').description('Workspace used for new sessions'),
+  stickySessionId: Schema.string().default('').description('Session currently bound to this command')
+})
+
+export const Config = Schema.object({
+  commands: Schema.array(CustomCommand).default([]).description('Reusable custom commands')
+})
+
+export function apply(ctx, config) {
+  ctx.inject(['settings'], (settingsCtx) => {
+    settingsCtx.settings.register(SETTINGS_NAMESPACE, Config, { base: config || {} })
+  })
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "dsh-command-palette",
+  "version": "0.1.0",
+  "description": "A keyboard-first command palette for DeepSeek Harness sessions, workspaces, features, and reusable custom commands.",
+  "license": "MIT",
+  "author": "chenyangcun",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "check": "node --check index.js && node --check client.js && npm test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chenyangcun/dsh-command-palette.git"
+  },
+  "homepage": "https://github.com/chenyangcun/dsh-command-palette#readme",
+  "bugs": {
+    "url": "https://github.com/chenyangcun/dsh-command-palette/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "command-palette",
+    "workspace",
+    "session"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "3.18.1"
+  },
+  "devDependencies": {
+    "jsdom": "26.1.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.1-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-layout": ">=0.1.1-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.1-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-sidebar": ">=0.1.1-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2 <0.2.0-0",
+    "react": ">=18.2.0 <19.0.0-0",
+    "react-dom": ">=18.2.0 <19.0.0-0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
+  }
+}