first commit

2026-03-09 16:31:42 +08:00
commit 4a9c444b10
486 changed files with 52479 additions and 0 deletions
@@ -0,0 +1,14 @@
+# Root docs migration note
+
+本目录为从项目根目录 `docs/` 迁移过来的文档快照（全量复制，不跳过）。
+
+目的：
+- 保留原始设计背景与历史规范，便于在 `sync_state_machine` 目录内就地查阅；
+- 与当前 `sync_state_machine/docs/` 的“现行实现文档”并存。
+
+使用建议：
+- 以 `sync_state_machine/docs/` 下现行文档（如 `state_machine.md`、`sync_flow.md`、`architecture.md`）作为运行时真义；
+- 本目录文档作为历史参考来源，遇到冲突时以现行实现与状态机配置为准：
+  - `sync_state_machine/config/node_state_machine.yaml`
+  - `sync_state_machine/sync_system/strategy.py`
+  - `sync_state_machine/engine/semantics.py`