[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82957":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":14,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":13,"starSnapshotCount":13,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},82957,"TRPG_Agent","qigangc\u002FTRPG_Agent","qigangc","A TRPG Agent with a UI for a better solo gaming experience.",null,"Python",100,8,0,32,40,2.86,"MIT License",false,"main",true,[],"2026-06-12 02:04:29","# TRPG Agent\n\n[English](docs\u002FREADME_en.md) | [简体中文](docs\u002FREADME_zh.md) | [繁體中文](docs\u002FREADME_zh_TW.md) | [日本語](docs\u002FREADME_ja.md)\n\n[路线图](docs\u002Froadmap_zh.md) | [Roadmap](docs\u002Froadmap_en.md)\n\n## 简介\n\nTRPG Agent 是一个基于大模型的本地文字 TRPG Agent。项目使用 FastAPI + Jinja2 + Vanilla JS 构建网页界面，通过 SSE `\u002Fapi\u002Fchat\u002Fstream` 流式返回 AI 叙事，并使用 `saves\u002F` 下的 JSON 文件保存本地存档。\n\n项目入口为 `TRPG_Agent\u002Fmain.py`，在项目目录中运行 `python main.py` 后访问 `http:\u002F\u002Flocalhost:7860\u002Fmain` 或 `http:\u002F\u002F127.0.0.1:7860\u002Fmain`。\n\n## 功能\n\n- 支持 DND 和 CNC 两种世界观\n- AI 扮演 DM\u002FGM，提供文字叙事与行动反馈\n- 通过 SSE 流式输出聊天内容\n- 支持 d20 检定、大成功和大失败\n- 支持角色创建、属性分配、经验和升级\n- 支持 JSON 本地存档读取与保存\n- 提供模型设置和规则设置页面\n\n## 快速开始\n\n```bash\ncd TRPG_Agent\npip install -r requirements.txt\ncp .env.example .env\npython main.py\n```\n\n启动前必须在 `.env` 中配置：\n\n```env\nZHIPU_API_KEY=你的智谱 API Key\n```\n\n浏览器打开：`http:\u002F\u002Flocalhost:7860\u002Fmain`\n\n## 页面\u002F路由\n\n| 路由 | 说明 |\n|---|---|\n| `\u002Fmain` | 世界观选择页 |\n| `\u002Fsave` | 存档管理页 |\n| `\u002FcreateCharacter` | 角色创建页 |\n| `\u002Fgame` | 游戏对话页 |\n| `\u002Fsettings` | 设置入口 |\n| `\u002Fsettings\u002Fmodel` | 模型配置页 |\n| `\u002Fsettings\u002Frules` | 规则配置页 |\n\n主要流式接口：`POST \u002Fapi\u002Fchat\u002Fstream`，返回 `text\u002Fevent-stream`。\n\n## 游戏流程\n\n1. 在 `\u002Fmain` 选择 DND 或 CNC 世界观\n2. 在 `\u002Fsave` 读取存档或新建游戏\n3. 在 `\u002FcreateCharacter` 创建角色并分配属性\n4. 在 `\u002Fgame` 与 AI 主持人对话并推进冒险\n5. 触发检定时自动执行 d20 判定\n6. 游戏状态可保存到 `saves\u002F` JSON 存档\n\n## 世界观\n\n### DND\n\nDND 是偏史诗、庄重的中世纪奇幻世界观。AI 使用检定标签：`[检定:属性 DC=N]`。\n\n### CNC\n\nCNC 是偏轻松、吐槽风格的国产奇幻世界观。AI 使用挑战标签：`[挑战:属性 DC=N]`。\n\n## 规则\n\n### d20 检定\n\n检定公式：`d20 + 属性调整值 >= DC`\n\n- 自然 20：大成功\n- 自然 1：大失败\n- 其他点数按公式判断是否成功\n\n常见 DC：\n\n| DC | 难度 |\n|---|---|\n| 10 | 简单 |\n| 15 | 中等 |\n| 20 | 困难 |\n| 25 | 极难 |\n\n### 角色属性\n\n角色使用 6 项属性，内部字段名如下：\n\n| 字段 | 中文 |\n|---|---|\n| `strength` | 力量 |\n| `dexterity` | 敏捷 |\n| `constitution` | 体质 |\n| `intelligence` | 智力 |\n| `wisdom` | 感知 |\n| `charisma` | 魅力 |\n\n属性调整值按 `(属性值 - 10) \u002F\u002F 2` 计算。\n\n## 配置\n\n配置通过 `.env` 和 `config.py` 读取。`ZHIPU_API_KEY` 为必填。\n\n| 变量 | 说明 |\n|---|---|\n| `ZHIPU_API_KEY` | 智谱 API Key，必填 |\n| `MODEL_NAME` | 模型名称 |\n| `MAX_HISTORY` | 保留的历史对话轮数 |\n| `INITIAL_ATTRIBUTE_POINTS` | 初始属性点 |\n| `TEMPERATURE` | 模型采样温度 |\n| `MAX_TOKENS` | 单次回复最大 token 数 |\n| `MAX_RETRIES` | API 调用重试次数 |\n| `EXP_THRESHOLD` | 升级经验阈值基数 |\n\n## 项目结构\n\n```text\nTRPG_Agent\u002F\n├── main.py\n├── app.py\n├── config.py\n├── game_engine.py\n├── llm_client.py\n├── storage.py\n├── env_writer.py\n├── rules\u002F\n├── worlds\u002F\n├── templates\u002F\n├── static\u002F\n├── saves\u002F\n├── docs\u002F\n├── requirements.txt\n└── .env.example\n```\n\n## 开发说明\u002F注意事项\n\n- 当前 Web UI 基于 FastAPI、Jinja2、Vanilla JS 和 SSE\n- `main.py` 启动 uvicorn，默认监听 `127.0.0.1:7860`\n- 所有页面由服务端 Jinja2 模板渲染\n- 聊天流使用 `\u002Fapi\u002Fchat\u002Fstream`\n- 存档为 `saves\u002F` 目录下的 JSON 文件\n- 世界观包括 DND 和 CNC\n- 修改模型或规则配置时，优先通过设置页面或 `.env` 调整\n\n## 路线图\n\n- [路线图](docs\u002Froadmap_zh.md)\n- [Roadmap](docs\u002Froadmap_en.md)\n","TRPG Agent 是一个基于大模型的本地文字 TRPG 代理，旨在提供更好的单人游戏体验。该项目使用 FastAPI 和 Jinja2 构建网页界面，并通过 SSE 流式返回 AI 叙事。核心功能包括支持 DND 和 CNC 两种世界观、AI 扮演 DM\u002FGM 提供文字叙事与行动反馈、d20 检定、角色创建及属性分配、以及 JSON 本地存档读取与保存。适合喜欢桌面角色扮演游戏但又难以找到合适玩家或 DM 的用户，在本地环境中享受沉浸式的冒险体验。",2,"2026-06-11 04:09:42","CREATED_QUERY"]