Arcana — command deck

中文 · English

# Arcana [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) > Every slash command in DeepSeek Harness, as a draggable, collapsible, usage-sorted floating command deck. A floating command deck for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), pinned to the right side of the Web UI: it lists every `/` command the Harness serves — built-in and plugin-provided — as buttons. Hover for details, click to run, sorted by usage, with pagination at 10 commands per page. ## ✨ Features - 🔍 **Full command discovery** — reads the Harness command directory (`remote.commands` RPC), the exact same catalog the composer's `/` palette uses, so built-in and third-party plugin commands all appear. - 🧭 **Hover for details** — hovering a button shows the command `description` (identical to the chat-bar hint); argument-taking commands also show their usage hint. - ⚡ **Click to run** — argument-free commands run instantly; commands that need input reveal an inline field, Enter to run. - 🪟 **Draggable & collapsible** — drag the header to move vertically (position remembered); the "▸/◂" toggle collapses to just the header (like context-vista). - 📊 **Usage-sorted** — per-command usage counts are persisted in localStorage, so frequently used commands float to the top across reloads and restarts. - 📄 **10 per page** — paginated with prev/next when commands overflow; the list scrolls. - 🌐 **Bilingual** — follows the Harness locale. - 🎨 **Client-only, zero build** — no host logic, no bundler; themed through the shell's `--dsw-*` tokens (light/dark aware). ## 🚀 Install ```sh npx @deepseek-ai/dsh plugin --profile web add github:GooodWei/arcana npx @deepseek-ai/dsh web ``` > Install pnpm first (`dsh plugin add` invokes it internally). If dsh is installed globally, `npx @deepseek-ai/dsh` can be shortened to `dsh`. Restart DSH (`dsh --profile web`) and the deck appears on the right side. ## 🧭 Usage - **Run**: click a command — argument-free commands run immediately; commands with arguments (e.g. `/resume-claude`) show an inline input. - **Inspect**: hover a button for its full description and usage. - **Paginate**: use `‹ 1/3 ›` at the bottom, 10 per page. - **Drag**: grab the header to move; position is remembered. - **Collapse/expand**: use the "▸/◂" toggle to collapse to just the header. - **Sort**: commands are ordered by usage count (descending, then by name); the more you use one, the higher it ranks. ## 🗂 Layout ``` package.json npm metadata + dsh.client manifest cordis.patch.yml bundle patch (inserts the host row) lib/index.js empty host half (client-only plugin) lib/client.js client half: command discovery + floating deck + pagination README.md / README.en.md bilingual docs ``` ## 🛠 Compatibility - Targets `dsh 0.1.0-rc.6` (web profile). - Client-only; never touches the DSH engine. Consumes only the public `remote.commands`, `sessions`, `slots`, and `locale` services. ## 📄 License MIT