English | 中文
DCP 在 OpenCode 发送模型请求之前，按当前模型预算折叠较旧的成功工具输出。修改只作用于请求副本；原始会话历史、工具调用和原生压缩流程仍由宿主管理。
- 从本次消息中的明确会话身份和最新用户消息的模型引用出发，通过宿主只读模型目录取得当前限额。缺少身份、模型或有效预算时保持原文。
- 估算消息正文、完整工具输入、输出及协议开销。输出预算预先扣除，默认的
targetRatio为稍后加入的系统提示和工具定义留出余量。 - 保护最近的完整工具执行步骤：默认至少 4 步、至少 16,000 个估算 tokens，两项同时满足。一次用户请求内的多次工具执行也能区分远近；同一步中的并行工具一起保护。
- 超过目标时，优先折叠重复的旧读取输出，再从旧到新选择其他有足够收益的成功工具输出。只设置宿主原生
state.time.compacted标记；宿主在模型请求中显示[Old tool result content cleared]，输入和调用身份仍完整存在。 - 在独立结果上完成计算，成功后提交请求副本；失败保持原文。
只处理已核实的 read、grep、glob，以及明确记录退出码 0 的 bash 输出。错误、未完成工具、未知工具、附件、技能/子任务结果及携带指令的读取输出（包括动态加载的指令）受到保护。直接读取 AGENTS.md、AGENTS.override.md、CLAUDE.md、CONTEXT.md 和 SKILL.md 也受保护，不依赖动态加载标记。用户可以增加受保护工具，但不能取消内置保护。
重复优先规则仅适用于 read、grep、glob：工具名、完整输入的 JSON 序列化结果和完整输出均相同，且后面还有未被清理的合格副本。同路径的不同分页、修改前后的不同结果均独立处理。重复清理阶段保留最新副本；如果仍超预算，后续有损折叠仍可能清理它。低于预算时不主动去重，单项收益门槛和近期保护始终有效。
用户消息、助手文本、推理及签名、工具输入和错误内容逐字保留。消息和 parts 的数量、顺序、身份及调用配对保持不变。没有话题猜测、机械摘要、输入缩减或工具调用合并。重复输出优先清理不会把多次调用改写成一次调用。
普通 @文件、@目录 和 @agent 引用的宿主标记不会阻止剪枝：引用展开后的文本照常计算，标记原样保留。已被宿主压缩的工具按清理后的输出估算，即使原始历史仍保存附件。实际仍会发送给模型的媒体或未知内容继续保留原文，不猜测其 token 数。
**折叠是有损的工具输出清理。**过去的输出细节会从本次模型请求中消失，仍可在原始会话中查阅。DCP 不承诺任意长对话都能装入窗口：近期步骤、长输入、受保护内容或系统提示本身可能过大，此时保留保护规则，由宿主原生压缩处理。
宿主可能根据上一轮真实用量，在下一次剪枝入口之前启动自动压缩。因此，窗口较小或系统提示、工具定义较大时，可能先发生原生摘要，DCP 尚未有可折叠的旧步骤。targetRatio 是历史预算比例，不是最终模型请求的硬上限；近期保护不会因窗口不足而自动降低。原生摘要成功后是否续跑、正在执行的工具如何结算，属于宿主执行契约。
压缩不控制 Agent 的执行状态机。 DCP 只处理宿主原本要发送的请求副本，不暂停或取消工具，不等待停工后压缩，不触发摘要或重新启动任务。投影失败时保留原文并返回原有流程。工具结算、原生摘要后的续跑和用户显式取消继续由宿主管理；宿主自身的执行缺陷仍需通过对应版本的运行验证排除。
模型可调用 dcp_prune，请求下一次普通模型请求主动折叠符合条件的历史输出。工具立即返回，同样遵守近期和内容保护；请求消费后不影响未来策略，不保存永久加深等级。可向助手提出“调用 dcp_prune 压缩旧工具输出”。
/compact 继续使用宿主原生行为。DCP 不触发 summarize、不写检查点、不替换摘要提示，也不改宿主 compaction 默认配置。宿主 compacting 钩子为随后同会话的 transform 设置一次跳过标志，确保摘要输入不被 DCP 改写。
在 OpenCode 配置中加入插件：
需要支持 V1 插件接口的 OpenCode，插件 peer 范围为 >=1.4.3 <2。类型兼容矩阵检查最低版和最新 V1 版本；运行时契约另有固定真实宿主版本验证，环境准备见开发。不带显式会话身份或模型信息的消息形状不会被猜测或压缩。
GraphAgent 1.0.39 的官方 macOS ARM64 制品在 Native LLM 模式下，自动压缩可能中断仍在运行的工具；DCP 开启和关闭时都可复现。该组合尚不支持需要可靠慢工具结算的任务。相同制品的 AI SDK 模式通过了本次慢工具与显式取消对照。固定开发源码通过测试不能替代已发布制品的运行证据，完整范围和复现入口见宿主验证。
下面就是内置默认值，无需创建配置文件：自动剪枝和重复优先策略默认启用，至少保留最近 4 个完整步骤且覆盖 16,000 估算 tokens，历史预算比例为 0.7，单项最低节省为 512。此组参数沿用已经验证的近期保护与收益门槛；重复优先不增加需要手动设置的开关。默认值、schema 和中英文示例由回归测试核对，已有有效用户配置仍按原有层级覆盖。
按以下顺序覆盖：全局 $XDG_CONFIG_HOME/opencode/dcp.jsonc（默认 ~/.config/opencode/dcp.jsonc）→ $OPENCODE_CONFIG_DIR/dcp.jsonc → 项目最近一级包含 DCP 配置文件的 .opencode 目录。同目录支持 .json，优先 .jsonc。没有 DCP 配置文件的目录会继续向上查找；找到后只使用最近一级，不再合并更上层的项目配置。插件不自动创建配置文件。
{
"$schema": "https://raw.githubusercontent.com/LeXwDeX/opencode-dynamic-context-pruning/master/dcp.schema.json",
"enabled": true,
"autoUpdate": true,
"debug": false,
"dtc": {
"enabled": true,
"protectRecentSteps": 4,
"protectRecentTokens": 16000,
"targetRatio": 0.7,
"minimumSavingsTokens": 512,
"protectedTools": [],
},
"tool": { "enabled": true },
}| 参数 | 含义 |
|---|---|
dtc.protectRecentSteps |
最近完整工具步骤的最少数量，整数且至少 1 |
dtc.protectRecentTokens |
扩展近期保护区直到满足的估算 token 数，非负整数 |
dtc.targetRatio |
消息历史占保守输入预算的比例，范围 (0, 1] |
dtc.minimumSavingsTokens |
单个输出值得折叠的最低估算节省量，正整数 |
dtc.protectedTools |
额外保护的工具名称 |
tool.enabled |
注册 dcp_prune；DTC 关闭时也不注册工具 |
autoUpdate |
仅提示新版本，不安装或修改插件 |
debug |
记录投影统计、跳过及安全熔断原因，不捕获会话正文 |
三个整数参数均不能超过 JavaScript 安全整数上限 9007199254740991；protectedTools 中每个名称必须包含非空白字符。无效 JSONC 整层忽略；类型错误或越界的字段保留上一层有效值并显示提示。所有状态仅存在于插件进程内，控制标志有容量上限。
投影统计中的 foldedTools 是全部折叠数量，redundantTools 是其中因后续存在相同完整读取结果而优先清理的数量。后者不代表所有重复调用都已合并，也不保证最后一份输出在后续预算清理中永久保留。
本版本修复了“先丢掉唯一结果，却保留重复结果”的清理顺序。连续修改合并需要完整版本快照；失败重试去噪需要保留根因与部分副作用；远处内容和已结束分支需要有来源的任务摘要。它们的实现依赖与验收已分别记录在 #61、#62、#63，尚未启用。设计评估见架构文档。
6.0 直接替换旧引擎，不提供旧策略开关：
- 删除 D/M/C 分区、话题漂移和机械摘要；没有摘要缓存，也不再通过时间戳推测会话。
- 删除结构合并与输入/错误/推理改写。
tailTurns、lowWatermarkRatio、driftThreshold、toolOutputKeepChars、mergeRuns不再生效。 - 删除
/dcp fold|status。V1 命令钩子没有正式取消协议，旧实现的异常拦截不再保留；commands.*退役。使用dcp_prune，运行诊断见 debug 日志。 - 手动折叠由永久等级改为下一次普通请求的一次性控制。
- 不再注入
compaction.tail_turns或preserve_recent_tokens。已有用户配置仍由宿主读取。 - 更早的
compress、summarize、autoPrune、manualMode、strategies、turnProtection、language、experimental仍仅给退役提示；不会迁移出话题阈值。
安装新版本后重启 OpenCode 以加载新钩子。历史会话无需迁移；DCP 从未将本版本的折叠结果写回历史。
使用 npm 和 Node.js 的 node:test：npm test、npm run typecheck、npm run format:check、npm run check:package。
真实宿主测试需要干净、隔离的 OpenCode 源码副本，固定到 scripts/test-host.mjs 指定的提交。按 .github/workflows/pr-checks.yml 安装 Bun 和宿主依赖，设置 OPENCODE_SOURCE_ROOT 指向该副本，然后执行 npm run test:host。
开发工具链使用 Node.js 26.8.1 和 npm 12.0.2；执行 npm ci --no-audit --no-fund 安装，再单独运行 npm audit --audit-level=high。版本升级、安装脚本许可和上游依赖约束见升级记录。
npm 通过 GitHub Actions trusted publishing 发布。普通分支提交不会发版；合并并审查版本变更后，推送与 package.json 一致的 v<version> 标签。手动运行发布工作流也必须选择该版本标签。发布前校验标签、格式、类型、测试、包内容和依赖审计；本地不重复执行 npm publish。
许可证：AGPL-3.0-or-later。
{ "plugin": ["@lexwdex-org/opencode-dcp@^6"], }