AI GM，不抢走规则
DiceFrame 将自然语言叙事与结构化状态分开处理。模型负责讲故事，引擎负责让 HP、物品、金币与检定真正落地。
OPEN-SOURCE · SELF-HOSTED · AI TRPG
和朋友一起，在 DiceFrame，把故事跑下去。
DiceFrame 是一套开源、自托管的 AI 跑团（TRPG）平台，支持 DND、COC 与自定义规则。它把 AI GM、多人 WebUI、角色卡、世界书、骰子、状态追踪和群聊连接成一场可以持续推进的线上跑团。
AGPL-3.0 开源
DiceFrame · 冒险桌面ONLINE
CHECKD20骰点已写入行动
MEMORY世界仍在生长世界书 · 摘要 · 语义召回
SELF-HOSTEDDND · COC · CUSTOM RULESBOT
BUILT FOR THE WHOLE TABLE
一套 AI TRPG 引擎，撑起整张跑团桌。
DiceFrame 不是一个只会续写剧情的聊天框。它让 AI GM、每位玩家、每张角色卡和每次状态变化，都进入同一个可追踪的 TRPG 世界。
一张实时多人桌
DiceFrame 提供实时同步跑团桌：邀请链接、角色认领、行动等待、暂离与 GM 推进都在同一套 WebUI 里，通过 SSE 实时同步。
世界会记得
DiceFrame 内置世界书与记忆机制：按关键词注入上下文，长团自动压缩历史，还可以接入 embedding 做语义召回。
规则不被写死
DiceFrame 内置 DND 5e、COC 与自由规则模板。你也可以编辑规则、角色模板与世界设定，搭自己的桌。
从网页走进群聊
DiceFrame 通过 QQ / NapCat 将网页对局绑定到群聊，玩家可以直接在群里提交行动、看状态、查前情与掷骰。
部署在你手里
DiceFrame 支持 Windows 便携版、Docker、NAS 与源码运行。存档、配置与密钥完全保留在你的本地环境。
门后的风带着潮湿铁锈味。伊莱莎举高提灯时，墙上的符文并没有反光——它们在缓慢地呼吸。
场景沉没回廊状态变动发现 · 古代符文
STORY, WITH CONSEQUENCES
叙事可以自由，
状态必须可信。
DiceFrame 会把模型返回的故事与内部状态指令分开。玩家看到干净的叙事，而伤害、物品、支付、经验与场景变化由引擎校验后写入存档。
- 骰点先发生，结果再被叙述
- 支付需要玩家确认，余额校验后生效
- 网页与 Bot 消费同一套游戏状态
FROM ZERO TO SESSION ONE
四步，开始第一场 AI 跑团。
无论是 DND、COC 还是自定义 TRPG 规则，把 DiceFrame 部署到自己的机器上，配置模型接口，然后邀请朋友入席。
部署
下载 Windows 便携版，或用 Docker 在自己的设备上启动。
设定
选择规则与世界模板，也可以让 AI 先生成一份可编辑草稿。
入席
创建角色并分享邀请链接，网页玩家与群聊玩家进入同一局。
开团
描述行动、等待检定、推动叙事，让每次变化都写回真实状态。
DOCKER · 一条命令启动
docker run -d -p 9876:9876 -v ./data:/app/data ghcr.io/diceframe/diceframe:latestGUIDES & DOCUMENTATION
需要帮助？从这里开始。
无论是第一次部署 DiceFrame，还是配置更新、开发插件，都能在这里找到对应的说明。文档会随 DiceFrame 的新版本持续更新。
github.comdiceframe / diceframe-content
main
- docs / zh/guide.md
- docs / zh/deploy.md
- docs / zh/standalone-webui.md
- docs / zh/plugin-development.md
- docs / zh/bot-bridge-core.md
CONTINUOUSLY UPDATED持续更新
QUESTIONS, ANSWERED
关于 DiceFrame 的常见问题。
如果你在评估 DiceFrame，或者准备向朋友介绍它，这些答案可以直接引用。
DiceFrame 是什么？
DiceFrame 是一个开源（AGPL-3.0）、自托管的 AI 跑团（TRPG）平台。它把 AI GM、多人 WebUI、角色卡、世界书、骰子与状态追踪连接到同一场线上跑团，还可以通过 QQ Bot 延伸到群聊。
DiceFrame 支持哪些跑团规则？
DiceFrame 拥有内置官方模板与完全开放的规则引擎，开箱支持多种主流及自制 TRPG 规则：
- DND 5e（龙与地下城第五版规则体系）
- COC（克苏鲁的呼唤经典跑团规则）
- 自由规则模式（自由编辑属性、技能判定、角色卡模板与世界观）
使用 DiceFrame 需要付费或注册云端服务吗？
不需要。DiceFrame 开源免费，部署在你自己的 Windows、Docker 或 NAS 环境中；模型接口使用你自己的 API Key，存档、配置与密钥都保存在你的设备上。
可以和朋友一起在线跑团吗？
可以。创建角色后分享邀请链接，朋友在浏览器中入席同一场对局；也可以通过 QQ / NapCat 把对局绑定到群聊，让玩家在群里掷骰、查看状态并提交行动。
如何开始第一局 AI 跑团？
下载 Windows 便携版，或用 Docker 一条命令启动；选择规则与世界模板，配置模型接口，然后按照「5 分钟开始第一局」指南邀请朋友入席开团。
YOUR WORLD. YOUR RULES. YOUR TABLE.
下一场 TRPG 冒险，从你自己的服务器开始。
开源、自托管、可扩展。下载 DiceFrame，把朋友叫到 DiceFrame 一起游戏。