dsh-universal-palette
适用于 DeepSeek Harness Web 的高密度半透明玻璃风格通用面板：将命令、模型、会话、对话命中项、技能和参考资料整合到一个以键盘操作为主的界面中，并提供丰富条目的次级操作。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yunmin311/dsh-universal-palette#dbfed4e6e7aab813c4b92764ec7d7e3f792ae407Universal Palette 以 dsh-universal-palette 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Dense translucent-glass Universal Palette for DeepSeek Harness Web.
One sentence differentiation: not "another command palette" — it finds a DSH object and then, in the same keyboard flow, executes the next action that object currently allows (open / reference / copy / switch / load).
| Shortcut | Where |
|---|---|
Ctrl+Shift+K (Windows/Linux) · Cmd+Shift+K (macOS) | Open the palette |
The default shortcut is deliberately off Ctrl/Cmd+K (taken by
dsh-spotlight) and off Alt+M (taken by dsh-model-palette).
When a known conflict is detected, the palette surfaces it as a soft
notice inside the surface — it never silently overrides.
This release is verified against the exact upstream SHA below —
not latest master, not 0.1.x, not any moving target.
| Upstream | deepseek-ai/deepseek-harness |
| SHA | 76fda729799fe9b3848dbe2c211d4b231032b81e |
| Root package version | 0.1.2-rc.1 |
Other DSH versions are best-effort / unverified. Compatibility is not guaranteed for any other SHA.
The V1 P0 set is exactly:
session.selectModelctx.sessionQuery against a
persistent FTS index opened on first-search (enabled by the
plugin's cordis.patch.yml)0.46·text + 0.19·context + 0.15·frecency + 0.10·pin + 0.10·providerHint, no LLMSkills, generic References, Alias, and Hide remain in the code path as optional surfaces; none are part of the V1 release gate. No V1.1 features are tracked here.
Open /
Switch / Load as primary, plus a small … that opens a second
layer (Tab / →) with Reference, Copy excerpt, Pin.localStorage under the
dsh-universal-palette namespace). Pin persists the same way.
Reset ranking clears frecency, not pins.shell.overlay → no palette: the UI mounts only through the
public Slot system. If the slot is absent in the running DSH build,
the palette disables itself — there is no document.body fallback,
no DOM scraping, no first-party patching.Requirements: dsh CLI on a web profile, version
0.1.2-rc.1 (matching the locked SHA).
dsh plugin --profile web add github:yunmin311/dsh-universal-palette#main
The plugin's cordis.patch.yml activates the shipped
session-query-sqlite row (persistent path under DSH_HOME,
openAt: first-search) so Conversation Hits populate without
requiring the user to install any additional plugin.
Then start DSH Web:
dsh --profile web
Press the default shortcut to open.
| Action | Key |
|---|---|
| Open palette | Ctrl/Cmd+Shift+K |
| Close palette | Esc (or Esc again from Action Panel) |
| Move selection | ↑ / ↓ |
| Run primary action | Enter |
| Open Action Panel | Tab or → |
| Move within Action Panel | ↑ / ↓ |
| Back from Action Panel | Esc or Tab |
| Force commands/actions | type > first |
Empty query shows up to 7 items: Pinned → Current-context → Recent/Frequent. No dashboard, no marketing text — the palette opens into the input box.
| Plugin | Shortcut | What it covers | How Universal Palette differs |
|---|---|---|---|
dsh-spotlight | Ctrl/Cmd+K | Native slash commands, recent sessions, DOM-action discovery, plugin settings | Universal Palette does not scrape host DOM. It talks only to host services and adds rich secondary actions on every result. |
dsh-command-palette | Double Shift | Sessions, workspaces, settings, features, custom prompts, provider extension | Universal Palette is not a settings navigator. It federates only the host's native contract surface. |
dsh-session-workbench (was dsh-session-kb) | sidebar tab | FTS fragment hits + locate + @recall | Universal Palette activates the same shipped session-query-sqlite row, no second FTS index, no dsh-session-kb clone. |
dsh-reference-anything | @ | Unified @ menu (commands, skills, files, sessions, external conversations) | Universal Palette is a global action surface. Reference insertion is one secondary action among many on a result — it never replaces the @ flow. |
dsh-model-palette | Alt+M | Provider rail + model config + OpenRouter media | Universal Palette exposes Model as one item kind with Switch as primary; model configuration is not its concern. |
dsh-codex-ui | sidebar replacement | Replaces main UI | Universal Palette is an additive overlay only. Uninstalling it leaves zero layout residue. |
Install any combination. Universal Palette picks a non-conflicting shortcut by default; when conflicts are detected, it surfaces them instead of overriding.
The browser half ships at dist/client.js and exports a default
activateClient(ctx) function. The DSH shell calls it after the host
graph loads.
import activateClient, { type ClientCtx } from '@yunmin311/dsh-universal-palette/client'
const handle = activateClient({
host: {
commands: { /* wire adapter */ },
sessions: { /* wire adapter */ },
modelDirectory: { /* wire adapter */ },
sessionQuery: { /* wire adapter */ },
},
overlay: {
shellOverlayRoot: ctx.slots.resolve('shell.overlay'),
},
})
// Later, on plugin unload:
handle.dispose()
There is no public registerProvider() API in V1. Third-party
plugins extend DSH native services instead. Universal Palette
federates only the host's native capability set.
See docs/ARCHITECTURE.md for the host /
browser split, capability probe, ranking math, provider contract, and
disposal guarantees.
See docs/COMPATIBILITY.md for the exact
real-API binding table, runtime capability matrix, recorded
deviations, and per-plugin coexistence behavior.
IMPLEMENTATION_REPORT.md records the
final capability probe, verified commands, P0 acceptance, dedup
result, and verdict.
git clone https://github.com/yunmin311/dsh-universal-palette.git
cd dsh-universal-palette
pnpm install
pnpm run typecheck
pnpm run build
pnpm run test
Requirements: Node.js >=22.19, pnpm 11.x.
MIT