前言¶
在 DeepSeek Harness 裏跑帶 Task 子 Agent 的長會話時，主會話、子 Agent 和工具調用都散落在對話與軌跡裏。要弄清「誰在做哪件事、彙報到了哪一步」，往往得在標籤頁之間來回翻，腦內還原協作結構。dsh-mutipleagent 是社區插件（維護者 lkuliuying，分類：工作流），把同一會話裏的主 Agent、子 Agent、工具活動與彙報放進統一的 3D「辦公室」場景，只做只讀觀察，不替代 Harness 的對話與審批。下面介紹它的定位、能力、安裝方式和典型用法。
這是什麼¶
全名 dsh-mutipleagent（npm 包名相同，顯示名「DSH 多 Agent 辦公室」），當前版本 v0.4.0，許可證 MIT。它兼容 DeepSeek Harness ^0.2.2-rc.1，插件運行環境要求 Node.js ^22.19.0 || >=24.0.0。
一句話定位：DeepSeek Harness 多 Agent 3D 協作辦公室插件——在 3D 場景中觀察真實主會話、子 Agent、工具活動與完整彙報。插件只讀：不啓動任務、不調用模型、不審批、不修改會話，也不把內容發到本機以外。數據來自 Harness 的 sessionQuery 公開接口，不讀取 .codex、憑據或私有推理。
頁面路由爲宿主下的 /dsh-mutipleagent/，Web 與 Desktop 共用同源入口；會話接口沿用 Harness 登錄校驗，僅允許 owner 訪問。
核心功能¶
會話頁內一鍵打開當前辦公室¶
自 v0.3.0 起，插件註冊 conversation.view，在任意會話頁頂部標籤行增加「多 Agent 辦公室」，與「對話 / 軌跡 / 上下文」並列；標籤放不下時收入右側「更多會話視圖」。點開即顯示當前會話的辦公室，不必先選工作目錄再選會話。嵌入模式用 ?mode=live&source=harness&rootId=<會話 ID>&embed=1 打開，目錄選擇器自動隱藏，標題顯示當前會話名；切換會話或標籤時 iframe 按新會話 ID 重載。
v0.3.1：打開該標籤時，會話頁底部輸入框自動收起以騰出畫面高度；嵌入模式下辦公室自有頂欄（搜索、會話下拉、計時、鈴鐺）收起，協作統計與「Agent 詳情」上移到標籤頁頂部，搜索與通知改用宿主自帶能力。
3D 場景與協作信息¶
v0.4.0 將辦公室鋪滿一整層：4 列 × 3 行對坐工位共 24 座，主 Agent 與第一位子 Agent 隔桌面對面；共享長桌、玻璃會議室、設備櫃、書架、茶水吧與休息角等場景元素一併補齊。支持拖動旋轉、滾輪縮放，點擊人物或工位查看詳情，點擊顯示器看工位屏幕詳情；「隱藏面板」（工具條按鈕或按 H）可只留 3D 畫面，Esc 或右下角「顯示面板」恢復，偏好存本地。
右側可查看任務原文、工具活動、進展消息與彙報全文；底部時間線展示分配、追加指令、等待、彙報、完成和失敗。頂部鈴鐺查看協作動態。無 WebGL 時仍可使用團隊樹、活動記錄與報告。
側欄跨項目瀏覽¶
側欄入口「多 Agent 辦公室」保留，用於跨項目瀏覽：先選工作目錄，再選具體會話。下拉支持按路徑、標題、時間、ID 篩選；記住上次目錄與會話，「跟隨新會話」僅跟隨當前目錄。後臺會話標題最多每 30 秒刷新，觀察中的團隊隨原有輪詢更新。
性能與只讀邊界¶
v0.2.x 起側重讀取效率：對未變化會話複用觀察租約與日誌游標，減少重複摺疊與 zstd 日誌重讀；靜態資源支持 ETag / gzip，無頁面連接時停止輪詢。插件停用或卸載時釋放路由、輪詢與頁面資源；構建產物與模型隨包提供，不使用 CDN。
要在辦公室裏看到真實子 Agent，需要在 Harness 會話中實際創建子 Agent（例如通過 Task 分工）；插件本身不會替你啓動並行任務。
安裝與啓用¶
安裝前建議完全退出 Harness Desktop，裝完再重啓。README 中的示例版本號爲 0.2.1；倉庫與 npm 當前發佈爲 v0.4.0，升級時把命令裏的版本號換成目標版本即可。
從 npm 安裝¶
包已發佈到 npm：
dsh plugin --profile desktop add 'dsh-mutipleagent@0.2.1' --ignore-scripts
若本機終端沒有 dsh，可使用 Desktop 隨附 CLI（README 以 Windows 爲例）：
& 'C:\ProgramSoftware\Deepseek\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add 'dsh-mutipleagent@0.2.1' --ignore-scripts
從 GitHub 標籤安裝¶
完全退出 Desktop 後，用固定標籤的 tarball 安裝（同樣可將 v0.2.1 改爲目標標籤，例如 v0.4.0）：
dsh plugin --profile desktop add 'dsh-mutipleagent@https://codeload.github.com/lkuliuying/dsh-mutipleagent/legacy.tar.gz/refs/tags/v0.2.1' --ignore-scripts
從本地打包安裝¶
在插件源碼目錄構建並打包後，退出 Desktop，安裝生成的 .tgz（路徑按實際調整）：
npm ci
npm run build
node -e "require('node:fs').mkdirSync('.artifacts', { recursive: true })"
npm pack --pack-destination .artifacts --ignore-scripts
dsh plugin --profile desktop add "F:\Program\Multiple-Agent\.artifacts\dsh-mutipleagent-0.2.1.tgz"
啓用後：在會話頁頂部點「多 Agent 辦公室」，或從側欄打開。不需要單獨運行辦公室服務，也不需要設置 API Key。
典型用法¶
在 Harness 內觀察當前會話¶
- 安裝並重啓 Desktop。
- 打開已有子 Agent 分工的主會話（若沒有，先在對話裏明確要求並行子 Agent 並等待其運行）。
- 在頂部標籤點「多 Agent 辦公室」，確認畫面綁定當前
rootId。 - 在 3D 場景中點選成員，在右側讀任務原文與彙報；用時間線對照分配與完成順序。
README 給出的 Codex 側提示語示例（需在真實任務環境中自行發起，插件只觀察）：
請啓動兩個只讀子 Agent：一個檢查接口契約，另一個檢查測試缺口。等待它們完成，再彙總發現和建議。
演示與獨立觀察器（可選）¶
倉庫還支持脫離 Harness 的本地只讀觀察：Windows 可雙擊 啓動辦公室.cmd，或運行 node src/server.js --open，默認瀏覽器打開 http://127.0.0.1:4317。純前端演示頁爲 http://127.0.0.1:4317/demo.html；帶真實數據的演示爲 demo.html?mode=live。該路徑面向 Codex Desktop / CLI 會話目錄觀察，與 Harness 插件共用同一套 3D 與 UI 思路，但 Harness 用戶日常以插件標籤頁爲主即可。
適用場景與注意¶
適合誰：需要在 DSH 裏做子 Agent 編排、又想用空間化視圖跟蹤分工與彙報的開發者；不適合指望在本插件裏下發指令、改會話或代批審批的場景。
權限與信任：插件以當前 DSH 進程權限運行，能讀到的範圍與會話 owner 規則一致。安裝前應查看 源碼倉庫 與 MIT 許可證，自行判斷是否納入工作環境。
生態說明：DeepSeek Harness 奉行「一切皆插件」；SkillHub 目錄頁 是社區收錄站點，與 DeepSeek / 幻方無官方從屬關係，不等同於官方應用商店。
版本信息：變更細節見倉庫 CHANGELOG.md 與 GitHub Releases。倉庫 README 安裝示例仍寫 0.2.1，與 package.json 中 0.4.0 並存時，以你顯式指定的安裝版本爲準。
結尾¶
dsh-mutipleagent 把多 Agent 協作從線性日誌裏「抽」成可巡視的 3D 辦公室，並嚴格限定爲只讀觀察，降低理解並行任務時的切換成本。目錄與文檔入口：
