2026/9/11 23:14:39
FEATURED · 精选文章 
opencode-goal 插件设计原则文档文档版本: v1.0编写日期: 2026-09-10基于深度代码审计与官方源码研究文档定位: 插件设计原则目录1. 设计原则总览2. 核心设计原则3. 设计原则详解4. 设计原则落地验证5. 文档说明1. 设计原则总览1.1 设计原则总览设计原则总览:原则说明实现机制设计目的最小化机制、最大化合规只实现当前必需的功能规则以法条式强制机制事实以最小字段出现禁止衍生 AI 禁令规则法条式、最小化机制避免过度设计用户门控优先所有用户行为由用户显式授权AI 不得越权用户门控机制从源头杜绝越权单一驱动、双门控TICK 是唯一续推驱动但通过门控机制保证主代理线程不阻塞TICK 双门控保证驱动能力与物理完成规则与机制分离规则只写「AI 必须做什么/禁止做什么」机制事实以最小字段出现规则与机制分离机制确保可执行性和可追溯性证据与门禁物理上强制 AI 提供完成证据从源头杜绝虚假完成证据与门禁机制确保物理完成生命周期管理明确的目标状态转换与生命周期所有转换经过用户门控生命周期机制确保生命周期完整性1.2 设计原则目标设计目标:用户控制权保障: 所有用户行为由用户显式授权AI 不得越权驱动能力保障: 通过门控机制保证主代理的持续驱动能力物理完成保障: 通过证据门禁确保物理上无法声称完成可追溯性保障: 规则与机制分离确保可执行性和可追溯性避免过度设计: 只实现当前必需的功能2. 核心设计原则2.1 最小化机制、最大化合规说明: 只实现当前必需的功能规则以法条式强制机制事实以最小字段出现禁止衍生 AI 禁令。实现机制:只实现当前必需的功能避免过度设计机制事实以最小字段出现如 pending 含义、指纹归属规则法条式禁止口述规则通过最小化机制避免衍生 AI 禁令设计目的: 避免过度设计确保只实现当前必需的功能通过最小化机制事实避免衍生 AI 禁令通过法条式规则确保可执行性和可追溯性。2.2 用户门控优先说明: 所有用户行为由用户显式授权AI 不得越权。实现机制:目标所有权AI 不得越权修改用户目标用户暂停的恢复规则用户可自动恢复但直接闭合需盖章用户中止的指纹检测确保不误判设计目的: 从源头杜绝越权确保用户控制权不被越权。2.3 单一驱动、双门控说明: TICK 是唯一续推驱动但通过门控机制保证主代理线程不阻塞。实现机制:TICK 双门控忙子暂缓 卡死营救子代理双门控发起即后台 双门控让行证据门禁三层校验物理不可绕过设计目的: 保证驱动能力与物理完成避免因子代理或卡死导致主代理阻塞。2.4 规则与机制分离说明: 规则只写「AI 必须做什么/禁止做什么」机制事实以最小字段出现AI 能否执行是唯一判定依据。实现机制:规则只写可执行约束机制事实以最小字段出现机制与规则边界由 AI 能否执行判定法条式规则确保可执行性和可追溯性设计目的: 确保可执行性和可追溯性同时避免衍生 AI 禁令。2.5 证据与门禁说明: 物理上强制 AI 提供完成证据从源头杜绝虚假完成。实现机制:三层证据校验L1 存在性、L2 语义、L3 内容物理不可绕过从存在性、语义、内容三个维度严格把关设计目的: 确保物理完成从源头杜绝虚假完成。2.6 生命周期管理说明: 明确的目标状态转换与生命周期所有转换经过用户门控。实现机制:状态机设计确保目标生命周期有明确的转换路径和边界所有转换经过用户门控关闭即删除重启语义明确设计目的: 确保生命周期完整性确保用户控制权不被越权。3. 设计原则详解3.1 最小化机制、最大化合规工作方式:只实现当前必需的功能机制事实最小化禁止衍生 AI 禁令规则法条式禁止口述规则设计要点:避免过度设计只实现当前必需功能机制事实最小化避免衍生 AI 禁令规则法条式确保可执行性和可追溯性底层逻辑: 最小化机制设计确保只实现当前必需的功能通过最小化机制事实避免衍生 AI 禁令通过法条式规则确保可执行性和可追溯性。3.2 用户门控优先工作方式:目标所有权AI 不得越权修改用户目标用户暂停的恢复规则用户可自动恢复但直接闭合需盖章用户中止的指纹检测确保不误判设计要点:从源头杜绝越权确保用户控制权不被越权用户暂停的恢复规则明确避免误恢复用户中止的指纹检测确保不误判底层逻辑: 用户门控是核心边界确保用户控制权不被越权。所有用户行为都经过用户显式授权从源头杜绝越权。3.3 单一驱动、双门控工作方式:TICK 双门控忙子暂缓 卡死营救子代理双门控发起即后台 双门控让行证据门禁三层校验物理不可绕过设计要点:TICK 双门控保证主代理持续驱动能力子代理双门控保证并行执行不阻塞证据门禁保证物理完成底层逻辑: 双门控机制确保驱动能力与物理完成避免因子代理或卡死导致主代理阻塞。3.4 规则与机制分离工作方式:规则只写「AI 必须做什么/禁止做什么」机制事实以最小字段出现机制与规则边界由 AI 能否执行判定法条式规则确保可执行性和可追溯性设计要点:规则与机制分离是核心设计原则通过最小化机制事实避免衍生 AI 禁令法条式规则确保可执行性和可追溯性底层逻辑: 规则与机制分离是核心设计原则确保可执行性和可追溯性同时避免衍生 AI 禁令。3.5 证据与门禁工作方式:三层证据校验物理不可绕过从存在性、语义、内容三个维度严格把关确保物理上无法声称完成设计要点:三层校验从存在性、语义、内容三个维度严格把关确保物理上无法声称完成从源头杜绝虚假完成底层逻辑: 证据门禁是物理不可绕过的强制机制确保物理完成。3.6 生命周期管理工作方式:状态机设计确保目标生命周期有明确的转换路径和边界所有转换经过用户门控关闭即删除重启语义明确设计要点:状态机设计确保生命周期完整性所有转换经过用户门控关闭即删除防止目标泄漏重启语义明确底层逻辑: 状态机设计确保生命周期完整性所有转换经过用户门控确保用户控制权不被越权。4. 设计原则落地验证4.1 最小化机制验证工作方式: 当前文档聚焦当前必需功能未引入未验证的机制机制事实以最小字段出现。验证结果:只实现当前必需的功能未引入未验证的机制机制事实以最小字段出现如 pending 含义、指纹归属规则法条式未引入口述规则验证结论: 符合最小化机制设计避免过度设计。4.2 用户门控验证工作方式: 所有用户行为目标创建/暂停/恢复都经过用户显式授权。验证结果:目标所有权AI 不得越权修改用户目标用户暂停的恢复规则用户可自动恢复但直接闭合需盖章用户中止的指纹检测确保不误判验证结论: 符合用户门控设计从源头杜绝越权。4.3 双门控验证工作方式: TICK 双门控 子代理双门控 证据门禁。验证结果:TICK 双门控保证主代理持续驱动能力子代理双门控保证并行执行不阻塞证据门禁保证物理完成验证结论: 符合双门控设计驱动能力与物理完成有保障。4.4 规则与机制分离验证工作方式: 规则只写可执行约束机制事实以最小字段出现。验证结果:规则只写可执行约束机制事实以最小字段出现机制与规则边界由 AI 能否执行判定法条式规则确保可执行性和可追溯性验证结论: 符合规则与机制分离设计可执行性和可追溯性有保障。4.5 证据与门禁验证工作方式: 三层证据校验物理不可绕过。验证结果:三层校验从存在性、语义、内容三个维度严格把关确保物理上无法声称完成从源头杜绝虚假完成验证结论: 符合证据与门禁设计物理完成有保障。4.6 生命周期验证工作方式: 状态机设计确保目标生命周期有明确的转换路径和边界。验证结果:状态机设计确保生命周期完整性所有转换经过用户门控关闭即删除防止目标泄漏重启语义明确验证结论: 符合生命周期设计生命周期完整性有保障。5. 文档说明文档定位: 插件设计原则文档范围: 覆盖设计原则总览、核心设计原则、设计原则详解、落地验证文档依据: 基于 opencode 官方源码v1.18.x与本地代码深度审计文档用途: 指导设计原则应用、指导机制设计、指导规则编写编写原则: 内容严谨、专业、可落地不添加无意义内容不吹嘘夸大
opencode-goal 插件设计原则文档
opencode-goal 插件设计原则文档文档版本: v1.0编写日期: 2026-09-10基于深度代码审计与官方源码研究文档定位: 插件设计原则目录1. 设计原则总览2. 核心设计原则3. 设计原则详解4. 设计原则落地验证5. 文档说明1. 设计原则总览1.1 设计原则总览设计原则总览:原则说明实现机制设计目的最小化机制、最大化合规只实现当前必需的功能规则以法条式强制机制事实以最小字段出现禁止衍生 AI 禁令规则法条式、最小化机制避免过度设计用户门控优先所有用户行为由用户显式授权AI 不得越权用户门控机制从源头杜绝越权单一驱动、双门控TICK 是唯一续推驱动但通过门控机制保证主代理线程不阻塞TICK 双门控保证驱动能力与物理完成规则与机制分离规则只写「AI 必须做什么/禁止做什么」机制事实以最小字段出现规则与机制分离机制确保可执行性和可追溯性证据与门禁物理上强制 AI 提供完成证据从源头杜绝虚假完成证据与门禁机制确保物理完成生命周期管理明确的目标状态转换与生命周期所有转换经过用户门控生命周期机制确保生命周期完整性1.2 设计原则目标设计目标:用户控制权保障: 所有用户行为由用户显式授权AI 不得越权驱动能力保障: 通过门控机制保证主代理的持续驱动能力物理完成保障: 通过证据门禁确保物理上无法声称完成可追溯性保障: 规则与机制分离确保可执行性和可追溯性避免过度设计: 只实现当前必需的功能2. 核心设计原则2.1 最小化机制、最大化合规说明: 只实现当前必需的功能规则以法条式强制机制事实以最小字段出现禁止衍生 AI 禁令。实现机制:只实现当前必需的功能避免过度设计机制事实以最小字段出现如 pending 含义、指纹归属规则法条式禁止口述规则通过最小化机制避免衍生 AI 禁令设计目的: 避免过度设计确保只实现当前必需的功能通过最小化机制事实避免衍生 AI 禁令通过法条式规则确保可执行性和可追溯性。2.2 用户门控优先说明: 所有用户行为由用户显式授权AI 不得越权。实现机制:目标所有权AI 不得越权修改用户目标用户暂停的恢复规则用户可自动恢复但直接闭合需盖章用户中止的指纹检测确保不误判设计目的: 从源头杜绝越权确保用户控制权不被越权。2.3 单一驱动、双门控说明: TICK 是唯一续推驱动但通过门控机制保证主代理线程不阻塞。实现机制:TICK 双门控忙子暂缓 卡死营救子代理双门控发起即后台 双门控让行证据门禁三层校验物理不可绕过设计目的: 保证驱动能力与物理完成避免因子代理或卡死导致主代理阻塞。2.4 规则与机制分离说明: 规则只写「AI 必须做什么/禁止做什么」机制事实以最小字段出现AI 能否执行是唯一判定依据。实现机制:规则只写可执行约束机制事实以最小字段出现机制与规则边界由 AI 能否执行判定法条式规则确保可执行性和可追溯性设计目的: 确保可执行性和可追溯性同时避免衍生 AI 禁令。2.5 证据与门禁说明: 物理上强制 AI 提供完成证据从源头杜绝虚假完成。实现机制:三层证据校验L1 存在性、L2 语义、L3 内容物理不可绕过从存在性、语义、内容三个维度严格把关设计目的: 确保物理完成从源头杜绝虚假完成。2.6 生命周期管理说明: 明确的目标状态转换与生命周期所有转换经过用户门控。实现机制:状态机设计确保目标生命周期有明确的转换路径和边界所有转换经过用户门控关闭即删除重启语义明确设计目的: 确保生命周期完整性确保用户控制权不被越权。3. 设计原则详解3.1 最小化机制、最大化合规工作方式:只实现当前必需的功能机制事实最小化禁止衍生 AI 禁令规则法条式禁止口述规则设计要点:避免过度设计只实现当前必需功能机制事实最小化避免衍生 AI 禁令规则法条式确保可执行性和可追溯性底层逻辑: 最小化机制设计确保只实现当前必需的功能通过最小化机制事实避免衍生 AI 禁令通过法条式规则确保可执行性和可追溯性。3.2 用户门控优先工作方式:目标所有权AI 不得越权修改用户目标用户暂停的恢复规则用户可自动恢复但直接闭合需盖章用户中止的指纹检测确保不误判设计要点:从源头杜绝越权确保用户控制权不被越权用户暂停的恢复规则明确避免误恢复用户中止的指纹检测确保不误判底层逻辑: 用户门控是核心边界确保用户控制权不被越权。所有用户行为都经过用户显式授权从源头杜绝越权。3.3 单一驱动、双门控工作方式:TICK 双门控忙子暂缓 卡死营救子代理双门控发起即后台 双门控让行证据门禁三层校验物理不可绕过设计要点:TICK 双门控保证主代理持续驱动能力子代理双门控保证并行执行不阻塞证据门禁保证物理完成底层逻辑: 双门控机制确保驱动能力与物理完成避免因子代理或卡死导致主代理阻塞。3.4 规则与机制分离工作方式:规则只写「AI 必须做什么/禁止做什么」机制事实以最小字段出现机制与规则边界由 AI 能否执行判定法条式规则确保可执行性和可追溯性设计要点:规则与机制分离是核心设计原则通过最小化机制事实避免衍生 AI 禁令法条式规则确保可执行性和可追溯性底层逻辑: 规则与机制分离是核心设计原则确保可执行性和可追溯性同时避免衍生 AI 禁令。3.5 证据与门禁工作方式:三层证据校验物理不可绕过从存在性、语义、内容三个维度严格把关确保物理上无法声称完成设计要点:三层校验从存在性、语义、内容三个维度严格把关确保物理上无法声称完成从源头杜绝虚假完成底层逻辑: 证据门禁是物理不可绕过的强制机制确保物理完成。3.6 生命周期管理工作方式:状态机设计确保目标生命周期有明确的转换路径和边界所有转换经过用户门控关闭即删除重启语义明确设计要点:状态机设计确保生命周期完整性所有转换经过用户门控关闭即删除防止目标泄漏重启语义明确底层逻辑: 状态机设计确保生命周期完整性所有转换经过用户门控确保用户控制权不被越权。4. 设计原则落地验证4.1 最小化机制验证工作方式: 当前文档聚焦当前必需功能未引入未验证的机制机制事实以最小字段出现。验证结果:只实现当前必需的功能未引入未验证的机制机制事实以最小字段出现如 pending 含义、指纹归属规则法条式未引入口述规则验证结论: 符合最小化机制设计避免过度设计。4.2 用户门控验证工作方式: 所有用户行为目标创建/暂停/恢复都经过用户显式授权。验证结果:目标所有权AI 不得越权修改用户目标用户暂停的恢复规则用户可自动恢复但直接闭合需盖章用户中止的指纹检测确保不误判验证结论: 符合用户门控设计从源头杜绝越权。4.3 双门控验证工作方式: TICK 双门控 子代理双门控 证据门禁。验证结果:TICK 双门控保证主代理持续驱动能力子代理双门控保证并行执行不阻塞证据门禁保证物理完成验证结论: 符合双门控设计驱动能力与物理完成有保障。4.4 规则与机制分离验证工作方式: 规则只写可执行约束机制事实以最小字段出现。验证结果:规则只写可执行约束机制事实以最小字段出现机制与规则边界由 AI 能否执行判定法条式规则确保可执行性和可追溯性验证结论: 符合规则与机制分离设计可执行性和可追溯性有保障。4.5 证据与门禁验证工作方式: 三层证据校验物理不可绕过。验证结果:三层校验从存在性、语义、内容三个维度严格把关确保物理上无法声称完成从源头杜绝虚假完成验证结论: 符合证据与门禁设计物理完成有保障。4.6 生命周期验证工作方式: 状态机设计确保目标生命周期有明确的转换路径和边界。验证结果:状态机设计确保生命周期完整性所有转换经过用户门控关闭即删除防止目标泄漏重启语义明确验证结论: 符合生命周期设计生命周期完整性有保障。5. 文档说明文档定位: 插件设计原则文档范围: 覆盖设计原则总览、核心设计原则、设计原则详解、落地验证文档依据: 基于 opencode 官方源码v1.18.x与本地代码深度审计文档用途: 指导设计原则应用、指导机制设计、指导规则编写编写原则: 内容严谨、专业、可落地不添加无意义内容不吹嘘夸大 
