前言¶
在 DeepSeek Harness (DSH) 上開發長週期智能體時，歷史記錄會不斷積累。常規做法是壓縮歷史，但這會導致細節丟失，且壓縮後的摘要往往成爲唯一的“事實來源”，造成信息失真。dsh-epistemic-fold 提供了一種契約保留的上下文運行時方案，它將舊軌跡摺疊出熱上下文，同時保留精確的歷史記錄，確保有損摘要不再作爲權威來源。
插件定位¶
該插件由 orangeofcarl0-sys 維護，是一個爲 DSH 提供的上下文運行時組件。它通過維護一個單調的摺疊前沿，在保持上下文窗口大小的同時，確保原始歷史可被檢索和恢復。
核心功能¶
該插件提供以下能力：
- 精確歷史可恢復：通過歸檔和召回機制，確保持久化的歷史消息可被精確檢索。
- 熱上下文摺疊：舊軌跡離開活躍提示詞，進入緊湊檢查點，釋放上下文窗口。
- 單調摺疊前沿：摺疊過程保持單向推進，避免反覆重寫之前的摘要。
- 確定性狀態表示：當前狀態可以獨立於敘述文本進行表示。
- 非權威摘要：有損摘要不再是事實的唯一來源，只有在需要時才檢索精確檔案。
- 運行時監控：側邊欄顯示上下文壓力、摺疊次數、歸檔狀態和檢索活動。
- 檢索工具：提供
context_search和context_recall工具，允許智能體主動檢索歷史。
安裝與啓用¶
首先通過命令安裝插件。插件必須加載在 dsh-web-app 之後，以便修補 DSH 的預設配置。
dsh plugin --profile <name> add github:orangeofcarl0-sys/dsh-epistemic-fold#v0.1.0
注意：在 Profile bundle 配置中，請確保
dsh-web-app位於dsh-epistemic-fold之前。
典型用法¶
1. 設置上下文模式¶
插件提供三種模式以平衡上下文窗口與保留策略：
/context mode economy
/context mode balanced
/context mode quality
- Economy：保持熱上下文精簡，按需恢復舊細節。
- Balanced：保留較大的字面量尾部。
- Quality：在平衡模式基礎上增加語義理由檢查點。
2. 檢查運行時狀態¶
使用命令查看當前的上下文壓力、摺疊次數和歸檔狀態。
/context status
狀態界面位於側邊欄，它獨立於模型歷史，不會消耗上下文窗口。
3. 使用檢索工具¶
當智能體需要歷史細節時，可使用註冊的工具：
context_search：定位相關的摺疊歷史和帶邊界限制的字面量摘錄。context_recall：檢索檢查點視圖或精確歸檔的消息。
適用場景與注意¶
該插件適用於需要長時間運行且上下文窗口受限的智能體任務。使用時需注意以下事實：
- 分支鎖定：
github:owner/repo格式默認指向默認分支，而非 Release 版本。如需鎖定特定版本，需顯式指定標籤（如#v0.1.0）。 - 加載順序：插件必須加載在
dsh-web-app之後，否則無法正確修補 DSH 預設。 - 狀態 UI：狀態 UI 不在模型歷史中，查看狀態不會消耗上下文。
總結¶
dsh-epistemic-fold 通過分離“活躍上下文”與“歸檔歷史”，解決了長週期智能體上下文管理中的信息丟失問題。它將有損摘要降級爲輔助信息，通過精確的歸檔和檢索機制，保證了智能體行爲的可追溯性和狀態的一致性。
