桌面应用AI 应用【免费下载链接】Easydict一个简洁优雅的词典翻译 macOS App。开箱即用支持离线 OCR 识别支持有道词典 苹果系统词典 苹果系统翻译OpenAIGeminiDeepLGoogleBing腾讯百度阿里小牛彩云和火山翻译。A concise and elegant Dictionary and Translator macOS App for looking up words and translating text.项目地址https://gitcode.com/gh_mirrors/ea/Easydict点击查看免费下载导读本文以 Easydict 仓库在 2026-08-23 落地的《Planning 子代理编排》任务记录为核心完整还原新增项目级只读planner子代理的动机、配置契约、触发与回退规则、权限边界以及静态验证方法。读者可以从中掌握如何为一个 macOS 开源项目引入职责聚焦的 Codex custom agent如何用 TOML 固定模型与推理强度如何通过仓库指南约束何时委派、何时回退、谁做最终决策以及如何在不开箱运行的情况下用tomllib、rg与git diff --check完成可信验证。任务背景为什么需要一个专属的 Planning 子代理Easydict 是一个 macOS 词典与翻译应用其仓库中同时维护着面向 Agent 的协作文档体系根 AGENTS.md 为唯一任务入口专题规则分布在各子文档。在本次任务之前仓库已经区分了planning与implementation两种任务模式但没有项目级的.codex/agents/配置也没有任何子代理subagent编排规则——这意味着高强度、高成本的规划推理无法被定向启用所有规划任务都由主 Agent 用默认配置完成。2026-08-23 的任务目标因此非常明确让非简单planning使用gpt-5.6-sol、xhigh的只读子代理生成规划建议并由主 Agent 核验和交付最终方案。该目标被拆解为三个落地动作见 任务记录新增项目级.codex/agents/planner.toml固定模型、推理强度、只读行为和返回契约在仓库指南repository-guide.md中定义非简单 planning 的触发规则、简单任务排除、等待行为与主 Agent 责任在 Agent 集成文档skills.md中定义 custom agent 调用、等价显式覆盖、回退、权限和禁止递归委派边界。核心方案项目级 planner.toml 的配置契约方案的第一步是新增.codex/agents/planner.toml。这是一份 Codex 项目级 custom agent 声明其关键约束由执行计划文档 2026-08-23-planning-subagent.md 的验收标准固化模型固定明确固定精确模型 IDgpt-5.6-sol不接受模糊的模型别名避免能力声明漂移推理强度xhigh作为独立 effort 配置项与模型分开设置使选哪个模型与花多大推理预算可以被独立审查只读行为sandbox_mode与developer_instructions双重约束禁止 planning 写入文件、修改 Git 或调用外部服务返回契约角色描述与指令共同规定 planner 只产出证据驱动的规划建议不执行任何写入动作。为什么用项目级 agent 而不是全局默认这是本次设计中最关键的一个决策记录在 执行计划 的决策记录中使用.codex/agents/planner.toml这种项目级、职责聚焦的声明方式而不是在[agents]中设置全局默认。原因有二高成本推理xhigh 专用模型只应被非简单 planning触发全局默认会把高成本强加给所有子代理包括那些根本不需要规划的任务保持其他子代理implementation/review/test 等的全局默认不变使引入 planner 的变更面最小、回归风险最低。配置的演化从非简单 planning到通用只读 planner需要说明的是planner.toml 的职责描述在后续迭代中发生了两次有记录的演化这两次演化同样记录在仓库中2026-08-27 泛化在 2026-08-27-generic-planner-agent.md 中角色描述从绑定 Easydict 的非简单 planning泛化为通用的只读 planning 子代理并改为读取当前仓库根目录的AGENTS.md如果存在及其任务路由要求以便在不同仓库 checkout 间复用同时保留证据驱动规划、禁止修改文件和 Git、禁止外部服务、禁止扩大授权、禁止递归委派五项不变约束。2026-08-31 等待提示在 2026-08-31-planner-latency-description.md 中仅更新description字段提醒调用方高推理配置的 planner 需要较长响应时间避免父 Agent 因短暂无输出而提前终止或重复启动developer_instructions、model、model_reasoning_effort和sandbox_mode全部保持不变。该记录还明确了一个职责划分原则description用于 Codex 选择和启动 agent 时的角色提示负责表达响应特征与调用注意事项developer_instructions用于定义 agent 自身行为不负责控制父 Agent 的等待策略——因此描述中刻意不写入gpt-5.6-luna等具体主模型名避免主模型调整后产生过时的比较。触发与回退规则把何时委派写进每个任务都会读取的文档仅有 TOML 配置还不够——Agent 只有在知道何时启动 planner时才会真正使用它。本方案将触发规则放入了每个任务都会读取的仓库指南docs/agents/repository-guide.md以保证规则的稳定可见性触发条件对定义明确的非简单 planning强制启动并等待planner简单任务排除简单 planning 不启动高成本模型避免对简单任务也启动高成本模型的资源浪费这是执行计划中列明的首要风险与缓解措施等待行为主 Agent 必须等待 planner 产出建议而不是抢跑或边等边改主 Agent 责任planner 只提供建议最终决策与最终方案交付仍由掌握用户上下文的父会话主 Agent 负责。回退与静默替换禁令执行计划 2026-08-23-planning-subagent.md 的风险与缓解明确处理了两类降级风险风险缓解措施简单任务也被启动高成本模型只对定义明确的非简单 planning 强制触发默认只启动一个planner模型、effort 或 custom agent 不可用时静默降级禁止静默替换按用户是否将精确配置设为硬性条件决定报告降级还是阻塞父会话实时权限覆盖 custom agent 的 sandbox 默认值同时在仓库规则和developer_instructions中禁止 planning 写入禁止静默替换是其中最关键的一条如果gpt-5.6-sol或xhigh不可用就悄悄换成其他模型会让调用方产生错误的能力声明。规则要求要么明确报告降级要么阻塞等待用户决定二者取决于用户是否把精确配置视为硬性条件。权限与编排边界父会话权限不能突破 sandbox本方案在 Agent 集成文档docs/agents/skills.md中额外定义了 custom agent 的调用语义与权限边界核心是一条容易被忽视的安全原则父会话的实时权限覆盖override不能突破 custom agent 的 sandbox 默认值、扩大写入范围。也就是说即使父 Agent 会话拥有写入权限也不得用该权限顺便让只读的 planner 去改文件。这个约束在配置sandbox_mode与文档只读规则两个层面同时表达形成双保险——因为执行计划明确记录sandbox_mode本身不能代替文档中的只读规则反之亦然。文档层面的规则还包括子代理不能扩大用户授权或任务模式禁止递归委派planner 不能再启动其他子代理等价显式覆盖与回退语义必须在文档中明确定义不允许含糊处理。验证方法不开箱、不改产品代码的静态验证该任务是一个纯Agent 文档 TOML 配置变更没有触碰任何产品源码、测试或 Xcode 工程元数据因此验证完全采用静态手段这也是验证章节强调未运行xcodebuild的原因——没有产品代码变更运行构建既无必要也无法证明配置正确性TOML 解析断言使用 Python 标准库tomllib解析.codex/agents/planner.toml断言planner固定为gpt-5.6-sol、xhigh与只读配置从语法与字段两个层面证明配置可被 Codex 正确加载针对性rg扫描确认触发、回退、只读和禁止静默替换规则存在于对应文档中且没有引入全局模型默认防止方案悄悄污染其他子代理静态复核确认简单 planning 排除规则、主 Agent 最终责任、禁止递归委派边界完整git diff --check检查文本差异没有尾随空白等格式问题链接与范围检查在后续迁移任务中还补充了活动文档失效引用扫描、Markdown 相对链接检查与精确变更范围复核。这套配置解析 规则扫描 差异检查的组合是仓库中面向 Agent 治理类任务的标准验证范式不伪装成 runtime smoke test但足以证明配置可解析、规则已就位、变更无副作用。方案的落地档案与后续演进脉络该方案的完整证据链在仓库中按执行计划 历史记录双轨归档执行计划docs/exec-plans/completed/2026-08/2026-08-23-planning-subagent.md 记录了任务契约、允许动作、允许修改路径、验收标准、输入来源、范围、风险与缓解、里程碑与决策记录是理解本方案设计取舍的第一手材料历史记录docs/histories/2026-08/2026-08-23-planning-subagent.md 即本文主体给出了用户请求、变更、设计意图、验证与受影响文件的浓缩版。该方案在 2026-08-27 又经历了一次启动入口迁移见 2026-08-27-planning-agent-entry.mdPlanning 委派契约被集中到docs/agents/request-boundary.mdAGENTS.md改为直接区分 Planning 子代理、具体 Skill 与 Easydict 专属路由planner.toml 的描述泛化到所有 planning 任务职责混杂的docs/agents/skills.md在迁移其有效规则后删除。需要提醒读者的是仓库的 Agent 治理文档持续演进当前 AGENTS.md 已采用计划模式 / 执行模式双模式路由docs/agents/目录下现存的 skills.md 主题已转变为外部 Skill 资产管理因此在引用本文所述的planner.toml或request-boundary.md时应将其视为特定时间点2026-08的历史方案快照当前仓库的实际 Agent 行为以根 AGENTS.md 为准。总结从本方案可以复用的四条经验用项目级 custom agent 隔离高成本能力需要高模型 高强度推理的场景用.codex/agents/name.toml精准声明不碰全局默认变更面最小模型、effort、只读三者独立且显式精确模型 ID 单独固定、xhigh独立成项、sandbox_mode与指令双重只读任一维度都可通过tomllib断言验证触发规则写在每个任务都会读取的文档里只对非简单 planning 触发、显式排除简单任务、主 Agent 等待并核验把资源消耗与决策权分配写清楚禁止静默降级、禁止递归委派、父权限不得突破 sandbox这三条权限边界是防止配置漂移 能力谎报 权限蔓延的最小必要约束。赞分享桌面应用AI 应用【免费下载链接】Easydict一个简洁优雅的词典翻译 macOS App。开箱即用支持离线 OCR 识别支持有道词典 苹果系统词典 苹果系统翻译OpenAIGeminiDeepLGoogleBing腾讯百度阿里小牛彩云和火山翻译。A concise and elegant Dictionary and Translator macOS App for looking up words and translating text.项目地址https://gitcode.com/gh_mirrors/ea/Easydict点击查看免费下载相关推荐Easydict 仓库的 Planning 子代理编排实践只读 planner 的配置、触发规则与验证方法Easydict 仓库的 Planning 子代理编排实践只读 planner 的配置、触发规则与验证方法 导读 本文基于 Easydict 仓库中已归档的执桌面应用AI 应用Easydict Agent 规则职责拆分与 Planning 只读边界移植实践Easydict Agent 规则职责拆分与 Planning 只读边界移植实践 Easydict 仓库通过一次代号为 agent rule structure桌面应用AI 应用Easydict 仓库 code-simplifier Skill 解读Electron/TypeScript 代码简化的专项规则与实践Easydict 仓库 code simplifier Skill 解读Electron/TypeScript 代码简化的专项规则与实践 导读 本文基于 Ea桌面应用AI 应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
