核心功能
dnd-dm 是一款专为龙与地下城（D&D 5e）设计的AI城主代理系统，采用三层架构实现叙事智能与游戏机制的彻底分离：
- LLM层（dnd-dm Skill）：负责场景描述、NPC对话、叙事生成，通过prompt驱动保持创造性优势
- API层（dnd-api）：FastAPI提供22个HTTP端点，标准化输入输出，支持Discord/Foundry等多平台接入
- 引擎层（dnd-engine）：纯Python实现，涵盖骰子、战斗检定、存档管理、SRD搜索等核心规则计算，零LLM依赖，90项pytest测试覆盖
显著优点
1. 规则权威性：严格遵循2024版D&D 5e规则，检定公式、AC/DC计算、伤害结算均由引擎层结构化返回，杜绝LLM"幻觉"导致的规则错误
2. 架构健壮性：分层设计确保"上层依赖下层，下层不依赖上层"，引擎层可独立运行，便于集成与扩展
3. 开发规范性：内置15条行为红线（禁止偏离模组、禁止放水、禁止混用世界观等），配合DM_DEV_GUIDE.md实现标准化开发
4. 渐进式体验：7阶段对话式角色创建、幕前自然语言引导+幕后场景缓存追踪，降低新玩家门槛
潜在局限
- 部署复杂度：需同时配置references目录、dnd-engine包、可选API服务，对纯新手有一定门槛
- 内容依赖：核心规则书（2024版三宝书）和模组需用户自行准备，SRD仅覆盖基础参考
- 实时性限制：HTTP API模式引入网络延迟，纯本地运行需跳过API层
适合人群
- 追求规则严谨性的资深DM，希望AI辅助但拒绝规则妥协
- 技术型玩家具备Python环境配置能力，理解FastAPI/HTTP调用
- 模组作者需要可扩展的自动化测试框架（90项测试）验证战斗平衡
常规风险
- 存档安全：自动生成saves/目录，建议定期备份；combat_state.json损坏可能导致战斗进度丢失
- 版本锁定：严格绑定2024版规则，若官方发布2025修订版需等待引擎更新
- SRD边界：SRD 5.2.1不含完整子职业与魔法物品，高阶内容需手动导入
---
版本1.1.0（2026-06-04）· 三层架构 · 90项测试通过