English | 简体中文 | 繁體中文 | 日本語

路线图 | Roadmap

1跑团推广最大的难点一直在于，需要多人+长时间投入来进行。因此一直在考虑想找一个办法让跑团能变成一个单人的事情

TRPG Agent 是一个基于大模型的本地文字 TRPG Agent。项目使用 FastAPI + Jinja2 + Vanilla JS 构建网页界面，通过 SSE /api/chat/stream 流式返回 AI 叙事，并使用 saves/ 下的 JSON 文件保存本地存档。

项目入口为 TRPG_Agent/main.py，在项目目录中运行 python main.py 后访问 http://localhost:7860/main 或 http://127.0.0.1:7860/main。

• 支持 DND 和 CNC 两种世界观
• AI 扮演 DM/GM，提供文字叙事与行动反馈
• 通过 SSE 流式输出聊天内容
• 支持 d20 检定、大成功和大失败
• 支持角色创建、属性分配、经验和升级
• 支持 JSON 本地存档读取与保存
• 提供模型设置和规则设置页面

cd TRPG_Agent
pip install -r requirements.txt
cp .env.example .env
python main.py

启动前必须在 .env 中配置：

ZHIPU_API_KEY=你的智谱 API Key

浏览器打开：http://localhost:7860/main

主要流式接口：POST /api/chat/stream，返回 text/event-stream。

1. 在 /main 选择 DND 或 CNC 世界观
2. 在 /save 读取存档或新建游戏
3. 在 /createCharacter 创建角色并分配属性
4. 在 /game 与 AI 主持人对话并推进冒险
5. 触发检定时自动执行 d20 判定
6. 游戏状态可保存到 saves/ JSON 存档

DND 是偏史诗、庄重的中世纪奇幻世界观。AI 使用检定标签：[检定:属性 DC=N]。

CNC 是偏轻松、吐槽风格的国产奇幻世界观。AI 使用挑战标签：[挑战:属性 DC=N]。

检定公式：d20 + 属性调整值 >= DC

• 自然 20：大成功
• 自然 1：大失败
• 其他点数按公式判断是否成功

常见 DC：

角色使用 6 项属性，内部字段名如下：

属性调整值按 (属性值 - 10) // 2 计算。

配置通过 .env 和 config.py 读取。ZHIPU_API_KEY 为必填。

TRPG_Agent/
├── main.py
├── app.py
├── config.py
├── game_engine.py
├── llm_client.py
├── storage.py
├── env_writer.py
├── rules/
├── worlds/
├── templates/
├── static/
├── saves/
├── docs/
├── requirements.txt
└── .env.example

• 当前 Web UI 基于 FastAPI、Jinja2、Vanilla JS 和 SSE
• main.py 启动 uvicorn，默认监听 127.0.0.1:7860
• 所有页面由服务端 Jinja2 模板渲染
• 聊天流使用 /api/chat/stream
• 存档为 saves/ 目录下的 JSON 文件
• 世界观包括 DND 和 CNC
• 修改模型或规则配置时，优先通过设置页面或 .env 调整

• 路线图
• Roadmap