dsh-optimize：DeepSeek Harness 長會話資源管理器

長會話隨着對話的深入，每次步驟都會重發歷史記錄，導致上下文成本和會話日誌無限制增長。同時，Web UI 需要渲染的歷史節點也越來越多，導致交互變慢。dsh-optimize 作爲 DeepSeek Harness 的長會話資源管理器，通過測量上下文增長、報告負載狀態、提供自動壓縮選項以及優化瀏覽器渲染，解決這些問題。

插件定位¶

這是一個由 aoripus 維護的 DSH 插件，用於監控和優化長對話會話的資源消耗。它不改變系統提示詞、工具模式或請求前綴，只負責統計、告警和輔助壓縮。

安裝與啓用¶

使用官方命令安裝插件到指定 Profile：

dsh plugin --profile <profile> add dsh-optimize

配置¶

插件的默認配置已包含在打包補丁中，通常無需修改。如需覆蓋，在 Profile 的補丁層文件中編輯：

~/.dsh/profiles/<profile>/cordis.patch.yml

- id: dsh-optimize
  config:
    warnTokens: 120000
    criticalTokens: 300000
    autoCompact: false
    compactAtTokens: 200000
    compactCooldownMs: 300000
    verbose: false

配置項說明：

warnTokens (默認 120000)：觸發警告的請求權重閾值。
criticalTokens (默認 300000)：觸發嚴重警告的請求權重閾值。
autoCompact (默認 false)：是否啓用自動壓縮。
compactAtTokens (默認 200000)：達到此權重時允許運行壓縮。
compactCooldownMs (默認 300000)：兩次自動壓縮之間的最小間隔。
verbose (默認 false)：是否記錄所有請求的測量數據，而不僅僅是跨越閾值的數據。

估算邏輯爲：拉丁文本約 4 字符/Token，CJK 約 1.5 字符/Token。插件取上限進行比較，因此混合語言會話傾向於更早報告。

核心功能¶

1. 上下文負載測量¶

插件在每個 agent 或 pre-step 上測量發出的請求權重，包括消息數量、字符數和估算的 Token 範圍。它還會讀取 Harness 自身的 contextPressure 投影以獲取權威的 Token 數值。

2. 會話狀態記錄¶

插件在 $DSH_HOME/storages/dsh-optimize/state.json 中爲每個會話維護一條記錄，包含請求歷史、事件、最後及最大請求權重、投影 Token 數和壓縮次數。

3. 自動壓縮¶

通過 ctx.agentPresets.serviceFor(agent, 'compaction') 接口調用 Harness 的壓縮引擎。
* 需要注意的是，壓縮功能默認關閉。
* 壓縮功能需要 Agent 處於空閒狀態，否則請求會被拒絕並重試。
* 它決定何時壓縮，而具體的摘要內容由 Harness 引擎決定。

4. 優化主機服務¶

插件提供了 optimize 主機服務，包含以下方法：
* snapshot(id)：獲取指定會話的快照。
* list()：列出會話列表。
* flush()：刷新數據。

5. 瀏覽器視圖優化¶

在 Web UI 中，插件默認開啓“Lite rendering”（精簡渲染）模式。
* 通過 CSS 設置 content-visibility: auto 和 contain-intrinsic-size，瀏覽器會跳過滾動視口外節點的佈局和繪製。
* React 仍然會正常協調節點，但不會導致頁面卡頓。
* 點擊 Composer 芯片或進入設置 -> 常規可以切換此模式。
* 開關狀態持久化在 localStorage 的 dsh-optimize:lite 鍵下。

注意事項¶

權限與影響：插件以當前 DSH 進程權限運行。安裝前請檢查源碼。
默認行爲：自動壓縮默認關閉，以避免改變模型實際接收到的上下文。
渲染機制：Lite 渲染不會隱藏 DOM 節點，所有節點依然存在且可訪問，僅優化渲染性能。
日誌隔離：插件不寫入會話事件或觸碰會話日誌文件。

總結¶

dsh-optimize 專注於讓長會話的代價變得可見。通過精確的測量和可選的自動化控制，它幫助開發者管理資源消耗；通過瀏覽器端優化，它提升了長對話界面的流暢度。更多細節可查閱插件目錄或源碼倉庫。