opencode-goal 插件工作流程文档-创锋一号

opencode-goal 插件工作流程文档

文档版本: v1.0
编写日期: 2026-09-10
基于深度代码审计与官方源码研究
文档定位: 插件工作流程详解

1. 工作流程总览

1.1 工作流程总览

工作流程总览:

工作流程说明:

用户输入/goal命令后，进入目标生命周期管理
TICK 循环驱动目标执行
子代理感知与营救完成
证据门禁校验
目标完成/中止/恢复

1.2 工作流程总览图

工作流程总览图:

工作流程说明:

用户输入/goal命令后，进入目标生命周期管理
TICK 循环驱动目标执行
子代理感知与营救完成
证据门禁校验
目标完成/中止/恢复

2. 完整工作流

2.1 完整工作流

完整工作流:

完整工作流说明:

用户输入/goal命令后，进入目标生命周期管理
TICK 循环驱动目标执行
子代理感知与营救完成
证据门禁校验
目标完成/中止/恢复

2.2 完整工作流图

完整工作流图:

完整工作流说明:

用户输入/goal命令后，进入目标生命周期管理
TICK 循环驱动目标执行
子代理感知与营救完成
证据门禁校验
目标完成/中止/恢复

3. 各环节逻辑

3.1 目标生命周期管理

工作方式:

用户门控：所有用户行为由用户显式授权
状态机：6 值状态机（active/paused/budget/complete/unmet）
关闭即删除：防止目标泄漏
重启语义：新实例在用户发言前不驱动任何 active 目标

底层逻辑: 目标管理是「用户意图 → 状态转换」的映射，所有转换都经过用户门控，确保用户控制权不被越权。

3.2 TICK 驱动机制

工作方式:

单一驱动：TICK 是唯一续推驱动
双门控：忙子暂缓 + 卡死营救
子代理后台化：task 强制 background
预算控制：token 用量与轮次上限

底层逻辑: TICK 是「唯一驱动者」的设计，确保主代理线程不被占用，通过门控机制保证主代理的持续驱动能力。

3.3 子代理感知机制

工作方式:

发起即后台：task 强制 background
双门控：忙子暂缓 + 技术故障放行
回程带 ID：自动带发送方会话 ID
孤儿恢复：主代理死后恢复
自动搬运：兜底搬运

底层逻辑: 子代理的并行执行通过「发起即后台 + 双门控 + 回程带 ID」实现，避免主代理阻塞等待；通过「复用会话」减少上下文重载，降低对子代理的依赖。

3.4 规则与合规机制

工作方式:

法条式规则：确保可执行性和可追溯性
静态前缀：最大化 KV 缓存命中
强制合规行：确保合规

底层逻辑: 规则系统采用「法条式」书写，确保规则的可执行性和可追溯性；静态前缀策略通过最大化 KV 缓存命中提升效率，同时保证规则的可缓存性。

3.5 证据门禁机制

工作方式:

三层校验：L1 存在性、L2 语义、L3 内容
物理不可绕过
从存在性、语义、内容三个维度严格把关

底层逻辑: 证据门禁是「物理上无法绕过」的强制机制，确保 AI 在物理上无法声称完成，从源头杜绝虚假完成。

4. 工作流时序

工作流时序:

用户输入/goal命令后，进入目标生命周期管理
TICK 循环驱动目标执行
子代理感知与营救完成
证据门禁校验
目标完成/中止/恢复

底层逻辑: 工作流的核心是「用户意图 → 状态转换 → 驱动执行 → 证据验证 → 闭环控制」，所有环节都经过门控机制保障，确保闭环的完整性。

5. 文档说明

文档定位: 插件工作流程详解
文档范围: 覆盖工作流程总览、完整工作流、各环节逻辑、工作流时序
文档依据: 基于 opencode 官方源码（v1.18.x）与本地代码深度审计
文档用途: 指导工作流理解、指导流程设计、指导流程实现
编写原则: 内容严谨、专业、可落地，不添加无意义内容，不吹嘘夸大

企业官网建设流程全解析