flowchart TD
    A[CLI / REST / MCP / SDK / Playground] --> B[AcademicCopilotFacade]
    B --> C[Copilot: 意图识别]
    B --> D[Planner + What-if]
    C --> E[DecisionContext + RuleEngine]
    D --> E
    E --> F[AuditSnapshot + 五层证据链]
    F --> G[Repository 层]
    G --> H[Knowledge / Rule / Ontology]
    H --> I[Compiler: PDF → AST → IR → plan JSON]

cd academic-copilot-framework/packages/ade

# 1. 构建知识库（5 个专业）
python -m compiler.cli knowledge build --verify

# 2. 健康检查（版本 / Hash / 知识库 / 规则 / Ontology / Benchmark / Replay）
python -m compiler.cli doctor

cd academic-copilot-framework/examples
python 01_basic_status.py     # Student → Audit → Response
python 02_risk.py             # 毕业风险评估
python 03_plan.py             # 补修计划
python 04_what_if.py          # 补修课程 → 重新判定

.
├── academic-copilot-framework/   # ADE 学业决策引擎
│   ├── packages/ade/             #   核心：compiler/knowledge/rule/decision/
│   │                             #         audit/matcher/copilot/planner/simulation
│   ├── validation/               #   验证工作区：golden cases + benchmark
│   ├── docs/                     #   架构 / API / ADR / 图
│   ├── examples/                 #   8 个可运行示例
│   ├── demo/                     #   开箱即用的演示学生
│   ├── playground/               #   交互式 Playground
│   ├── benchmark/                #   Benchmark 可视化
│   ├── plugins/                  #   插件 SDK（Notification/Rule/Planner/Matcher）
│   ├── installer/                #   Windows 安装器脚手架
│   └── paper/                    #   学术论文
├── gdmu_mcp/ server.py           # 正方教务 MCP 桥
└── docs/                         # 逆向与教务系统分析文档

cd academic-copilot-framework/packages/ade && python -m pytest tests -q   # 426 tests
cd academic-copilot-framework/validation && python -m pytest tests -q     # 241 tests