# 文档首页

这里是文档入口。先按你要解决的问题选路，不要一开始就翻完整套材料。

## 快速路径

- 想先跑起来: [getting-started.md](getting-started.md)
- 想先确认编号规则: [user-guide/ring-numbering.md](user-guide/ring-numbering.md)
- 想先看仓库结构: [development/project-structure.md](development/project-structure.md)

## 入口约定

这个项目只使用一套 canonical numbering：

- `1 = 内酯羰基碳`
- `2 = 相邻酯氧`
- `3..N = 从 2 位出发沿环唯一图遍历顺序继续编号`

对 16 元环，镜像映射是固定的 `p_mirror = ring_size - p + 3`，因此 `6 → 13`、`7 → 12`、`15 → 4`、`16 → 3`。
公开 API 不支持 `clockwise` / `anticlockwise` 参数。

## 这套文档保留什么

- `README.md`: 渐进式入口
- `AGENTS.md`: 唯一权威 agent 入口
- `user-guide/`: 面向使用者的稳定规则
- `development/`: 面向维护者的结构说明

如果你只想开始干活，先看 [getting-started.md](getting-started.md)。