在 DeepSeek Harness (DSH) 的開發流程中，模型上下文往往是一個黑盒：系統提示詞、歷史消息、工具結果以及運行時注入的內容混雜在一起，開發者很難單獨查看或精準修改。dsh-ctm 插件將這段上下文轉化爲可視、可編輯且帶有有效性評分的“一等對象”，解決了這一痛點。
這是什麼¶
dsh-ctm（Context Transparency Manager）是由開發者 ac0033 維護的 DeepSeek Harness 插件。它基於純 TypeScript 和 Zod 構建，通過零耦合的 HTTP 協議與 DSH 主進程通信，提供全量上下文可見性、MECE 令牌覈算、實時編輯和有效性評分功能。
核心功能¶
-
全局可見與分段流視圖
插件提供 Turn 到 Segment 的流程視圖，內容按角色、令牌數、緩存狀態和有效性評分着色，支持 Markdown 渲染和分頁。你可以清晰地看到每一段內容在上下文流中的位置和狀態。 -
MECE 令牌覈算
KPI 條帶使用 MECE（Mutually Exclusive, Collectively Exhaustive）分桶統計令牌，包括未緩存輸入、緩存命中、輸出。數據優先取自提供商測量的tokenUsage，當投影不可用時回退至全日誌摺疊。視圖會顯示緩存命中率，並在 Turn 和 Step 標題中展示累計或單步數據。 -
實時刷新
編輯器基於反應式訂閱機制，新消息、工具結果和回合邊界會觸發即時更新，無需輪詢。 -
可編輯性
支持對初始系統提示詞進行替換、刪除、回滾、快照恢復和撤銷操作。同時也支持手動覆蓋內容的有效性評分。需要說明的是，除了初始系統提示詞外，系統注入內容、工具結果、CTM 佔位符標記在 UI 中爲只讀。 -
有效性評分引擎
內置自動評分引擎，根據 2-gram 相似性（LRU 緩存，500 條目上限）判定內容爲“有效”、“冗餘”、“陳舊”或“注入”，並允許開發者手動覆蓋裁決。 -
真實應用
當啓用“真實應用”功能時，替換、刪除或回滾操作不再僅僅是 UI 級的預覽，而是通過agent/pre-step水流寫入會話日誌，實現攔截和修改上下文。工具調用與結果對不會拆分，刪除操作會自動平衡工具調用的最小範圍。
安裝與啓用¶
通過 DSH 生態目錄或 GitHub 倉庫獲取。安裝後，在 DSH 界面中註冊即可使用。
典型用法¶
-
測試系統提示詞變體
在 Context 標籤頁中，替換初始系統提示詞，觀察模型在不同指令或約束下的行爲變化，無需重新啓動會話。 -
攔截並修改上下文
啓用“真實應用”開關，在日誌記錄前攔截上下文並進行修改，確保最終進入模型的上下文符合預期。 -
查看性能指標
在 Context 標籤頁中查看 KPI 條帶，監控緩存命中率及 Token 使用情況，輔助優化上下文長度。
適用場景與注意¶
- 注意：分段級別的令牌計數爲啓發式估算，僅供參考。
- 注意：系統注入內容在 UI 中爲只讀。
- 注意：工具調用/結果對不會拆分。
- 注意：撤銷功能僅對最近一次操作有效。
- 注意：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
短結尾¶
dsh-ctm 提供了從“看”到“改”再到“評”的上下文管理閉環，適合需要精細調試上下文流或優化提示詞效果的 DSH 用戶。更多詳情請參考插件目錄或GitHub 倉庫。
