选择你的冒险规则

选择一套规则系统开始跑团之旅——不同规则将带来完全不同的视觉体验与专属工具。

🎭 选择你的角色

还没有角色——去"人物卡"页面捏一个,或者点右边的按钮快速创建一个
AI

AI 主持人 (KP/DM) — 即刻开始跑团

接入 AI 大模型作为你的专属游戏主持人。自动适配当前规则系统,实时叙述、判定、扮演 NPC。支持 Anthropic Claude 和 OpenAI 兼容接口。不同规则系统下的游戏会话互相独立。

选择角色后,点击这里开始冒险
D

龙与地下城 5e

Dungeons & Dragons 5th Edition

剑与魔法的史诗冒险。探索被遗忘的国度,对抗远古巨龙,在奇幻世界中书写传奇篇章。

奇幻中世纪d20系统高魔世界
C

克苏鲁的呼唤

Call of Cthulhu 7th Edition

踏入不可名状的恐怖深渊。调查诡异事件,直面宇宙的疯狂真相,在理智崩溃的边缘求生。

恐怖调查d100系统宇宙恐怖
R

赛博朋克 红

Cyberpunk RED

高科技,低生活。在霓虹浸染的夜之城中,用赛博义体和尖端科技武装自己,对抗巨型企业的铁幕。

科幻赛博朋克d10系统反乌托邦
P

开拓者

Pathfinder 2nd Edition

无限深度的策略奇幻。丰富的职业定制选项,精密的战术战斗系统,打造真正独一无二的传奇英雄。

奇幻策略d20系统深度定制

D&D 5e 在线资源库

角色肖像

+ 点击或拖拽上传肖像
表情头像
😀 😁 🤣 😂 😊 😎 😍 🧐 🤓 😏 😈 👻 💀 🎭 👽 🤖 😇 🐱 🐉 🦊 🧙 🧝 ⚔️ 🛡️

已保存角色

核心属性 (百分制 · 购点法)

技能熟练

装备与物品

物品数量重量分类装备

法术书

点击"编辑"修改法术详情,点击 ◆/◇ 切换准备状态

特质

专长与能力

战斗数据

先攻追踪器

跑团笔记

历史笔记

全选

剧情梳理面板

来自记忆库的NPC、线索、剧情线程,方便梳理

游戏进行中时将自动填充...
TTRPG

多人联机跑团

与好友一起冒险,由同一个 AI 主持人主持游戏

房间创建后将自动生成房间号,分享给好友即可加入。

使用 Cloudflare Worker WebSocket 中继 · 无需局域网或公网 IP · 稳定低延迟

输入房主分享的房间号即可加入游戏。

配置

管理 AI 大模型、语音输出与应用设置

LLM 大模型配置

AI 主持人使用的大语言模型。支持 Anthropic Claude、DeepSeek 和 OpenAI 兼容接口。配置保存后在首页 AI 主持人面板中生效。

不同提供商有默认地址,切换提供商自动填充,也可手动修改为自定义中转地址

切换提供商自动更新建议列表,或点击"获取模型列表"从 API 拉取

⚠️ API Key 仅保存在浏览器本地存储中,不会上传到任何第三方服务器。

语音输出 (TTS)

AI 主持人的回复可通过小米 MiMo TTS API 实时朗读。流式合成引擎按标点智能分句,当前句播放时下一句已预合成就绪。

🔑 前往 xiaomimimo.com 注册获取 MiMo API Key

关于跑团助手

AI 驱动的桌面角色扮演游戏伴侣 — 让每一次冒险都独一无二

项目简介

跑团助手是一个开源的 AI 驱动 TTRPG 伴侣,专为桌面角色扮演游戏玩家设计。无论你是想独自体验一场由 AI 主持的冒险,还是与朋友联机协作,这里都有你需要的工具。

项目完全免费开源,数据存储在浏览器本地,保护你的隐私。AI 功能支持多种大模型接口,包括 Anthropic Claude、OpenAI GPT 和 DeepSeek。

作者

txy571 — 在读大学生 & 前端开发者 & 资深跑团玩家

热爱 TTRPG,致力于用技术降低跑团门槛。欢迎在 GitHub 上交流、提 PR、一起改进这个项目!

Quark — 晚期智人

无穷的远方,无数的人们,都和我有关

快速上手

1
选择规则系统

点击顶栏主题徽章(如 "D&D 5e"),在下拉菜单中切换你喜欢的规则系统。不同规则带来不同的视觉主题和专属工具。

2
创建角色卡

进入"人物卡"页面,填写角色姓名、种族、职业、属性、技能。上传角色立绘(自动压缩至 <100KB)。CoC 模式支持时代预设(1920s / 维多利亚 / 现代),一键填充时代特色技能。

3
配置 AI 主持人

在首页选择角色后,点击 AI KP 横幅进入聊天面板。前往顶栏"配置"页面填入你的 API Key 和模型选择,然后返回首页开始游戏。点击"测试连通"验证配置。

4
开始冒险!

在 KP 对话框中输入你的行动——"我要调查那扇吱吱作响的门"、"向酒保打听最近的失踪事件"。AI 主持人会根据规则系统自动判定、叙述、扮演 NPC。

5
语音输出 (可选)

在顶栏"配置"页面的"语音输出"区域填入小米 MiMo API Key 并开启语音。AI 的叙述将自动朗读——按标点智能分句、流式预合成、自然衔接。在首页 AI 聊天面板中可随时开关语音,勾选"播完静音"可在每段输出结束后自动关闭。

5
笔记

"笔记"页面提供 Markdown 实时预览编辑器,支持加密导出和多选批量导出。骰子功能已嵌入 AI 主持人面板,检定请求出现时可直接投掷。

API 配置详解

跑团助手本身不提供 AI 服务,需要你自行获取 API Key。支持以下三种接口:

Anthropic (Claude) — 推荐

前往 console.anthropic.com 注册并获取 API Key。推荐模型:Claude Sonnet 4.6(速度快/性价比高)或 Claude Opus 4.7(最强推理)。

需要海外支付方式。API Key 格式:sk-ant-api03-xxx

DeepSeek

前往 platform.deepseek.com 注册并获取 API Key。国内可访问,支持支付宝充值。推荐模型:DeepSeek V4 Pro。

价格低廉,中文能力强,是性价比最高的选择。

OpenAI 兼容接口

支持所有兼容 OpenAI Chat Completions 格式的 API 服务(如 OpenAI 官方、Azure OpenAI、Ollama 本地模型、Groq 等)。

对于自建代理或第三方中转,选择此项并在后端配置对应地址即可。

小米 MiMo TTS — 语音合成

AI 主持人的回复可实时转换为语音朗读。前往 xiaomimimo.com 注册账号,在控制台创建 API Key 并充值即可使用。支持多种音色选择。

在顶栏"配置"页面的"语音输出"区域填入 API Key。支持按标点智能分句、流式预合成,播放流畅无间隔。

隐私说明:API Key 仅存储在浏览器 localStorage 中,通过 Cloudflare Worker 代理转发请求(或直接调用 API),绝不会上传到任何第三方服务器。你可以随时清除浏览器数据来删除 Key。

支持的规则系统

D&D 5e — 龙与地下城

经典奇幻冒险。d20 系统,属性分为六维(力量/敏捷/体质/智力/感知/魅力),技能熟练度加成。高魔世界,剑与魔法的史诗叙事。

CoC 7e — 克苏鲁的呼唤

宇宙恐怖调查。d100 百分骰系统,包含 SAN 值(理智)、HP、Luck、MP 机制。三个时代预设,40+ 专业技能,战斗轮与追击规则。

Cyberpunk RED — 赛博朋克

近未来反乌托邦。d10 系统,强调义体改造、网络黑客、街头声誉。霓虹浸染的夜之城,高科技低生活的生存法则。

Pathfinder 2e — 开拓者

深度策略奇幻。d20 系统,拥有极为丰富的职业定制、专长树和战术选项。适合追求机制深度和 Build 乐趣的硬核玩家。

高级功能

AI 记忆库

AI 会自动记录关键 NPC、线索和剧情节点,形成结构化记忆。长会话中自动压缩上下文,防止遗忘重要信息。手动添加记忆条目,AI 会严格遵循。

剧本知识库

在 KP 面板中打开"剧本库",编写 NPC 资料、地点描述、隐藏线索和剧情钩子。AI 会将这些设定作为运行游戏的基准参考。

游戏存档

支持手动存档和自动存档(每 5 分钟)。存档包含完整的对话历史、角色状态和世界状态。随时回档到之前的冒险节点。

多人联机

通过 WebRTC(PeerJS)实现 P2P 多人联机。支持 1 位 KP + 最多 4 名玩家的房间模式,实时同步骰子结果、角色状态和聊天消息。

笔记加密

笔记支持 AES-GCM 加密导出(PBKDF2 密钥派生,10 万次迭代)。敏感游戏笔记只有知道密码的人才能解密读取。

浅色/深色模式

点击顶栏右侧的太阳/月亮图标切换。所有四个规则系统均有独立的浅色和深色视觉方案,在明亮和黑暗环境下都能舒适使用。

AI 自动骰子

在对话中直接输入骰子表达式(如 "1d20+5"),AI 会自动识别并投掷,将结果融入叙述中。

语音输出 (TTS)

支持小米 MiMo TTS API,AI 主持人的回复可实时朗读。流式合成引擎按标点智能分句,当前句播放时下一句已预合成就绪,体验流畅无间隔。可在游戏中随时开关声音,支持输出完后自动静音。

Markdown 笔记

WYSIWYG 编辑器,实时预览,支持标签分类和全文检索。批量导出为 JSON,方便备份和迁移。

快捷键

1 首页
2 人物卡
3 笔记
4 联机
5 配置
6 关于
Enter 发送 KP 消息 / 掷骰

技术栈

Astro 6.xVanilla JSCSS Custom Properties Cloudflare WorkersDurable ObjectsWebRTC (PeerJS) Web Crypto APIGitHub PagesGitHub Actions Markdown (marked.js)Font Awesome 6SSE Streaming MiMo TTS APIWeb Audio API

愿你的骰运昌隆,冒险永无止境

跑团助手 v2.x — MIT License — © 2026 txy571