[CLI agent (Claude Code 等)]   ← 智能/编排：读题拆题、选知识点、挑章节、判难度（"算"在这）
      │ stdio（MCP）
[teacher-mcp]                  ← 确定性代理：登录注入身份 + 双底座 HTTP + 转换/查表；零 LLM
      │                          ├─ backends/ruoyi.py   → book-server :9090（envelope+clientid，401 自动重登一次）
      │                          ├─ backends/toolkit.py → toolkit :9093（FastAPI，举一反三引擎，ruoyi_token 注入）
      │                          └─ backends/db.py      → MySQL :3307（pymysql 收口，挂账：对外开放前 HTTP 化）
[平台]                          ← 业务事实库 + book-ui 展示（老师视觉验收）

# 依赖（独立 venv）
uv venv; uv pip install --python .venv\Scripts\python.exe -e . --group dev
copy .env.example .env   # 填 RUOYI_USERNAME/PASSWORD（不入 git）

# 测试（gate 全套；G3/G4/G6 基线/G7 需 BE:9090 在跑，G4 另需 toolkit:9093）
.venv\Scripts\python.exe -m pytest tests -q
# 变式链冒烟（不落库，到 compose-figure）
.venv\Scripts\python.exe scripts\smoke_variant.py

{
  "mcpServers": {
    "prep-assistant":    { "command": "<本仓>\\.venv\\Scripts\\python.exe", "args": ["-m", "teacher_mcp.server"],
      "env": { "PYTHONPATH": "<本仓>\\src", "TEACHER_MCP_ROLE": "prep",    "RUOYI_USERNAME": "…", "RUOYI_PASSWORD": "…" } },
    "qbank-assistant":   { "同上，TEACHER_MCP_ROLE": "data（或旧值 ingest）" },
    "lecture-assistant": { "同上，TEACHER_MCP_ROLE": "data（或旧值 lecture）" },
    "variant-assistant": { "同上，TEACHER_MCP_ROLE": "variant" }
  }
}