wunianxiao
25dd0daa8b
- 所有 Rust crate 统一加 ias- 前缀：ai → ias-ai、common → ias-common、context → ias-context、mail → ias-mail、service → ias-service、wechat → ias-wechat - 新增 ias-main 模块承载 CLI 入口和二进制打包 - 各模块开始独立维护版本号，ias-main 0.1.7 代表整体版本 - 新增 IA_WEB_INTERNAL_URL 环境变量，版本通知同时发送公网和内网链接 - 将已有升级日志翻译为中文 - ias_upgrade_logs 新增 modules JSONB 字段 - 新增 VERSION 文件和 CHANGELOG.md - 新增 AGENTS.md 项目规则文件
20 lines
1.2 KiB
Markdown
20 lines
1.2 KiB
Markdown
# 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` 的版本、日期和变更要保持一致。
|
|
- 升级日志应使用中文撰写，记录用户可感知变化、数据库迁移、配置项变化和关键验证结果。
|
|
- 纯讨论、方案设计或没有落地文件变更的代码审查，不需要升级版本。
|