用途
watchdog-approvals 的核心用途是:当 Codex 反复对同一类安全动作(例如运行测试、读取日志、执行 git 操作)弹出审批确认时,把用户已经明确批准过的行为固化进 Codex 的审批配置,使下次执行同类动作不再反复弹窗,同时避免权限被放大到不可控范围。
其核心思想是只持久化“确定安全且高频”的动作,并使用最小化的 allowlist(可回滚、可审计)。
什么算“已批准”
仅指在当前会话中,用户对某一类操作明确说过“可以”“都授权”“以后别再问”或“加入 allowlist”。
不包括:
- 没有得到用户明确授权的高风险动作(删除、执行未知二进制、访问敏感目录等)
- 只做一次的临时动作(除非用户要求持久化)
Codex 审批配置位置
通常需要同时查看两处:
- 项目信任级别(Project trust level)
- 文件:
~/.codex/config.toml - 键:
[projects."<path>"] trust_level = "trusted" | "untrusted"
- 文件:
- 命令允许规则(Command allow rules)
- 文件:
~/.codex/rules/default.rules - 格式:
prefix_rule(pattern=[...], decision="allow") - 含义:当命令 argv 以 pattern 为前缀时,直接允许
- 文件:
这是用户机器上的安全边界配置,任何写入都必须可解释、可撤销、可最小化。
协作规则与安全纪律
写入审批配置前,必须做到:
- 先提案,后落盘:列出候选允许项清单(每条含用途、风险、范围),让用户逐条确认(YES/NO)。
- 最小化授权:优先 allowlist 仓库内固定脚本(例如
scripts/run_*.sh或scripts/run_*.ps1),不要直接 allowlist/bin/bash -lc <任意命令>;不要 allowlist 带用户输入参数的危险命令(例如rm -rf <path>),除非 path 是固定且安全的;避免全局路径(例如把/mnt/e/development设为 trusted 会覆盖太多仓库,优先 repo root)。 - 可回滚:修改前备份,例如
cp ~/.codex/rules/default.rules ~/.codex/rules/default.rules.bak、cp ~/.codex/config.toml ~/.codex/config.toml.bak;每次只加少量规则(1–5 条),验证通过再继续。 - 可验证:写入后立刻执行一次“原本会弹审批”的动作,确认已静默通过。
- 不伪造:不猜测用户想授权什么,只从用户明确批准过的行为提炼规则。
使用方式(工作流程)
第 1 步:会话中建立候选清单
当出现审批提示且用户批准时,立刻记录一条候选项:
- 动作名称(如“运行无头 Godot 测试”)
- 精确的命令 argv(更推荐引导改成固定脚本后再 allowlist 脚本)
- 范围(只允许本仓库?只允许某个固定参数组合?)
- 安全性理由(为什么这是安全、可控、高频的)
第 2 步:归一化为稳定的允许模式
按从安全到危险的优先级:
- allowlist
scripts/<fixed entrypoint>(强烈推荐) - allowlist
git push、git status这类低风险固定子命令 - allowlist 固定二进制加固定参数前缀(需要谨慎)
- 禁止
/bin/bash -lc "<anything>"(范围过大)
第 3 步:提案并逐条确认
以表格形式给用户逐条确认(YES/NO),例如:
- Candidate:Run tests
- Pattern:
["scripts/run_godot_tests.ps1"] - Why:CI-equivalent
- Risk:low
- Persist:YES
第 4 步:写入配置并验证
- 追加
prefix_rule(...)到~/.codex/rules/default.rules - 如需信任仓库,写入
~/.codex/config.toml的[projects."<repo-root>"] trust_level="trusted" - 运行一次验证命令(应不再弹审批)
执行清单
- 列出本次会话里重复出现的审批点(命令或行为)
- 对每个候选项写明:用途、风险、最小 pattern、是否可改成固定脚本
- 让用户逐条 YES/NO
- 备份配置文件:
cp ~/.codex/rules/default.rules ~/.codex/rules/default.rules.bak与cp ~/.codex/config.toml ~/.codex/config.toml.bak - 小步写入(1–5 条规则)
- 立刻验证一次“原本会弹审批”的动作
- 如果出现意外放权或误匹配,立刻回滚
.bak并重新收敛 pattern
需立即停止的危险信号
- “先全部设成 trusted 或 allow all,省事”
- “给
/bin/bash -lc做通配 allowlist” - “加一个
rm -rf *的规则” - “没让用户逐条确认就落盘”
安全模式示例
建议优先 allowlist 固定脚本,而不是 Godot 二进制本身:
- Windows:
scripts\run_godot_tests.ps1 - WSL/Linux:先封装一个
scripts/run_godot_tests_linux.sh(固定GODOT_LINUX_EXE),再 allowlist 这个脚本
适用场景与限制
适用于使用 Codex 并在会话中反复遇到同类安全操作审批提示、希望按最小权限原则固化审批的用户。该技能本身不负责判定动作是否安全,安全判断与逐条确认仍依赖用户;对未明确授权的操作不做持久化。官方页面暂未提供更详细的价格、平台支持或版本说明。