D&D 5e AI 地下城主引擎

它解决什么问题

用大模型跑 D&D 时，常见问题是叙事可以，但数值裁决容易漂移：骰子、命中、伤害、豁免、XP、AC/DC、检定格式都靠模型口算或拼 JSON，结果不稳定，也不方便审计。dnd-dm-skill 把这类确定性问题从提示词里拆出来，让 LLM 只负责城主叙事、NPC 反应、场景推进和行为红线，把规则计算交给可测试的 Python 引擎。

技能如何工作

该技能按三层组织：

• LLM 层：dnd-dm Skill，用 Markdown 和 prompt 约束 DM 行为，发起检定但不自行计算。
• API 层：dnd-api，提供 /api/roll、/api/combat/skill-check、/api/saves/*、/api/srd/search 等端点，方便外部平台调用。
• 引擎层：dnd-engine，实现骰子表达式、命中判定、伤害结算、战斗状态、存档、世界状态、模组缓存和 SRD 搜索。

关键流程是：角色创建时由引擎执行 roll_stat()；战斗时由 dnd_engine.combat.checks 结构化返回检定公式和结果；存档由 write_save()、load_save()、list_saves() 管理；场景缓存写入 _scene_cache_*.json，避免 LLM 自由拼数据。规则裁决锁定 2024 版 D&D 5e，并执行自然 1 不重投等公平约束。

适用边界

适合想把 D&D 规则裁决做成确定性后端的工程师，尤其是已有 IM 或 Web 平台、需要调用骰子和战斗结算的场景。它不提供完整客户端，也不替代模组创作；若需要自定义规则，应遵循其三层边界：新增数值逻辑先进入引擎层，再由 API 暴露，最后才写进 DM 提示词。