DM 城主系统 - D&D 5e 2024 版 AI 地下城主

版本 1.0.14

总览

本技能将 OpenClaw 配置为《博德之门：坠入阿弗纳斯》模组的 AI 地下城主（明萨拉·班瑞人格），基于 D&D 5e 2024 版规则运行。支持场景级懒加载、存档/读档、战斗管理、自动检定、经验结算、世界状态追踪、剧情摘要、规则关键词检索，以及回声映射系统（现实隐喻→奇幻叙事）。

安装

将 DMskill-v1.0.14.zip 解压到 workspace 根目录即可。

确保 agent 配置中的 profile 指向对应的 agent 配置。

文件结构

dnd-dm/
├── SKILL.md                  # 本文件（技能描述）
├── _meta.json                # 版本元信息
├── CHANGELOG_DM_v2.md        # 完整更新日志
├── code/                     # Python 函数库
│   ├── combat/               # 战斗系统（命中/伤害/状态/展示）
│   ├── dice/                 # 骰子引擎
│   ├── module/               # 模组扫描/缓存/场景索引/初始化
│   ├── party/                # 角色查询/经验计算
│   ├── rule/                 # 规则关键词检索
│   ├── save/                 # 存档读写/模板/剧情摘要生成
│   ├── state/                # 结构化世界状态管理
│   └── summary/              # 剧情摘要生成
├── references/               # 参考文件
│   ├── DM_RULES.md           # DM 运行规则（含规则20：回声映射）
│   ├── DM_RULES_INDEX.md     # 规则层级索引
│   ├── DM_TEMPLATES.md       # 展示模板
│   ├── DM_DEV_GUIDE.md       # 开发规则
│   ├── DM_MAP_SYS.md         # 地图系统
│   ├── CHAR_CREATION.md      # 角色创建指南
│   ├── MODULE_INDEX.md       # 模组索引模板
│   ├── MODULE_ARC.md         # 模组进度总览模板
│   ├── ECHO_ARC.md           # 回声系统映射指南
│   ├── IDENTITY.md           # 城主身份定义
│   └── SOUL.md               # 城主灵魂文件
└── srd/                      # SRD 5.2.1 参考文件
    ├── references/           # 20 个 DND5eSRD_*.md 文件
    └── scripts/              # RAG 搜索脚本

核心规则

| 文件 | 用途 |
|------|------|
| DM_RULES.md | 城主运行规则（6层：层0常驻~层5模组控制） |
| DMRULESINDEX.md | 层索引，快速定位规则 |
| DM_TEMPLATES.md | 展示输出模板（9.3a/9.6a/9.9 等） |
| DMDEVGUIDE.md | 开发/维护流程 |

新功能：回声系统（v1.0.14）

每次新开一局或载入存档时，系统自动询问是否启用回声映射系统（规则20）：

• 现实隐喻→奇幻叙事：你在日常对话中倾诉/分享现实生活时，AI 城主可识别其中的情绪和主题，将其隐喻映射为 D&D 奇幻支线任务
• 隐私保护：5条隐私红线（不主动追问、必须隐喻转换、解密权属玩家、本地存储）
• 开关持久化：选择后写入 world_state.json，存档/读档自动保持状态
• 可在游戏中随时调整：口头指令「开关回声」即可

依赖

• OpenClaw v1.0+（运行环境）
• dnd5e-srd（可选，提供 SRD 5.2.1 RAG 搜索能力）
• D&D 2024 三宝书（用户自备，rules/ 目录）

相关技能

如需 SRD 内容搜索支持，安装 dnd5e-srd 技能，本技能通过 srd/scripts/ 脚本调用其数据。

作者

明萨拉·班瑞 · 阿弗纳斯之主 的仆人，老白干一杯