前言¶
在 DeepSeek Harness（DSH）里跑多智能体团队时，总管和队员往往分散在侧边栏、会话列表和日志里。谁在执行子任务、上下文烧到哪一步、能不能直接给某个队员派活，需要来回切换才能拼出全貌。朝堂（dsh-chaotang）是社区维护者 tiankongshenchu 发布的客户端类 DSH 插件：把当前团队渲染成「总管在上、队员在下」的卡片树，用连线表示汇报关系，并在卡片上展示状态、任务名与 token 用量。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
朝堂的定位，是把 DSH 里的智能体团队可视化成一棵「朝堂树」——谁是总管（lead）、谁在忙、任务进行到哪、各会话上下文用了多少 token，尽量在一屏里看清。插件在 package.json 中声明为 MIT 许可，要求 DSH 版本 >=0.1.5-rc.1，当前资料中的版本号为 1.0.4。
维护与源码：
- 社区目录页：https://www.skillhub.cn/plugins/tiankongshenchu/dsh-chaotang
- GitHub：https://github.com/tiankongshenchu/dsh-chaotang
DSH 生态主张「一切皆插件」；SkillHub 等目录站由社区维护，与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看仓库源码与许可证，并记住插件随当前 DSH 进程权限运行。
三个版本，别搞混¶
README 明确说明同一项目里有三种形态，用途不同：
| 形态 | 入口 | 适用场景 |
|---|---|---|
DSH 本体插件（lib/client.js） |
左侧栏「朝堂」 | 日常在 DSH 主区域使用；含典章里的「调色」；改代码后需升版本并重启 DSH |
网页版 · 单团队（lib/page.html） |
桌面「开朝堂」或 http://127.0.0.1:<端口>/chaotang |
独立浏览器窗口；功能与插件版基本一致（无调色）；设置与插件版分开存储 |
多团队预览版（预览-多团队.html） |
本地双击 HTML | 半成品演示，假数据，不接真数据，不能当正式版 |
正式能力目前只覆盖一个团队（一个总管 + 队员）。多团队预览页仅用于看布局草图，README 写明后端尚未改为返回 teams[] 数组。
两个正式版本（插件版与网页版）各有 chaotang-settings.json 与各自的背景图目录（lib/bg-plugin/、lib/bg/），互不同步，这是设计如此。
核心功能¶
团队可视化¶
界面大致为总管卡片在上、队员卡片在下，总管到各队员有连线；正在执行任务的连线会发光并流动。每张卡片显示：
- 名字与分工说明
- 中间一句状态文案（空闲闲话 / 进行中显示任务名 / 完成时金色「臣有本奏！」等，可在典章里改文案）
- 右下角状态：空闲 / 在忙 / 暂候 / 干完了
- 底部上下文用量（如
433k / 1.0M）、进度条、步数、时长
Host 侧通过 HTTP 提供团队快照与交互；常见路径包括 GET /chaotang/state（团队快照）、GET /chaotang/session?id=（会话消息）、POST /chaotang/send（给队员发消息，不能发给 lead）等，完整列表见仓库 README「接口一览」。
典章（设置）¶
点顶栏「典章」可改四类内容（插件版四页签，网页版无「调色」）：
- 文案：顶栏标题、卡片中间那句话（草稿与「入册」落定）
- 背景：整页与卡片背景、字色；上传原图不压缩
- 音色：开朝、退朝、养神等动作对应音效，可上传自定义音频
- 调色（仅插件版）：连线颜色
还可双击总管名字改称呼；顶栏「另册 ▾」可续录自定义状态；五个状态各有音效。
与队员协作¶
插件版支持点卡片打开右侧抽屉查看聊天记录，并直接给队员发消息派活（与 POST /chaotang/send 对应）。网页版同样可走 Host 接口，具体 UI 行为以当前版本界面为准。
安装与启用¶
方式一：DSH CLI（README 手动安装）¶
在 Windows 示例路径下，README 给出的装法为指向本地 link 目录（请换成你本机插件目录）：
dsh plugin --profile desktop add "link:D:\dsh-plugins\downloads\插件\朝堂插件"
装完后手动重启 DSH。卸载：
dsh plugin --profile desktop remove dsh-chaotang
方式二：编辑 profile 的 package.json（README「安装（给 AI 看的）」）¶
适用于从 GitHub 依赖安装，前置条件：DSH >=0.1.5-rc.1，profile 目录一般有 pnpm。
- 打开 profile 目录（通常为
~/.dsh/profiles/desktop） - 在
package.json的dependencies增加：
"dsh-chaotang": "github:tiankongshenchu/dsh-chaotang"
- 在同一文件的
dsh.profile.bundles数组中加入字符串"dsh-chaotang" - 在该目录执行
pnpm install - 让用户手动重启 DSH（不要自行结束 DSH 进程）
若 GitHub 拉取失败，可下载 dsh-chaotang-<版本>.tgz，改为 "dsh-chaotang": "file:<tgz 绝对路径>" 后重复 bundle 与 install 步骤。
安装后验证¶
重启后左侧栏应出现「朝堂」入口，点开主区域能看到卡片与连线。若没有入口：检查 bundles 与 pnpm install；有入口但空白：检查 DSH 版本是否满足 >=0.1.5-rc.1；提示 main panel 未注册时查 DSH 日志。
典型用法¶
- 在 DSH 中照常组建并运行智能体团队（一个 lead + 若干队员）。
- 打开「朝堂」面板或浏览器访问
http://127.0.0.1:<端口>/chaotang，观察卡片状态与连线动画，确认上下文 meter 与任务名是否随运行更新。 - 需要改视觉或文案时，打开「典章」调整背景、音色、文案；插件版还可调连线颜色。
- 要给某队员追加指令时，在插件版点该队员卡片，在抽屉中发消息；或通过 Host 的
POST /chaotang/send（需按 README 参数约定）。
改插件前端 client.js 后须升高 package.json 版本并重启 DSH（客户端按版本缓存）；改 page.html 则刷新浏览器即可。
适用场景与注意¶
适合谁： 经常在 DSH 里用 agent team、希望用一张「组织图」盯进度、token 与派活，又愿意接受朝堂主题 UI 的开发者。
注意：
- 插件与 DSH 同进程权限，安装前请审阅源码与 MIT 许可证。
- 网页版与插件版设置、背景目录分离，改一边不会同步。
- 多团队预览 HTML 仅为布局演示，勿对外宣称已支持多团队。
- 背景图静态资源路由为 prefix
/chaotang/bg，README 强调不要加尾斜杠。 - 上下文进度条应基于
totalTokens等稳定字段；README 开发笔记提到勿用surfaceTokens做进度条（重启后会变小）。
仓库内 开发日志-踩过的坑.md 记录了开发中的现象与解法，改代码前可先翻该文件。
结尾¶
朝堂把 DSH 智能体团队从「列表 + 日志」收成一张可交互的上朝图：卡片、发光连线、任务滚动感与上下文 meter，并支持典章定制与给队员发消息。日常建议在 DSH 侧边栏用插件版；需要第二块屏时用 /chaotang 网页版。
- 目录页：https://www.skillhub.cn/plugins/tiankongshenchu/dsh-chaotang
- 源码与完整接口说明：https://github.com/tiankongshenchu/dsh-chaotang
