DeepSeek Harness (DSH) 中的長工具結果會導致巨大的上下文壓力。DSH 自帶一個優秀的 LLM 壓縮機制 (/compact)，但它在壓力建立後才運行，且需要額外的模型調用。dsh-ledger-compact 插件在結果到達模型之前處理整形，並提供一種本地機械摺頁方式，無需 LLM 調用。
插件概覽¶
這是一個 DeepSeek Harness 插件，用於在工具結果到達模型前進行入境整形，並提供本地機械摺頁功能。該插件由 telagod 維護，採用 MIT 許可證。
核心功能¶
插件主要包含以下三個功能：
- 入境整形：在空閒預步驟中凍結過大的未發送工具結果。僅處理剛完成的步驟，確保不會破壞提供者的前綴緩存。
- 機械摺頁：通過
/fast-compact和輸入欄摺疊較舊的歷史記錄，生成簡短的摺頁卡片。 - 替換默認壓縮：可選地重用官方引擎的
summarize掛鉤，使/compact、自動壓縮和溢出恢復跳過 LLM。
安裝與啓用¶
安裝前請確保 DeepSeek Harness 版本爲 >= 0.1.2-rc.1。使用以下命令安裝插件：
dsh plugin --profile web add github:telagod/dsh-ledger-compact
安裝完成後，重啓 web profile 即可生效。插件會通過 bundle patch 插入自身 ID。
典型用法¶
插件提供以下命令：
/fast-compact
/fast-compact status
/fast-compact：手動觸發機械摺頁。/fast-compact status：查看健康狀態，包括入境整形計數器、最後錯誤以及壓縮引擎的掛鉤情況。
注意事項¶
- 依賴要求：需要
dsh >= 0.1.2-rc.1。 - 引擎兼容：不替換 DSH 引擎本身，需要保留
@deepseek-ai/dsh-compaction-basic。 - 視覺功能：不支持 vision sidecar，且
/fast-compact vision …命令已被移除。 - PNG 限制：PNG 圖片功能受限於特定條件，例如模型必須明確支持
image模態，且圖像成本必須低於文本成本。
