@infituit/opencode-acp 2.0.0-alpha.1 → 2.0.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -437
- package/dist/auth.d.ts.map +1 -0
- package/dist/commands/compression-targets.d.ts.map +1 -0
- package/dist/commands/context.d.ts.map +1 -0
- package/dist/commands/export.d.ts.map +1 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/stats.d.ts.map +1 -0
- package/dist/compress/decompress-logic.d.ts.map +1 -0
- package/dist/compress/decompress.d.ts.map +1 -0
- package/dist/compress/hide-consumed.d.ts.map +1 -0
- package/dist/compress/hide-failed.d.ts.map +1 -0
- package/dist/compress/image-archive.d.ts.map +1 -0
- package/dist/compress/index.d.ts.map +1 -0
- package/dist/compress/keep-markers.d.ts.map +1 -0
- package/dist/compress/parts.d.ts.map +1 -0
- package/dist/compress/pipeline.d.ts.map +1 -0
- package/dist/compress/protected-content.d.ts.map +1 -0
- package/dist/compress/quality-gate/algorithms/index.d.ts.map +1 -0
- package/dist/compress/quality-gate/evaluate.d.ts.map +1 -0
- package/dist/compress/quality-gate/index.d.ts.map +1 -0
- package/dist/compress/quality-gate/registry.d.ts.map +1 -0
- package/dist/compress/quality-gate/rejection.d.ts.map +1 -0
- package/dist/compress/quality-gate/types.d.ts.map +1 -0
- package/dist/compress/range-utils.d.ts.map +1 -0
- package/dist/compress/range.d.ts.map +1 -0
- package/dist/compress/recap.d.ts.map +1 -0
- package/dist/compress/search.d.ts.map +1 -0
- package/dist/compress/smart-plan.d.ts.map +1 -0
- package/dist/compress/state.d.ts.map +1 -0
- package/dist/compress/status.d.ts.map +1 -0
- package/dist/compress/timing.d.ts.map +1 -0
- package/dist/compress/types.d.ts.map +1 -0
- package/dist/compress-permission.d.ts.map +1 -0
- package/dist/config-validation.d.ts.map +1 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/gc/merge.d.ts.map +1 -0
- package/dist/hooks.d.ts.map +1 -0
- package/dist/host-permissions.d.ts.map +1 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +89 -111
- package/dist/index.js.map +1 -1
- package/dist/logger.d.ts.map +1 -0
- package/dist/message-ids.d.ts.map +1 -0
- package/dist/messages/enforce-budget.d.ts.map +1 -0
- package/dist/messages/filter/apply.d.ts.map +1 -0
- package/dist/messages/filter/builtin/index.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-context.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-mode-injection.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-system-reminder.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-task-directive.d.ts.map +1 -0
- package/dist/messages/filter/builtin/omo-todo-continuation.d.ts.map +1 -0
- package/dist/messages/filter/index.d.ts.map +1 -0
- package/dist/messages/filter/registry.d.ts.map +1 -0
- package/dist/messages/filter/types.d.ts.map +1 -0
- package/dist/messages/index.d.ts.map +1 -0
- package/dist/messages/inject/candidates.d.ts.map +1 -0
- package/dist/messages/inject/inject.d.ts.map +1 -0
- package/dist/messages/inject/policy/index.d.ts.map +1 -0
- package/dist/messages/inject/policy/registry.d.ts.map +1 -0
- package/dist/messages/inject/policy/types.d.ts.map +1 -0
- package/dist/messages/inject/utils.d.ts.map +1 -0
- package/dist/messages/priority.d.ts.map +1 -0
- package/dist/messages/prune.d.ts.map +1 -0
- package/dist/messages/query.d.ts.map +1 -0
- package/dist/messages/reasoning-strip.d.ts.map +1 -0
- package/dist/messages/shape.d.ts.map +1 -0
- package/dist/messages/sticky-truncation.d.ts.map +1 -0
- package/dist/messages/sync.d.ts.map +1 -0
- package/dist/messages/truncate-tools.d.ts.map +1 -0
- package/dist/messages/utils.d.ts.map +1 -0
- package/dist/prompts/compress-range.d.ts.map +1 -0
- package/dist/prompts/context-limit-nudge.d.ts.map +1 -0
- package/dist/prompts/extensions/nudge.d.ts.map +1 -0
- package/dist/prompts/extensions/system.d.ts.map +1 -0
- package/dist/prompts/extensions/tool.d.ts.map +1 -0
- package/dist/prompts/index.d.ts.map +1 -0
- package/dist/prompts/iteration-nudge.d.ts.map +1 -0
- package/dist/prompts/store.d.ts.map +1 -0
- package/dist/prompts/system.d.ts.map +1 -0
- package/dist/prompts/turn-nudge.d.ts.map +1 -0
- package/dist/protected-patterns.d.ts.map +1 -0
- package/dist/state/index.d.ts.map +1 -0
- package/dist/state/message-types.d.ts.map +1 -0
- package/dist/state/model-limits.d.ts.map +1 -0
- package/dist/state/persistence.d.ts.map +1 -0
- package/dist/state/rebuild.d.ts.map +1 -0
- package/dist/state/state.d.ts.map +1 -0
- package/dist/state/tool-cache.d.ts.map +1 -0
- package/dist/state/types.d.ts.map +1 -0
- package/dist/state/utils.d.ts.map +1 -0
- package/dist/token-utils.d.ts.map +1 -0
- package/dist/ui/notification.d.ts.map +1 -0
- package/dist/ui/utils.d.ts.map +1 -0
- package/dist/update.d.ts.map +1 -0
- package/dist/v2/messages.d.ts.map +1 -0
- package/dist/v2/plugin.d.ts.map +1 -0
- package/package.json +1 -1
- package/dist/lib/auth.d.ts.map +0 -1
- package/dist/lib/bili-proxy.d.ts +0 -64
- package/dist/lib/bili-proxy.d.ts.map +0 -1
- package/dist/lib/commands/compression-targets.d.ts.map +0 -1
- package/dist/lib/commands/context.d.ts.map +0 -1
- package/dist/lib/commands/export.d.ts.map +0 -1
- package/dist/lib/commands/index.d.ts.map +0 -1
- package/dist/lib/commands/stats.d.ts.map +0 -1
- package/dist/lib/compress/decompress-logic.d.ts.map +0 -1
- package/dist/lib/compress/decompress.d.ts.map +0 -1
- package/dist/lib/compress/hide-consumed.d.ts.map +0 -1
- package/dist/lib/compress/hide-failed.d.ts.map +0 -1
- package/dist/lib/compress/image-archive.d.ts.map +0 -1
- package/dist/lib/compress/index.d.ts.map +0 -1
- package/dist/lib/compress/keep-markers.d.ts.map +0 -1
- package/dist/lib/compress/parts.d.ts.map +0 -1
- package/dist/lib/compress/pipeline.d.ts.map +0 -1
- package/dist/lib/compress/protected-content.d.ts.map +0 -1
- package/dist/lib/compress/quality-gate/algorithms/index.d.ts.map +0 -1
- package/dist/lib/compress/quality-gate/evaluate.d.ts.map +0 -1
- package/dist/lib/compress/quality-gate/index.d.ts.map +0 -1
- package/dist/lib/compress/quality-gate/registry.d.ts.map +0 -1
- package/dist/lib/compress/quality-gate/rejection.d.ts.map +0 -1
- package/dist/lib/compress/quality-gate/types.d.ts.map +0 -1
- package/dist/lib/compress/range-utils.d.ts.map +0 -1
- package/dist/lib/compress/range.d.ts.map +0 -1
- package/dist/lib/compress/recap.d.ts.map +0 -1
- package/dist/lib/compress/search.d.ts.map +0 -1
- package/dist/lib/compress/smart-plan.d.ts.map +0 -1
- package/dist/lib/compress/state.d.ts.map +0 -1
- package/dist/lib/compress/status.d.ts.map +0 -1
- package/dist/lib/compress/timing.d.ts.map +0 -1
- package/dist/lib/compress/types.d.ts.map +0 -1
- package/dist/lib/compress-permission.d.ts.map +0 -1
- package/dist/lib/config-validation.d.ts.map +0 -1
- package/dist/lib/config.d.ts.map +0 -1
- package/dist/lib/gc/merge.d.ts.map +0 -1
- package/dist/lib/hooks.d.ts.map +0 -1
- package/dist/lib/host-permissions.d.ts.map +0 -1
- package/dist/lib/logger.d.ts.map +0 -1
- package/dist/lib/message-ids.d.ts.map +0 -1
- package/dist/lib/messages/enforce-budget.d.ts.map +0 -1
- package/dist/lib/messages/filter/apply.d.ts.map +0 -1
- package/dist/lib/messages/filter/builtin/index.d.ts.map +0 -1
- package/dist/lib/messages/filter/builtin/omo-context.d.ts.map +0 -1
- package/dist/lib/messages/filter/builtin/omo-mode-injection.d.ts.map +0 -1
- package/dist/lib/messages/filter/builtin/omo-system-reminder.d.ts.map +0 -1
- package/dist/lib/messages/filter/builtin/omo-task-directive.d.ts.map +0 -1
- package/dist/lib/messages/filter/builtin/omo-todo-continuation.d.ts.map +0 -1
- package/dist/lib/messages/filter/index.d.ts.map +0 -1
- package/dist/lib/messages/filter/registry.d.ts.map +0 -1
- package/dist/lib/messages/filter/types.d.ts.map +0 -1
- package/dist/lib/messages/index.d.ts.map +0 -1
- package/dist/lib/messages/inject/candidates.d.ts.map +0 -1
- package/dist/lib/messages/inject/inject.d.ts.map +0 -1
- package/dist/lib/messages/inject/policy/index.d.ts.map +0 -1
- package/dist/lib/messages/inject/policy/registry.d.ts.map +0 -1
- package/dist/lib/messages/inject/policy/types.d.ts.map +0 -1
- package/dist/lib/messages/inject/utils.d.ts.map +0 -1
- package/dist/lib/messages/priority.d.ts.map +0 -1
- package/dist/lib/messages/prune.d.ts.map +0 -1
- package/dist/lib/messages/query.d.ts.map +0 -1
- package/dist/lib/messages/reasoning-strip.d.ts.map +0 -1
- package/dist/lib/messages/shape.d.ts.map +0 -1
- package/dist/lib/messages/sticky-truncation.d.ts.map +0 -1
- package/dist/lib/messages/sync.d.ts.map +0 -1
- package/dist/lib/messages/truncate-tools.d.ts.map +0 -1
- package/dist/lib/messages/utils.d.ts.map +0 -1
- package/dist/lib/prompts/compress-range.d.ts.map +0 -1
- package/dist/lib/prompts/context-limit-nudge.d.ts.map +0 -1
- package/dist/lib/prompts/extensions/nudge.d.ts.map +0 -1
- package/dist/lib/prompts/extensions/system.d.ts.map +0 -1
- package/dist/lib/prompts/extensions/tool.d.ts.map +0 -1
- package/dist/lib/prompts/index.d.ts.map +0 -1
- package/dist/lib/prompts/iteration-nudge.d.ts.map +0 -1
- package/dist/lib/prompts/store.d.ts.map +0 -1
- package/dist/lib/prompts/system.d.ts.map +0 -1
- package/dist/lib/prompts/turn-nudge.d.ts.map +0 -1
- package/dist/lib/protected-patterns.d.ts.map +0 -1
- package/dist/lib/state/index.d.ts.map +0 -1
- package/dist/lib/state/message-types.d.ts.map +0 -1
- package/dist/lib/state/model-limits.d.ts.map +0 -1
- package/dist/lib/state/persistence.d.ts.map +0 -1
- package/dist/lib/state/rebuild.d.ts.map +0 -1
- package/dist/lib/state/state.d.ts.map +0 -1
- package/dist/lib/state/tool-cache.d.ts.map +0 -1
- package/dist/lib/state/types.d.ts.map +0 -1
- package/dist/lib/state/utils.d.ts.map +0 -1
- package/dist/lib/token-utils.d.ts.map +0 -1
- package/dist/lib/ui/notification.d.ts.map +0 -1
- package/dist/lib/ui/utils.d.ts.map +0 -1
- package/dist/lib/update.d.ts.map +0 -1
- package/dist/lib/v2/messages.d.ts.map +0 -1
- package/dist/lib/v2/plugin.d.ts.map +0 -1
- /package/dist/{lib/auth.d.ts → auth.d.ts} +0 -0
- /package/dist/{lib/commands → commands}/compression-targets.d.ts +0 -0
- /package/dist/{lib/commands → commands}/context.d.ts +0 -0
- /package/dist/{lib/commands → commands}/export.d.ts +0 -0
- /package/dist/{lib/commands → commands}/index.d.ts +0 -0
- /package/dist/{lib/commands → commands}/stats.d.ts +0 -0
- /package/dist/{lib/compress → compress}/decompress-logic.d.ts +0 -0
- /package/dist/{lib/compress → compress}/decompress.d.ts +0 -0
- /package/dist/{lib/compress → compress}/hide-consumed.d.ts +0 -0
- /package/dist/{lib/compress → compress}/hide-failed.d.ts +0 -0
- /package/dist/{lib/compress → compress}/image-archive.d.ts +0 -0
- /package/dist/{lib/compress → compress}/index.d.ts +0 -0
- /package/dist/{lib/compress → compress}/keep-markers.d.ts +0 -0
- /package/dist/{lib/compress → compress}/parts.d.ts +0 -0
- /package/dist/{lib/compress → compress}/pipeline.d.ts +0 -0
- /package/dist/{lib/compress → compress}/protected-content.d.ts +0 -0
- /package/dist/{lib/compress → compress}/quality-gate/algorithms/index.d.ts +0 -0
- /package/dist/{lib/compress → compress}/quality-gate/evaluate.d.ts +0 -0
- /package/dist/{lib/compress → compress}/quality-gate/index.d.ts +0 -0
- /package/dist/{lib/compress → compress}/quality-gate/registry.d.ts +0 -0
- /package/dist/{lib/compress → compress}/quality-gate/rejection.d.ts +0 -0
- /package/dist/{lib/compress → compress}/quality-gate/types.d.ts +0 -0
- /package/dist/{lib/compress → compress}/range-utils.d.ts +0 -0
- /package/dist/{lib/compress → compress}/range.d.ts +0 -0
- /package/dist/{lib/compress → compress}/recap.d.ts +0 -0
- /package/dist/{lib/compress → compress}/search.d.ts +0 -0
- /package/dist/{lib/compress → compress}/smart-plan.d.ts +0 -0
- /package/dist/{lib/compress → compress}/state.d.ts +0 -0
- /package/dist/{lib/compress → compress}/status.d.ts +0 -0
- /package/dist/{lib/compress → compress}/timing.d.ts +0 -0
- /package/dist/{lib/compress → compress}/types.d.ts +0 -0
- /package/dist/{lib/compress-permission.d.ts → compress-permission.d.ts} +0 -0
- /package/dist/{lib/config-validation.d.ts → config-validation.d.ts} +0 -0
- /package/dist/{lib/config.d.ts → config.d.ts} +0 -0
- /package/dist/{lib/gc → gc}/merge.d.ts +0 -0
- /package/dist/{lib/hooks.d.ts → hooks.d.ts} +0 -0
- /package/dist/{lib/host-permissions.d.ts → host-permissions.d.ts} +0 -0
- /package/dist/{lib/logger.d.ts → logger.d.ts} +0 -0
- /package/dist/{lib/message-ids.d.ts → message-ids.d.ts} +0 -0
- /package/dist/{lib/messages → messages}/enforce-budget.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/apply.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/builtin/index.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/builtin/omo-context.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/builtin/omo-mode-injection.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/builtin/omo-system-reminder.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/builtin/omo-task-directive.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/builtin/omo-todo-continuation.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/index.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/registry.d.ts +0 -0
- /package/dist/{lib/messages → messages}/filter/types.d.ts +0 -0
- /package/dist/{lib/messages → messages}/index.d.ts +0 -0
- /package/dist/{lib/messages → messages}/inject/candidates.d.ts +0 -0
- /package/dist/{lib/messages → messages}/inject/inject.d.ts +0 -0
- /package/dist/{lib/messages → messages}/inject/policy/index.d.ts +0 -0
- /package/dist/{lib/messages → messages}/inject/policy/registry.d.ts +0 -0
- /package/dist/{lib/messages → messages}/inject/policy/types.d.ts +0 -0
- /package/dist/{lib/messages → messages}/inject/utils.d.ts +0 -0
- /package/dist/{lib/messages → messages}/priority.d.ts +0 -0
- /package/dist/{lib/messages → messages}/prune.d.ts +0 -0
- /package/dist/{lib/messages → messages}/query.d.ts +0 -0
- /package/dist/{lib/messages → messages}/reasoning-strip.d.ts +0 -0
- /package/dist/{lib/messages → messages}/shape.d.ts +0 -0
- /package/dist/{lib/messages → messages}/sticky-truncation.d.ts +0 -0
- /package/dist/{lib/messages → messages}/sync.d.ts +0 -0
- /package/dist/{lib/messages → messages}/truncate-tools.d.ts +0 -0
- /package/dist/{lib/messages → messages}/utils.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/compress-range.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/context-limit-nudge.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/extensions/nudge.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/extensions/system.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/extensions/tool.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/index.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/iteration-nudge.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/store.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/system.d.ts +0 -0
- /package/dist/{lib/prompts → prompts}/turn-nudge.d.ts +0 -0
- /package/dist/{lib/protected-patterns.d.ts → protected-patterns.d.ts} +0 -0
- /package/dist/{lib/state → state}/index.d.ts +0 -0
- /package/dist/{lib/state → state}/message-types.d.ts +0 -0
- /package/dist/{lib/state → state}/model-limits.d.ts +0 -0
- /package/dist/{lib/state → state}/persistence.d.ts +0 -0
- /package/dist/{lib/state → state}/rebuild.d.ts +0 -0
- /package/dist/{lib/state → state}/state.d.ts +0 -0
- /package/dist/{lib/state → state}/tool-cache.d.ts +0 -0
- /package/dist/{lib/state → state}/types.d.ts +0 -0
- /package/dist/{lib/state → state}/utils.d.ts +0 -0
- /package/dist/{lib/token-utils.d.ts → token-utils.d.ts} +0 -0
- /package/dist/{lib/ui → ui}/notification.d.ts +0 -0
- /package/dist/{lib/ui → ui}/utils.d.ts +0 -0
- /package/dist/{lib/update.d.ts → update.d.ts} +0 -0
- /package/dist/{lib/v2 → v2}/messages.d.ts +0 -0
- /package/dist/{lib/v2 → v2}/plugin.d.ts +0 -0
package/README.md
CHANGED
|
@@ -1,438 +1,119 @@
|
|
|
1
|
-
|
|
1
|
+
# Active Context Pruning
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
<strong>Active Context Pruning</strong> — <a href="https://opencode.ai">OpenCode</a> 的主动上下文剪枝插件
|
|
5
|
-
<br />
|
|
6
|
-
由模型决定<em>何时</em>压缩、压缩<em>什么</em> — 而非硬性截断。
|
|
7
|
-
<br />
|
|
8
|
-
<strong>20 万 token 足矣。</strong>
|
|
9
|
-
</p>
|
|
3
|
+
ACP 是 [OpenCode](https://opencode.ai) 的上下文管理插件。它向模型提供压缩、恢复、搜索摘要和查看上下文用量的工具,用摘要替换暂时不需要的历史内容。
|
|
10
4
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
## 社区
|
|
14
|
-
|
|
15
|
-
QQ群:
|
|
16
|
-
1056132097(已满)
|
|
17
|
-
1108730198(未满)
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
> **ACP 2.0 要求 OpenCode >=2.1.4 且 <3。** 本版本使用 V2 插件 API,不支持 OpenCode 1.x。本版本仅通过 GitHub 分发,未发布到 npm;`opencode-acp@stable` 和 `@latest` 不会安装本次发布的版本。
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
|
-
## 📄 论文 / 预印本
|
|
26
|
-
|
|
27
|
-
- **[模型驱动的分层增量压缩:面向长寿命编码 Agent 的免训练多代上下文管理](./paper/模型驱动的分层增量压缩-免训练多代上下文管理.md)**(中文版,v0.2)
|
|
28
|
-
|
|
29
|
-
> 📝 **论文本身与代码一同以 MIT 许可开源(位于 `paper/` 目录),是代码库的一部分 —— 这是一份活文档,任何人都可以编辑,欢迎提 PR 改进。**
|
|
30
|
-
|
|
31
|
-
生产规模纵向研究:四个半月、三宿主、174,327 次模型调用、187.6 亿累计输入 token(三宿主合计约 247 亿),204,800-token 窗口零违规,马拉松会话 8,584–12,049 次调用。
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
<p align="center">
|
|
36
|
-
<a href="https://github.com/infituit/opencode-acp/releases"><img src="https://img.shields.io/github/v/release/infituit/opencode-acp?style=flat-square" alt="GitHub release"></a>
|
|
37
|
-
<a href="https://github.com/infituit/opencode-acp/blob/master/LICENSE"><img src="https://img.shields.io/github/license/infituit/opencode-acp?style=flat-square" alt="license"></a>
|
|
38
|
-
<a href="https://github.com/infituit/opencode-acp"><img src="https://img.shields.io/badge/GitHub-infituit%2Fopencode--acp-181717?style=flat-square&logo=github" alt="GitHub"></a>
|
|
39
|
-
</p>
|
|
40
|
-
|
|
41
|
-
<p align="center">
|
|
42
|
-
<code>opencode plugin add github:infituit/opencode-acp#v2.0.0-alpha.1</code>
|
|
43
|
-
</p>
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
47
|
-
## 为什么选择 ACP
|
|
48
|
-
|
|
49
|
-
ACP 将上下文管理的所有权限交给模型自己,不需要额外模型或外部上下文管理服务。压缩、恢复和上下文统计都集中在同一个 OpenCode 插件中。
|
|
50
|
-
|
|
51
|
-
这带来两个影响:
|
|
52
|
-
|
|
53
|
-
- **20 万 token 足矣。** 在 50 个真实工程会话、3 万余次 API 调用中,**97% 的请求低于 20 万 token** —— p90 约 15 万,p95 约 18 万。每次 API 调用都会对完整上下文重新计费,因此上下文越低越省钱 —— 即使缓存命中率达 90%+,未缓存部分仍按全价计费。
|
|
54
|
-
- **超长上下文不丢关键内容** —— 实测单会话 **3,300+ 条消息、3 亿+ 累计 token**;架构上支持单会话 **10 万条消息**(5 位消息 ID 空间)。
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
## 实战验证
|
|
59
|
-
|
|
60
|
-
真实工程中的上下文情况。
|
|
61
|
-
|
|
62
|
-
**在 6 个活跃工程会话(11,000+ 次 API 调用)中,上下文 p90 稳定在 15 万–19 万(15–19%),p95 在 16 万–21 万(16–21%)—— 聚合缓存命中率达 91%。** 缓存指标的含义见[对 Prompt 缓存的影响](#对-prompt-缓存的影响)。
|
|
63
|
-
|
|
64
|
-
| 会话 | 时长 | 消息数 | API 调用 | 累计 token | 缓存命中率 | 上下文 p50 | 上下文 p90 | 上下文 p95 |
|
|
65
|
-
| --------- | ----------- | ------ | -------- | ---------- | ---------- | ----------- | ----------- | ----------- |
|
|
66
|
-
| 0b89319b | 230h (9.5d) | 3,344 | 2,796 | 3.39 亿 | 93% | 10.8万(11%) | 16.7万(17%) | 21.0万(21%) |
|
|
67
|
-
| 0a3be0cd | 130h (5.4d) | 3,183 | 2,499 | 2.76 亿 | 91% | 10.4万(10%) | 14.5万(15%) | 15.3万(15%) |
|
|
68
|
-
| 0b2cd5a7 | 131h (5.4d) | 2,560 | 2,181 | 3.14 亿 | 91% | 14.2万(14%) | 19.1万(19%) | 19.7万(20%) |
|
|
69
|
-
| 08f2d501 | 37h (1.5d) | 1,985 | 1,888 | 1.96 亿 | 95% | 10.0万(10%) | 15.6万(16%) | 16.8万(17%) |
|
|
70
|
-
| 1410c791† | 865h (36d) | 1,279 | 1,100 | 2.18 亿 | 87% | 13.2万(13%) | 40.7万(41%) | 42.7万(43%) |
|
|
71
|
-
| 096cf8c4 | 72h (3d) | 1,041 | 918 | 0.91 亿 | 89% | 9.2万(9%) | 14.8万(15%) | 16.1万(16%) |
|
|
72
|
-
|
|
73
|
-
† Bug 测试会话,p95 异常偏高。排除该会话后,其余会话 p95 均 ≤ 21 万。
|
|
74
|
-
|
|
75
|
-
(上下文百分比均以 1M 窗口计。)
|
|
76
|
-
|
|
77
|
-
---
|
|
5
|
+
> **ACP 2.0 要求 OpenCode >=2.1.4 且 <3。** 本版本使用 V2 插件 API,不支持 OpenCode 1.x。通过 GitHub Release 和 npm 包 `@infituit/opencode-acp` 分发;无 scope 的 `opencode-acp` 不是本项目发布的包。
|
|
78
6
|
|
|
79
7
|
## 安装
|
|
80
8
|
|
|
81
|
-
需要 OpenCode **>=2.1.4 且 <3
|
|
82
|
-
通过 GitHub release tag 全局安装:
|
|
9
|
+
需要 OpenCode **>=2.1.4 且 <3**。通过 npm 包全局安装(已包含预构建代码,无需从 Git 构建):
|
|
83
10
|
|
|
84
11
|
```bash
|
|
85
|
-
opencode plugin add
|
|
12
|
+
opencode plugin add @infituit/opencode-acp@2.0.0-beta.1
|
|
86
13
|
```
|
|
87
14
|
|
|
88
|
-
|
|
15
|
+
也可使用 `opencode plugin add @infituit/opencode-acp@beta` 跟随 Beta 渠道,或者在 `opencode.json(c)` 中添加固定版本:
|
|
89
16
|
|
|
90
17
|
```json
|
|
91
18
|
{
|
|
92
19
|
"$schema": "https://opencode.ai/config.json",
|
|
93
|
-
"plugins": ["
|
|
20
|
+
"plugins": ["@infituit/opencode-acp@2.0.0-beta.1"]
|
|
94
21
|
}
|
|
95
22
|
```
|
|
96
23
|
|
|
97
|
-
移除已有的 npm 或本地 ACP 插件项,避免重复加载。修改配置后执行 `/reload
|
|
98
|
-
GitHub 自动生成的源码归档不含 `dist/`。
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## 工作原理
|
|
103
|
-
|
|
104
|
-
ACP 把上下文压缩工具直接交给模型。模型对上下文压缩**负全责**。模型的主要工具是 **compress** 和 **decompress**,辅以 **acp_status**(上下文监控)和 **search_context**(搜索已压缩内容)。压缩采用**三级 LSM-tree 架构**(T1 捕获 → T2 蒸馏 → T3 浓缩),使上下文在数年内保持有界。当上下文达到 100% 时,系统自动触发 GC 截断作为兜底。
|
|
105
|
-
|
|
106
|
-
### 生命周期 — 三级压缩
|
|
107
|
-
|
|
108
|
-
ACP 采用**三级 LSM-tree 压缩架构**,灵感来自数据库存储引擎。每一级压缩上一级的输出,产生逐渐精炼的摘要,频率自然递减:
|
|
109
|
-
|
|
110
|
-
```mermaid
|
|
111
|
-
stateDiagram-v2
|
|
112
|
-
Raw --> Tier1 : compress(约每 7 轮)
|
|
113
|
-
Tier1 --> Tier2 : distill(约每 250 轮)
|
|
114
|
-
Tier2 --> Tier3 : condense(约每 2500 轮)
|
|
115
|
-
Tier1 --> Raw : decompress
|
|
116
|
-
Tier2 --> Raw : decompress(递归)
|
|
117
|
-
Tier3 --> Raw : decompress(递归)
|
|
118
|
-
Tier1 --> GC_Truncated : GC(100% 上下文)
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
| 层级 | 名称 | 输入 | 输出 | 压缩比 | 触发时机 |
|
|
122
|
-
| ------ | ---- | -------------------------------- | --------------------- | ------ | ---------------------------- |
|
|
123
|
-
| **T1** | 捕获 | 原始对话 | 详细摘要 | ~45× | 上下文超过 `maxContextLimit` |
|
|
124
|
-
| **T2** | 蒸馏 | T1 摘要(≥ `nudgeGrowthTokens`) | 精炼的决策/结果 | ~10× | T1 摘要累积超过阈值 |
|
|
125
|
-
| **T3** | 浓缩 | T2 摘要(≥ `nudgeGrowthTokens`) | 纯事实(每块 1-3 条) | ~5× | T2 摘要累积超过阈值 |
|
|
126
|
-
|
|
127
|
-
**触发机制:**
|
|
24
|
+
移除已有的 npm、Git 或本地 ACP 插件项,避免重复加载。修改配置后执行 `/reload`,新建会话并运行 `/acp` 确认插件可用。
|
|
25
|
+
GitHub Release 仍保留预构建 tarball;Git tag 安装会从源码执行 `prepare` 构建,需要 Git 和 Node.js/npm。GitHub 自动生成的源码归档不含 `dist/`。
|
|
128
26
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
| 1M | 19 亿 tok | 105 亿 tok | **689 亿 tok** | 第 259 天(~8.6 月) |
|
|
142
|
-
| 400K | 19 亿 tok | 103 亿 tok | **103 亿 tok** | 第 89 天(~3 月) |
|
|
143
|
-
| 400K(200 调用/天) | 5.6 亿 tok | 25 亿 tok | **95 亿 tok** | 第 212 天(~7 月) |
|
|
144
|
-
|
|
145
|
-
**Token 节省** — 无 ACP 时上下文无限增长,约 100 次 API 调用后崩溃(~0.2 天)。有 ACP 时上下文被压缩在有界范围:
|
|
146
|
-
|
|
147
|
-
| 指标 | 无 ACP | 有 ACP(1M 模型) |
|
|
148
|
-
| ------------- | -------- | ------------------------ |
|
|
149
|
-
| 会话寿命 | ~0.2 天 | 259 天(**长 1295 倍**) |
|
|
150
|
-
| 总 token 产出 | ~5200 万 | 689 亿(**多 1325 倍**) |
|
|
151
|
-
|
|
152
|
-
核心价值:ACP 不是减少每次调用的 token 成本,而是**让一个会话能处理 1000 倍以上的工作量**。
|
|
153
|
-
|
|
154
|
-
模型对所有层级使用**同一个 `compress` 工具**。T2/T3 压缩使用块 ID 作为边界(`compress({ content: [{ startId: "b5", endId: "b20", summary: "..." }] })`)。层级根据被消费的块自动检测。
|
|
155
|
-
|
|
156
|
-
### 压缩策略(一级压缩 / Tier 1)
|
|
157
|
-
|
|
158
|
-
系统会注入一段 prompt,告诉模型当前的上下文比例、压缩比例、上下文是否空闲,以及压缩建议。当触发比例被命中时,内容按**优先级顺序**被压缩:
|
|
159
|
-
|
|
160
|
-
1. Agent/子代理的评审与咨询结果(最大一块未压缩内容)
|
|
161
|
-
2. 冗长的命令输出(构建/测试运行、git diff/log/status、目录列表)
|
|
162
|
-
3. 无结果的探索(失败的方法、死胡同式的搜索)
|
|
163
|
-
4. 冗余的工具结果(反复读同一个文件、重复的状态检查)
|
|
164
|
-
5. 已完成多步任务的中间步骤
|
|
165
|
-
6. 已尘埃落定的讨论(一旦决策被记录)
|
|
166
|
-
7. 已经用过的大段文件内容
|
|
167
|
-
|
|
168
|
-
压缩完成后,原始内容被一个简短的 **block** 替换,该 block 引用原始内容(可通过 `decompress` 恢复)。
|
|
27
|
+
> [!IMPORTANT]
|
|
28
|
+
> **禁用 OpenCode 的内置自动压缩。** ACP 自行处理上下文管理,两者同时运行可能导致消息重新展开、压缩状态丢失。请在 `opencode.json` 中添加:
|
|
29
|
+
>
|
|
30
|
+
> ```jsonc
|
|
31
|
+
> {
|
|
32
|
+
> "compaction": {
|
|
33
|
+
> "auto": false,
|
|
34
|
+
> },
|
|
35
|
+
> }
|
|
36
|
+
> ```
|
|
37
|
+
>
|
|
38
|
+
> 或设置环境变量:`OPENCODE_DISABLE_AUTOCOMPACT=1`
|
|
169
39
|
|
|
170
|
-
|
|
40
|
+
## 命令
|
|
171
41
|
|
|
172
|
-
|
|
42
|
+
ACP 提供 `/acp` 斜杠命令:
|
|
173
43
|
|
|
174
|
-
|
|
44
|
+
| 命令 | 说明 |
|
|
45
|
+
| -------------- | -------------------------------------------------------------------------------------------------- |
|
|
46
|
+
| `/acp` | 显示压缩状态(同 `/acp stats`);`/acp help` 查看命令列表 |
|
|
47
|
+
| `/acp context` | 按类别(system、user、assistant、tools 等)显示 token 用量明细,以及通过剪枝节省的量 |
|
|
48
|
+
| `/acp stats` | 压缩状态:压缩块、上下文用量、推荐范围(与 `acp_status` 工具同一报告) |
|
|
49
|
+
| `/acp export` | 导出活动压缩块到 markdown 文件。选项:`--output <path>`、`--tier t1,t2,t3`、`--stdout`、`--append` |
|
|
175
50
|
|
|
176
|
-
|
|
51
|
+
## 工作原理
|
|
177
52
|
|
|
178
|
-
|
|
53
|
+
ACP 根据上下文用量和配置向模型注入压缩提示,由模型选择范围并编写摘要。主要工具包括:
|
|
179
54
|
|
|
180
|
-
|
|
55
|
+
- `acp_compress`:将选定范围替换为摘要。
|
|
56
|
+
- `acp_decompress`:按需恢复压缩范围的原始内容。
|
|
57
|
+
- `acp_status`:查看上下文用量、压缩块和可压缩范围。
|
|
58
|
+
- `acp_search_context`:在活动压缩块的摘要中搜索,帮助定位需要恢复的内容。
|
|
181
59
|
|
|
182
|
-
|
|
60
|
+
### 分层压缩
|
|
183
61
|
|
|
184
|
-
|
|
185
|
-
- **L2(内容覆盖)**:只在通过 L1 的块上运行。当 **同时** ROUGE-1 F1 < 0.05 **且** top-20 关键词召回 < 0.20 时触发(AND 合并使误报率维持在 ~6.6%)。
|
|
62
|
+
摘要可以再次压缩,分为三个层级:
|
|
186
63
|
|
|
187
|
-
|
|
64
|
+
| 层级 | 名称 | 输入 | 输出 |
|
|
65
|
+
| ---- | ---- | -------- | ---------------- |
|
|
66
|
+
| T1 | 捕获 | 原始对话 | 保留细节的摘要 |
|
|
67
|
+
| T2 | 蒸馏 | T1 摘要 | 决策和结果 |
|
|
68
|
+
| T3 | 浓缩 | T2 摘要 | 进一步精简的事实 |
|
|
188
69
|
|
|
189
|
-
|
|
70
|
+
各层使用同一个 `acp_compress` 工具。原始消息使用 `mNNNNN` 引用,压缩块使用 `bN` 引用,层级根据被消费的块检测。例如:
|
|
190
71
|
|
|
191
|
-
```
|
|
192
|
-
{
|
|
193
|
-
"qualityGate": {
|
|
194
|
-
"enabled": true,
|
|
195
|
-
"algorithm": "rouge-recall-v1",
|
|
196
|
-
},
|
|
197
|
-
}
|
|
72
|
+
```text
|
|
73
|
+
acp_compress({ content: [{ startId: "b5", endId: "b20", summary: "..." }] })
|
|
198
74
|
```
|
|
199
75
|
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
## 对 Prompt 缓存的影响
|
|
203
|
-
|
|
204
|
-
ACP 修复了大量低缓存命中率问题。目前整体缓存命中率约为 **91%**。
|
|
205
|
-
|
|
206
|
-
ACP 保持对话前缀只追加,同时用紧凑 block 替换已压缩范围。这样可以保留服务商可复用的前缀,并将总上下文大部分时间维持在 **~10–15%**(以 1M 窗口计,p50 10 万、p90 15 万)。
|
|
207
|
-
|
|
208
|
-
**结论:** ACP 保持上下文有界、保留可复用前缀,并支持按需恢复已压缩内容。
|
|
209
|
-
|
|
210
|
-
---
|
|
76
|
+
压缩时机受上下文阈值、摘要增长量和提醒频率等配置影响,不是固定每若干轮执行一次。压缩提示优先建议处理冗长工具输出、重复探索、已完成任务的中间步骤和不再需要的历史内容。
|
|
211
77
|
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
ACP 提供 `/acp` 斜杠命令:
|
|
78
|
+
### 限制
|
|
215
79
|
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
| `/acp context` | 按类别(system、user、assistant、tools 等)显示 token 用量明细,以及通过剪枝节省的量 |
|
|
220
|
-
| `/acp stats` | 压缩状态:压缩块、上下文用量、推荐范围(与 `acp_status` 工具同一报告) |
|
|
221
|
-
| `/acp export` | 导出活动压缩块到 markdown 文件。选项:`--output <path>`、`--tier t1,t2,t3`、`--stdout`、`--append` |
|
|
222
|
-
|
|
223
|
-
---
|
|
80
|
+
- 摘要由模型生成,可能遗漏信息。需要原始细节时,应搜索摘要并按需解压;不要把压缩当作无损存档。
|
|
81
|
+
- GC 截断是上下文管理的兜底机制,不能替代正常压缩。
|
|
82
|
+
- 压缩比、缓存命中率和可持续会话长度取决于模型、服务商、配置及任务内容,不保证固定数值或无限会话寿命。
|
|
224
83
|
|
|
225
84
|
## 配置
|
|
226
85
|
|
|
227
|
-
ACP
|
|
86
|
+
ACP 使用自己的配置文件,按以下顺序加载:
|
|
228
87
|
|
|
229
|
-
1. **全局:** `~/.config/opencode/acp.jsonc`(或 `acp.json
|
|
230
|
-
2. **自定义配置目录:** `$OPENCODE_CONFIG_DIR/acp.jsonc`(或 `acp.json`),当设置了 `OPENCODE_CONFIG_DIR`
|
|
231
|
-
3. **项目级:** 项目 `.opencode` 目录下的 `.opencode/acp.jsonc`(或 `acp.json
|
|
88
|
+
1. **全局:** `~/.config/opencode/acp.jsonc`(或 `acp.json`),首次运行时自动创建;设置 `XDG_CONFIG_HOME` 时使用其下的 `opencode` 目录。
|
|
89
|
+
2. **自定义配置目录:** `$OPENCODE_CONFIG_DIR/acp.jsonc`(或 `acp.json`),当设置了 `OPENCODE_CONFIG_DIR` 时。
|
|
90
|
+
3. **项目级:** 项目 `.opencode` 目录下的 `.opencode/acp.jsonc`(或 `acp.json`)。
|
|
232
91
|
|
|
233
|
-
|
|
92
|
+
每一层覆盖前一层,因此项目设置优先于全局设置。修改 ACP 配置后请重启 OpenCode。
|
|
234
93
|
|
|
235
|
-
|
|
94
|
+
完整字段结构见 [`acp.schema.json`](./acp.schema.json),默认值见 [`src/config.ts`](./src/config.ts) 中的 `defaultConfig`。不需要在配置文件中复制所有默认值,只填写需要覆盖的字段。
|
|
236
95
|
|
|
237
|
-
|
|
238
|
-
> **禁用 OpenCode 的内置自动压缩。** ACP 自行处理上下文管理 — OpenCode 的压缩与 ACP 冲突,可能导致问题(消息重新展开、压缩状态丢失)。请在 `opencode.json` 中添加:
|
|
239
|
-
>
|
|
240
|
-
> ```jsonc
|
|
241
|
-
> {
|
|
242
|
-
> "compaction": {
|
|
243
|
-
> "auto": false,
|
|
244
|
-
> },
|
|
245
|
-
> }
|
|
246
|
-
> ```
|
|
247
|
-
>
|
|
248
|
-
> 或设置环境变量:`OPENCODE_DISABLE_AUTOCOMPACT=1`
|
|
249
|
-
|
|
250
|
-
> [!NOTE]
|
|
251
|
-
> 如果你使用上下文窗口较小的模型(如 GitHub Copilot 模型或本地模型),请在配置中降低 `compress.minContextLimit` 和 `compress.maxContextLimit` 以匹配可用上下文。
|
|
96
|
+
### 配置示例
|
|
252
97
|
|
|
253
|
-
|
|
254
|
-
<summary><strong>默认配置</strong>(点击展开)</summary>
|
|
98
|
+
以下示例设置日志级别、上下文提醒阈值和工具保护,不是完整配置:
|
|
255
99
|
|
|
256
100
|
```jsonc
|
|
257
101
|
{
|
|
258
102
|
"$schema": "https://raw.githubusercontent.com/infituit/opencode-acp/master/acp.schema.json",
|
|
259
|
-
// Enable or disable the plugin
|
|
260
|
-
"enabled": true,
|
|
261
|
-
// 自动更新 npm 安装的 ACP:跟踪安装所用 dist-tag/规范(@stable 跟随 stable,@latest 跟随 latest)。
|
|
262
|
-
// 版本锁定的规范不会被更新。
|
|
263
|
-
"autoUpdate": true,
|
|
264
|
-
// 文件日志级别: "debug" | "info" | "warn" | "error" | "silent"
|
|
265
|
-
// 默认 "info":决策级事件(压缩提示、转换摘要、更新检查)落盘到
|
|
266
|
-
// ~/.config/opencode/logs/acp/daily/<日期>.log
|
|
267
103
|
"logLevel": "info",
|
|
268
|
-
// 启用完整 DEBUG 日志 + 按请求快照(优先于 logLevel)
|
|
269
|
-
"debug": false,
|
|
270
|
-
// Notification display: "off", "minimal", or "detailed"
|
|
271
|
-
"pruneNotification": "detailed",
|
|
272
|
-
// Notification type: "chat" (deprecated, falls back to toast) or "toast" (system toast)
|
|
273
|
-
"pruneNotificationType": "toast",
|
|
274
|
-
// Slash commands configuration
|
|
275
|
-
"commands": {
|
|
276
|
-
"enabled": true,
|
|
277
|
-
// Additional tools to protect from pruning via commands
|
|
278
|
-
"protectedTools": [],
|
|
279
|
-
},
|
|
280
|
-
// Manual mode: disables autonomous context management,
|
|
281
|
-
// tools only run when explicitly triggered via /acp commands
|
|
282
|
-
// 允许在子代理会话中运行 ACP(默认:开启)
|
|
283
|
-
"allowSubAgents": true,
|
|
284
|
-
// Experimental settings
|
|
285
|
-
"experimental": {
|
|
286
|
-
// Enable user-editable prompt overrides under acp-prompts directories
|
|
287
|
-
// When false (default), prompt override files/directories are ignored
|
|
288
|
-
"customPrompts": false,
|
|
289
|
-
},
|
|
290
|
-
// Protect file operations from pruning via glob patterns
|
|
291
|
-
// Patterns match tool parameters.filePath (e.g. read/write/edit)
|
|
292
|
-
"protectedFilePatterns": [],
|
|
293
|
-
// Unified context compression tool and behavior settings
|
|
294
104
|
"compress": {
|
|
295
|
-
|
|
296
|
-
// or experimental "message" (compress individual raw messages)
|
|
297
|
-
// Permission mode: "allow" (no prompt), "ask" (prompt), "deny" (tool not registered)
|
|
298
|
-
"permission": "allow",
|
|
299
|
-
// Show compression content in a chat notification
|
|
300
|
-
"showCompression": true,
|
|
301
|
-
// Let active summary tokens extend the effective maxContextLimit
|
|
302
|
-
"summaryBuffer": true,
|
|
303
|
-
// Soft upper threshold: above this, ACP keeps injecting strong
|
|
304
|
-
// compression nudges (based on nudgeFrequency), so compression is
|
|
305
|
-
// much more likely. Accepts: number or "X%" of model context window.
|
|
306
|
-
"maxContextLimit": "55%",
|
|
307
|
-
// Soft lower threshold for reminder nudges: below this, turn/iteration
|
|
308
|
-
// reminders are off (compression less likely). At/above this, reminders
|
|
309
|
-
// are on. Accepts: number or "X%" of model context window.
|
|
310
|
-
"minContextLimit": "45%",
|
|
311
|
-
// Optional per-model override for maxContextLimit by providerID/modelID.
|
|
312
|
-
// If present, this wins over the global maxContextLimit.
|
|
313
|
-
// Accepts: number or "X%".
|
|
314
|
-
// Example:
|
|
315
|
-
// "modelMaxLimits": {
|
|
316
|
-
// "openai/gpt-5.3-codex": 120000,
|
|
317
|
-
// "anthropic/claude-sonnet-4.6": "80%"
|
|
318
|
-
// },
|
|
319
|
-
// Optional per-model override for minContextLimit.
|
|
320
|
-
// 已废弃 —— 将随 minContextLimit 一并移除;
|
|
321
|
-
// 请改用 compress.providers(增长型提醒用
|
|
322
|
-
// minNudgeContextPercent)。移除前仍然生效。
|
|
323
|
-
// If present, this wins over the global minContextLimit.
|
|
324
|
-
// "modelMinLimits": {
|
|
325
|
-
// "openai/gpt-5.3-codex": 50000,
|
|
326
|
-
// "anthropic/claude-sonnet-4.6": "25%"
|
|
327
|
-
// },
|
|
328
|
-
// 嵌套的 provider/model 级覆盖:可覆盖任意 compress 字段
|
|
329
|
-
// (23 项:阈值、nudge 行为、保护策略等)。
|
|
330
|
-
// 逐字段解析优先级:model > provider > 全局。
|
|
331
|
-
// 未知的 provider/model ID 回退到全局值。
|
|
332
|
-
// "providers": {
|
|
333
|
-
// "anthropic": {
|
|
334
|
-
// "nudgeGrowthTokens": 50000,
|
|
335
|
-
// "models": {
|
|
336
|
-
// "claude-sonnet-4.6": {
|
|
337
|
-
// "maxContextLimit": "70%",
|
|
338
|
-
// "minNudgeContextPercent": 10
|
|
339
|
-
// }
|
|
340
|
-
// }
|
|
341
|
-
// }
|
|
342
|
-
// },
|
|
343
|
-
// How often the context-limit nudge fires (1 = every fetch, 5 = every 5th)
|
|
105
|
+
"maxContextLimit": "80%",
|
|
344
106
|
"nudgeFrequency": 5,
|
|
345
|
-
|
|
346
|
-
// messages have happened since the last user message
|
|
347
|
-
"iterationNudgeThreshold": 15,
|
|
348
|
-
// Controls how likely compression is after user messages
|
|
349
|
-
// ("strong" = more likely, "soft" = less likely)
|
|
350
|
-
"nudgeForce": "soft",
|
|
351
|
-
// Hard-excluded tool names. The root default is ["skill", "compress"]; an explicit
|
|
352
|
-
// array replaces the inherited policy. Use [] to compress all tool outputs.
|
|
353
|
-
// "compress" is always force-protected regardless of this setting — its summary
|
|
354
|
-
// parameter is the sole record of compressed conversation and cannot be recovered
|
|
355
|
-
// if lost. Use [] to compress all tool outputs except compress itself.
|
|
356
|
-
"protectedTools": ["skill", "compress"],
|
|
357
|
-
// Preserve text wrapped in <protect>...</protect> when compressed
|
|
358
|
-
"protectTags": false,
|
|
359
|
-
// Preserve your messages during compression.
|
|
360
|
-
// Warning: large copy-pasted prompts will never be compressed away
|
|
361
|
-
"protectUserMessages": false,
|
|
362
|
-
// [#368] 请求时丢弃历史 compress 工具调用中超大的 reasoning(思考)。
|
|
363
|
-
// compress 调用被硬排除在压缩之外,其思考内容会随每次请求原样重发,
|
|
364
|
-
// 形成无法回收的上下文底座。仅作用于已关闭的轮次,活跃轮永不触碰;
|
|
365
|
-
// 低于阈值的小思考保留。
|
|
366
|
-
"reasoning": {
|
|
367
|
-
"drop": true,
|
|
368
|
-
"threshold": 2048,
|
|
369
|
-
},
|
|
370
|
-
// [#478] 图片归档:图片(data-URL)进入会话时即落盘,折叠后摘要里保留
|
|
371
|
-
// 可重读的路径指针,而不是把像素悄悄丢掉。文件落在
|
|
372
|
-
// <storageDir>/images/<dirName(sessionId)>/(权限 0600);覆盖它们的折叠块
|
|
373
|
-
// 摘要末尾追加绝对路径,模型用自己的文件工具重新读取即可。
|
|
374
|
-
// 不参与按模型的覆盖级联。
|
|
375
|
-
"images": {
|
|
376
|
-
"enabled": true,
|
|
377
|
-
"minBytes": 16384,
|
|
378
|
-
"ttlDays": 7,
|
|
379
|
-
},
|
|
380
|
-
},
|
|
381
|
-
// 垃圾回收与批量清理
|
|
382
|
-
"gc": {
|
|
383
|
-
"algorithm": "truncate",
|
|
384
|
-
// 存活此次数后从新生代晋升为老年代
|
|
385
|
-
"promotionThreshold": 5,
|
|
386
|
-
// 存活此次数后停用该块
|
|
387
|
-
"maxBlockAge": 15,
|
|
388
|
-
// 截断超过此长度(字符)的老年代摘要
|
|
389
|
-
"maxOldGenSummaryLength": 3000,
|
|
390
|
-
// 上下文使用率超过此值时执行主 GC(兜底,硬编码为 100%)
|
|
391
|
-
"majorGcThresholdPercent": "100%",
|
|
392
|
-
},
|
|
393
|
-
// 压缩后质量门控(非阻塞;默认关闭)
|
|
394
|
-
"qualityGate": {
|
|
395
|
-
// 主开关。false 时不执行任何评估
|
|
396
|
-
"enabled": false,
|
|
397
|
-
// 算法名。可拔插——未来算法(包括外部 API 评审)可以注册而无需改 pipeline
|
|
398
|
-
"algorithm": "rouge-recall-v1",
|
|
399
|
-
// 各算法的独立配置
|
|
400
|
-
"algorithms": {
|
|
401
|
-
"rouge-recall-v1": {
|
|
402
|
-
// 摘要长度硬下限(字符)。低于此值 → L1 失败
|
|
403
|
-
"layer1MinChars": 200,
|
|
404
|
-
// 最小留存率 = summaryLen / (compressedTokens*4) * 100
|
|
405
|
-
// 捕获灾难性留存失败(<1%),0% 误报
|
|
406
|
-
"layer1MinRetentionPct": 1.0,
|
|
407
|
-
// 当 ROUGE-1 F1 低于此值时(与 top20Recall 经 AND 合并)L2 失败
|
|
408
|
-
"layer2MaxRougeF1": 0.05,
|
|
409
|
-
// 当 top-20 关键词召回低于此值时(与 rougeF1 经 AND 合并)L2 失败
|
|
410
|
-
"layer2MaxTop20Recall": 0.2,
|
|
411
|
-
},
|
|
412
|
-
},
|
|
413
|
-
},
|
|
414
|
-
// 消息过滤器——在 ACP 处理之前,从可见上下文中剥离/去重第三方插件注入
|
|
415
|
-
// (例如 oh-my-opencode 的 system reminder)。被过滤的内容不计入上下文使用量。
|
|
416
|
-
// 5 个内置 OMO 过滤器默认开启(v1.14.8+);
|
|
417
|
-
// 完整的 messageFilters 结构见 acp.schema.json。
|
|
418
|
-
"messageFilters": {
|
|
419
|
-
"enabled": true,
|
|
420
|
-
"filters": {
|
|
421
|
-
"omo-system-reminder": { "enabled": true },
|
|
422
|
-
"omo-context": { "enabled": true },
|
|
423
|
-
"omo-task-directive": { "enabled": true },
|
|
424
|
-
"omo-todo-continuation": { "enabled": true },
|
|
425
|
-
"omo-mode-injection": { "enabled": true },
|
|
426
|
-
},
|
|
107
|
+
"protectedTools": ["skill", "acp_compress"],
|
|
427
108
|
},
|
|
428
109
|
}
|
|
429
110
|
```
|
|
430
111
|
|
|
431
|
-
|
|
112
|
+
上下文阈值接受 token 数或模型上下文窗口的百分比。`maxContextLimit` 是触发压缩提示的软阈值,不是硬性截断上限;达到阈值不代表模型一定立即执行压缩。根据模型的可用上下文调整阈值。
|
|
432
113
|
|
|
433
114
|
### 按 Provider / 按模型覆盖
|
|
434
115
|
|
|
435
|
-
|
|
116
|
+
支持的 `compress` 字段可通过嵌套的 `compress.providers` 按 provider 和按模型覆盖:
|
|
436
117
|
|
|
437
118
|
```jsonc
|
|
438
119
|
{
|
|
@@ -453,10 +134,42 @@ ACP 使用自己的配置文件,按以下顺序搜索:
|
|
|
453
134
|
|
|
454
135
|
解析为**逐字段**优先级:model > provider > 全局。未知的 provider/model ID 回退到全局值。嵌套的 `maxContextLimit` 同时优先于旧版扁平 `modelMaxLimits` 映射。多层配置(全局 → 配置目录 → 项目)按 provider/model 键深合并。
|
|
455
136
|
|
|
456
|
-
不可覆盖:`permission`、已废弃的 `minContextLimit` / `modelMinLimits` 系列、以及扁平 `modelMaxLimits` / `modelMinLimits`
|
|
137
|
+
不可覆盖:`permission`、已废弃的 `minContextLimit` / `modelMinLimits` 系列、以及扁平 `modelMaxLimits` / `modelMinLimits` 映射自身。`modelMaxLimits` 仍受支持,只是优先级低于嵌套的 `maxContextLimit`。
|
|
457
138
|
|
|
458
139
|
完整的 `compress.providers` 字段结构见 [`acp.schema.json`](./acp.schema.json)。
|
|
459
140
|
|
|
141
|
+
### 受保护工具
|
|
142
|
+
|
|
143
|
+
默认情况下,以下工具受命令剪枝保护:
|
|
144
|
+
`task`、`skill`、`todowrite`、`todoread`、`acp_compress`、`decompress`、`batch`、`plan_enter`、`plan_exit`、`write`、`edit`。
|
|
145
|
+
|
|
146
|
+
`commands.protectedTools` 数组会添加到此默认列表。
|
|
147
|
+
|
|
148
|
+
`compress.protectedTools` 则控制模型压缩时的工具输出保护:当压缩范围包含这些工具的消息时,其内容完整保留在可见上下文中,只有周围的非受保护消息被压缩。
|
|
149
|
+
|
|
150
|
+
- 默认值为 `["skill", "acp_compress"]`,显式数组替换继承的策略。
|
|
151
|
+
- `"acp_compress"` 始终被强制保护,因为工具调用的 `summary` 参数承载已压缩对话的记录。
|
|
152
|
+
- 设置 `[]` 仅保留对 `acp_compress` 的强制保护;设置 `["task"]` 保护 `task` 和 `acp_compress`。
|
|
153
|
+
|
|
154
|
+
### 质量门控
|
|
155
|
+
|
|
156
|
+
质量门控默认关闭,使用 `rouge-recall-v1` 算法检查摘要长度、留存比例和词汇覆盖。启用方式:
|
|
157
|
+
|
|
158
|
+
```jsonc
|
|
159
|
+
{
|
|
160
|
+
"qualityGate": {
|
|
161
|
+
"enabled": true,
|
|
162
|
+
"algorithm": "rouge-recall-v1",
|
|
163
|
+
},
|
|
164
|
+
}
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
启用后,范围压缩会在提交前检查摘要;未通过时拒绝本次压缩并返回原因。应补充摘要中的关键细节后重试。提交后的检查失败会记录警告,不回滚已完成的压缩。质量指标不能保证摘要在语义上完整或正确。
|
|
168
|
+
|
|
169
|
+
### 日志
|
|
170
|
+
|
|
171
|
+
`logLevel` 支持 `debug`、`info`、`warn`、`error` 和 `silent`,默认值为 `info`。`debug: true` 会覆盖日志级别并启用完整调试日志及按请求快照。
|
|
172
|
+
|
|
460
173
|
### Prompt 覆盖
|
|
461
174
|
|
|
462
175
|
ACP 暴露六个可编辑的 prompt:
|
|
@@ -472,67 +185,20 @@ ACP 暴露六个可编辑的 prompt:
|
|
|
472
185
|
|
|
473
186
|
启用后,托管的默认值会作为纯文本 prompt 文件写入 `~/.config/opencode/acp-prompts/defaults/`。该目录中的 `README.md` 解释了每个 prompt 以及如何创建覆盖。
|
|
474
187
|
|
|
475
|
-
|
|
188
|
+
要自定义行为,在覆盖目录下添加同名文件并作为纯文本编辑。要重置覆盖,从覆盖目录中删除对应文件。
|
|
476
189
|
|
|
477
|
-
|
|
190
|
+
## 更新日志
|
|
478
191
|
|
|
479
|
-
|
|
192
|
+
版本历史见 [`support-files/changelog/zh/`](./support-files/changelog/zh/)。
|
|
480
193
|
|
|
481
|
-
|
|
482
|
-
`task`、`skill`、`todowrite`、`todoread`、`compress`、`decompress`、`batch`、`plan_enter`、`plan_exit`、`write`、`edit`
|
|
483
|
-
|
|
484
|
-
`commands` 中的 `protectedTools` 数组会添加到此默认列表。
|
|
485
|
-
|
|
486
|
-
对于 `compress` 工具,`compress.protectedTools` 确保特定工具的输出被**硬排除**在压缩范围之外(v1.10.0+)。当模型压缩包含受保护工具消息的范围时,该消息完整保留在可见上下文中 — 只有周围的非受保护消息被压缩。根默认值为 `["skill", "compress"]`(`compress` 条目保护携带 summary 的 compress 工具调用,防止被后续顺序压缩吞噬);显式数组会替换继承的策略。**`"compress"` 无论用户如何配置都会被强制保护** — 其 `summary` 参数是已压缩对话的唯一记录,一旦丢失无法恢复。设置 `[]` 仅保护 `compress`;设置 `["task"]` 保护 `task` 和 `compress`。
|
|
487
|
-
|
|
488
|
-
---
|
|
489
|
-
|
|
490
|
-
<details>
|
|
491
|
-
<summary><strong>错误修复(共 39 项)</strong></summary>
|
|
492
|
-
|
|
493
|
-
| # | 严重程度 | 摘要 |
|
|
494
|
-
| ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
495
|
-
| 1 | 严重 | 状态在重启后未持久化 — messageIds、块停用、保存错误均静默丢失 |
|
|
496
|
-
| 2 | 严重 | resetOnCompaction() 清除所有压缩块 — 撤销所有剪枝工作 |
|
|
497
|
-
| 3 | 严重 | prune 静默丢弃摘要 — 当锚点前无用户消息时导致数据丢失 |
|
|
498
|
-
| 4 | 严重 | getCurrentTokenUsage 返回 0 — 导致 nudge 永远无法触发 |
|
|
499
|
-
| 5 | 高 | loadPruneMessagesState 重复 activeBlockIds + reasoning-strip 未定义保护缺失 |
|
|
500
|
-
| 6 | 高 | 合成摘要消息获得 mNNNN 引用但对边界查找不可见 |
|
|
501
|
-
| 7 | 高 | 状态在重启后未持久化 — messageIds、块停用和保存错误均静默丢失 |
|
|
502
|
-
| 8 | 高 | isMessageCompacted() 与压缩摘要消息处理不一致 |
|
|
503
|
-
| 9 | 高 | 已压缩的块摘要保留过时的 mNNNN 消息 ID 标签 — 模型复制过时 ID |
|
|
504
|
-
| 10 | 高 | 模型使用 nudge/摘要中的过时 mNNNN ID — compress 因 "startId not available" 失败 |
|
|
505
|
-
| 11 | 高 | 主 GC 跳过没有 generation 字段的旧块 — 过大的块永远不会被回收 |
|
|
506
|
-
| 12 | 高 | 基于百分比的阈值基于有效输入上下文而非完整模型上下文窗口计算 |
|
|
507
|
-
| 13 | 高 | 上下文窗口泄漏 — 压缩后的消息在 /compact 后重新出现 |
|
|
508
|
-
| 14 | 高 | 压缩通知将完整块摘要写入数据库 — 每条通知可达 150KB+ |
|
|
509
|
-
| 15 | 高 | npm 自动安装用上游包覆盖分支 |
|
|
510
|
-
| 16 | 高 | compress 输出中的摘要 mNNNN 引用 — 模型复制过时的消息 ID |
|
|
511
|
-
| 17 | 高 | 合成消息不在 messageIdToBlockId 中 — compress 无法找到它们 |
|
|
512
|
-
| 18 | 高 | compress 在压缩完成后阻止模型响应 |
|
|
513
|
-
| 19 | 高 | 动态块引导破坏 API 前缀缓存 |
|
|
514
|
-
| 20 | 高 | GC 从不停用旧块 — 死重无限累积 |
|
|
515
|
-
| 21 | 高 | Logger + tokenizer 每轮延迟 20-50 秒(268 倍减速) |
|
|
516
|
-
| 22 | 高 | compress 在块边界反转时抛出硬错误 — 模型放弃 |
|
|
517
|
-
| 23--34 | 中 | 去重、错误清除、schema 验证、hook 时序等方面的多项修复 |
|
|
518
|
-
| 35 | 高 | 在低上下文使用率(<50%)时显示老化警告 — 触发不必要的 compress,浪费 token |
|
|
519
|
-
| 36 | 高 | 压缩摘要作为独立的 user 消息插入在用户真实发言之前 — 模型把自己先前的 assistant 输出误读为用户输入,导致对话角色混乱 / 自问自答循环 |
|
|
520
|
-
| 37 | 高 | 消息转换管线对 OpenCode 隐藏的 title/summary/compaction agent 请求也运行 — 污染请求并破坏共享会话状态,导致会话标题生成失效 |
|
|
521
|
-
| 38 | 严重 | pruneToolOutputs/pruneToolInputs/pruneToolErrors 原地修改现有消息 — 破坏 LLM 前缀缓存,导致 89% 的新鲜输入 token 浪费在缓存失效的重发上 |
|
|
522
|
-
| 39 | 高 | 受保护工具输出(skill/task/todowrite)在压缩时仅软保护 — 追加到摘要后从上下文中剪枝,丧失语义权威且易被 GC 截断。v1.10.0 用硬排除修复 |
|
|
523
|
-
|
|
524
|
-
完整列表及根因分析,请参见 [Bug Tracker](https://github.com/infituit/opencode-acp/issues)。
|
|
525
|
-
|
|
526
|
-
</details>
|
|
527
|
-
|
|
528
|
-
---
|
|
194
|
+
## 项目来源与维护
|
|
529
195
|
|
|
530
|
-
|
|
196
|
+
本项目 fork 自 [ranxianglei/opencode-acp](https://github.com/ranxianglei/opencode-acp),其最早来源为 [Tarquinen/opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning)。
|
|
531
197
|
|
|
532
|
-
|
|
198
|
+
自 v2 起,本项目由 infituit 相关成员独立维护,进行系统性重构,并将插件迁移至 OpenCode V2 API,不再兼容 OpenCode 1.x。
|
|
533
199
|
|
|
534
|
-
|
|
200
|
+
**维护原则:不继承历史债务。** 不会为了维持历史兼容性而保留已知问题或延续不合理设计;必要时接受不兼容变更。
|
|
535
201
|
|
|
536
202
|
## 许可证
|
|
537
203
|
|
|
538
|
-
AGPL-3.0-or-later
|
|
204
|
+
本项目采用 AGPL-3.0-or-later 许可证,见 [LICENSE](./LICENSE)。历史作者及第三方组件的版权和许可声明予以保留,见 [LICENSE](./LICENSE) 和 [NOTICE](./NOTICE)。
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAQ3D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAsBpD"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compression-targets.d.ts","sourceRoot":"","sources":["../../src/commands/compression-targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAEpE,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AA8DD,wBAAgB,2BAA2B,CACvC,aAAa,EAAE,kBAAkB,GAClC,iBAAiB,EAAE,CAMrB;AAED,wBAAgB,wBAAwB,CACpC,aAAa,EAAE,kBAAkB,EACjC,OAAO,EAAE,MAAM,GAChB,iBAAiB,GAAG,IAAI,CAkB1B"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAQvD,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,EAAE,CAAA;CACxB;AAqOD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF"}
|