前言¶
在 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
