# dsh-worktable ๐Ÿ–ฅ๏ธ

English ยท ็ฎ€ไฝ“ไธญๆ–‡

**An agent-project workbench for DeepSeek Harness** โ€” a sidebar app drawer that turns every project into dockable windows, plus a built-in control room that watches them all in real time. ## ๐Ÿ“ธ Screenshots | | | |---|---| | Control room | **๐Ÿ–ฅ๏ธ Control room** โ€” the built-in default project: a live card grid watching every project (working / needs you / done) with glassmorphism cards on a blueprint grid | | Worktable sidebar | **๐Ÿงฉ Worktable sidebar** โ€” the app drawer: projects, shortcuts and the pinned control-room entry | | Split workspace | **๐ŸชŸ Our projects** โ€” every project opens as a dockable split workspace (resident apps like Travel Atlas included) | --- ## โœจ Feature tour ### ๐Ÿงฉ Sidebar app drawer - Collects your self-hosted projects (and resident plugins like dsh-travelatlas) in one place - Rename / icon / reorder / hide each project; per-project folder; **project โ†” conversation binding** โ€” opening a project switches the chat pane to its bound conversation - Collapse the sidebar and every project becomes a tappable square tile (icon only) ### ๐ŸชŸ Dockable split workspace - Declarative layout presets (left column / top row / main grid + right chat pane) - Draggable dividers, per-pane tabs, per-layout width persistence - Built-in panes: **file explorer, terminal, browser, animation site, custom window** - Custom window: send a requirement to a new or existing conversation; the agent builds it and the result auto-mounts into the window (locked) ### ๐Ÿ–ฅ๏ธ Control room (built-in default project) - A pinned, undeletable first project โ€” bind one management conversation on first open - 3-column card grid mirrors **every** project: working / needs you / done with live runtime, subagent counts and a cleaned message preview - Event-driven host snapshot mirroring โ€” **zero polling, zero tokens** - Glassmorphism cards, dark / light / system theme, neon status glows and a rotating comet on busy cards --- ## At a glance | | | |---|------| | ๐Ÿงฉ Plugin type | Cordis plugin โ€” host routes + web client, pure additive (no official plugin replaced) | | ๐ŸชŸ Workspace engine | Self-built split engine rendered into the host shell overlay seat | | ๐Ÿ’ฌ Chat pane | Reuses the host conversation โ€” the plugin only selects sessions (`sessions.open`) | | ๐Ÿ“ก Status data | Mirror of the host session runtime snapshots (subscription-driven) | | ๐Ÿ’พ State | localStorage only (`dsh.worktable.*`); no workspace files touched | | ๐ŸŽจ UI | TypeScript + React (host externals) + vanilla CSS, dark-first with light theme | --- ## Quick start 1. **Install** (pick one): **A ยท one-liner (recommended)** โ€” straight from the GitHub Release tarball, no Git needed: ```bash dsh plugin --profile web add "https://github.com/Aisland-SJL/dsh-worktable/releases/latest/download/dsh-worktable.tgz" ``` **B ยท local clone (for hacking on the source)** โ€” `link:` accepts a local absolute path only (no spaces in the path): ```bash git clone https://github.com/Aisland-SJL/dsh-worktable.git dsh plugin --profile web add "link:/01_content" # e.g. cloned into D:\tools โ†’ dsh plugin --profile web add "link:D:/tools/dsh-worktable/01_content" ``` Either way the `add` command registers `dsh-worktable` in the profile bundle list (writes to `~/.dsh`, may ask for authorization). If the `dsh` command is missing, use `npx @deepseek-ai/dsh` instead. 2. **Restart** the DSH web process, refresh the GUI 3. **Open the control room**: click the pinned ๐Ÿ–ฅ๏ธ control-room card โ†’ bind one conversation (join existing or create new) โ†’ you get the live card grid 4. **Create projects**: sidebar ๏ผ‹ โ†’ pick a layout preset, set a project folder --- ## Architecture One package ships the **host Cordis plugin** and the **web client**: - **host**: `/api/worktable/*` routes โ€” health, file system, git, file read/write, site serving, mkdir, workspaces, native skin template; WebSocket `/api/worktable/term` for the terminal pane (PowerShell on Windows) - **client**: injected into the sidebar and the shell overlay via the slot protocol; the split engine, tab model, drag/drop and persistence are self-built - **control room**: reads the host session list snapshot (running / pending / completed, jobs, subagent catalogs) โ€” an event-driven mirror, no model involvement - **window tasks**: the agent writes `widget-result.json` into the project folder on completion; the client mounts the artifact into the addressed window and locks it --- ## Development & testing ```bash cd 01_content npm install npm run build # lib/index.js + lib/client.js node --check lib/index.js ``` - **Build must run inside `01_content`** โ€” building from the repo root writes `lib/` to the wrong place while the host keeps loading the old bundle - The client bundle keeps the `window.__ModuleLoader__.load` handshake; `react` and `@deepseek-ai/*` stay external - Regression: `04_test/functional-diag.cjs` (20 steps) plus targeted probes (control room, bind panel, collapsed rail, model inheritance) --- ## Known limits - State lives in the browser (`localStorage`) โ€” projects, bindings and views do not sync across machines - The terminal pane is a plain PowerShell host on Windows (no PTY feature parity with the native terminal app) - Auto-mount requires the agent to actually write `widget-result.json` in the project folder - The control room monitors projects that are **bound** to a conversation; unbound projects show as idle --- ## Privacy No telemetry, no network calls beyond the host APIs and the plugin routes. All user state stays in localStorage. Optional update check: a read-only GET to the GitHub Releases API (automatic at most once a day, plus a manual "Check now" button); nothing is uploaded, and it can be disabled in Settings. --- ## License MIT ## Related - [dsh-reminder](https://github.com/Aisland-SJL/dsh-reminder) โ€” cross-window completion & approval notifications - [dsh-usage](https://github.com/Aisland-SJL/dsh-usage) โ€” persistent balance/usage dock