核心用法
dnd-dm 是一套完整的AI驱动D&D 5e游戏主持系统，采用独特的三层架构设计：底层 dnd-engine（纯Python引擎，90项测试覆盖）负责骰子、战斗结算、存档管理等确定性计算；中间层 dnd-api（FastAPI，30个HTTP端点）提供标准化接口；顶层 dnd-dm Skill 专注叙事生成与NPC交互。用户通过任意IM软件即可与AI城主"明萨拉·班瑞"对话，无需专用客户端。
安装流程极简：解压即用，自动加载内置引擎。首次使用回复 /verify 完成环境校验。游戏全程遵循2024版规则，检定、伤害、状态管理均由引擎层结构化返回，LLM仅负责叙事渲染，杜绝"幻觉数值"。
显著优点
- 架构清晰：上层依赖下层、下层零LLM依赖的分层设计，功能边界明确
- 规则严谨：严格2024版规则，6步检定流程、自然1不重投等机制代码化
- 即开即玩：内置引擎源码，无需pip安装，Python 3.10+环境即可运行
- 跨平台：支持Windows/macOS/Linux，自动端口检测避免冲突
- 持久化完善：存档自动嵌入场景缓存，
party-sheet.html可视化角色卡
潜在局限
- 版权依赖：2024版三宝书与模组需用户自行准备，无法随分发
- 技术门槛：虽宣称"纯对话"，但三层架构的调试/扩展需理解API与引擎交互
- 城主人格固定：明萨拉·班瑞的守序邪恶设定可能不适合偏好轻松风格的游戏
- 中文生态：SRD检索与规则引用以英文SRD为主，中文支持依赖LLM翻译
适合人群
- 熟悉D&D 5e 2024版规则、希望AI接管DM计算负担的老玩家
- 追求规则严谨性、反感LLM"口胡"数值的技术向TRPG爱好者
- 需要快速开团的线上游戏主持人
常规风险
- 存档安全：
saves/与live_party.json为明文JSON，需自行备份 - API暴露：本地FastAPI服务默认监听所有接口，公共网络使用需额外防护
- 模组兼容性：未明确验证第三方模组格式，可能存在解析失败风险
- LLM幻觉：虽引擎层隔离计算，叙事层仍可能产生规则理解偏差