src/regs_mcp/
├── core/        领域模型与引用强制规则（不依赖 MCP/LLM/DB）
├── retrieval/   数据持久化与混合检索（SQLite + 纯 Python 打分，零外部依赖）
├── llm/         OpenAI 兼容 LLM 客户端 + 离线 mock 兜底
├── qa/          问答管线（检索→草稿→引用校验→结构化）
├── ingest/      种子数据加载
├── mcp/         MCP 适配层（regs-knowledge 智能核）
├── feishu/      飞书适配器（规划）
└── eval/        评测集 + 指标

cd vehicle-regs-mcp
python -m venv .venv && . .venv/Scripts/activate
pip install -e ".[dev]"

# 灌入种子数据
PYTHONPATH=src python -c "from regs_mcp.ingest.loader import load_seed; \
from regs_mcp.retrieval.store import RegulationStore; \
s=RegulationStore('data/regs.db'); print(load_seed(s, 'data/seed'))"

# 评测（离线可跑，无需任何 API key）
PYTHONPATH=src python -m regs_mcp.eval.run

# 测试
pytest

# 启动 MCP 服务（Streamable HTTP）
PYTHONPATH=src python -m regs_mcp.mcp.server

export REGS_LLM_BASE_URL=http://<endpoint>/v1
export REGS_LLM_API_KEY=<token>
export REGS_LLM_MODEL=<model>
export REGS_LLM_MOCK=0