前言¶
智能體開發過程中，開發者往往只能看到控制台日誌或簡單的狀態輸出，難以直觀瞭解代理的思考過程、工具調用和等待狀態。如果代理需要人工審批，審批進度和等待原因也不容易追蹤。
DSH（DeepSeek Harness）採用「一切皆插件」的理念，允許通過插件擴展功能。dsh-agent-office 是一個客戶端插件，它將代理的運行狀態可視化爲一個像素風格的虛擬辦公室，讓代理像真實的同事一樣出現在屏幕上。
這是什麼¶
dsh-agent-office 是一個爲 DeepSeek Harness 提供的實時代理辦公看板插件。由 xx-ytg 維護，分類爲客戶端。它不改變代理的執行邏輯，只是通過 WebSocket 接收 Harness 的會話事件，在前端渲染代理的桌面、工具使用、等待審批和休息狀態。
插件本身零運行時依賴，不依賴額外的 API 密鑰，也不需要額外的模型調用。
核心功能¶
1. 實時會話可視化¶
代理的工作狀態會以像素風格的同事形象展示在屏幕上。每個代理有自己的工位，工位上有工具實驗室、審批角、沙發和植物等元素。代理會離開工位去使用工具，使用完畢後回到工位；需要審批時進入審批角等待；每輪對話結束後會去沙發上休息。
2. 會話追蹤與層級關係¶
支持主會話和子代理會話的實時投影。通過父鏈接表示會話的層級關係（session lineage），而不是推斷出的對話關係。
3. 狀態分類¶
代理有多種狀態：完成（turn 完成）、錯誤、阻塞、暫停、空閒。「完成」指一輪對話結束，不代表項目通過驗收測試。
4. 交互與導出¶
- 可點擊代理名單，將任意會話帶到當前視圖
- 查看活動流、每輪步驟、工具調用、令牌使用量
- 導出 PNG 場景截圖
- 支持中英文界面、日間/夜間主題、移動端佈局和無障礙支持
5. 獨立等待狀態¶
獨立跟蹤待處理的工具和審批任務。並行請求不會提前清除等待狀態。
安裝與啓用¶
前置要求¶
- Node.js >=22.19.0
- DeepSeek Harness >=0.2.1-alpha.4
安裝命令¶
在包含 dsh-agent-office 文件夾的目錄下執行：
dsh plugin --profile office add ./dsh-agent-office
dsh --profile office web
如果 CLI 未全局安裝，可使用 npx @deepseek-ai/dsh@0.2.1-alpha.4 替代 dsh。
安裝後需要重啓 Harness。啓動後訪問 http://127.0.0.1:4319。插件會在終端輸出其 URL。
配置¶
通過 profile overlay 編輯已安裝的插件配置：
- id: agent-office
config:
port: 4320
maxAgents: 48
maxEvents: 120
| 設置 | 默認值 | 範圍 | 用途 |
|---|---|---|---|
port |
4319 | 1024–65535 | 僅綁定到本地的辦公室服務器 |
maxAgents |
48 | 1–200 | 跟蹤的會話數；不活躍的會話優先被清除 |
maxEvents |
120 | 10–500 | 內存中的活動歷史 |
最多同時繪製 12 名同事，所有跟蹤的會話仍可在名單中選擇。如果跟蹤上限已滿，新會話會被忽略直到有空位。計數器自插件啓動後累計，非生命週期總數。UI 活動流顯示最近 6 條事件。
典型用法¶
10 秒預覽演示¶
在下載倉庫後，直接運行：
cd dsh-agent-office
node src/demo.mjs
打開 http://127.0.0.1:4319。演示模式使用模擬事件，不會連接到正在運行的 Harness。
連接真實代理¶
在 Harness profile 中配置模型，然後啓動 Harness 和辦公室看板：
dsh --profile office web
在另一個終端啓動 Harness，開始任務。辦公室會自動從 Harness 的事件流中讀取數據。點擊名單中的代理可以查看其活動。
源碼覆蓋安裝¶
如果不想安裝插件，可以使用覆蓋方式加載：
node scripts/make-patch.mjs > office.local.patch.yml
dsh --profile office web --patch ./office.local.patch.yml
適用場景與注意¶
適合需要可視化代理運行狀態、調試工具調用和審批流程的開發者。它不會攔截或修改代理執行，只觀察和展示 Harness 的事件。
注意：
- 插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證
- HTTP 服務器僅綁定到
127.0.0.1，不暴露到公網 - 狀態存儲在內存中，重啓後清除
- 沒有寫入端點，不會向第三方發送數據
- 不支持跨 Harness 進程的會話（不同進程的代理不可見）
短結尾¶
dsh-agent-office 提供了一種直觀的方式觀察代理的思考過程和工具使用情況。它不改變代理邏輯，只是將 Harness 的事件投影到像素風格的辦公場景中，幫助開發者更好地理解代理的行爲。
更多詳情請訪問：https://www.skillhub.cn/plugins/xx-ytg/dsh-agent-office
源代碼：https://github.com/xx-ytg/dsh-agent-office
