用途:审查指定 Git 仓库、指定范围内的提交,由 Agent 逐 commit 评估风险,最终产出可视化安全审查报告。
主要能力:流程为 resolve → collect_commits → agent_review(TO_AGENT) → aggregate → export_html。agent_review 为 TO_AGENT 节点,跑到该节点退出进程后由 Agent 介入;aggregate 做纯 Python 双索引聚合(作者风险榜 + commit 风险明细),产出 aggregate.json 与 process.md;export_html 渲染 security_report.html 并自动弹出浏览器。
使用方式:依赖 pip install esflow。示例:python3 scripts/run.py --repo /path/to/repo --scope 2026-05-01..2026-05-07;--scope 也支持分支范围 main..dev 或单分支 main。首跑到 agent_review 退出(exit 2)后,Agent 读 vigil_md 与 commits,按规则逐 commit 评估并写 review.json,再执行 python3 scripts/run.py --resume <job_dir> 续跑聚合与 HTML。report 路径见 stdout envelope 的 data.report(绝对路径)。可选参数包括 --out、--max-count、--no-open、--dry-run、--schema;退出码 0 ok / 1 runtime / 2 to_agent / 3 validation / 4 auth。
限制:review.json 由 Agent 生成,框架严格校验字段,必填 hash/author/risk_level/risk_summary/files/fix_suggestion,可选 time/subject/cause;risk_level 只能 P0-P5,files 元素格式 path:起-止。默认 output_root 为 /tmp/esflow/outputs,自动清理,需长期保留用 --out 指定持久目录;--resume 依赖 job_dir 存活。审查代码只读,不修改被审查业务代码;每次跑用独立 job_id,不覆盖历史报告。agent_review 节点执行前必须读 assets/vigil.md。缺失信息:官方文本暂未提供。