MiloMMIN/dsh-agent-board

dsh-agent-board

跨 Agent 工作台 —— 一个用于 DeepSeek Harness (dsh) 的持久化插件，它监视每一个本地编码 agent（Claude Code、Codex、Kimi Code、Pi、Hermes），并让你一键继续它们的工作。

它以只读方式读取其他 agent 的会话存储，展示它们当前正在做什么，并将工作交接给正确工作区中的一个全新 dsh 会话 —— 附带一份结构化的交接简报（来源 agent、任务摘要、工作状态、创建/最后修改时间）。

社区话题：github.com/topics/dsh-plugin

功能特性

- 实时跨 Agent 面板 —— 侧边栏面板（⟠）+ 独立页面 /agent-view，每 N 秒自动刷新
- Claude Code、Codex、Kimi Code、Pi、Hermes 会话汇聚于一个列表
- “正在继续”（在阈值内活跃）徽章、时长、标题、工作目录、创建/最后修改时间、各 agent 总计
- 一键继续 —— 点击任意会话行：
1. 为该会话根目录解析/创建工作区（已存在的工作区会被合并，绝不重复创建）
2. 在该工作区中打开一个新会话并导航至其中
3. 将会话重命名为 short-task-description--agent（例如 知识库整理--kimi）
4. 向对话中发送一份交接简报：来源 agent、会话 id、工作目录、任务摘要、工作状态（已完成 / 未确认 / 正在继续）、创建与最后修改时间
5. dsh 确认并等待你的指令 —— 之后的每一条指令都携带该上下文
- 主题感知 —— 跟随 shell 的明暗主题令牌，点击外部 / Esc 关闭面板
- 设置页面 —— 每一项行为均可在 设置 → Agent 工作台 下配置
- 模型工具 —— agent_board 工具让 agent 自身能够报告“其他 agent 现在在做什么”

安装

这是一个用于 web profile 的 profile 级持久化插件（它不是动态插件）。

1. place the package anywhere, e.g.
mkdir -p ~/.dsh/profiles/web/plugins
copy this repository there (or use link:)

2. add the dependency to the profile (replace the path with yours)
cd ~/.dsh/profiles/web
pnpm add dsh-agent-board@link:D:/path/to/dsh-agent-board
or manually add "dsh-agent-board": "link:" to package.json dependencies

3. insert the plugin row into the profile patch layer
~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: agent-board
name: dsh-agent-board

4. restart dsh web

扫描器还通过 Hermes 的 CLI（hermes sessions list / hermes project show）与其通信；无法解析出目录的会话会回退到可配置的默认工作区（默认为用户主目录）。

使用方法

- 侧边栏底部 → ⟠ Agent 工作台 → 面板列出全部五个 agent 的近期会话
- 点击某一行（或其 继续工作 按钮）即可交接工作
- 全屏面板：http://127.0.0.1:/agent-view
- 在聊天中询问：“现在其他 agent 在干什么”（agent_board 工具）
设置（设置 → Agent 工作台）

| 设置 | 默认值 | 含义 |
| --- | --- | --- |
| refreshSeconds | 20 | 面板/看板刷新间隔 |
| activeMinutes | 15 | 超过此时间未活动的会话不再计为“进行中” |
| perAgentLimit | 6 | 每个 agent 显示的会话数 |
| titleDescChars | 24 | 描述--agent 会话标题中任务描述的最大字符数 |
| fallbackCwd | 用户主目录 | 用于没有目录的会话（例如 Hermes 网关会话）的工作区 |
| autoConfirm | true | 将交接简报作为真实消息发送，并让 dsh 确认；关闭时，简报作为隐藏上下文注入 |
| autoClosePanel | true | 交接后关闭面板 |
| briefExtra | "" | 附加到每个交接简报的额外常驻指令 |

安全

- 设计上只读：扫描器从不修改其他 agent 的会话文件。它只读取 JSONL/SQLite/CLI 输出。
- 会话记录被视为数据，而非指令。
- 交接流程使用官方 agent 收件箱（followup / inject）和工作区注册表——与普通用户消息相同的通道。

开发

- scan-worker.cjs — 独立扫描器；运行 node scan-worker.cjs [perAgentLimit] [activeMinutes]
- index.js — 宿主端：路由 /agent-view、/agent-view/api/status|settings|prepare|inject、agent_board 工具
- client.js — 浏览器端：侧边栏面板、设置页面（标准 window.__ModuleLoader__.load 包）
- 设置持久化到包旁边的 settings.json（已被 git 忽略）

许可证

MIT