codex在十万行java微服务中因258k token上限触发语义压缩，导致幻觉；需按模块隔离会话、加载agents.md基线约束、预处理超长文件，并在重构中分四步实施上下文保鲜。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在开发十万行级Java微服务项目时，Codex频繁出现上下文截断、关键函数引用丢失、重构偏离架构规范等问题，直接影响模块交付节奏和Code Review通过率。
理解Codex上下文窗口的真实限制
Codex并非拥有无限记忆，其会话窗口存在硬性token上限，当前主流部署版本默认为258K tokens。当会话中累计输入+输出超过该阈值，系统将自动触发背景压缩（Context Compression）——不是简单删除末尾内容，而是对语义块进行抽象降维，例如把“UserServiceImpl.java中第142行的findByPhone方法调用RedisTemplate执行缓存穿透防护”压缩为“用户服务→查手机号→缓存”。【这种压缩不可逆，且极易引发AI幻觉】。一旦发生，后续所有关于该方法的修改请求都会指向错误位置或生成不兼容逻辑。
验证是否已触发压缩：在任意新请求后观察响应开头是否出现“根据之前讨论…”“如前所述…”等模糊指代，而非精确引用文件名、行号或变量名。
大型项目必须启用的上下文隔离策略
方法一：按功能域切分会话，禁止跨模块混用
每个核心模块（如订单中心、支付网关、风控引擎）单独开启独立Codex会话，会话ID命名规则为projectname-module-v2。每次启动前先执行codex --load-context ./context/order-center.md加载该模块专属上下文摘要。
方法二：强制注入AGENTS.md作为会话基线
在项目根目录创建AGENTS.md，写入：
```markdown
## 项目约束
- 技术栈：Spring Boot 3.3 + MyBatis-Plus 4.3
- 禁止修改：/config/、/common/exception/、/domain/entity/BaseEntity.java
- 必须遵守：DTO与VO严格分离，所有接口返回Result
## 验证方式
- 修改后必须运行：mvn test -Dtest=OrderServiceTest#testPlaceOrderWithCoupon
- 格式检查：./gradlew spotbugsMain
```
启动Codex时添加参数--auto-load-agents，确保每次会话自动读取并锁定该文件内容。
方法三：对超长文件实施主动截断预处理
遇到单文件超8000行（如LegacyOrderProcessor.java），不直接丢给Codex。先用脚本提取关键片段：sed -n '1,50p; /public class LegacyOrderProcessor/,/^}/p' LegacyOrderProcessor.java > LegacyOrderProcessor.keyparts.java
再将.keyparts.java作为上下文输入。这一步跳过无关注释和重复工具方法，【避免Codex因注意力稀释而忽略核心分支逻辑】。
重构阶段的上下文保鲜操作流
第一步：执行规划阶段隔离
向Codex发送指令：“Act as orchestrator. List all files that must be modified to extract PaymentService into separate module. Do not write code. Output only absolute paths, one per line.”
第二步：人工审核路径清单
检查输出是否包含非目标文件（如误列/config/application.yml），剔除后保存为payment-refactor-scope.txt。
第三步：构建最小化上下文包
执行：tar -cf payment-context.tar $(cat payment-refactor-scope.txt) AGENTS.md
然后启动新会话：codex --context payment-context.tar --mode plan
第四步：执行阶段绑定沙箱路径
确认规划无误后，切换至执行模式：codex --context payment-context.tar --sandbox ./modules/payment/ --approval required
此时Codex仅能读写./modules/payment/内文件，且每条写入命令需人工确认。
