前言¶
用 DSH Web 驅動 Agent 跑任務時，一個現實的問題是：回合進行中你很難看到它此刻在做什麼——工具調用到了哪一步、子代理有沒有在協作、令牌消耗了多少、折算成人民幣大概是多少。這些信息通常要等回合結束再翻記錄。dsh-plugin-mission-control 解決的就是這件事：把當前 DeepSeek Harness Session 的即時狀態放進 Session 列表下方的一塊緊湊面板，需要細看時再展開成全屏儀表盤。
這是什麼¶
dsh-plugin-mission-control 由 Jian-Sparrow 維護，當前版本 0.3.1。一句話定位：爲當前 DeepSeek Harness Session 提供即時可觀測性——呈現 Agent 活動、工具調用、子代理協作、權威令牌計數與 CNY 成本估算。
DSH 的理念是「一切皆插件」，這個插件正是以一行 Cordis 配置掛進 Web profile 的。使用前有兩點設計值得先說清楚：
1、它只顯示 Harness 已記錄的 Session 事實，不向模型上下文添加模型工具、提示或隱藏推理，儀表盤也不渲染模型思維鏈。
2、它是 live-only 的：只在面板可見時維持訂閱，不提供事後回放。
核心功能¶
全局 HUD¶
HUD 常駐顯示：連接狀態、總令牌數、四個令牌桶（Input / Output / Cache read / Cache write）、近期令牌速率、估算 CNY 成本、Agent 數、運行中工具數與診斷信息。令牌字段來自 Harness 的權威令牌計數，近期令牌速率按 velocityWindowMs 配置的滾動窗口統計。
Agent 樹與即時工具流¶
面板以當前 Session 爲根渲染一棵可選中 Agent 樹，子代理協作也會呈現在其中。選中某個 Agent 後，令牌合計與工具行會聯動過濾。
工具流逐行展示歸屬、耗時、結果狀態，行數有上界（maxLiveRows），並可選載荷預覽。
兩個入口與全屏儀表盤¶
有兩個原生入口：當前 Session 頭部，以及 DSH Web 側邊欄底部（Settings 旁的 ◎ Mission Control）。未選中 Session 時，側邊欄入口處於禁用狀態。
內嵌標題欄的 Expand Mission Control 可展開爲全屏儀表盤：左側 Agent 拓撲，右側工具即時流，上方是 Token/CNY HUD；Restore Mission Control 恢復內嵌視圖。Expand 與 Restore 不會重連 SSE、不會重置 Agent 選擇、也不會清空工具行。Escape 可關閉任一呈現。
Live-only 訂閱¶
面板可見時，插件只維持一條同源 SSE 訂閱，跟隨全局當前 Session；重連期間凍結最後快照。訂閱在以下情況釋放：關閉面板、側邊欄收起、Session 切換、插件卸載、瀏覽器斷開。
安裝與啓用¶
依賴要求：
- DeepSeek Harness
0.1.0-rc.7 - DSH Web profile
- Node.js
^22.19.0或>=24.0.0 - 經 Corepack 使用 pnpm
先安裝插件，再驗證組合後的配置行，最後啓動 DSH Web：
dsh plugin --profile web add dsh-plugin-mission-control
dsh --profile web --dump-config
dsh --profile web
插件包會向 Cordis 配置插入一行 mission-control，其默認層等效於：
- id: mission-control
name: dsh-plugin-mission-control
config:
previewMode: names-only
tokenPublishIntervalMs: 250
velocityWindowMs: 5000
maxLiveRows: 300
如果想用本地 checkout 而不是 npm 安裝，把路徑傳給同一條命令即可：
dsh plugin --profile web add ./dsh-plugin-mission-control
典型用法¶
1、啓動 DSH Web，在其中啓動或打開一個 Session。
2、從 Session 頭部選擇 Mission Control，或點擊側邊欄 Settings 旁的 ◎ Mission Control；未選中 Session 時側邊欄入口是禁用的。
3、需要細看時，點內嵌標題欄的 Expand Mission Control 進入全屏儀表盤，看完點 Restore Mission Control 回到 Session 列表面板。
4、切換選中的 Session 時，面板保持打開，即時流跟隨新的當前 Session，訂閱會隨之釋放重建。
5、修改配置：在 profile 或用戶目錄的 cordis.patch.yml 中整體覆蓋 mission-control 行。
配置¶
上面默認層裏的幾個字段含義如下：previewMode 控制工具載荷預覽的檔位，tokenPublishIntervalMs 是令牌更新的合併間隔，velocityWindowMs 是近期令牌速率的滾動窗口，maxLiveRows 是保留的工具行數上限。
所有配置字段在 Cordis 插件加載時校驗，非法配置會顯式報錯（fails loudly），不會被靜默忽略。
成本估算¶
成本估算完全離線進行：插件內置一份版本化價目目錄，只對精確匹配目錄的 deepseek-official 路由計價，按峯/谷時段取價，HUD 會報告計價步比例。未知提供商、模型別名、未知模型、缺失請求路由或時間戳的步驟保持未計價，而不是按免費處理。
內置價目表於 2026-08-18 對照 DeepSeek 官方中文定價頁覈對。
需要強調的是：金額是估算而非實際賬單，不含稅費、賬戶條款、促銷、取整規則或服務商側計費調整；插件在運行時不查詢賬戶或計費 API。
隱私與網絡¶
previewMode 控制工具載荷的可見程度，共三檔：
names-only（默認）：只顯示工具名稱、歸屬、耗時與結果狀態；redacted：展示有界的參數與結果摘要，對敏感字段與憑據樣式文本做盡力脫敏；脫敏是盡力而爲，不構成安全邊界；full：展示完整載荷，儀表盤保留屏幕警告。
無論哪一檔，儀表盤都不渲染模型思維鏈或隱藏推理，只顯示 Harness 已記錄的 Session 事實。
網絡暴露由 DSH Web 負責：插件使用同源端點，繼承 Web profile 的綁定地址、trusted-host 校驗、認證與反向代理行爲。不要僅僅爲了查看這個面板，把 DSH Web 暴露給不可信網絡。
適用場景與注意¶
適合在 DSH Web 裏跑多 Agent 或長任務、需要即時掌握工具調用與令牌成本的開發者。
使用前有幾點注意：
1、插件以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證。倉庫中帶有 LICENSE 文件，但本次覈對未能確認具體許可證類型，請以倉庫內容爲準。
2、0.3.x 適配 Harness rc.7 的側邊欄 DOM（根植於 sidebar.footer.action 槽位）。未來 Harness 側邊欄標記變更可能需要插件更新；屆時插件會以具名集成錯誤顯式失敗，而不是靜默掛載到錯誤位置。
3、成本數字只作估算參考，不要當作賬單依據。
4、面板是 live-only 的，只反映訂閱期間的狀態；關閉面板後訂閱即釋放。
結尾¶
回顧一下：dsh-plugin-mission-control 把 DSH Web 的當前 Session 變成一塊可盯的即時面板——Agent 樹、工具流、令牌計數與 CNY 估算在同一屏，且不向模型上下文注入任何內容。如果你日常在 DSH Web 裏跑任務，它值得裝進 Web profile 試一試。
- 社區目錄頁：https://www.skillhub.cn/plugins/Jian-Sparrow/dsh-plugin-mission-control
- GitHub 倉庫：https://github.com/Jian-Sparrow/dsh-plugin-mission-control
其中目錄鏈接指向社區維護的插件目錄，該目錄爲獨立站點，與 DeepSeek、幻方無官方從屬關係。
