前言¶
在使用 DeepSeek V4.1 Flash 進行長對話時，模型常出現否定先前結論、丟失關鍵節點或幻覺升高的問題。DSH 的原生壓縮機制在空閒窗口難以觸發。dsh-context-checkpoint 插件通過自動總結、壓縮和注入，將關鍵狀態固定在提示詞開頭，確保模型在注意力最高的位置讀取當前事實。
這是什麼¶
插件名 leafstory/dsh-context-checkpoint，由 Leafstory 維護。這是一個工作流插件，使用 MIT 許可證。它實現了一個閉環：達限 → 總結落盤 → 自動壓縮 → 壓縮後注入回上下文開頭。
核心功能¶
- 自動總結落盤：將項目狀態寫入文件，作爲長期存儲。
- 壓縮注入回上下文開頭：壓縮後注入爲靜態上下文，不依賴模型記憶。
- 使用 context_compact 預約壓縮：通過工具預約壓縮時機。
- 在 agent/pre-step 步驟邊界觸發壓縮：不依賴空閒窗口，在步驟切換時自動執行。
- 工具 context_status 和 context_compact：提供狀態查看與預約接口。
工作原理¶
- 達限：佔用超過閾值時觸發總結。
- 落盤：將狀態寫入
important_view.<task>-<session>.md文件。 - 預約：使用
context_compact預約壓縮。 - 注入：壓縮後注入爲靜態上下文，位於提示詞前部。
典型用法¶
- 用戶意圖豁免：用戶明確說“總結/落盤/壓縮”時，豁免觸發門檻。
- 強制繞過：調用
context_compact {force:true}可繞過門檻與落盤閘。 - 狀態查看：使用
context_status查看精確 token 佔用。 - 取證：使用
scripts/list-events.mjs查看檢查點注入情況。
安裝與啓用¶
插件通過 npm 腳本進行安裝：
npm run dsh:install
安裝完成後，修改代碼必須重啓 DSH 才能生效。
適用場景與注意¶
- 依賴關係：依賴 DSH 原生壓縮引擎，不自行實現壓縮算法。
- 觸發時機：壓縮不依賴空閒窗口，在
agent/pre-step步驟邊界自動執行。 - 上下文性質：注入內容作爲靜態上下文，不依賴模型記憶。
- 預約條件：預約壓縮前需確保檢查點文件存在且新鮮（10分鐘內）。
短結尾¶
該插件通過工程手段將關鍵狀態反覆放到提示詞最前部，是解決長任務穩定性的實用工具。
目錄頁：Leafstory/dsh-context-checkpoint
GitHub：Leafstory/dsh-context-checkpoint
