本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

billion-context-dsh

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add billion-context-dsh

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 模型驱动 —— 摘要由模型自己书写，没有第二次 LLM 摘要调用
• 只建议、不强令 —— 自动策略只 nudge（提醒），是否压缩、何时压缩由模型决定
• 持久且可恢复 —— 压缩范围成为 checkpoint 节点，原文保留在 append-only 会话日志中；decompress 可恢复，search_context 可在块内查找
• 长任务稳得住 —— 每一步都接着前面的成果走，关键结论持续可用、不断叠加，超长任务更容易跑完
• 上下文始终精简 —— 每次请求都只用少量、精炼的上下文，只保留关键信息；不做大段统一压缩，细节不随之衰失，token 消耗自然更低

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

和 DeepSeek Harness 自带的 dsh-compaction-basic 有什么区别？

内置的 basic 是自动摘要：上下文超过阈值就自动生成一段总结替换原始内容；billion-context-dsh 是模型驱动：模型看到一个"效率提示"后，由模型自己判断是否压缩、写哪段摘要。所有原文都保留在 append-only 会话日志里，可以随时 decompress 恢复、search_context 检索。

安装后需要禁用 dsh-compaction-basic 吗？

需要。同一 realm 内两个都 provide ctx.compaction 会冲突；在 profile 补丁里把 compaction-basic 行设为 disabled: true，或者直接删掉，再插入本插件的组合行。

压缩之后还能找回原始内容吗？

可以。decompress 工具按 acp_status 显示的 bN 编号恢复某个块的原文，search_context 在压缩块摘要和原文里做混合检索（词干化 + CJK bigram + 字符 n-gram）。原文一直留在 append-only 会话日志里，不丢失。

上下文窗口是怎么决定的？

默认开启自动探测：调用 agent.ctx.llm.resolveModelInfo 从 LLM 运行时读取模型真实窗口，失败则回退到 128000。可以显式写 modelContextLimit 覆盖探测；探测结果按 provider/model 路由缓存，探测失败也会缓存避免重复尝试。

这个插件是正式版吗？

不是。v0.2.9 是公开测试版，DeepSeek Harness 本身也是公开测试版；README 明确写了不要用于生产环境，预期会有破坏性变更。

怎么配置自定义的提示词文案？

通过 config.prompts 覆盖：nudge / rangeTable / tools / systemPrompt 四个分组，支持命名占位符（{pct} {philosophy} 等），模板占位符拼写错误会在引擎启动时直接抛错（fail-fast），不会漏出字面 {pct} 到模型上下文。

卸载方法是什么？

用 dsh plugin 命令卸载 bundle；bundle 安装时往 profile 插入了一行 id: compaction-acp，卸载会同步移除。如果当初是手写 profile 补丁，手动删除对应行即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则