前言¶
在 DeepSeek Harness（DSH）裏跑智能體會話時，工具調用、審批、後臺任務和 token 消耗往往交錯進行。內置的 Trajectory 賬本適合事後回放整條軌跡，但當你需要知道「這一會話此刻在幹什麼、有沒有在等我點批准、這輪已經燒了多少 token」時，右側欄缺少一塊麪向「現在」的視圖。dsh-live 是社區維護者 123caiji 發佈的客戶端類插件，在 DSH 右側欄增加「現場駕駛艙」面板，用會話投影把當前輪次、步驟、階段和花費同步到 UI。
這是什麼¶
dsh-live（GitHub：123caiji/dsh-live）的定位是：Live cockpit for DeepSeek Harness——展示本會話此刻在做什麼、哪些事項需要你處理、本輪 token 成本（host 投影 + 右側欄面板）。分類屬於客戶端插件；維護者爲 123caiji。社區目錄頁見 skillhub.cn/plugins/123caiji/dsh-live，與 DeepSeek / 幻方無官方從屬關係，安裝前請自行查閱源碼與 MIT 許可證。
面板裏有什麼¶
下面介紹右側欄面板各區塊（資料中的表格摘要）。
| 區塊 | 內容 |
|---|---|
| 狀態行 | 思考中 / 正在執行工具 / 等你處理 / 空閒，以及「第 N 輪 · 第 M 步 · 已跑 S 秒」 |
| 運行中的工具 | 工具名與已運行秒數；空閒時顯示「沒有工具在運行」 |
| 需要你處理 | 待批准請求（有才出現），標題與等待秒數 |
| 後臺任務 | 未結束的後臺 job（有才出現），名字與已運行秒數；名字取命令首行、壓平空白並截到 48 字 |
| Token | 本輪累計「↑ 輸入 / ↓ 輸出」，有重試時附錯誤數 |
| 剛完成的 | 最近 5 次工具調用：成功/失敗、名字、耗時毫秒 |
耗時每秒自刷一次；沒有事件時面板不重渲染。
工作原理（簡述）¶
host 半通過 DSH 的 ctx.sessionProjections 註冊 key 爲 live 的會話投影，對事件日誌做純同步摺疊，只處理 turn/start|end、step/start、tool/call|result、approval/asked|decided、job/registered|settled、assistant/message（usage）、llm/retry、llm/retry-started 等事件；無關事件原樣返回同一 state 引用，減少下游發佈。
client 半依賴右側欄席位 @deepseek-ai/dsh-client-ui-sidebar-right，用 useProjection('live') 讀取投影，註冊 tab（id: "dsh-live", kind: "live"）並在 Guide 中提供「現場駕駛艙」入口。運行時 host 半零第三方依賴；缺右側欄包時 client 半不會掛載。
投影字段包括：turn、step、phase（idle|llm|tool|waiting）、當前工具、待審批列表、後臺任務、本輪 tokensIn / tokensOut、錯誤計數與最近 5 條工具結果等。
安裝與啓用¶
已安裝 DSH Desktop 時，用打包運行時的 CLI 裝進 desktop profile。先把 $dsh 換成本機 DSH 安裝路徑：
$dsh = 'C:\Program Files\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd' # 換成你的安裝路徑
& $dsh plugin --profile desktop add dsh-live
本地開發（不改桌面 profile，家目錄重定向到工作區）時：
$env:DSH_HOME = '<你的開發家目錄>'
& $dsh --profile dev --from-default-profile web --dump-config
& $dsh plugin --profile dev add '<本包絕對路徑>' --store-dir '<pnpm store 絕對路徑>'
& $dsh --profile dev --no-open --port 3181
然後打開 CLI 打印的 http://127.0.0.1:3181/?token=...，點右側欄的 +（Guide）→「現場駕駛艙」。
典型用法¶
日常使用路徑：安裝插件 → 啓動 DSH Web/桌面 → 在 Guide 裏打開「現場駕駛艙」→ 在同一會話裏觀察狀態行與 Token 區塊隨事件更新。開發自測可在插件目錄執行：
npm test # host 摺疊 / client 模塊結構 / 迷你 React 渲染
npm i # test:react 需要 react + jsdom（devDependencies）
npm run test:react # React 19 + jsdom 掛載、1 秒自刷
適用場景與注意¶
適合需要在 DSH 裏實時盯會話進度、審批隊列、後臺 shell 任務和本輪 token 的開發者；不適合跨會話彙總或按貨幣計價——DSH usage 無價格字段，插件也不提供金額。
務必知曉：插件與當前 DSH 進程同權限運行，安裝前應閱讀 GitHub 倉庫 源碼。已知限制包括：面板僅本會話維度；工具結果需與 tool/call 配對才進入「剛完成的」；後臺任務僅覆蓋走 job/registered / job/settled 的任務。
結尾¶
dsh-live 用輕量會話投影補上了 Trajectory 之外的「現在」視圖。目錄頁：https://www.skillhub.cn/plugins/123caiji/dsh-live；源碼與說明：https://github.com/123caiji/dsh-live。
