# dsh-agent-grid > 定员八席 —— 把 DeepSeek Harness 的侧栏换成 2×4 的常驻席位看板：八个 agent 各自的实时动作、状态与待办一眼看全。Not affiliated with DeepSeek. Latest version **0.1.3** (published 2026-09-24) · MIT license · 0 weekly downloads ## Install ```sh npm install dsh-agent-grid pnpm add dsh-agent-grid yarn add dsh-agent-grid bun add dsh-agent-grid ``` ## Health **Score 60/100 (C)** — status: active. Positive: esm support; no vulnerabilities; recently updated; high maintenance score. Warnings: low downloads; no types; pre 1.0. ## Facts | | | |---|---| | Version | 0.1.3 | | Published | 2026-09-24 | | First published | 2026-09-22 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | ESM + CommonJS | | Dependencies | 2 | | Unpacked size | 300 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 1 | | Maintainers | yefengliu | | Keywords | dsh-plugin, deepseek-harness, agent-dashboard, multi-agent, sidebar | ## Links - npm: https://www.npmjs.com/package/dsh-agent-grid - Repository: https://github.com/yefengliu1/dsh-agent-grid - Homepage: https://github.com/yefengliu1/dsh-agent-grid#readme - Issues: https://github.com/yefengliu1/dsh-agent-grid/issues - npm.io page: https://npm.io/package/dsh-agent-grid ## Dependencies (2) - [zod](https://npm.io/package/zod.md) ^4.4.3 - [@deepseek-ai/schemastery](https://npm.io/package/@deepseek-ai/schemastery.md) ^3.18.2 ## Alternatives - [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads - [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads - [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads - [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads - [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads ## Recent versions - 0.1.3 (latest) — 2026-09-24 - 0.1.2 — 2026-09-24 - 0.1.0 — 2026-09-22 ## README # Eight Standing Seats · 定员八席 > **其静也专，其动也直** — "Still, it is single-minded; moving, it goes straight." (*I Ching*, Great Treatise I) > > A 2×4 standing-seat board that replaces the DeepSeek Harness sidebar: see what all eight agents are doing, and which one is waiting for you, at a glance. [中文](README.zh.md) ｜ **English** [![npm](https://img.shields.io/npm/v/dsh-agent-grid?style=flat-square&color=3A7284)](https://www.npmjs.com/package/dsh-agent-grid) [![license](https://img.shields.io/badge/license-MIT-26221C?style=flat-square)](#license) [![dsh-plugin](https://img.shields.io/badge/dsh--plugin-community%20topic-9A6B50?style=flat-square)](https://github.com/topics/dsh-plugin) [![DSH](https://img.shields.io/badge/DSH-0.1.5--rc.2-7FB4C4?style=flat-square)](#compatibility) --- ![The eight-seat board](docs/seats.png) > A **real screenshot**, not a mock-up: each seat's avatar, status dot and current action (a green dot for the working seat, greyed-out for the two vacant ones). *Dynamic text and working directories on the cards are redacted.* ## What it solves DSH's sidebar is a **session list** by default. Once you run one agent per session, what you actually want to know is not "which sessions exist" but **"what is each seat doing, and which one is waiting for me"** — a list cannot answer that, it only grows longer. This plugin swaps it for a fixed 2×4 board: > **Seat identity is permanent. Sessions are disposable payload.** Each of the eight seats keeps a permanent identity (persona, accent colour, index); real sessions are just replaceable payload mounted on a seat. Adding, removing or reordering sessions never makes a cell change occupant — that is the precondition for "understandable at a glance". Each seat has its own name and emblem (the Eight Immortals of Chinese lore: Han Zhongli, Lü Dongbin, Tieguai Li, Zhang Guolao, He Xiangu, Lan Caihe, Han Xiangzi, Cao Guojiu), with a hand-drawn pixel avatar (56×24 logical canvas at integer 2× scale). **The animation is a finite state machine, not a looping GIF** — the figure follows the facts: waiting on you → raises a flag, working → emblem fires, finished-but-unread → settles with an afterglow, otherwise → at rest. ## Three orthogonal states Deliberately **not collapsed into one field**, because their rates of change and their owners differ completely: | Dimension | Values | Rate | Owner | | --- | --- | --- | --- | | **Persona** | name / emblem / accent | almost never | you | | **Activity** | working / resting / awaiting answer / awaiting approval | high | the agent | | **Context** | empty / in use / near limit | medium | the system | Key consequence: **"resting" ≠ "vacant"**. Resting means "has an identity, is ready, is not working"; vacant means "this slot has never been commissioned". A bot can perfectly well be "resting but 87% context-full" — the card must say so, because you need to clear it before assigning the next task. ## The seven labels | Label | Fact it states | Source | Figure | | --- | --- | --- | --- | | **Vacant** | no session bound yet | no binding | at rest (grey) | | **Standing by** | seated, session still empty | `blank` | at rest | | **Working** | currently running | `running` | emblem fires | | **To review** | a turn ended and **you have not looked** | unread notice | settles + afterglow | | **Resting** | idle, nothing unread | otherwise | at rest | | **Awaiting answer** | it asked you a question and is stuck | projection `attention=question` | raises flag | | **Awaiting approval** | an un-reviewed approval is pending | projection `attention=approval` | raises flag | Status dots: working **green** · to-review **gold** `#C9A227` ![](https://img.shields.io/badge/-%20-C9A227?style=flat-square) · awaiting **cinnabar** `#B5453C` ![](https://img.shields.io/badge/-%20-B5453C?style=flat-square) · vacant / standing by / resting **grey** Priority: the two awaiting states outrank everything except vacant; the rest order as working → to-review → standing by → resting. > **Why not call it "completed"**: `completed` is not a lifecycle state, it is an **unread notice** — the host lights it on the true→false edge of `running`, and it **does not judge success** (a crashed or interrupted turn lights it too). > Calling it "completed" is not merely imprecise, it can be **simply wrong**. It really only says two things: a turn ended, and you have not looked. > > Also: the seat you are currently viewing does **not** light the notice when it finishes — so "to review" always appears on a seat you were *not* watching. That is exactly what this board is for. ## The card shows the process Not just a status dot. A host-side `seat-activity` projection supplies each seat's latest slice: **tool call → thought (reasoning) → ↳ (tool result) → speech (answer)**, plus how long since the seat last moved. So when all eight cards are animating, you can tell **what each one is doing** — not eight identical spinners. > Vertical space is a hard constraint: eight full cards must fit one screen with no scrollbar. Measured at 164px per full card (4 rows + gaps = 697px against ~750px usable), narrow windows drop secondary rows. Better to hide a row than to show a scrollbar. ## The main pane stays stock The board **does not rewrite the conversation area**. The main pane remains DSH's stock Conversation; the plugin only injects a **seat badge** into the conversation header, so you always know which seat you are talking to. (An earlier version replaced the main pane with a custom detail page — that threw away the stock conversation. Overturned; it was reinventing the wheel.) ## Escape hatch **Settings → General → Sidebar**: `[ Seats │ Default ]` Switching to "Default" works by **unregistering**, not by hiding a component — once our slot registration is `dispose()`d, the built-in `WorkspaceBrowser` returns to the render position automatically. The choice survives page refreshes and host restarts; deployments without a settings service degrade to a local-only switch with an inline notice. ## Install ```bash dsh plugin --profile web add dsh-agent-grid ``` Then refresh. To go back to the stock sidebar: **Settings → General → Sidebar → Default**. ## Intrusiveness This plugin **replaces the host's `sidebar.workspaces` slot** (shadowing the built-in implementation with `priority: -1`). It patches no host source, but it does change how the sidebar presents itself — the switch above exists precisely as the way back. ## Compatibility - Verified on **DSH 0.1.5-rc.2** (`@deepseek-ai/dsh`) - Consumes only host design tokens and hard-codes no colours — so **any DSH theme can drive it** - Not affiliated with DeepSeek ## With a theme Companion theme **[dsh-theme-songgrid](https://github.com/yefengliu1/dsh-theme-songgrid)** (Songgrid · rice paper / night ink) was tuned for it: warm paper against the board's grey-scale cards, Ru celadon carrying the interactive states. The two are fully independent — either works alone. ## License MIT --- _Source: https://npm.io/package/dsh-agent-grid · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._