历史版本资料
本页记录旧版本当时的设计、操作或验证事实,不是 V7.17.3 当前使用说明。请从文档中心进入当前规范。
V6.2 Windows 实机兼容固化版¶
V6.2 基于 V6.1,并将 Windows 原生 Codex CLI 0.150.1 实机升级与生命周期验收中发现、修复并验证的兼容问题正式纳入发行包。V6.2 不是仅修改版本号的重新打包。
主要变化¶
- 六个 Windows Hook 统一通过 quote-free
cmd.exe /d /c %PLUGIN_ROOT%\hooks\cp_hook.cmd <HookName>启动,规避 Codex 0.150.1 对带引号 Hook 命令的解析问题。 cp_hook.cmd优先寻找本机账户 CPython,再回退 PATH 中的python.exe或py.exe -3;不创建、也无需额外创建python3.exe。- Hook 使用原始字节读取 stdin,并以 UTF-8 输出;兼容 Windows 中文 Stop payload 截断,仍能恢复生命周期身份字段并返回合法中性 JSON
{}。 - 观测写入失败保持 fail-open;PreToolUse 模型门禁保持 fail-closed。
- 自动子 Agent 显式模型采用精确 allowlist,仅允许
gpt-5.6-luna与gpt-5.6-terra;xhigh/max/ultra、Sol、未知模型和未来 Terra 名称均拒绝自动派发。 - 安装器原子 staging 名称缩短,并在备份、复制、验证、卸载和回滚 I/O 边界统一使用 Windows extended-length path;长账户目录下连续安装、升级备份与恢复不再受 legacy MAX_PATH 限制。
- 卸载
AGENTS.md与 standalonehooks.json时只恢复本包受管区块/精确命令 Hook,保留安装期间新增或修改的外部内容;畸形现有配置失败关闭且不覆盖。 - Windows 安装测试同时隔离
HOME与USERPROFILE,使用 fakecodex.cmd、超长目录和无需管理员权限的 Junction 测试升级恢复与 Reparse Point 防护。 - 自然语言说明、规则、Reviewer 提示和测试身份统一采用中性表达;CLI 参数、JSON 字段和路径变量等机器契约不变。
保持不变¶
- 10 个工程 Skills、7 个专业 Reviewer、6 个生命周期 Hooks。
- TaskOutcomeEvent V2、SHA-256 事件链、
project_id + repo_fingerprint双重项目隔离。 - Luna Low → Luna Medium → Terra Medium → Terra High 自动成本路线,自动上限 Terra High。
- 主 Agent 模型保持外部选择;Reviewer TOML 不写死模型。
execution_authorization=NONE;Proposal 不自动接受、执行或修改 Skill。- 不自动提交、推送、部署、重启、写生产数据或操作生产环境。
- 安装事务的 dry-run、备份、漂移检测、回滚和未知外部文件保护。
兼容性¶
- 目标宿主:Windows 原生 Codex CLI 0.150.1。
- 支持从 V6.1、V6.0 及 manifest 中列出的旧版本升级。
- V6.1 项目上下文、Event、Snapshot、Assessment、Proposal、Decision 和生命周期记录继续复用,不执行迁移或删除。
- Plugin 成功标准仍为
codex plugin list --json中目标项同时满足installed=true、enabled=true、version=6.2.0。
升级提示¶
- 解压 ZIP,不要直接在 ZIP 内运行。
- 执行
doctor和 Plugin dry-run。 - dry-run 无阻断后执行账户级 Plugin 安装。
- 执行
verify和codex plugin list --json。 - 关闭并重新打开升级前已经存在的 Codex 任务。
完整步骤见 docs/USER_GUIDE_V6.2.md。