核心用法
dnd-dm 是一款将AI作为地下城主(DM)的D&D 5e游戏系统，采用独特的三层架构设计：
- LLM层(dnd-dm Skill)：负责叙事生成、NPC对话、场景描述和行为红线约束，通过prompt驱动保持AI的核心优势
- API层(dnd-api)：30个HTTP端点+CLI命令行工具，支持跨平台调用（Discord/Foundry/Web等）
- 引擎层(dnd-engine)：纯Python实现，零LLM依赖，涵盖骰子、战斗、存档、世界状态等核心功能，90项测试覆盖
安装仅需3步：解压→放入规则书与模组→校验开玩。支持纯对话交互，任何IM软件即可运行。
显著优点
1. 架构解耦，各司其职：上层依赖下层，下层不依赖上层。LLM专注叙事，计算全交引擎，避免AI幻觉导致的规则错误
2. 2024版规则严格落地：6步检定流程、自然1不重投、26条运行规则按6层架构组织
3. 多平台兼容：FastAPI自动检测端口，CLI+HTTP双接口，角色卡网页双击即看
4. 城主人格鲜明：守序邪恶卓尔圣武士明萨拉·班瑞，语气霸道果断但公平不放水
5. 完整功能闭环：角色创建(7阶段对话式)→战斗裁决(一键回合结算)→存档管理(自动场景缓存嵌入)
潜在局限
- 版权内容需自备：2024版三宝书与模组因版权无法分发，需用户自行准备
- Python环境依赖：需要Python 3.10+及pip，对非技术用户有一定门槛
- 本地部署为主：虽支持API调用，但核心体验偏向本地单机运行
- SRD检索依赖外部：战时快速查规则需配合
dnd5e-srd技能
适合人群
- 熟悉D&D 5e规则、追求公平裁决的硬核玩家
- 希望AI担任DM但担心规则被随意篡改的谨慎型用户
- 有基础技术能力、能处理Python环境配置的爱好者
- 偏好文字交互、对图形客户端无硬性要求的跑团群体
常规风险
- 规则理解门槛：2024版与2014版规则差异需主动学习，系统明确禁止混用
- 内容红线约束：15条行为红线包括NO R18G、NO未成年人相关内容等，违规交互会被拒绝
- 存档兼容性：引擎层更新可能影响旧存档读取，建议关注版本变更日志
- API端口冲突：自动检测端口机制在特定防火墙环境下可能失效