@infituit/opencode-acp 2.0.0-alpha.1 → 2.0.0-alpha.3

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.
Files changed (286) hide show
  1. package/README.md +103 -437
  2. package/dist/auth.d.ts.map +1 -0
  3. package/dist/commands/compression-targets.d.ts.map +1 -0
  4. package/dist/commands/context.d.ts.map +1 -0
  5. package/dist/commands/export.d.ts.map +1 -0
  6. package/dist/commands/index.d.ts.map +1 -0
  7. package/dist/commands/stats.d.ts.map +1 -0
  8. package/dist/compress/decompress-logic.d.ts.map +1 -0
  9. package/dist/compress/decompress.d.ts.map +1 -0
  10. package/dist/compress/hide-consumed.d.ts.map +1 -0
  11. package/dist/compress/hide-failed.d.ts.map +1 -0
  12. package/dist/compress/image-archive.d.ts.map +1 -0
  13. package/dist/compress/index.d.ts.map +1 -0
  14. package/dist/compress/keep-markers.d.ts.map +1 -0
  15. package/dist/compress/parts.d.ts.map +1 -0
  16. package/dist/compress/pipeline.d.ts.map +1 -0
  17. package/dist/compress/protected-content.d.ts.map +1 -0
  18. package/dist/compress/quality-gate/algorithms/index.d.ts.map +1 -0
  19. package/dist/compress/quality-gate/evaluate.d.ts.map +1 -0
  20. package/dist/compress/quality-gate/index.d.ts.map +1 -0
  21. package/dist/compress/quality-gate/registry.d.ts.map +1 -0
  22. package/dist/compress/quality-gate/rejection.d.ts.map +1 -0
  23. package/dist/compress/quality-gate/types.d.ts.map +1 -0
  24. package/dist/compress/range-utils.d.ts.map +1 -0
  25. package/dist/compress/range.d.ts.map +1 -0
  26. package/dist/compress/recap.d.ts.map +1 -0
  27. package/dist/compress/search.d.ts.map +1 -0
  28. package/dist/compress/smart-plan.d.ts.map +1 -0
  29. package/dist/compress/state.d.ts.map +1 -0
  30. package/dist/compress/status.d.ts.map +1 -0
  31. package/dist/compress/timing.d.ts.map +1 -0
  32. package/dist/compress/types.d.ts.map +1 -0
  33. package/dist/compress-permission.d.ts.map +1 -0
  34. package/dist/config-validation.d.ts.map +1 -0
  35. package/dist/config.d.ts.map +1 -0
  36. package/dist/diagnostics.d.ts +43 -0
  37. package/dist/diagnostics.d.ts.map +1 -0
  38. package/dist/gc/merge.d.ts.map +1 -0
  39. package/dist/hooks.d.ts.map +1 -0
  40. package/dist/host-permissions.d.ts.map +1 -0
  41. package/dist/index.d.ts +1 -1
  42. package/dist/index.d.ts.map +1 -1
  43. package/dist/index.js +511 -345
  44. package/dist/index.js.map +1 -1
  45. package/dist/{lib/logger.d.ts → logger.d.ts} +2 -0
  46. package/dist/logger.d.ts.map +1 -0
  47. package/dist/message-ids.d.ts.map +1 -0
  48. package/dist/messages/enforce-budget.d.ts.map +1 -0
  49. package/dist/messages/filter/apply.d.ts.map +1 -0
  50. package/dist/messages/filter/builtin/index.d.ts.map +1 -0
  51. package/dist/messages/filter/builtin/omo-context.d.ts.map +1 -0
  52. package/dist/messages/filter/builtin/omo-mode-injection.d.ts.map +1 -0
  53. package/dist/messages/filter/builtin/omo-system-reminder.d.ts.map +1 -0
  54. package/dist/messages/filter/builtin/omo-task-directive.d.ts.map +1 -0
  55. package/dist/messages/filter/builtin/omo-todo-continuation.d.ts.map +1 -0
  56. package/dist/messages/filter/index.d.ts.map +1 -0
  57. package/dist/messages/filter/registry.d.ts.map +1 -0
  58. package/dist/messages/filter/types.d.ts.map +1 -0
  59. package/dist/messages/index.d.ts.map +1 -0
  60. package/dist/messages/inject/candidates.d.ts.map +1 -0
  61. package/dist/messages/inject/inject.d.ts.map +1 -0
  62. package/dist/messages/inject/policy/index.d.ts.map +1 -0
  63. package/dist/messages/inject/policy/registry.d.ts.map +1 -0
  64. package/dist/messages/inject/policy/types.d.ts.map +1 -0
  65. package/dist/messages/inject/utils.d.ts.map +1 -0
  66. package/dist/messages/priority.d.ts.map +1 -0
  67. package/dist/messages/prune.d.ts.map +1 -0
  68. package/dist/messages/query.d.ts.map +1 -0
  69. package/dist/messages/reasoning-strip.d.ts.map +1 -0
  70. package/dist/messages/shape.d.ts.map +1 -0
  71. package/dist/messages/sticky-truncation.d.ts.map +1 -0
  72. package/dist/messages/sync.d.ts.map +1 -0
  73. package/dist/messages/truncate-tools.d.ts.map +1 -0
  74. package/dist/messages/utils.d.ts.map +1 -0
  75. package/dist/prompts/compress-range.d.ts.map +1 -0
  76. package/dist/prompts/context-limit-nudge.d.ts.map +1 -0
  77. package/dist/prompts/extensions/nudge.d.ts.map +1 -0
  78. package/dist/prompts/extensions/system.d.ts.map +1 -0
  79. package/dist/prompts/extensions/tool.d.ts.map +1 -0
  80. package/dist/prompts/index.d.ts.map +1 -0
  81. package/dist/prompts/iteration-nudge.d.ts.map +1 -0
  82. package/dist/prompts/store.d.ts.map +1 -0
  83. package/dist/prompts/system.d.ts.map +1 -0
  84. package/dist/prompts/turn-nudge.d.ts.map +1 -0
  85. package/dist/protected-patterns.d.ts.map +1 -0
  86. package/dist/state/index.d.ts.map +1 -0
  87. package/dist/state/message-types.d.ts.map +1 -0
  88. package/dist/state/model-limits.d.ts.map +1 -0
  89. package/dist/state/persistence.d.ts.map +1 -0
  90. package/dist/state/rebuild.d.ts.map +1 -0
  91. package/dist/state/state.d.ts.map +1 -0
  92. package/dist/state/tool-cache.d.ts.map +1 -0
  93. package/dist/state/types.d.ts.map +1 -0
  94. package/dist/state/utils.d.ts.map +1 -0
  95. package/dist/token-utils.d.ts.map +1 -0
  96. package/dist/ui/notification.d.ts.map +1 -0
  97. package/dist/ui/utils.d.ts.map +1 -0
  98. package/dist/update.d.ts.map +1 -0
  99. package/dist/v2/messages.d.ts.map +1 -0
  100. package/dist/v2/plugin.d.ts.map +1 -0
  101. package/package.json +1 -1
  102. package/dist/lib/auth.d.ts.map +0 -1
  103. package/dist/lib/bili-proxy.d.ts +0 -64
  104. package/dist/lib/bili-proxy.d.ts.map +0 -1
  105. package/dist/lib/commands/compression-targets.d.ts.map +0 -1
  106. package/dist/lib/commands/context.d.ts.map +0 -1
  107. package/dist/lib/commands/export.d.ts.map +0 -1
  108. package/dist/lib/commands/index.d.ts.map +0 -1
  109. package/dist/lib/commands/stats.d.ts.map +0 -1
  110. package/dist/lib/compress/decompress-logic.d.ts.map +0 -1
  111. package/dist/lib/compress/decompress.d.ts.map +0 -1
  112. package/dist/lib/compress/hide-consumed.d.ts.map +0 -1
  113. package/dist/lib/compress/hide-failed.d.ts.map +0 -1
  114. package/dist/lib/compress/image-archive.d.ts.map +0 -1
  115. package/dist/lib/compress/index.d.ts.map +0 -1
  116. package/dist/lib/compress/keep-markers.d.ts.map +0 -1
  117. package/dist/lib/compress/parts.d.ts.map +0 -1
  118. package/dist/lib/compress/pipeline.d.ts.map +0 -1
  119. package/dist/lib/compress/protected-content.d.ts.map +0 -1
  120. package/dist/lib/compress/quality-gate/algorithms/index.d.ts.map +0 -1
  121. package/dist/lib/compress/quality-gate/evaluate.d.ts.map +0 -1
  122. package/dist/lib/compress/quality-gate/index.d.ts.map +0 -1
  123. package/dist/lib/compress/quality-gate/registry.d.ts.map +0 -1
  124. package/dist/lib/compress/quality-gate/rejection.d.ts.map +0 -1
  125. package/dist/lib/compress/quality-gate/types.d.ts.map +0 -1
  126. package/dist/lib/compress/range-utils.d.ts.map +0 -1
  127. package/dist/lib/compress/range.d.ts.map +0 -1
  128. package/dist/lib/compress/recap.d.ts.map +0 -1
  129. package/dist/lib/compress/search.d.ts.map +0 -1
  130. package/dist/lib/compress/smart-plan.d.ts.map +0 -1
  131. package/dist/lib/compress/state.d.ts.map +0 -1
  132. package/dist/lib/compress/status.d.ts.map +0 -1
  133. package/dist/lib/compress/timing.d.ts.map +0 -1
  134. package/dist/lib/compress/types.d.ts.map +0 -1
  135. package/dist/lib/compress-permission.d.ts.map +0 -1
  136. package/dist/lib/config-validation.d.ts.map +0 -1
  137. package/dist/lib/config.d.ts.map +0 -1
  138. package/dist/lib/gc/merge.d.ts.map +0 -1
  139. package/dist/lib/hooks.d.ts.map +0 -1
  140. package/dist/lib/host-permissions.d.ts.map +0 -1
  141. package/dist/lib/logger.d.ts.map +0 -1
  142. package/dist/lib/message-ids.d.ts.map +0 -1
  143. package/dist/lib/messages/enforce-budget.d.ts.map +0 -1
  144. package/dist/lib/messages/filter/apply.d.ts.map +0 -1
  145. package/dist/lib/messages/filter/builtin/index.d.ts.map +0 -1
  146. package/dist/lib/messages/filter/builtin/omo-context.d.ts.map +0 -1
  147. package/dist/lib/messages/filter/builtin/omo-mode-injection.d.ts.map +0 -1
  148. package/dist/lib/messages/filter/builtin/omo-system-reminder.d.ts.map +0 -1
  149. package/dist/lib/messages/filter/builtin/omo-task-directive.d.ts.map +0 -1
  150. package/dist/lib/messages/filter/builtin/omo-todo-continuation.d.ts.map +0 -1
  151. package/dist/lib/messages/filter/index.d.ts.map +0 -1
  152. package/dist/lib/messages/filter/registry.d.ts.map +0 -1
  153. package/dist/lib/messages/filter/types.d.ts.map +0 -1
  154. package/dist/lib/messages/index.d.ts.map +0 -1
  155. package/dist/lib/messages/inject/candidates.d.ts.map +0 -1
  156. package/dist/lib/messages/inject/inject.d.ts.map +0 -1
  157. package/dist/lib/messages/inject/policy/index.d.ts.map +0 -1
  158. package/dist/lib/messages/inject/policy/registry.d.ts.map +0 -1
  159. package/dist/lib/messages/inject/policy/types.d.ts.map +0 -1
  160. package/dist/lib/messages/inject/utils.d.ts.map +0 -1
  161. package/dist/lib/messages/priority.d.ts.map +0 -1
  162. package/dist/lib/messages/prune.d.ts.map +0 -1
  163. package/dist/lib/messages/query.d.ts.map +0 -1
  164. package/dist/lib/messages/reasoning-strip.d.ts.map +0 -1
  165. package/dist/lib/messages/shape.d.ts.map +0 -1
  166. package/dist/lib/messages/sticky-truncation.d.ts.map +0 -1
  167. package/dist/lib/messages/sync.d.ts.map +0 -1
  168. package/dist/lib/messages/truncate-tools.d.ts.map +0 -1
  169. package/dist/lib/messages/utils.d.ts.map +0 -1
  170. package/dist/lib/prompts/compress-range.d.ts.map +0 -1
  171. package/dist/lib/prompts/context-limit-nudge.d.ts.map +0 -1
  172. package/dist/lib/prompts/extensions/nudge.d.ts.map +0 -1
  173. package/dist/lib/prompts/extensions/system.d.ts.map +0 -1
  174. package/dist/lib/prompts/extensions/tool.d.ts.map +0 -1
  175. package/dist/lib/prompts/index.d.ts.map +0 -1
  176. package/dist/lib/prompts/iteration-nudge.d.ts.map +0 -1
  177. package/dist/lib/prompts/store.d.ts.map +0 -1
  178. package/dist/lib/prompts/system.d.ts.map +0 -1
  179. package/dist/lib/prompts/turn-nudge.d.ts.map +0 -1
  180. package/dist/lib/protected-patterns.d.ts.map +0 -1
  181. package/dist/lib/state/index.d.ts.map +0 -1
  182. package/dist/lib/state/message-types.d.ts.map +0 -1
  183. package/dist/lib/state/model-limits.d.ts.map +0 -1
  184. package/dist/lib/state/persistence.d.ts.map +0 -1
  185. package/dist/lib/state/rebuild.d.ts.map +0 -1
  186. package/dist/lib/state/state.d.ts.map +0 -1
  187. package/dist/lib/state/tool-cache.d.ts.map +0 -1
  188. package/dist/lib/state/types.d.ts.map +0 -1
  189. package/dist/lib/state/utils.d.ts.map +0 -1
  190. package/dist/lib/token-utils.d.ts.map +0 -1
  191. package/dist/lib/ui/notification.d.ts.map +0 -1
  192. package/dist/lib/ui/utils.d.ts.map +0 -1
  193. package/dist/lib/update.d.ts.map +0 -1
  194. package/dist/lib/v2/messages.d.ts.map +0 -1
  195. package/dist/lib/v2/plugin.d.ts.map +0 -1
  196. /package/dist/{lib/auth.d.ts → auth.d.ts} +0 -0
  197. /package/dist/{lib/commands → commands}/compression-targets.d.ts +0 -0
  198. /package/dist/{lib/commands → commands}/context.d.ts +0 -0
  199. /package/dist/{lib/commands → commands}/export.d.ts +0 -0
  200. /package/dist/{lib/commands → commands}/index.d.ts +0 -0
  201. /package/dist/{lib/commands → commands}/stats.d.ts +0 -0
  202. /package/dist/{lib/compress → compress}/decompress-logic.d.ts +0 -0
  203. /package/dist/{lib/compress → compress}/decompress.d.ts +0 -0
  204. /package/dist/{lib/compress → compress}/hide-consumed.d.ts +0 -0
  205. /package/dist/{lib/compress → compress}/hide-failed.d.ts +0 -0
  206. /package/dist/{lib/compress → compress}/image-archive.d.ts +0 -0
  207. /package/dist/{lib/compress → compress}/index.d.ts +0 -0
  208. /package/dist/{lib/compress → compress}/keep-markers.d.ts +0 -0
  209. /package/dist/{lib/compress → compress}/parts.d.ts +0 -0
  210. /package/dist/{lib/compress → compress}/pipeline.d.ts +0 -0
  211. /package/dist/{lib/compress → compress}/protected-content.d.ts +0 -0
  212. /package/dist/{lib/compress → compress}/quality-gate/algorithms/index.d.ts +0 -0
  213. /package/dist/{lib/compress → compress}/quality-gate/evaluate.d.ts +0 -0
  214. /package/dist/{lib/compress → compress}/quality-gate/index.d.ts +0 -0
  215. /package/dist/{lib/compress → compress}/quality-gate/registry.d.ts +0 -0
  216. /package/dist/{lib/compress → compress}/quality-gate/rejection.d.ts +0 -0
  217. /package/dist/{lib/compress → compress}/quality-gate/types.d.ts +0 -0
  218. /package/dist/{lib/compress → compress}/range-utils.d.ts +0 -0
  219. /package/dist/{lib/compress → compress}/range.d.ts +0 -0
  220. /package/dist/{lib/compress → compress}/recap.d.ts +0 -0
  221. /package/dist/{lib/compress → compress}/search.d.ts +0 -0
  222. /package/dist/{lib/compress → compress}/smart-plan.d.ts +0 -0
  223. /package/dist/{lib/compress → compress}/state.d.ts +0 -0
  224. /package/dist/{lib/compress → compress}/status.d.ts +0 -0
  225. /package/dist/{lib/compress → compress}/timing.d.ts +0 -0
  226. /package/dist/{lib/compress → compress}/types.d.ts +0 -0
  227. /package/dist/{lib/compress-permission.d.ts → compress-permission.d.ts} +0 -0
  228. /package/dist/{lib/config-validation.d.ts → config-validation.d.ts} +0 -0
  229. /package/dist/{lib/config.d.ts → config.d.ts} +0 -0
  230. /package/dist/{lib/gc → gc}/merge.d.ts +0 -0
  231. /package/dist/{lib/hooks.d.ts → hooks.d.ts} +0 -0
  232. /package/dist/{lib/host-permissions.d.ts → host-permissions.d.ts} +0 -0
  233. /package/dist/{lib/message-ids.d.ts → message-ids.d.ts} +0 -0
  234. /package/dist/{lib/messages → messages}/enforce-budget.d.ts +0 -0
  235. /package/dist/{lib/messages → messages}/filter/apply.d.ts +0 -0
  236. /package/dist/{lib/messages → messages}/filter/builtin/index.d.ts +0 -0
  237. /package/dist/{lib/messages → messages}/filter/builtin/omo-context.d.ts +0 -0
  238. /package/dist/{lib/messages → messages}/filter/builtin/omo-mode-injection.d.ts +0 -0
  239. /package/dist/{lib/messages → messages}/filter/builtin/omo-system-reminder.d.ts +0 -0
  240. /package/dist/{lib/messages → messages}/filter/builtin/omo-task-directive.d.ts +0 -0
  241. /package/dist/{lib/messages → messages}/filter/builtin/omo-todo-continuation.d.ts +0 -0
  242. /package/dist/{lib/messages → messages}/filter/index.d.ts +0 -0
  243. /package/dist/{lib/messages → messages}/filter/registry.d.ts +0 -0
  244. /package/dist/{lib/messages → messages}/filter/types.d.ts +0 -0
  245. /package/dist/{lib/messages → messages}/index.d.ts +0 -0
  246. /package/dist/{lib/messages → messages}/inject/candidates.d.ts +0 -0
  247. /package/dist/{lib/messages → messages}/inject/inject.d.ts +0 -0
  248. /package/dist/{lib/messages → messages}/inject/policy/index.d.ts +0 -0
  249. /package/dist/{lib/messages → messages}/inject/policy/registry.d.ts +0 -0
  250. /package/dist/{lib/messages → messages}/inject/policy/types.d.ts +0 -0
  251. /package/dist/{lib/messages → messages}/inject/utils.d.ts +0 -0
  252. /package/dist/{lib/messages → messages}/priority.d.ts +0 -0
  253. /package/dist/{lib/messages → messages}/prune.d.ts +0 -0
  254. /package/dist/{lib/messages → messages}/query.d.ts +0 -0
  255. /package/dist/{lib/messages → messages}/reasoning-strip.d.ts +0 -0
  256. /package/dist/{lib/messages → messages}/shape.d.ts +0 -0
  257. /package/dist/{lib/messages → messages}/sticky-truncation.d.ts +0 -0
  258. /package/dist/{lib/messages → messages}/sync.d.ts +0 -0
  259. /package/dist/{lib/messages → messages}/truncate-tools.d.ts +0 -0
  260. /package/dist/{lib/messages → messages}/utils.d.ts +0 -0
  261. /package/dist/{lib/prompts → prompts}/compress-range.d.ts +0 -0
  262. /package/dist/{lib/prompts → prompts}/context-limit-nudge.d.ts +0 -0
  263. /package/dist/{lib/prompts → prompts}/extensions/nudge.d.ts +0 -0
  264. /package/dist/{lib/prompts → prompts}/extensions/system.d.ts +0 -0
  265. /package/dist/{lib/prompts → prompts}/extensions/tool.d.ts +0 -0
  266. /package/dist/{lib/prompts → prompts}/index.d.ts +0 -0
  267. /package/dist/{lib/prompts → prompts}/iteration-nudge.d.ts +0 -0
  268. /package/dist/{lib/prompts → prompts}/store.d.ts +0 -0
  269. /package/dist/{lib/prompts → prompts}/system.d.ts +0 -0
  270. /package/dist/{lib/prompts → prompts}/turn-nudge.d.ts +0 -0
  271. /package/dist/{lib/protected-patterns.d.ts → protected-patterns.d.ts} +0 -0
  272. /package/dist/{lib/state → state}/index.d.ts +0 -0
  273. /package/dist/{lib/state → state}/message-types.d.ts +0 -0
  274. /package/dist/{lib/state → state}/model-limits.d.ts +0 -0
  275. /package/dist/{lib/state → state}/persistence.d.ts +0 -0
  276. /package/dist/{lib/state → state}/rebuild.d.ts +0 -0
  277. /package/dist/{lib/state → state}/state.d.ts +0 -0
  278. /package/dist/{lib/state → state}/tool-cache.d.ts +0 -0
  279. /package/dist/{lib/state → state}/types.d.ts +0 -0
  280. /package/dist/{lib/state → state}/utils.d.ts +0 -0
  281. /package/dist/{lib/token-utils.d.ts → token-utils.d.ts} +0 -0
  282. /package/dist/{lib/ui → ui}/notification.d.ts +0 -0
  283. /package/dist/{lib/ui → ui}/utils.d.ts +0 -0
  284. /package/dist/{lib/update.d.ts → update.d.ts} +0 -0
  285. /package/dist/{lib/v2 → v2}/messages.d.ts +0 -0
  286. /package/dist/{lib/v2 → v2}/plugin.d.ts +0 -0
package/README.md CHANGED
@@ -1,438 +1,119 @@
1
- [English](./README.md) | [中文](README.md)
1
+ # Active Context Pruning
2
2
 
3
- <p align="center">
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**、Git,以及用于构建包的 Node.js/npm。
82
- 通过 GitHub release tag 全局安装:
9
+ 需要 OpenCode **>=2.1.4 且 <3**。通过 npm 包全局安装(已包含预构建代码,无需从 Git 构建):
83
10
 
84
11
  ```bash
85
- opencode plugin add github:infituit/opencode-acp#v2.0.0-alpha.1
12
+ opencode plugin add @infituit/opencode-acp@2.0.0-beta.1
86
13
  ```
87
14
 
88
- 或者在 `opencode.json(c)` 中添加固定到该 tag 的 Git 包:
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": ["github:infituit/opencode-acp#v2.0.0-alpha.1"]
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
- - **T1** 在原始上下文超过配置限制时触发。模型看到可压缩范围,编写详细摘要,保留文件路径、函数签名、决策和理由。
130
- - **T2** 在 T1 摘要 token 达到 `nudgeGrowthTokens`(固定默认 50000)时触发。模型蒸馏旧的 T1 块 — 保留决策和结果,丢弃冗长的过程细节。
131
- - **T3** 在 T2 摘要 token 达到同样阈值时触发。模型浓缩为纯事实(已发布的版本、关键 bug、架构决策)。
132
-
133
- 每层有**独立的节奏计数器** — T2 触发不阻塞 T3。T1 通过 `!shouldInject` 守卫获得优先级:如果 T1 触发了,T2/T3 等到下一轮。这确保原始上下文压缩优先发生(影响最大)。
134
-
135
- 模型对所有层级使用**同一个 `compress` 工具**。T2/T3 压缩使用块 ID 作为边界(`compress({ content: [{ startId: "b5", endId: "b20", summary: "..." }] })`)。层级根据被消费的块自动检测。
136
-
137
- **会话容量** — 一个会话从空 → T1 → T2 → T3 → 上下文极限,总共可以处理多少 token(真实校准:500 次 API 调用/天,~9.6K 新 token/调用,T1=45x/T2=10x/T3=3x):
138
-
139
- | 上下文上限 | 1 个月 | 3 个月 | 到极限 | 极限时间 |
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
- 由模型决定何时解压。当上下文大到足以干扰模型的 self-attention 时,简短的 block 会让模型先压缩一部分内容,处理完紧急事务,再在后续工作中按需解压。
42
+ ACP 提供 `/acp` 斜杠命令:
173
43
 
174
- ### GC 兜底
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
- 当上下文达到 100% 时,系统自动截断老年代 block 摘要,防止上下文溢出。这是最后的兜底机制 — 有了三级压缩,GC 极少激活,因为 T2/T3 蒸馏将摘要开销控制在有界范围内。
51
+ ## 工作原理
177
52
 
178
- ### 质量门控(非阻塞,默认关闭)
53
+ ACP 根据上下文用量和配置向模型注入压缩提示,由模型选择范围并编写摘要。主要工具包括:
179
54
 
180
- 每次 `compress` 调用之后,ACP 可以运行一个可拔插的质量门控,检测摘要是否灾难性丢失了内容(例如:5K token 的范围被压缩成 147 字符、且不含任何技术关键词的摘要)。失败只发出 `logger.warn`——绝不拒绝压缩(结果已经提交到状态、对模型可见)。
55
+ - `acp_compress`:将选定范围替换为摘要。
56
+ - `acp_decompress`:按需恢复压缩范围的原始内容。
57
+ - `acp_status`:查看上下文用量、压缩块和可压缩范围。
58
+ - `acp_search_context`:在活动压缩块的摘要中搜索,帮助定位需要恢复的内容。
181
59
 
182
- 默认算法 `rouge-recall-v1` 是基于 6,913 个真实块校准的两层门控:
60
+ ### 分层压缩
183
61
 
184
- - **L1(长度下限)**:捕获灾难性留存失败——摘要短于 200 字符 OR 留存率低于原始的 1%。100% 召回,0% 误报。
185
- - **L2(内容覆盖)**:只在通过 L1 的块上运行。当 **同时** ROUGE-1 F1 < 0.05 **且** top-20 关键词召回 < 0.20 时触发(AND 合并使误报率维持在 ~6.6%)。
62
+ 摘要可以再次压缩,分为三个层级:
186
63
 
187
- 接口可拔插:未来算法(例如通过外部 API 的 LLM-as-judge)可通过 `registerQualityGate()` 注册,无需改动 pipeline 接线。分词器使用手写的词级分词(英文关键词 + 中文 unigram/bigram),不使用 ACP 的 BPE 分词器——后者对 ROUGE 风格的匹配粒度过粗。
64
+ | 层级 | 名称 | 输入 | 输出 |
65
+ | ---- | ---- | -------- | ---------------- |
66
+ | T1 | 捕获 | 原始对话 | 保留细节的摘要 |
67
+ | T2 | 蒸馏 | T1 摘要 | 决策和结果 |
68
+ | T3 | 浓缩 | T2 摘要 | 进一步精简的事实 |
188
69
 
189
- 默认关闭,发布一个版本的烧入期后再开启。启用方式:
70
+ 各层使用同一个 `acp_compress` 工具。原始消息使用 `mNNNNN` 引用,压缩块使用 `bN` 引用,层级根据被消费的块检测。例如:
190
71
 
191
- ```jsonc
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
- | `/acp` | 显示压缩状态(同 `/acp stats`);`/acp help` 查看命令列表 |
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
- 每一层覆盖前一层,因此项目设置优先于全局设置。修改配置后请重启 OpenCode。
92
+ 每一层覆盖前一层,因此项目设置优先于全局设置。修改 ACP 配置后请重启 OpenCode。
234
93
 
235
- > **📖 完整参数参考:** 配置参考文档正在重写;完整字段结构见 [`acp.schema.json`](./acp.schema.json)。
94
+ 完整字段结构见 [`acp.schema.json`](./acp.schema.json),默认值见 [`src/config.ts`](./src/config.ts) 中的 `defaultConfig`。不需要在配置文件中复制所有默认值,只填写需要覆盖的字段。
236
95
 
237
- > [!IMPORTANT]
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
- <details>
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
- // Compression mode: "range" (compress spans into block summaries)
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
- // Start adding compression reminders after this many
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
- </details>
112
+ 上下文阈值接受 token 数或模型上下文窗口的百分比。`maxContextLimit` 是触发压缩提示的软阈值,不是硬性截断上限;达到阈值不代表模型一定立即执行压缩。根据模型的可用上下文调整阈值。
432
113
 
433
114
  ### 按 Provider / 按模型覆盖
434
115
 
435
- 任意 `compress` 字段都可通过嵌套的 `compress.providers` 按 provider 和按模型覆盖:
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` 映射自身。注意:`modelMaxLimits` **未废弃** —— 仍完全支持,只是优先级低于嵌套的 `maxContextLimit`。
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
- 完整版本历史维护在 [`support-files/changelog/zh/`](./support-files/changelog/zh/)。
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 — 本项目源自 [Tarquinen](https://github.com/Tarquinen) 的开源项目。原始版权归原始作者所有。修改和错误修复由 ranxianglei 完成。
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"}