billion-context-dsh

billion-context-dsh

中文 | English 🛑 本项目已停止维护 不再更新、不再修复问题，也不再受理新功能请求。同类需求请改用 ranxianglei/billion-context——它已经是官方统一版，原生支持 DeepSeek Harness（同一套实现同时覆盖 pi / OpenCode / Claude Code 等二十多个宿主）。 已发布的历史版本仍可安装使用，但不再提供支持。 ⚠️ 测试版声明——请勿用于生产环境 本项目（v0.2.27）仍处于开发中的测试版。DeepSeek Harness 本身也处于公开测试版阶段。请勿将两者用于工程化 / 生产环境——预期会有破坏性变更与粗糙之处。

衷心感谢以下项目——请给它们一个 ⭐： DeepSeek Harness · billion-context-pi · acp-kernel · opencode-acp

Billion-Context for DeepSeek Harness 由模型决定 何时 压缩、 压缩什么 ——而不是一个硬性上限。 npm install billion-context-dsh 为什么？

当对话变长，模型会耗尽上下文。多数工具直接硬截断——悄悄丢弃早期消息。billion-context-dsh 给模型一个 compress 工具：由 LLM 决定何时、压缩什么，写成高保真摘要，保留关键细节（文件路径、决策、错误信息）的同时回收上下文空间。

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

这是 billion-context-pi（Pi 编码代理适配器）在 DeepSeek Harness 上的移植：压缩内核（acp-kernel）原样复用，适配层针对 DSH 的 durable-surface 模型重写——经过验证的映射关系见 docs。 安装 💡 想让 DeepSeek Harness 帮你装？ 本仓库本身就运行在 DSH 上：把 docs/INSTALL.md 交给会话里的 agent，它会读取指南、解析 你的 profile、编辑组合配置并验证挂载。前提：① 配置写在 ~/.dsh 下，需要 你批准一次文件权限；② 装完让它调用 acp_status 自证。

方式一（推荐）：DSH 商店 / dsh plugin 一键装（bundle）——装完即全局生效，零配置。

在 DSH 的插件商店里点安装，或命令行执行：

命令内部会装包并把本包的 bundle 补丁（cordis.patch.yml）自动挂进该 profile 的层栈。补丁做了两件事： 禁用 host 的 compaction-basic——避免同一 realm 内两个后端同时注册 ctx.compaction 冲突（现代 DSH 的 web bundle 已自带该禁用，此行为幂等兜底，任何受支持版本下都成立）； 把 ACP 引擎挂到 host 平面——四种模型工具（compress / decompress / search_context / acp_status）、/acp-prune 命令、nudge、ACP 提示词段对该 profile 的所有模式（standard / code / minimal / cordis / 自定义预设）生效。窗口自动探测、工具/命令/nudge 默认全开，无需任何手工配置。

装完重启 dsh（bundle 层在启动时组合），新开会话即可用——让模型调用 acp_status 或执行 /acp-prune status 自证。shipped 预设（standard / code / cordis）内部的 realm 级 compaction-basic 自动压缩兜底仍然保留（这些模式里"自动摘要"照旧，ACP 工具与 nudge 并存）；minimal 等不带 compaction realm 的预设直接使用本引擎。 与 DSH 版本的兼容性。 包把五个运行期 seam 包（dsh-compaction / dsh-session / dsh-llm / dsh-tools / dsh-settings）都声明为 peer 依赖，共享同一个 范围 >=0.1.5-alpha.1 改名为 { op, startSeq, endSeq }，且校验严格（只接受这三个字段）；本引擎只 输出新形态，因此在更旧的 DSH（ 拒绝（issue #136）——旧版本不再受支持，请先升级 DSH 再安装本发行版。范围 写成显式区间而非 caret 是有意为之：上界 0.2.1-0 挡住未经验证的下一版本线 （house rule；原上界 0.1.6-0 在 #190 逐线验证后放宽）。0.2.0 线还改了两处读取形状——工具结果事件的调用 id 提升到消息级、宿主新增 developer/message 工具注册表行——引擎对整条范围按线读取，单一构建即可服务全区间（issue #192）。把这五个 seam 包一并声明为 peer（而不只是 dsh-compaction），是为了让 安装在 pnpm 的集成/封存布局下仍能把它们解析到宿主自己的副本，而不是 某个与宿主不一致的陈旧嵌套副本。 行为注记（0.1.5 起）：宿主不再允许"不可见"替换节点，引擎清理孤立工具消息时 会在其位置留下一条短可见占位消息；宿主的系统提示节点（surface node 0）被排除 在可压缩范围表之外。

方式二：纯 npm install（只装包，需要手写组合行）。