# 环编号系统

本项目只采用一套 canonical numbering。它是确定性的，不依赖 `clockwise` / `anticlockwise` 参数，也不是视觉上的方向切换。

## 规则

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

这条规则在代码、文档、测试和验证输出中都保持一致。

## 16 元环镜像映射

当你需要把代码里的 canonical numbering 转成文献里常见的反向标注时，使用：

```text
p_mirror = ring_size - p + 3
```

对 16 元环，这会得到：

- `3 → 16`
- `4 → 15`
- `5 → 14`
- `6 → 13`
- `7 → 12`
- `8 → 11`
- `9 → 10`
- `10 → 9`
- `11 → 8`
- `12 → 7`
- `13 → 6`
- `14 → 5`
- `15 → 4`
- `16 → 3`

常见对照点：

- `6 → 13`
- `7 → 12`
- `15 → 4`
- `16 → 3`

## 使用建议

- 先在代码和数据库里保留 canonical numbering。
- 只在图注、论文、汇报里按需要加镜像标签。
- 不要把方向差异实现成 API 参数。
- 如果分子是 bridge / fused multi-anchor，先把结构语义说明清楚，再讨论编号可视化。

## 最短结论

如果你在看代码，记 canonical numbering。
如果你在对照文献，记 `p_mirror = ring_size - p + 3`。