# AGENTS.md

primary use Chinese!!!

## Codex 规则位置

- 项目级规则写在 Codex 实际会读取的指令文件里；本仓库使用根目录 `AGENTS.md`。
- 如果以后新增更深层目录的 `AGENTS.md`，并且 Codex 会在对应上下文读取它，相关局部规则要写在那个目录的 `AGENTS.md`。

## 版本与升级日志

- 每个模块独立维护版本号，记录在各自 `Cargo.toml` 的 `package.version`。
- `ias-main` 的版本号代表整体项目版本，记录在根目录 `VERSION`。
- 每次完成代码或行为变更，必须更新受影响模块的版本号；如果 `ias-main` 也受影响，同步更新 `VERSION`。
- 同步更新 `CHANGELOG.md`，并通过 `service/migrations` 将升级记录写入 `ias_upgrade_logs`。
- `ias_upgrade_logs` 的 `version` 对应 `ias-main` 整体版本，`modules` JSONB 字段记录各模块版本。
- `CHANGELOG.md` 与 `ias_upgrade_logs` 的版本、日期和变更要保持一致。
- 升级日志应使用中文撰写，记录用户可感知变化、数据库迁移、配置项变化和关键验证结果。
- 纯讨论、方案设计或没有落地文件变更的代码审查，不需要升级版本。