前言¶

在 DeepSeek Harness（DSH）裏跑 Agent 時，任務是否在推進、工具是否在執行、長時間無輸出是正常停頓還是異常，往往只能盯着對話流或反覆點開側欄。社區插件 Caelum Orbis（包名 dsh-orbis，倉庫 mycherish/dsh-orbis）把 Host 側會話事件摺疊成只讀快照，在 Web GUI 上提供常駐進度 HUD、懸浮 3D 能量球和可展開的 Workspace，不調用 LLM、不讀推理正文。下面按定位、能力、安裝與使用說明展開。

這是什麼¶

Caelum Orbis（環樞）由 mycherish 維護，分類爲客戶端插件：瀏覽器端覆蓋層 + Host 側事件管線，面向 DSH Web 界面。當前資料中的版本爲 2.1.13，許可證 MIT；要求 DSH >=0.2.2-rc.1 <0.3.0-0，Node ^22.19.0 || >=24.0.0。

它解決的是「不用打開額外面板也能看見 Agent 在幹什麼」：對話區右側浮出約 470px 寬的玻璃 HUD，展示任務標題、階段、最近活動、當前狀態與真實計數；需要細節時再打開 Workspace，查看 3D 能量球、活動記錄與執行時間線。所有展示來自 DSH 真實事件，插件只讀、不執行工具、不寫會話、不落庫，也不修改 DSH 源碼。

核心功能¶

Always-on HUD（v2）¶

HUD 寬 min(470px, 92vw)，貼在對話區右側（top: 118px），不擋底部輸入；視口 ≤720px 時改爲頂部浮動。標題欄含 Logo、名稱、狀態膠囊，以及打開 Workspace、固定、收起的控制。

任務區左側爲與 Workspace 共用的 WebGL 能量球（96px），右側爲任務標題（來自 session/title，缺省爲「當前任務處理中」）、階段與當前動作。運行信息標明時長與「純事件模式 · 0 額外 Token」。最近活動最多 5 條，按成功 / 執行中 / 模型處理 / 等待 / 失敗着色。當前狀態用一句話描述；靜默時給出基於單調時鐘的真實秒數（例如已連續 45 秒無新活動），文檔明確不會用「卡死」一類措辭。若 Agent 通過 todo/write 寫了計劃，才顯示「下一步」區塊。底部只展示已觀察到的活動數、工具次數與運行時長。

顯示模式有三種（2.1.10 起區分清楚）：

用戶手動收起後，自動模式不會再次自動彈開；📌 固定後空閒也不自動摺疊（手動收起優先）。

十一狀態能量球¶

Host 用 13 族活動分類與 11 態狀態機，把 turn/start、step/start、tool/call、assistant-stream 增量、approval/asked 等映射爲 idle、starting、thinking、preparing、executing、responding、waiting、quiet、completed、interrupted、error。球體爲真實 3D（內層 GLSL 能量材質、玻璃殼、軌道與粒子），狀態切換爲插值動畫。

三條與誤判相關的規則值得記住：agent/status: running 不等同於「思考中」，最多升到 starting；長耗時工具執行期間保持 executing，靜默單獨用 quietLevel 上報；completed / interrupted / error 爲帶時限保持態後回落。靜默分檔自 30 秒起算，避免普通推理停頓被標成「安靜」。

Workspace 工作空間¶

展開後約爲 780×600（最大 94vw×88vh）的深色磨砂玻璃面板：左側大能量球與圖例，右側最多 40 條實時活動（工具 / 文件 / 審批 / Agent），底部爲執行時間線與統計（輪次、步數、工具、幀率等）。設置項包括總開關、上述三種顯示模式、活動列表、30/60 FPS、粒子密度、軌道與光效、減少動態、後臺暫停等。

架構與安全（使用側結論）¶

Host 監聽會話事件，經白名單化、分類、關聯與狀態機生成 OrbitSnapshot，經 GET /api/orbis/state 與 GET /api/orbis/events（SSE，輪詢兜底）推到瀏覽器。瀏覽器通過 shell.overlay 掛載 HUD、Launcher 與 Workspace。

隱私上，傳到前端的字段經 redactor 白名單處理：不包含 rawArguments、reasoningText、fileContent 等；路徑只保留 basename 並截斷；流式幀僅讀 chunk.type。插件不新增遙測、不訪問第三方域、無寫接口。卸載時路由與 SSE 會清理；總開關關閉可連同渲染器一起釋放。

性能方面，默認 30 FPS（可選 60），HUD 爲純 DOM；標籤頁隱藏或 Workspace 關閉時會暫停對應 WebGL 循環。

安裝與啓用¶

Desktop 配置下，在終端執行官方安裝命令：

dsh plugin --profile desktop add dsh-orbis

若 Harness 由 dsh web 啓動，把 desktop 換成 web：

dsh plugin --profile web add dsh-orbis

安裝完成後刷新一次 Harness 頁面（瀏覽器對每個頁面代次通常只加載一次插件資源）。

也可在 GUI 中：設置 → 插件 → 添加插件 → 安裝第三方插件，包名填寫 dsh-orbis。GitHub tag、離線包、本地 link: 開發安裝及卸載方式見倉庫 README「開發」下的安裝 / 卸載小節。

插件目錄頁：SkillHub — mycherish/dsh-orbis。

典型用法¶

1. 按上一節安裝並刷新頁面，確認右側或右下角出現 HUD / 能量球（取決於顯示模式）。
2. 發起一輪 Agent 任務，觀察 HUD 中階段、最近 5 條活動與底部計數是否隨工具調用變化；長命令執行時應保持「執行中」而非誤判爲靜默。
3. 點擊標題欄 ··· 或點擊懸浮球，打開 Workspace，覈對活動列表、時間線與 SSE 連接狀態。
4. 在 Workspace 或設置中切換「自動展開 / 始終緊湊 / 僅能量球」，按機器性能調節幀率與粒子密度；不需要時關閉總開關以釋放渲染器。

未在資料中出現的 CLI 子命令或配置文件名，本文不另行編造；以倉庫 README 爲準。

適用場景與注意¶

適合長期在本機或內網 DSH Web 上調試 Agent、需要一眼看到輪次、工具與審批狀態、又希望零額外 Token 的開發者。不適合把它當作審計日誌或遠程運維面板：緩衝與展示有上限（如最近 40 條活動），且刻意不暴露參數與文件全文。

DSH 生態主張「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。安裝第三方插件前，應自行查看 GitHub 源碼 與 MIT 許可證；插件隨當前 DSH 進程權限運行，Host 會掛鉤會話事件——若環境對只讀 API 或 SSE 有安全策略，需自行評估。

結尾¶

Caelum Orbis 把 DSH 已有事件流做成常駐 HUD 與 3D 狀態可視化，強調只讀、白名單與可獨立停用。需要安裝命令與架構細節時，以 GitHub 倉庫 README 爲準；瀏覽插件元信息可訪問 SkillHub 目錄頁。