结构化摘要

文章主旨：

OpenCode V2 的四大设计变化（Permission 有序规则数组、Plugin 双层能力、Compaction 检查点机制、Instructions 增量与 epoch）共同指向一个方向：驾驭 AI Agent 正在从“提示工程”走向“系统工程”，控制手段从“说清楚”变为“让它不能不知道、不能做、做了也能回滚”。

关键要点：

• Permission 从按工具分组的对象改为有序规则数组，采用“最后匹配规则生效”的显式优先级，支持全局规则与 Agent 级追加规则的分层策略，体现“策略即代码”思路。
• Plugin 分为 Transform hooks 和 Runtime hooks 两层；可通过修改模型请求直接删除工具，使 Agent “不知道”工具存在，而不是仅“拒绝”；hook 失败会阻断操作，可作为硬性门禁。
• Compaction 变为带版本号的 checkpoint 机制：包含结构化摘要和最近上下文尾部，并支持上下文溢出自动压缩重试；Instructions 以 durable deltas 存储变更，compaction 推进 instruction epoch，使上下文管理具备“版本号”语义。
• 嵌套 AGENTS.md 改为按需发现：位于当前目录之下的规则不启动加载，仅在 Agent 读取相关目录时注入，平衡完整性与上下文效率。
• 引入基于 Git 的 per-step 快照和 Undo/Redo，使 Agent 的每一步操作具有“事务语义”，可完整回滚。

内容结构：

引言：V2 的表面变化与深层问题

OpenCode V2 beta 的运行时、桌面框架、插件 API 和配置字段发生变化，但更值得关注的是其设计者在回答“当 Agent 能力越强，人类如何既利用又控制”这一问题。四个核心变化对应上下文工程与驾驭工程的三个趋势。

趋势一：从配置到策略——Permission 的有序规则数组

V1 的 permission 按工具分组，规则冲突时优先级隐式且不可预测。V2 改为有序数组（action、resource、effect），官方明确“最后匹配规则生效”，并支持全局规则先于 Agent 规则追加，使 agent 规则可细化但不会覆盖全局。文档还建议：shell 是原始文本，无法穷举危险命令，应使用窄白名单而非黑名单。这体现了“红线 deny、白名单 allow、其余 ask”的默认行为。

趋势二：从回调函数到组合式中间件——Plugin 的双层能力

V1 的 plugin 仅是回调函数，无法修改模型请求或工具集。V2 分为 Transform hooks（修改配置）和 Runtime hooks（拦截运行时操作），其中 ctx.session.hook("context") 可在请求发出前修改 system prompt、消息列表和工具集。由此可让 Agent 完全不知道某个工具存在，实现比 deny 更强的控制。文档明确“hook 失败会阻断被拦截的操作”，可用于硬性门禁。

趋势三：从“遗忘”到“有版本的状态管理”

V1 的 compaction 会压缩旧消息，但无法保证关键约束保留。V2 将其设计为 checkpoint：包含结构化摘要和序列化的最近上下文尾部，并在溢出时自动压缩重试。Instructions 以 durable deltas 存储增量变更，compaction 后推进 instruction epoch，折叠历史增量。此机制使上下文管理可类比为 Git：deltas 是 commit，epoch 是 tag，checkpoint 是 snapshot，请求装配是 checkout。嵌套 AGENTS.md 采用按需发现，避免全量加载。此外，基于 Git 的 per-step 快照支持 /undo 回滚，为 Agent 操作提供安全网。

总结：三个趋势，一个方向

三个趋势分别是从“配置”到“策略即代码”、从“监控”到“可编程阀门”、从“祈祷不丢”到“确定性状态管理”。它们共同表明：驾驭 AI Agent 从提示工程走向系统工程。OpenCode V2 目前是 beta，数据可能被清理、API 会变化，但设计方向明确且具有行业代表性。

文章总结：

本文以 OpenCode V2 文档为素材，从设计意图层面解读其变化，提出驾驭工程向策略化、管线化、版本化演进的清晰判断，并最终指向“系统工程”的结论，是一篇逻辑严谨的技术分析文章。

软件质量报道

查看原文：从 OpenCode 升级到 V2，我们看到上下文工程与驾驭工程的三个趋势

文章来源：

软件质量报道

扫码关注公众号