# 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 不属于当前阶段。

## 实际运行顺序

```powershell
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 使任务“看起来完成”。

## 文档

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