dsh-context-truth：为 DeepSeek Harness 回填真实上下文占用的 DSH plugin

它是做什么的？

Context Truth 是 DeepSeek Harness（DSH）的上下文占用回填插件，每轮把宿主实测的 token 用量写回给模型，并阻止「上下文快用尽了」这类错判被压缩摘要继承下去。它解决的是 DSH 从不把 token 用量告诉模型、模型只能靠会话长度瞎猜的问题——长会话里模型常在真实占用仅 17% 时就宣布见底、停止写操作。插件由 deepseekv41flash 维护，采用 MIT 协议，零依赖、零工具、零 UI、免构建。

核心功能

• 实测占用回填：每轮由宿主自己的 token meter 渲染一条动态 runtime-context，给出已用 / 窗口 / 自动压缩点 / 剩余余量，并声明该行是上下文压力的唯一权威，禁止模型凭会话长度估算。
• 四档语气分档：按自动压缩阈值的比例分为 ample、moderate、tight、critical 四档，带 5% 降档迟滞；ample 档会额外声明此前所有「上下文快满了」的说法（含压缩检查点里的）均已作废。
• 压缩指令补规则：通过公开的 llm/stream 瀑布在压缩摘要指令末尾追加两条规则，要求摘要绝不记录模型自己对剩余上下文的猜测、也不记录仅因上下文压力而停止或转交工作的计划，只改尾巴不动被缓存的前缀。
• 防误改兜底判据：以调用方打的 compaction 标记识别压缩调用，未打标记时要求末尾消息以指令开头，因此引用引擎源码、日志片段或 grep 命中的工具结果不会被误改。
• 数据全部取自宿主真实数字：已用量来自宿主对下一次请求的计价，窗口来自会话请求上下文，兜底读 provider 上报的 prompt 侧用量，与 Web UI 的上下文环同源。

怎么使用这个插件？

在 DSH 中启用后无需任何手动操作，两个能力默认全开：模型每轮自动收到一条实测占用行，压缩摘要调用也会自动被追加防错规则。文案语言可通过 language 配置在英文与中文之间切换，总开关 enabled 只关闭占用回填这一项。分档边界、显示台阶、自动压缩阈值、余量保留等参数都可在配置里调整，默认值与 dsh-compaction-basic 对齐；分档变化时还可选择写一条日志便于观察。由于 runtime-context 快照字节不变就不重发，读数按显示台阶量化，一个完整周期内文字大约变化五十余次，单条占用行约一百多 token。

报错怎么排查？

如果压缩摘要里仍然出现模型对自身上下文余量的猜测，先确认压缩调用是否带有 purpose 标记；部署未打标记时插件会退回「末尾消息以指令开头」的兜底判据，此时若摘要指令格式不同就可能漏判。若占用行显示为「under 50K」这类台阶值而非精确数字，属于按显示台阶量化的正常行为，调小 quantumPercent 可提高刷新频率。若读数与实际不符，检查兜底数据源是否可用，该投影与 Web UI 的上下文环同源，两者应保持一致。