核心用法
dnd-dm 是一款将AI大语言模型与确定性游戏引擎深度结合的D&D 5e（2024版）电子城主系统。采用三层架构设计：底层dnd-engine纯Python引擎负责骰子、战斗计算、存档管理等确定性逻辑（90项pytest测试覆盖）；中间dnd-api层提供30个FastAPI端点供任何平台调用；上层dnd-dm Skill专注叙事生成与NPC扮演。
用户通过日常IM软件（微信/Discord/Slack等）纯对话交互即可进行完整战役。角色创建采用7阶段对话式引导，战斗时LLM负责氛围渲染而引擎严格按6步检定流程结算。支持模组化运行，场景缓存自动嵌入存档，角色状态可通过party-sheet.html网页实时查看。
显著优点
1. 架构分离，可靠性高：LLM只负责"不可代码化"的叙事与红线判断，所有数值计算由引擎层保证，杜绝AI幻觉篡改AC/DC/伤害数值
2. 零客户端门槛：无需安装FoundryVTT等专用软件，手机IM即可游玩
3. 规则权威性：严格基于2024版三宝书，26条运行规则按6层架构组织，含15条行为红线（禁止R18G、禁止放水、禁止混用2014旧规则等）
4. 可扩展性强：30个REST API端点支持接入Discord Bot、网页端等第三方平台
潜在缺点与局限性
- 版权材料需自备：规则书与商业模组需用户自行准备，无法随Skill分发
- Python环境依赖：需要本地安装Python 3.10+及pip，对非技术用户有门槛
- 城主人格固定：当前仅内置"明萨拉·班瑞"守序邪恶卓尔圣武士人格，缺乏自定义选项
- 网络架构复杂度：API层需独立启动服务，端口自动检测机制在防火墙严格环境可能失效
适合人群
- 熟悉D&D 5e（2024版）规则、希望随时随地文字跑团的桌面玩家
- 有基础Python环境配置能力的技术型用户
- 需要自动化战斗裁决、厌烦"DM口头算错伤害"的硬核规则派
常规风险
1. 存档安全：live_party.json和saves/目录需定期备份，误删不可恢复
2. 规则版本混淆：用户若混入2014版旧规则内容，可能触发红线#6冲突
3. API服务稳定性：战斗状态依赖combat_state.json持久化，异常关机可能导致回合数据丢失