@qzsy/dsh-command-palette 0.0.0-stage → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qzsy
+
+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.md

@@ -1,3 +1,144 @@
-# Temporary Holding Version
+# @qzsy/dsh-command-palette
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Packaged from the local DSH plugin dsh-command-palette; published under the @qzsy scope.
+
+## Install
+
+~~~bash
+dsh plugin add @qzsy/dsh-command-palette
+~~~
+
+## Upstream README
+
+# Command Palette for DSH
+
+A persistent DeepSeek Harness Client plugin that turns `Command+K` into a command
+palette for the Web/Desktop GUI: recent sessions with live status, workspaces,
+files, and actions — searchable in Chinese, English, full pinyin, pinyin
+initials, or any mixed form.
+
+## What it does
+
+- **Command+K on the Desktop app** opens a floating palette; the same chord toggles
+  it closed. In the browser profile it adopts the browser-safe chord that
+  `session.search` used before (Mod+Alt+K on macOS).
+- **Sections and filters**: All / Sessions / Workspaces / Files / Actions.
+  - *Sessions*: every non-blank, non-archived Session ordered by `updatedAt`,
+    with its Workspace label, a compact relative age, and a **live status
+    badge** from the unified Session status snapshot: `工作中` (pulsing blue dot),
+    `待批准` / `待审阅` / `待回答` (amber), or `已完成` (green, unread completion).
+    The section label counts active Sessions, e.g. `近期会话 · 2 个进行中`; the
+    count updates live while the palette stays open. When the Git badge bundle
+    is installed, the Workspace name under each thread title also carries that
+    Workspace's `+N −M` / `干净` / `无 Git` badge.
+  - **Sub-agent threads are hidden by default.** Sessions whose
+    `origin === "subagent"` are excluded from rows, search results, workspace
+    activity badges and counts. When any exist, the footer shows
+    `显示 N 个子代理会话`; the toggle includes them for the current palette
+    session and returns to the hidden default on the next open, so teammate and
+    research threads never crowd the list unless asked for.
+  - *Workspaces*: Workspaces ordered by their most recent Session activity, with
+    an abbreviated path and an aggregate status badge (`N 个工作中` /
+    `N 个待处理`). When the `@qzsy/dsh-git-badge` bundle is installed, each
+    workspace name also carries its Git badge: `+N −M` line changes, `干净` for a
+    clean repository, `无 Git` outside a repository, or the file count when only
+    untracked files changed. Git data comes from the Host's
+    `POST /api/git-badge` route (8 s palette cache); without that route the
+    badges are simply absent. Enter opens the newest Session in the Workspace,
+    or a fresh blank Session when it has none.
+  - *Files*: live, debounced Host file-reference lookup scoped to the Session in
+    the main panel; choosing a row opens the file in the right-hand preview.
+    Opened files are remembered locally (origin-scoped `localStorage`) and listed
+    as *Recent files* when the search box is empty. File matching stays
+    Host-ranked path matching (see limitations).
+  - *Actions*: every registered shortcut command (labels and keys come from the
+    live shortcut catalog, so plugin commands appear automatically). Enter
+    invokes the command through the shortcut registry; Settings and the keyboard
+    shortcut reference open from here.
+- **Mixed Chinese/English search** through [`text-search-engine`](https://github.com/cjinhuo/text-search-engine):
+  one query covers Han characters (`登录`), full pinyin (`denglu`), pinyin
+  initials (`dl`), English subsequences (`nextjs`), space-separated terms, and
+  mixed forms (`qunxingerp`, `群erp`, `qxkf`). Matched ranges are highlighted in
+  titles and subtitles. Ranking prefers tighter, earlier title hits, then
+  detail hits, then recency.
+- **Keyboard**: Up/Down move the selection, Enter opens, Escape closes. The
+  filter switches with bare ← / → (both directions, wrapping) or Tab /
+  Shift+Tab; holding Alt/Ctrl/Cmd with an arrow keeps native caret or word
+  movement inside the query. IME composition is never intercepted, so pinyin
+  candidate selection keeps working. Focus returns to whatever had it before
+  opening.
+- **Sidebar entry**: the *命令面板 / Command palette* row joins the global panel
+  stack directly below 自动化任务 / Automations (glyph-only in the collapsed
+  rail). Choosing it opens the overlay without switching the main panel: the row
+  is an action, so the plugin answers that one panel id in the layout selection
+  and delegates every other id to the layout owner.
+- Light/dark themes follow `--dsw-*` tokens; all copy is registered in the Client
+  locale service (zh/en).
+
+## Search engine integration
+
+DSH's browser module table only resolves its own platform modules and
+client-plugin rows, so a plain-JS plugin cannot `require('text-search-engine')`
+at runtime. The package's minified browser IIFE is therefore vendored and
+injected into the client bundle:
+
+- `vendor/text-search-engine.min.js` — exact browser build from the pinned
+  `text-search-engine@1.6.0` dependency (MIT; license in
+  `vendor/text-search-engine.LICENSE`).
+- `scripts/sync-vendor-engine.mjs` — rewrites the marked region in `client.js`
+  from the vendored file; run `node scripts/sync-vendor-engine.mjs` after
+  updating the vendored build.
+- `client.js` — the generated region captures the engine exports in a factory
+  scope constant and uses `createSearcher()` with `title`/`detail` fields,
+  custom ranking, and hit ranges for highlighting. If the engine fails to
+  initialize, a built-in subsequence matcher keeps the palette usable.
+
+File search is delegated to the Host (`ctx.remote.fileReferences.list`), which
+retrieves and ranks paths from the current Session workspace; pinyin is applied
+to sessions, workspaces, and actions, where titles are user-facing Chinese text.
+
+## Session status
+
+The palette reads the root `useSessionStatus` hook of the `shell.overlay` slot
+(provided by `dsh-client-ui-session`). That observable snapshot carries
+`running`, `pendingInteraction.kind`, and `completionUnread` per Session, so
+badges and counts change live as agents start, wait for input, and finish.
+Pending states take precedence over running, because they need the user.
+
+## Shortcut ownership
+
+`session.search` already owns `Command+K` in the shipped UI. The palette registers
+with the free `Command+Shift+P` default and, once per device preference document,
+uses the public `ctx.shortcuts.edit()` API to:
+
+1. clear `session.search`'s binding, and
+2. bind `palette.open` to the chord `session.search` had (Command+K on Desktop,
+   Mod+Alt+K in the browser).
+
+That is a normal, visible override in Settings → Keyboard shortcuts: both rows
+show as modified, and *Restore All Defaults* restores the palette to
+`Command+Shift+P` and search to `Command+K`. On the next launch the plugin
+re-adopts the chord while both rows are still at their unmodified defaults, so
+`Command+K` keeps opening the palette. Session search itself stays available from
+the palette's Actions list and from the sidebar search icon.
+
+## Install
+
+The bundle is installed into the current profile with
+`plugin_manager install_bundle` (absolute package directory). It needs no build
+step at install time: `client.js` is a plain-JS `__ModuleLoader__` module that
+only requires `react` from the browser module table, with the vendored engine
+already inlined.
+
+## Files
+
+- `package.json` — bundle manifest (`dsh.bundle.patch`, `dsh.client`, display resources)
+- `cordis.patch.yml` — inserts the Host row
+- `index.js` — Host half (no-op; the palette is client-only)
+- `client.js` — shortcut adoption, overlay palette, live status badges, ranked
+  mixed-script search, sidebar trigger, zh/en dictionaries
+- `vendor/` — vendored engine build and its MIT license
+- `scripts/sync-vendor-engine.mjs` — regenerates the vendored engine region
+- `locale/en.json`, `locale/zh.json` — Plugin Manager title/description
+- `icon.svg` — original artwork
+- `docs/` — verification screenshots

package/cordis.patch.yml

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