Files
macrolactone-toolkit/docs/index.md
lingyuzeng 3e07402f4e feat(numbering): publish canonical numbering API
Add a public numbering module and route fragmenting, validation,
and scaffold preparation through the canonical numbering entry.

Rewrite the repository entry docs around the fixed numbering
contract, add MkDocs landing pages, and document the mirror
mapping used for medicinal-chemistry comparisons.

Also refresh the validation analysis reports to explain the
canonical-versus-mirrored numbering relationship.
2026-03-20 15:14:31 +08:00

30 lines
1.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 文档首页
这里是文档入口。先按你要解决的问题选路,不要一开始就翻完整套材料。
## 快速路径
- 想先跑起来: [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)。