用途:同步 openai/codex 的持久本地克隆,产出最新稳定(非预发布)标签之后未发布功能与重要改进的详尽摘要。主要证据来自定义功能阶段与用户可见元数据的源码文件,提交/PR 分析仅作辅助。
主要能力:每次运行先执行 gh auth status,未认证则失败关闭;解析本地克隆路径(默认 $CODEX_HOME/repos/<owner>-<repo>,回退 ~/.codex/repos/<owner>-<repo>,可用 --local-repo 覆盖),缺失则从 GitHub 克隆;每次运行同步(git fetch --tags --prune origin、检出默认分支、git pull --ff-only)。挖掘指定源码文件(如 codex-rs/core/src/features.rs、chatwidget.rs、codex.rs、codex_message_processor.rs、protocol/v2.rs、ExperimentalFeatureListResponse.json、app-server/README.md、tooltips.rs、announcement_tip.toml),缺失则失败关闭。从 features.rs 提取 Stage::Experimental 与 Stage::UnderDevelopment 的 name、menu_description、announcement;记录 git rev-parse HEAD;解析默认分支与最新稳定标签,计算 stable_tag..origin/default_branch 范围,将提交分类为 feature 或 notable_improvement,排除文档/杂项/测试类。输出含 UTC 时间、本地路径、提交 SHA、基线标签、比较链接、挖掘文件、源码功能列表、跨文件证据与逐项链接。
使用方式:uv run python scripts/summarize_upcoming.py --repo openai/codex;JSON 输出加 --output json;可用 --base-tag 覆盖基线、--local-repo 覆盖克隆路径。
限制:源码数据与提交文本冲突时以源码为准;不从开放 issue/PR 推断路线图;API/认证/限流失败时失败关闭;本地 origin 不匹配则失败关闭;修改过滤行为前需阅读 references/classification-rules.md。