前言¶
在 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 通过分离“活跃上下文”与“归档历史”，解决了长周期智能体上下文管理中的信息丢失问题。它将有损摘要降级为辅助信息，通过精确的归档和检索机制，保证了智能体行为的可追溯性和状态的一致性。
