前言¶
在 DeepSeek Harness（DSH）裏跑長任務時，對話流裏堆着工具輸出、回合與驗證結果，想快速回答「這輪在幹什麼、證據是什麼、關沒關」往往要往回翻很多消息。社區插件 dsh-vantage（維護者 regrevia）在會話視圖切換器裏註冊名爲 vantage 的只讀面板，與對話並排展示：當前回合的工作主題、每條主題背後的證據、驗證狀態，以及有界的歷史回合。它不調度、不停止、不替 Harness 做完成決策，只觀察已發生的會話事件並渲染。
這是什麼¶
dsh-vantage 是 DSH 的客戶端類插件：Host 端 index.js 摺疊會話事件並提供固定 API；客戶端 index.js 註冊的 client.js 在對話界面增加總覽視圖。分類上屬於「客戶端」；GitHub 倉庫 regrevia/dsh-vantage 當前 package 版本爲 0.1.38，許可證 MIT，依賴 DSH >=0.2.1-rc.3。
目錄頁：https://www.skillhub.cn/plugins/regrevia/dsh-vantage（社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
下面介紹面板展示的內容與行爲，均來自項目 README。
當前回合¶
- 一至三個工作主題：描述「改了什麼、還在查什麼、什麼阻塞任務」。主題是工作單元，不是工具名，也不是 test/lint/build 清單。
- 證據：每個主題可展開說明及其背後事實（計劃、報告或觀察）。原始命令輸出默認摺疊，僅在展開該行時拉取。
- 驗證：收尾檢查是通過、失敗還是仍開放；通過的檢查算作證據，不會單獨佔一個主題。驗證列表爲空時顯示「尚未明確」，不會默認視爲通過。
歷史與會話¶
- 歷史：以真實回覆結束的更早回合，新的在前。歷史列表與某一回合詳情不會同時出現；在回合內用分頁與 ←/→ 一次移動一回合；最新已保存回合的前進操作會變成「回到本輪」。
- 已保存會話：非 live 的會話以只讀打開，最後一輪、已交付項與歷史來自保存日誌，開關隱藏，避免誤開錄製或模型調用。
- 每會話開關：默認關閉。關閉時不折疊事件、不建快照、不向模型發送任何內容；打開後從該時刻開始錄製，歷史中已保存回合仍可讀。
界面與 Host 協作¶
總覽是閱讀面：掛載該視圖時插件會隱藏消息輸入區（composer seat），切回對話即恢復；實現爲作用域屬性加 Host 自身 seat 上的一條 CSS 規則，不重寫 DOM。
掛載時先 GET /snapshot，再輪詢。冷加載、Host 路由未就緒或請求失敗時，客戶端會自動重試四次（間隔 400 ms、1.6 s、3.6 s、6.4 s），首次成功或切換會話時重置；四次仍失敗則停在可手動重試狀態。控件樣式跟隨原型文案與 Host 的 --dsw-* 令牌，適配明暗與窄屏。
隱私與邊界¶
數據本地處理：每會話最多保留 20 個回合、全局最多 200 個回合；不復制完整軌跡；摘要僅發送有界事實包，不含憑證、環境變量或回放數據。關閉會話的開關時不發起模型調用、不存儲新回合。
安裝與啓用¶
插件爲單包結構，通過插件管理器的 install_bundle 安裝：將目錄鏈入 profile，並由 Cordis 應用 bundle patch（插入 id dsh-vantage，不修改已有條目）。安裝後需下一次插件重載纔出現視圖——點刷新按鈕，或重啓應用一次。
手動接線時：把檢出目錄加入 profile 的 dependencies，並在 dsh.profile.bundles 末尾加入 dsh-vantage。
Host 在 /api/dsh-vantage 下提供七條路由（四個 GET：snapshot、history、round、evidence；三個 POST：summaryRequest、enable、open）。所有路由僅會話 owner 可訪問；無 Harness 認證 cookie 返回 401，非 owner 返回 403。細節見倉庫 WIRE.md。
配置¶
選項均可選，默認偏安靜：
| key | default | 含義 |
|---|---|---|
enabled |
true |
是否提供 snapshot；每會話開關仍默認關 |
summary.enabled |
true |
開關打開時是否允許模型摘要 |
summary.cadenceMs |
180000 |
摘要最小間隔，下限 60 s |
summary.firstEligibleMs |
60000 |
回合開始後最早可摘要時間 |
summary.maxInputTokens |
2400 |
單次請求上限（含 system） |
summary.maxOutputTokens |
400 |
回答 token 上限 |
summary.maxTopics |
3 |
摘要最多主題數 |
summary.requestDeadlineMs |
25000 |
單次摘要硬超時 |
summary.provider |
"" |
空則用會話默認 provider |
summary.model |
"" |
空則用會話默認 model |
未配置可用模型時，視圖退化爲由摺疊事實構成的 factual summary；摘要失敗保留上一次有效結果及真實更新時間，不會退化成命令 checklist。
典型用法¶
- 按上文用
install_bundle或手動 bundles 安裝，滿足 DSH >=0.2.1-rc.3，重載插件後在對話視圖切換器中選擇 vantage（或 README 中的 overview 視圖）。 - 在需要記錄的會話裏打開每會話開關，從該時刻起 Host 開始摺疊事件並可選觸發摘要；閱讀當前一至三個主題、展開證據、查看驗證狀態。
- 用歷史列表進入更早回合；在回合內用分頁或 ←/→ 瀏覽；對已交付文件可通過
open交給系統查看器（僅允許該回合實際交付的路徑）。 - 查看已歸檔會話時保持只讀，無需也無法通過該視圖重新開錄。
適用場景與注意¶
適合需要在不離開當前 Harness 窗口的情況下，用只讀方式把握任務進展、證據與驗證、有限歷史回合的開發者。不適合把它當作任務調度器或自動收尾工具——README 明確說明視圖不參與調度與完成決策。
插件以當前 DSH 進程權限運行；安裝前請自行審閱 源碼與 MIT 許可證，確認符合你的安全與合規要求。摘要功能在開關打開且配置允許時會調用模型，但發送內容爲有界事實包；若完全不想觸達模型，可關閉 summary.enabled 或保持每會話開關關閉。
結尾¶
dsh-vantage 把「任務實際進行到哪」收成對話旁一塊只讀總覽：主題、證據、驗證與有界歷史同屏可讀，默認不錄、不喊模型，打開開關後才從當下開始觀察與可選摘要。
