前言¶
在 DeepSeek Harness(DSH)裏做長任務時,上下文窗口逼近上限會觸發壓縮:主流程往往要停下來等摘要生成,再繼續下一輪模型請求。對頻繁工具調用、多輪推理的會話,這種停頓會反覆出現。
社區插件 更快壓縮 · Faster Compress(包名 dsh-faster-compress,維護者 GallenShao)在 DSH 側提供後臺上下文壓縮:在達到準備閾值後於後臺生成摘要,主任務在安全餘量內繼續推進;到 step 邊界或下一次請求前再替換上下文。下面介紹其定位、能力與安裝方式。插件歸類爲模型推理相關能力,在 SkillHub 目錄頁 可查看條目;目錄爲社區站點,與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-faster-compress 是爲 DeepSeek Harness 編寫的插件,核心目標是提前準備上下文摘要,從而減少長對話裏因壓縮產生的等待,並通過壓縮歷史查看摘要結果、耗時與 token 用量。
與「到點再壓縮、主線程同步等待」相比,該插件在後臺並行準備摘要,準備好後在合適時機應用,並保留失敗時回退原生壓縮的路徑。摘要與預熱請求沿用當前對話的模型與已有憑據,按模型服務商規則計費;默認即用,無需 API Key,也不用編輯 YAML。
運行環境要求:Node.js ≥ 22.19;README 標明已在 DSH 0.2.0-rc.2 / 0.2.1-rc.2 上驗證。許可證爲 MIT(見倉庫 LICENSE)。
核心功能¶
邊工作邊準備,到點再應用¶
達到準備閾值後,插件在後臺生成摘要,主任務在安全餘量內可繼續推進。在下一次模型請求前替換上下文,並保留期間新增的消息;正常回合結束後也會保留摘要,供下一輪校驗複用。
失敗兜底¶
摘要失敗或失效時,回退 DSH 原生壓縮邏輯,仍可使用 /compact。
壓縮歷史¶
在會話頂部打開 壓縮歷史,可查看:
- 內容與狀態:摘要、原文摘錄、是否已應用,以及失敗原因;
- 耗時:後臺準備、壓縮等待與應用後的首輸出時間;
- 用量:壓縮前後實測輸入 token,以及摘要請求和緩存用量。
支持搜索、篩選、複製,並跟隨 DSH 主題。歷史數據會寫入 $DSH_HOME/data/faster-compress/traces/(摘要與原文摘錄);隱藏曆史標籤不會停止記錄。
可配置項¶
進入 插件 → 已安裝 → 更快壓縮 · Faster Compress,修改後保存即可生效,無需重啓。常用項如下:
| 設置 | 默認值 | 用途 |
|---|---|---|
| 後臺準備時機 | 100% | 摘要經常來不及時可調低;比例相對於準備閾值,並非上下文容量 |
| 預熱新上下文 | 關閉 | 可選額外請求,適合服務有餘力且能複用緩存時 |
| 顯示壓縮歷史標籤 | 開啓 | 控制會話中是否顯示歷史頁 |
通常保持默認即可;高級選項可調整輸出預留、安全餘量和併發數,升級會保留已有設置。
安裝與啓用¶
插件以當前 DSH 進程權限運行,安裝前建議瀏覽 GitHub 源碼 與許可證。
- 打開 DSH 側邊欄 插件 → 添加插件。
- 在輸入框填入包名(README 原文,勿自行拼接
github:owner/repo):
dsh-faster-compress
- 點擊安裝,完成後重新啓動 DSH。
若只用命令行(Web 配置),可執行:
dsh plugin --profile web add dsh-faster-compress
然後重新啓動 dsh web。桌面端請使用應用內的「添加插件」。
典型用法¶
安裝後無需額外配置文件即可工作。長對話或工具調用密集時,留意上下文用量;當後臺摘要就緒,會在下一次模型請求前自動參與替換上下文。
需要排查或復盤時,打開會話頂部的 壓縮歷史 查看單次壓縮的狀態與用量。若摘要未趕上或失敗,可繼續使用 DSH 自帶的 /compact 走原生壓縮。
調整「後臺準備時機」等項:進入已安裝插件的設置頁,保存後立即生效。
適用場景與注意¶
適合:長對話、頻繁工具調用的 DSH 會話,希望減少「停下來等摘要」的次數,並需要可觀測的壓縮記錄。
注意:
- 後臺摘要仍佔用模型資源並按服務商規則計費,不能保證消除所有等待。
- 未應用的摘要只保存在內存中;重啓 DSH 後會重新準備,或回退原生壓縮。
- 清理
$DSH_HOME/data/faster-compress/traces/中的歷史副本時,應先停止 DSH,再刪除該目錄。
開發與測試說明見倉庫 tests/README.md;更新與發佈見 CHANGELOG.md、RELEASES.md。
結尾¶
dsh-faster-compress 把上下文摘要 preparation 挪到後臺,在 step 邊界再提交,並輔以壓縮歷史與可調準備時機,面向 DSH 長任務中的壓縮等待問題。條目與分類見 SkillHub 目錄,源碼與安裝說明見 GitHub:GallenShao/dsh-faster-compress。