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.

docs/user-guide/index.md

@@ -0,0 +1,17 @@
+# 用户指南
+
+这里收的是稳定规则，不放临时笔记。
+
+## 你最可能要看的内容
+
+- [环编号系统](ring-numbering.md)
+
+## 这个目录的边界
+
+- 这里只描述公开、可复用、会长期维持的行为。
+- 所有编号说明都以 canonical numbering 为准。
+- 如果文献图里用的是反向标注，先把它转换成镜像映射，再和代码结果对照。
+
+## 一句话约定
+
+这套工具没有 `clockwise` / `anticlockwise` 开关，编号方向不靠参数切换。