Denis-Tang/dsh-agent-board ↗★ 0

dsh-agent-board

在右侧边栏以两列卡片实时展示主子智能体状态。 适合需要直观监控多Agent任务进度、Token和费用的用户。

包名
dsh-agent-board
兼容性
待验证
版本
1.0.0
许可证
MIT
最近更新
2026年10月24日

同名包的其他仓库

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Denis-Tang/dsh-agent-board

Agent Board / 智能体看板

Agent Board / 智能体看板 — a DeepSeek Harness UI plugin that renders the current session's agents as a live two-column card board in the right sidebar: the main agent on top, every sub-agent below it in creation-time order. It is a standard DSH bundle (dsh.bundle, bundle id dsh-agent-board) with a Web Client half and no build step.

中文简介:在 DeepSeek Harness 右侧边栏中以两列卡片实时展示当前会话的主/子智能体:主 agent 在最上方,子 agent 按创建时间往下排;每个卡片显示状态、计划进度、Token、费用和运行时间。

Each agent is a compact card ("小方块") with a minimal 1px outline:

  • the task it owns (the delegation label, or the session title when no label exists),
  • an agent label on the left of the status row: 我 on the main agent's card, and a short Greek-god / modern-scientist name (宙斯, 牛顿, 居里, …) on every sub-agent card,
  • a status tag beside it — RUN with a blinking dot, WAIT, DONE, IDLE, FAIL, or EXT for an external task,
  • a static progress bar based on its todo plan (no flowing animation),
  • a footer with current tokens, USD cost, and live duration.

The session you are viewing keeps a thin blue outline; there is no separate "current" badge any more. When the current session is itself a subagent, the chart walks up to the topmost available parent, so the main agent is always the first card on screen.

Install

Install straight from GitHub (no npm package needed):

dsh plugin --profile  add github:Denis-Tang/dsh-agent-board

On DSH Desktop, open the sidebar Plugins page → Add plugin (or Install a third-party plugin) and paste github:Denis-Tang/dsh-agent-board (the desktop app owns its profile, so the CLI does not change the running app's profile). After installation the plugin appears in the right sidebar's + guide; reload the page if the new tab does not show up immediately.

The plugin is also being prepared for the dsh-market catalog through awesome-dsh-plugin. Once the catalog entry is live, search Agent Board / 智能体看板 in Plugins → Plugin Market.

Repository: Denis-Tang/dsh-agent-board. Requires DeepSeek Harness >=0.2.1-rc.1 =0.2.1-rc.1 <0.3.0. It depends only on the Web Client slot surface and the standard session hooks:

  • sidebar.right.pane.tab slot with sessionId, useSessions, useSessionStatus, useProjection('todos') (optional, falls back to the projection store)
  • ctx.sidebarRightTabs.register (tab type) and ctx.get('sidebarRight') (open/focus)
  • conversation.session.header.utilities (invisible helper that opens the tab when a sub-agent is created)
  • ctx.sessions.refreshProjections
  • ctx.uiWorkspace.openSession
  • ctx.locale and ctx.slots

No Harness Client package is imported as a module; React comes from the browser module table.

Files

FilePurpose
index.jsHost half (metadata only)
client.jsBrowser module: view, two-column board, cards, styles, locale dictionaries
cordis.patch.ymlInserts the dsh-agent-board row
locale/en.json, locale/zh.jsonPlugin Manager display metadata
fonts/Embedded Collapse wordmark and JetBrains Mono web fonts
icon.svgOriginal artwork
screenshot-main.png, screenshot-sidebar.pngMarketplace screenshots
screenshots.jsondsh-market screenshot manifest
assets/icon.pngMarketplace tile icon (512×512 PNG)
marketplace/dsh-agent-board.ymlEntry prepared for the awesome-dsh-plugin catalog
LICENSEMIT

Notes and limits

  • The board reflects what the Client projection store knows. An agent that is not reachable through a parent's subagentCatalog (for example an external task without a parent-owned catalog fact) cannot be shown as a local child.
  • External tasks have no local execution status; they appear as normal cards without a local session to open.
  • When a running agent has no todo list, the bar is a static empty track labelled 无计划; the card never invents a percentage.
  • The plugin does not mark the main session as "completed" merely because it is idle; completion always follows the last closed turn or an all-completed todo list.

Development

The plugin has no build step. Edit client.js (a browser module registered through window.__ModuleLoader__) and let DSH HMR reload it, or reload the page. Run node --check client.js for a syntax check. The host half index.js is a no-op metadata module; the bundle patch inserts the client row.

上游与致谢 / Upstream and acknowledgements

Agent Board is an independent, rebranded fork based on the upstream project xiezouqu12/agent-trees, used and modified under the MIT License. Credit for the original board concept, two-column layout, interaction model and paper-cloud visual design belongs to the upstream author; this repository only renames the plugin, maintains it independently, and adds its own documentation and icon artwork.

License

MIT © 2026 xiezouqu12 (upstream work); modifications © 2026 Denis-Tang. See LICENSE.

Credits

The full-panel backdrop is a 1-bit dithered print of a Greek marble head from The Metropolitan Museum of Art (CC0 / public domain, object Marble head of a goddess), converted offline with a Floyd–Steinberg dither and printed as Hermes-blue ink on warm paper (single theme, no dark mode). A seamless paper-dot tile keeps the dot field covered at any sidebar width, and a few wide wavy dot bands with uneven widths drift and breathe at non-linear speeds, their widths changing over time.

The bundled Collapse wordmark font and JetBrains Mono web fonts are distributed under the SIL Open Font License 1.1; see fonts/OFL.txt for the full license text.