AI 开发日志

ai-dev/logs/ 是执行过程的证据层。Plan 定义"做什么"，Log 记录"实际做了什么、验证结果"。

它不是 source of truth。规范性文档在 docs-for-ai/ 和 ai-dev/design/。

编写规范见 ai-dev/logs/00-log-writing-guide.md。

结构

ai-dev/logs/
├── index.md
├── 00-log-writing-guide.md
└── 2026/
    ├── 05-25.md
    ├── 05-24.md
    ├── 05-23.md
    ├── 05-22.md
    ├── 05-21.md
    ├── 05-20.md
    ├── 05-19.md
    ├── 05-18.md
    ├── 05-17.md
    ├── 05-15.md
    ├── 05-11.md
    ├── 05-09.md
    ├── 05-08.md
    ├── 05-07.md
    ├── 05-05.md
    ├── 05-03.md
    ├── 05-02.md
    ├── 04-22.md
    ├── 04-19.md
    ├── 04-14.md
    ├── 04-10.md
    └── 04-09.md

路径约定：ai-dev/logs/{year}/{month}-{day}.md

写作规则

1. 一天一个文件。
2. 新条目追加在文件顶部，按倒序记录。
3. 保持简短，优先链接 docs-for-ai/、ai-dev/plans/ 或相关代码路径。
4. 日志只记录短期上下文、关键决策和下一步，不复制 canonical doc 内容。
5. 如果变更已经改变默认规则，先更新 docs-for-ai/，再写日志。

条目模板

# AI 开发日志 — YYYY-MM-DD

### YYYY-MM-DD

- 做了什么。
- 相关路径：`docs-for-ai/...`、`ai-dev/plans/...`、`module/...`
- 关键决策：...
- 下一步：...

索引（倒序）

2026-05

• 05-31 — 全仓 i18n-en:* 英文显示名修复完成，_dump/ 调试输出规则补齐，checker 全绿

• 05-25 —

• 05-24 — Plan 47 nop-stream 分布式执行路径接线完成

• 05-23 — Plan 42 nop-stream 设计实现 Phase 0-6 模型层（869 测试全通过）

• 05-22 — Plan 39 nop-stream 统一执行路径完成（快速路径删除）

• 05-21 — nop-message-pulsar 实现完成

• 05-20 — Plan 30 nop-stream 审计发现修复全部完成；nop-nosql 深度审计

• 05-19 — Plan 21 nop-job Adversarial Review Remediation 完成

• 05-18 — nop-job 深度审核完成 + 并发模式文档化

• 05-17 — Plan 17 nop-job 阻塞策略+Metrics 全部完成（RECOVERY策略+三套Metrics+Schedule聚合+限流设计文档）；吸引子层治理：ai-dev/design/README.md 新增；Plan 15 完成+Plan 16 迁移+Plan 17 新建；文档治理

• 05-15 — 修复 OrmEntityCopier inline 主子表复制时子表 autoExpr 读取主实体为 null 的时序问题，并补 AutoExprRunner scope 隔离回归测试

• 05-11 — Plan 14 nop-job 质量优化：TimeoutChecker N+1 批量预加载、Planner 锁冲突 Micrometer counter + DEBUG 日志、ErrorCode 规范化（5 个新定义）、LocalJobScheduler @Deprecated 标记

• 05-09 — 微调 GRC 结合律技术报告，前置澄清 carrier、潜在空间与 replace/remove 的证明边界，并补研究文档与开发规范的入口边界

• 05-08 — 修订 GRC paper 的 P1 审查问题，将附录 D/G 与潜在结构空间、终端投影和 stable-key children 证明边界对齐

• 05-07 — 新增《广义可逆计算》论文评价与 GRC 差量合并结合律形式化证明，使用多轮子 agent 审核收敛核心 LWW、局部幺半群和统一端函数三层证明边界

• 05-05 — SpotBugs findings 详细分析文档：nop-kernel 6 子模块 40 个 findings 源码级验证（3 true positive / 2 false positive / 35 design choice）

• 05-03 — SpotBugs 排除规则扩展、PMD 升级 3.28.0、nop-kernel qa profile、设计文档更新

• 05-02 — nop-code 多语言代码索引设计：nop-java-parser 精简为适配器，新增 nop-code-core 通用模型+分析算法，新增三个语言适配器子模块（Java/Python/TypeScript），tree-sitter NG 确认可用

2026-04

• 04-22 — relation writeMode 元数据链路打通：补齐 schema.xdef/obj-schema.xdef 共享定义、刷新 nop-xlang 生成结果，并为 nop-biz 增加 writeMode 校验测试
• 04-19 — relation writeMode 设计收敛：以 ObjMeta 读写对称性和同构 relation payload 为核心，确认 OrmEntityCopier 为 prop-level routing 主落点，去除 action-style relation op 表述
• 04-14 — 仅在 nop-ai-agent/docs/ 内拆分 Agent 设计草稿，保留原大文档不动，收敛为总览 / 运行时 / 扩展 / 可靠性 / 路线图五篇专题文档
• 04-10 — 复核 docs-for-ai 审查意见，修正路由缺口、DTO 规则、CRUD hook / QueryBean 指南，并补充 XLang/XPL 基础文档
• 04-09 — docs-for-ai 重构收口、自动维护规则、ai-dev/logs 机制建立