前言¶
在 DeepSeek Harness（DSH）裏跑 AI Agent 時，工具調用、子代理切換和 Token 消耗往往散落在對話與日誌裏，想一眼看清「當前在第幾步、誰在幹活、隊列裏還有什麼」並不直觀。社區插件 Agent Ops / Dispatch Center（倉庫 xinranmn-wq/dsh-agent-ops）掛在 DSH Web UI 上，把同一會話裏的運行元數據收成一塊可交互的全屏面板：記憶雲、旋轉卡片環和多條 HUD 信息流，並在有真實事件時用 LIVE FEED，空閒時自動切到 SIMULATION 演示，畫面不會停住。下面介紹它是什麼、能看什麼、怎麼裝、怎麼用，以及安裝時要注意什麼。
這是什麼¶
Agent Ops 是維護者 xinranmn-wq 發佈的 DeepSeek Harness（DSH）客戶端插件（MIT 許可，package.json 版本 0.1.0，包名 @local/dsh-agent-ops）。安裝後 DSH 頁面右下角會出現發光圓環，點開即 Agent 運行可視化面板；插件在設置裏顯示爲「Agent Ops 調度中心 / Agent Ops Dispatch Center」。
它解決的是 Agent 可觀測性：不替代 DSH 本體，而是在本機 DSH 進程內監聽 session/event，摺疊成只讀快照，由瀏覽器側 HUD 輪詢展示工具調用、Token 用量、子代理與事件日誌，並用 Canvas 2D + React 做記憶雲與 42 張狀態卡的環狀 HUD。倉庫已帶構建好的 client.js，安裝不需要 Node.js 或構建步驟；只有改 src/*.js 時才需要 Node.js 22+ 執行 node build.mjs。
環境上依賴帶插件系統的 DSH（Desktop 或 Web），需提供 shell.overlay 插槽、客戶端模塊加載（dsh.client），以及 Host 端的 webServer、sessions 與 session/event 事件。
核心功能¶
可視化與交互¶
- 可交互記憶雲：當前會話中的工具調用、文件讀寫、模型回覆與思考等會變爲記憶雲節點；懸停看標籤，點擊釘住並在右側
MEMORY INSPECTOR查看詳情，拖動旋轉、滾輪縮放。 - 旋轉卡片環：42 張狀態卡繞圓心旋轉；每張卡作爲「粒子噴嘴」，粒子從卡的一端進入、另一端扇出射向遠方（數量與手感可在
src/scene.js中通過CARD_N等常量調整）。 - 記憶與卡片聯動：選中記憶雲節點時，關聯卡片轉到可見位置並亮起，整環平滑減速；取消選中後恢復旋轉。
- 完整運行 HUD：包括
GLOBAL STATUS、AGENT ROSTER、DISPATCH BUFFER、AGENT REGISTRATION、MEMORY INSPECTOR，以及底部TASK FEED、WORKER PROFILE、TOOL CHANNEL / QUEUE、TELEMETRY。
你能從面板裏讀到什麼¶
- Agent 當前輪次、步驟，正在調用的工具、目標及成功/失敗；
- 各會話/子代理（Lead / Worker / Subagent）的狀態與活動；
- Token 輸入/輸出及最近一次回覆用量；
- 近期文件讀寫、工具調用隊列與完整事件日誌；
- 一次運行從開始到結束的軌跡，以及工具調用與文件、記憶之間的關聯。
數據與隱私（本地優先）¶
Host 半監聽本機 session/event，通過同源、只讀的 GET /dsh-agent-ops/state 暴露緊湊快照；瀏覽器每 1100 ms 輪詢該路由，不向外部服務器發送數據，無遙測與第三方請求。快照僅含運行元數據（會話/代理狀態、工具名與目標、事件日誌、Token 計數等），不讀取、不上傳文件內容。
頂欄 LIVE FEED 表示當前 DSH 會話真實事件流；會話空閒或數據不可達時自動進入 SIMULATION 演示模式（展示的是內置演示數據，不是真實運行記錄）。
安裝與啓用¶
插件以 本地 bundle 方式安裝爲主；資料未給出 dsh plugin add github:owner/repo 這類遠程一鍵命令。任選下列方式之一即可。
方式 A（推薦）：讓 DSH 裏的 Agent 安裝本地目錄¶
- 將倉庫下載或解壓到本機任意目錄（README 示例路徑請換成你的絕對路徑）。
- 在 DSH 對話中說明要把該目錄作爲本地插件 bundle 安裝到當前 profile，例如：
幫我把
C:\path\to\dsh-agent-ops這個目錄作爲本地插件 bundle 安裝到當前 profile。
DSH Agent 會通過 plugin_manager → install_bundle 寫入當前 profile。
- 安裝完成後 強制刷新 頁面（
Ctrl+Shift+R）。右下角出現發光圓環；每次頁面加載也會自動打開一次面板。
方式 B：命令行（若本機 DSH 提供）¶
dsh plugin --profile <你的 profile 名> add link:C:\path\to\dsh-agent-ops
將路徑改爲你本機插件目錄的絕對路徑。
方式 C：圖形界面¶
打開 DSH 設置 → 插件，按當前版本入口添加本地插件目錄或啓用 Agent Ops 調度中心，然後強刷頁面。
安裝後可在 設置 → 插件 確認條目已啓用；顯示名、描述與圖標來自 locale/{zh,en}.json 與 icon.svg。
典型用法¶
| 操作 | 效果 |
|---|---|
| 點擊右下角發光圓環 | 打開 / 關閉面板 |
ESC 或右上角 × |
關閉面板 |
| 懸停記憶雲節點 | 顯示標籤，MEMORY INSPECTOR 同步 |
| 點擊記憶雲節點 | 釘住記憶；關聯卡片轉向可見並亮起；整環減速 |
| 拖動記憶雲 | 旋轉（鬆手帶慣性） |
| 滾輪（指針在場景上） | 縮放記憶雲 |
| 點擊卡片 | 聚焦該卡，整環減速 |
| 點擊空白處 | 取消選中，恢復旋轉 |
點擊 TASK FEED / DISPATCH BUFFER 行 |
選中對應記憶，與場景雙向聯動 |
工作原理簡述：Host 在 index.js 中維護快照並註冊 /dsh-agent-ops/state；瀏覽器側 client.js 經 src/entry.js 掛到 shell.overlay，HUD 輪詢快照並驅動 Canvas 場景（src/scene.js、src/hud.js）。
適用場景與注意¶
適合誰：在 DSH 裏開發或調試多步 Agent、子代理與工具鏈，希望在本機 Web UI 內實時看運行軌跡與 Token/隊列，而不是隻靠滾動日誌的開發者。
權限與安全：插件隨 當前 DSH 進程權限 運行，Host 半會訂閱本會話事件並在本機 HTTP 上暴露只讀狀態路由。安裝前應閱讀倉庫源碼與 MIT 許可證，確認符合你的環境與合規要求；DSH 大版本升級後可能因內部插件 API 變化需要適配。
性能：目標約 1920×1080 / 60fps；設備較弱時可降低 CARD_N 或粒子池大小。
卸載：在 設置 → 插件 禁用或移除「Agent Ops 調度中心」，或讓 Agent 執行 plugin_manager 的 remove_bundle（包名 @local/dsh-agent-ops），然後強刷頁面。
生態說明：DSH 社區插件目錄（如 SkillHub 上的條目頁）是獨立站點，與 DeepSeek / 幻方無官方從屬關係；本文事實以倉庫 README 與 package.json 爲準。
結尾¶
Agent Ops 把 DSH 會話裏的 Agent 運行元數據收進一塊本地、可交互的可視化 HUD，適合需要工具調用、子代理與 Token 一覽的 Harness 用戶。進一步瞭解可訪問插件目錄頁與 GitHub 倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/xinranmn-wq/dsh-agent-ops
- GitHub：https://github.com/xinranmn-wq/dsh-agent-ops
