@lexwdex-org/opencode-dcp 3.4.11 → 3.4.13

package/README.en.md

@@ -4,7 +4,7 @@
 
 **English** | [中文](./README.md)
 
-DCP supplies a semantic-pruning policy to OpenCode's native compaction lifecycle. It no longer owns message markers, message IDs, compression blocks, anchors, placeholders, or a second summary state machine.
+DCP supplies a semantic-pruning policy and proactive triggers to OpenCode's native compaction lifecycle. It does not own message markers, message IDs, compression blocks, anchors, or placeholders.
 
 ## How it works
 
@@ -14,7 +14,27 @@ OpenCode owns one rolling checkpoint. After compaction, the model sees only:
 latest pruned checkpoint + uncompacted recent tail
 ```
 
-During `experimental.session.compacting`, DCP asks the summarizer to remove unrelated chat and other-project context, fold tool retries into the final successful result, fold repeated edits into the final state and valid decisions, and reduce small completed topics to short outcomes. Continuation-critical goals, constraints, decisions, implementation state, risks, and next steps remain.
+During `experimental.session.compacting`, DCP asks the summarizer to organize the checkpoint into a fixed three-tier structure:
+
+- `## 系统上下文` (System context) — system-level rules such as AGENTS.md, carried forward verbatim from the previous checkpoint;
+- `## 历史概要` (History digest) — early and middle history heavily compressed: one-line outcomes only, no process;
+- Recent tasks — lightly compressed: completed tasks summarized in one line each; in-progress tasks keep full detail (goal, finished steps, file paths, key decisions, blockers, next actions). Details related to the current task are preserved first so work can continue from the checkpoint alone.
+
+Unrelated chat, other-project context, tool retries, and repeated edits are folded away as before.
+
+## Trigger compaction
+
+- **OpenCode automatic compaction** uses the policy automatically.
+- **The `dcp_prune` model tool** — DCP registers an LLM-invokable tool whose description carries heuristic guidance: call it immediately when the topic clearly changes, when a task wraps up, or when the context has grown noticeably.
+- **Heuristic auto-prune** (`autoPrune`) — observes incoming user messages and triggers native compaction at turn boundaries (`session.idle`) on:
+    - topic drift: lexical similarity between the newest message and recent history drops sharply (CJK bigrams + Jaccard);
+    - message volume since the last prune crossing a threshold;
+    - resuming after a long idle gap.
+      Auto-triggers respect a cooldown; native `/compact` or host compaction also resets the counters.
+- OpenCode's native `/compact` command uses the same path.
+- `/dcp summarize` calls native `session.summarize()` manually.
+
+All entries share one coordinator: concurrent requests for the same session share a single native call. A failed call is fail-open and keeps the original context; retries are cooled down for 30 seconds by default.
 
 Pruned prefixes stop being sent to the model, but the original session history is not physically deleted from OpenCode's database. A later compaction replaces the previous checkpoint with one merged checkpoint instead of nesting summaries or building a compression-block graph.
 
@@ -24,14 +44,6 @@ Pruned prefixes stop being sent to the model, but the original session history i
 opencode plugin @lexwdex-org/opencode-dcp@latest --global
 ```
 
-## Trigger compaction
-
-- OpenCode automatic compaction uses the policy automatically.
-- OpenCode's native `/compact` command uses the same path.
-- `/dcp summarize` calls native `session.summarize()` for one-step semantic pruning.
-
-Concurrent requests for the same session share one native call. A failed call is fail-open and keeps the original context; retries are cooled down for 30 seconds by default.
-
 ## Configuration
 
 DCP loads global, custom-config-directory, then project configuration:
@@ -42,12 +54,33 @@ DCP loads global, custom-config-directory, then project configuration:
     "enabled": true,
     "autoUpdate": true,
     "debug": false,
+    "language": "zh",
     "commands": { "enabled": true },
     "experimental": { "customPrompts": false },
     "summarize": { "failureCooldownMs": 30000 },
+    "tool": { "enabled": true },
+    "autoPrune": {
+        "enabled": true,
+        "minMessages": 8,
+        "volumeThreshold": 30,
+        "driftThreshold": 0.18,
+        "idleGapMs": 1800000,
+        "cooldownMs": 300000,
+    },
 }
 ```
 
+| Key                         | Meaning                                                                                       |
+| --------------------------- | --------------------------------------------------------------------------------------------- |
+| `language`                  | Language of the bundled compaction prompt: `zh` (default) / `en`; custom overrides always win |
+| `tool.enabled`              | Register the model-invokable `dcp_prune` tool with heuristic usage guidance                   |
+| `autoPrune.enabled`         | Enable plugin-side heuristic auto-compaction                                                  |
+| `autoPrune.minMessages`     | Minimum user messages before any auto-prune signal is considered                              |
+| `autoPrune.volumeThreshold` | User messages since the last prune that trigger compaction by volume                          |
+| `autoPrune.driftThreshold`  | Jaccard similarity below which consecutive messages count as a topic change (0–1)             |
+| `autoPrune.idleGapMs`       | Gap between user messages that counts as resuming after a long break                          |
+| `autoPrune.cooldownMs`      | Minimum interval between two automatic prunes of the same session                             |
+
 When `experimental.customPrompts` is enabled, copy the generated
 `~/.config/opencode/dcp-prompts/defaults/compaction.md` to a project, custom-config, or global `dcp-prompts/overrides/compaction.md` path.
 
@@ -55,6 +88,6 @@ When `experimental.customPrompts` is enabled, copy the generated
 
 Legacy `compress`, `manualMode`, `strategies`, `turnProtection`, notification, protected-file, and command-protection settings are removed. DCP reports them as deprecated and ignores them.
 
-The old model tools, range/message compression, `/dcp compress`, decompression/recompression/sweep commands, message markers, nudges, and plugin compression persistence are gone. Existing legacy DCP state files are neither read nor modified; remove them manually only after deciding that you will not roll back.
+The old model tools, range/message compression, `/dcp compress`, decompression/recompression/sweep commands, message markers, and plugin compression persistence are gone. Existing legacy DCP state files are neither read nor modified; remove them manually only after deciding that you will not roll back.
 
 License: AGPL-3.0-or-later.

package/README.md

@@ -4,7 +4,7 @@
 
 [**English**](./README.en.md) | **中文**
 
-DCP 为 OpenCode 原生 compaction 提供语义剪枝策略。它不再维护消息标记、消息 ID、压缩块、锚点、占位符或第二套摘要状态机。
+DCP 为 OpenCode 原生 compaction 提供语义剪枝策略与主动触发机制。它不维护消息标记、消息 ID、压缩块、锚点或占位符。
 
 ## 工作原理
 
@@ -14,15 +14,27 @@ OpenCode 原生 compaction 负责生成和保存一个滚动检查点，并在
 最新剪枝检查点 + 尚未压缩的近期尾部
 ```
 
-DCP 只在 `experimental.session.compacting` 阶段提供专用提示词。提示词会：
+DCP 在 `experimental.session.compacting` 阶段提供专用提示词，把检查点组织为固定三段结构：
 
-- 删除无关闲聊、其他项目内容、重复解释和已推翻方案；
-- 把多次工具试错折叠为最终成功结果，必要时保留一次根因；
-- 把同一内容的重复修改折叠为最终状态和仍有效的决策；
-- 把小型已完成主题压缩为一句结果；
-- 保留继续工作需要的目标、约束、决策、实现状态、风险和下一步。
+- `## 系统上下文` — AGENTS.md、项目规则等系统级内容，从上一份检查点原样保留合并；
+- `## 历史概要` — 早期历史和中部历史高度压缩：每项主题只留一句结论，不含过程；
+- 最近任务 — 轻度压缩：已完成任务一句话概括；进行中任务保留完整详情（目标、已完成步骤、文件路径、关键决策、阻塞、下一步）。与当前任务相关的近期细节优先保留，保证凭检查点即可直接继续工作。
 
-压缩后的旧前缀不会再发送给模型，但 OpenCode 数据库中的原始会话历史不会被物理删除。下一次压缩会把旧检查点和新增尾部合并为一个新检查点，不会形成嵌套摘要或压缩块 DAG。
+## 触发压缩
+
+- **OpenCode 自动 compaction**：达到宿主阈值时自动运行。
+- **模型调用 `dcp_prune` 工具**：插件注册的 LLM 工具，描述内置启发式规则——话题明显变更、任务收尾、上下文明显变长时立即调用。
+- **插件启发式自动触发**（`autoPrune`）：监听用户消息流，在回合边界（`session.idle`）触发原生压缩：
+    - 话题变更：新消息与近期消息的词面相似度骤降（CJK 二元组 + Jaccard）；
+    - 消息量达到阈值；
+    - 长时间中断后恢复。
+      自动触发带冷却期；OpenCode 原生 `/compact` 或宿主压缩也会重置计数。
+- **OpenCode 原生 `/compact`**：手动触发同一条 compaction 路径。
+- **`/dcp summarize`**：手动调用原生 `session.summarize()`。
+
+所有入口都经过同一协调器：同一会话的并发请求合并为一次原生调用；失败不会提交半成品检查点，原始上下文保持可用，默认 30 秒内不重试失败的请求。
+
+压缩后的旧前缀不会再发送给模型，但 OpenCode 数据库中的原始会话历史不会被物理删除。下一次压缩会把旧检查点和新增尾部合并为一个新检查点，不会形成嵌套摘要。
 
 ## 安装
 
@@ -30,14 +42,6 @@ DCP 只在 `experimental.session.compacting` 阶段提供专用提示词。提
 opencode plugin @lexwdex-org/opencode-dcp@latest --global
 ```
 
-## 触发压缩
-
-- OpenCode 自动 compaction：达到宿主阈值时自动运行。
-- OpenCode 原生 `/compact`：手动触发同一条 compaction 路径。
-- `/dcp summarize`：调用原生 `session.summarize()`，一次完成语义摘要和真实上下文剪枝。
-
-同一会话的并发 `/dcp summarize` 会合并为一次原生调用。失败不会提交半成品检查点，原始上下文保持可用；默认 30 秒内不会重复调用失败的请求。
-
 ## 配置
 
 DCP 依次读取以下配置，后面的层覆盖前面的层：
@@ -52,6 +56,7 @@ DCP 依次读取以下配置，后面的层覆盖前面的层：
     "enabled": true,
     "autoUpdate": true,
     "debug": false,
+    "language": "zh",
     "commands": {
         "enabled": true,
     },
@@ -61,9 +66,31 @@ DCP 依次读取以下配置，后面的层覆盖前面的层：
     "summarize": {
         "failureCooldownMs": 30000,
     },
+    "tool": {
+        "enabled": true,
+    },
+    "autoPrune": {
+        "enabled": true,
+        "minMessages": 8,
+        "volumeThreshold": 30,
+        "driftThreshold": 0.18,
+        "idleGapMs": 1800000,
+        "cooldownMs": 300000,
+    },
 }
 ```
 
+| 键                          | 说明                                                                      |
+| --------------------------- | ------------------------------------------------------------------------- |
+| `language`                  | 内置压缩提示词语言：`zh`（默认）/ `en`；自定义覆盖文件优先于该配置        |
+| `tool.enabled`              | 注册模型可调用的 `dcp_prune` 工具（描述含"话题变更立即使用"的启发式指令） |
+| `autoPrune.enabled`         | 启用插件侧启发式自动压缩                                                  |
+| `autoPrune.minMessages`     | 会话用户消息数达到该值前不做任何自动判定                                  |
+| `autoPrune.volumeThreshold` | 距上次压缩的用户消息量阈值                                                |
+| `autoPrune.driftThreshold`  | Jaccard 相似度低于该值视为话题变更（0–1）                                 |
+| `autoPrune.idleGapMs`       | 用户消息间隔超过该值视为长时间中断后恢复                                  |
+| `autoPrune.cooldownMs`      | 同一会话两次自动压缩的最小间隔                                            |
+
 启用 `experimental.customPrompts` 后，可将生成的
 `~/.config/opencode/dcp-prompts/defaults/compaction.md` 复制到以下任一覆盖位置：
 
@@ -77,7 +104,7 @@ DCP 依次读取以下配置，后面的层覆盖前面的层：
 `pruneNotification`、`protectedFilePatterns` 及旧命令保护字段均已删除。DCP 会显示迁移警告并忽略这些字段，不会静默继续旧行为。
 
 以下功能已删除：`compress` / `compress_range` 模型工具、`/dcp compress`、
-`/dcp decompress`、`/dcp recompress`、`/dcp sweep`、消息标记、nudge 和插件压缩状态持久化。磁盘上已有的旧 DCP 会话状态文件不会被读取、改写或删除，可在确认不再回退旧版本后自行清理。
+`/dcp decompress`、`/dcp recompress`、`/dcp sweep`、消息标记和插件压缩状态持久化。磁盘上已有的旧 DCP 会话状态文件不会被读取、改写或删除，可在确认不再回退旧版本后自行清理。
 
 ## 开发验证
 

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAQjD,QAAA,MAAM,MAAM,EAAE,MA8BK,CAAA;AAEnB,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAejD,QAAA,MAAM,MAAM,EAAE,MAkDK,CAAA;AAEnB,eAAe,MAAM,CAAA"}