基于冻结上游
f02aa690bbebb9cabeac30a553d737486b0eb661的 Aevatar 结构化中文解读。
本仓库不是 Aevatar 源码仓库，只产出中文 Markdown 文档。关于当前实���的论断以只读冻结快照为准；canon、ADR、issue 与生产观察分别承担设计、决策、演进和版本化证据，不能互相冒充代码事实。
- 14 个 block：
00–13。 - 72 篇实质章节，另有 14 个只承担导读与顺序的
index.md。 - 上游基线：
f02aa690bbebb9cabeac30a553d737486b0eb661。 - 核验日期：
2026-07-25。
完整清单见 PLAN.md，站点入口见 docs/index.md。
Node.js 22+ 环境可以把当前首页、14 个 block index 和 PLAN.md 中的 72 篇完成章节临时投影为 OpenWiki 关系图：
bash scripts/visualize-wiki.sh
# 只启动服务，不自动打开浏览器
bash scripts/visualize-wiki.sh --port 4400 --no-open脚本固定调用 openwiki@0.2.5 visualize，不运行文档生成 agent，不需要 LLM/API key，也不会在仓库内创建第二套 wiki。首次运行需要 npm 网络，浏览器页面还会从公共 CDN 加载前端库；进程退出后临时镜像自动删除。
| 目标 | 路线 |
|---|---|
| 第一次跑通并理解主线 | 00 导读 → 01 启动与请求 → 03 Workflow → 05 CQRS |
| 理解产品、集成与生产 | 06 产品资源 → 07 Conversation → 08 Channel → 09 Automation → 10 生产运行 |
| 实作、排障与审计 | 11 教程 → 12 演进与缺口 → 13 事实源索引 |
| 状态 | 含义 |
|---|---|
current |
冻结基线中的当前设计或��力 |
mixed |
主体当前有效，但明确隔离历史、生产版本证据或目标态 |
historical |
只保留长期设计教训，不作为现行使用指南 |
target |
尚未落地，只能作为缺口与退出条件阅读 |
bash scripts/tests/test-doc-checks.sh openwiki-adapter
AEVATAR_SRC=<frozen-f02aa690-archive> bash scripts/check-md.sh --all
python3 scripts/check-links.py --all
bash scripts/check-drift.sh
python3 scripts/check-mermaid.py
mkdocs build --strict --clean冻结快照可由 Git 对象生成，不读取上游 live working tree：
AEVATAR_SRC="$(bash scripts/materialize-frozen-upstream.sh --repo ~/Code/aevatar --sha f02aa690bbebb9cabeac30a553d737486b0eb661)"
export AEVATAR_SRC~/Code/aevatar是只读外部仓库；本项目不得修改它。- 当前事实、历史、目标态和生产版本化证据必须分层表达。
- 本解读仓库采用 CC-BY-4.0；引用源码片段的版权归原作者所有。