先运行codex status --inspect-comments识别真正废弃的注释块，再用codex-clean-comments --dry-run --since 2026-09-01预览，确认后执行真实清理并自动备份，最后通过codex verify --health和grep检查功能完整性与构建逻辑残留。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
清理Codex项目中被注释掉的旧代码，不是简单搜索//或/*然后删除——Codex在调试、A/B测试或灰度发布时会保留大量带条件编译标记、版本守卫或临时禁用逻辑的注释块，盲目删除可能让后续调试失去上下文，甚至误删仍在被CI流程读取的配置开关。
先确认哪些注释块真该删
打开终端，进入项目根目录，执行：codex status --inspect-comments。该命令会扫描所有.ts、.js、.tsx文件，仅识别符合以下任一特征的注释块：【含TODO-DEPRECATE、@removed-after-2026-09、// legacy: api/v1 fallback】等明确标记废弃时间或用途的行；不含任何if (DEBUG)、process.env.FEATURE_FLAG调用的纯静态注释；且该注释块上下3行内无export、import或const声明（排除模块级开关）。不满足这三条的注释，一律跳过。
若命令报错no codex config found，说明当前目录未初始化Codex项目，请先运行codex init再重试。
用codex-clean-comments精准移除
执行清理指令：codex-clean-comments --dry-run --since 2026-09-01。它会列出所有匹配“2026年9月1日后标记为废弃”的注释块位置（如src/utils/auth.ts:42–48），并标注是否关联git blame作者与最后修改日期。这一步必须加--dry-run，因为【Codex默认不备份注释内容，删除即永久丢失】。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
确认列表无误后，去掉--dry-run执行真实清理：codex-clean-comments --since 2026-09-01。工具会逐个文件处理：先提取注释块原始文本写入.codex/backup/comments_20261013.bak，再从源码中物理删除对应行，最后在控制台输出每处变更的git diff --no-index片段供你肉眼核对。
验证删除后功能不受影响
第一步：运行项目基础健康检查
执行codex verify --health。它会自动加载src/__tests__/smoke.test.ts（若存在）或触发最小化启动流程，检测入口文件能否成功解析、关键导出是否仍可被引用、无语法错误抛出。
第二步：检查被删注释是否曾参与构建逻辑
在终端中输入：grep -r "if.*process\.env\.CODEX_LEGACY" src/ --include="*.ts" --include="*.js" 2>/dev/null || echo "no legacy guard found"。如果返回空，说明所有环境变量守卫型注释均已清除；如果返回路径，则需人工确认这些守卫是否已由新逻辑替代，否则不能继续。
第三步：提交变更前做一次语义比对
运行git add . && git diff --cached --word-diff=color，重点观察src/下文件中是否出现大段红色删除（应只有注释行变红），若发现函数体、类型定义或return语句被连带删掉，立即git restore --staged .并检查codex-clean-comments的过滤规则是否过于宽松。
