CM95/AGENTS.md

Codex / AI Agent 项目规则

当前目标

第一阶段已经具备 CM93 → MySQL 完整导入与审计代码。当前工作是用真实 CM93JAPAN 数据运行、诊断和修复实际兼容问题。

不要提前实现 PBF。

固定基线

• Windows 11
• Python 3.12.10
• MySQL 5.7.34-log
• CM93 根目录：D:\Ship\CM93V2\CM93JAPAN
• DB Schema：sql/001_schema_mysql57.sql

不可破坏规则

1. 禁止 MySQL 8 专用 SQL。
2. 禁止 float32 存最终经纬度。
3. 禁止 importer simplify/snap/quantize/round geometry。
4. 禁止自动 make_valid 后覆盖原 Polygon。
5. raw decoded tables、raw feature、raw attribute 必须可保留。
6. _wgsox/_wgsoy 必须保存。
7. 每个 feature 必须可追溯 dataset/cell/source_record_index。
8. 未知 object/attribute 不得静默跳过；无法确定长度时 cell 必须 FAILED。
9. parser 任一 header/count/EOF 不一致时 cell 必须 FAILED。
10. 每个 cell 独立事务；失败不得破坏其他 DONE cell。
11. DONE cell 支持续导跳过。
12. 不复制 OpenCPN GPL 源文件或类实现；保持独立实现。
13. PBF 不属于当前阶段。

实际运行顺序

cm93db env-check
cm93db db-check
cm93db scan
cm93db inspect-dicts
cm93db import --scale G --limit 10
cm93db audit --scale G --limit 10 --precision-samples 32

Pilot PASS 后再全量。

修复要求

发现失败时，优先保留一个具体失败 cell 作为回归输入，并报告：

• cell 路径
• parser stage
• byte position/record index
• header source counts
• 实际异常
• 修改前后审计结果

不得通过 catch-and-skip 使任务“看起来完成”。

文档

项目说明、报告、设计记录使用中文；代码稳定标识符、数据库字段使用英文。