纸是旧的,字是新的
纸张有 ivory 与 aged 两档底色,再叠污渍、折痕、烧边、撕裂四种做旧;预览与导出共用同一套 HTML/CSS,所见即所得。需要留档就导出 PDF 或 PNG。
四个入口都是同一个版本。GitHub 为官方发布页;国内访问不便时可用夸克网盘、百度网盘或 gofile 镜像。下载后解压,双击 start.cmd 即可启动。
百度网盘提取码:tf51 · QQ 交流群:1097421512
自托管遇到问题?发布包内附有 SELF-HOSTING-GUIDE.txt,用普通用户能看懂的话写了安装、启动、联机、备份与排错。
它不是一个只会续写剧情的聊天框。叙事与检定交给引擎,内容交给内置的剧本编辑器、世界书、角色卡编辑器与规则书知识库——两边分开,跑团才推得下去。
自然语言叙事与结构化状态分开处理。模型负责讲故事,引擎让检定结果、技能值与角色卡真正落地。
房间码邀请、成员列表、角色变更实时同步、正在输入提示。页面和实时聊天共用同一个端口,网络环境受限时也能保持同步。
命中触发词直接激活,未命中回退 BM25 + 向量检索;支持常驻条目、分层、概率、粘滞与冷却轮数,AI 只读到它此刻该读的部分。
Word / PDF / Markdown 模组按标题分节语义切块并建索引,导入完成即可开团;也可以先让 AI 转成结构化剧本,你审阅修改后再发布。「直接导入」与「审核导入」两条路径都在。
场景卡、结局、时间线、NPC、怪物与道具在同一个界面里编排,可配封面与简介。只有改动剧本内容才会生成新版本;改标题、作者、封面这类基础信息既不升版本、也不重算索引。
属性、技能、武器、专精与本地化技能名一应俱全;检定名会对照 character_skills.json(含专精与中文变体)校验,未知名直接拒绝并提示。聊天里的 1D100 结果直接写回卡上,失败 / 成功 / 困难 / 极难都有反馈。
不用手写 JSON:在页面里直接建卡、改卡、分配技能点。改动技能上限会按最终值裁剪所有点数;带专精的技能在右侧选好专精再切换基础值;技能基础值支持「房规 > 管理员默认 > 规则书默认」三级覆盖。
管理员上传 COC7 规则文本(.txt / .md / .doc / .docx)建成立即生效的检索库。玩家问「这个法术怎么算」时,AI 从你的规则书里找依据再回答,而不是凭记忆编。
单进程运行,不需要 Docker 也能跑。预置 DeepSeek / OpenAI / 阿里云百炼 / SiliconFlow / OpenRouter / LM Studio 六家平台,也支持任意 OpenAI 兼容接口。
前端依赖全部本地托管:Markdown 渲染、LaTeX 公式与实时通信库随包分发,不向 CDN 取件,断网也能正常渲染。
道具工坊把线索从聊天流里拿出来,做成有纸纹、有做旧、能投递也能导出的一件东西;模板与插件都不必改代码,团录也能装订成可搜索的 PDF。
私人书信、日记页、便签名片、多栏报纸、电报、请柬、档案卷宗、车票票据、收据、证物袋标签、老照片、契约——12 套模板都带纸纹与做旧。KP 填好内容,选中玩家,投递;玩家拿到的是一张能放大、能下载的纸片,而不是一段被刷过去的文字。
编辑器里点「让 AI 起草」,给出年代、地点、线索与语气,AI 就按模板填好字段;老照片模板还能调用你已经配置好的生图平台。两者都有预算与失败降级:起草失败不阻塞编辑,生图超额就退回空白照片框。
投递后的道具出现在聊天里,点开能读全文;卡片上的「问问 KP」把问题直接带进叙事,KP 结合道具内容回答。未揭示的道具对玩家返回 404,内容也不会进入玩家侧上下文——剧透从源头被挡住。
在 data/props/templates/<id>/ 里放清单、页面与样式,连重启都不用,点「重新扫描」就生效。纯数据、零代码;HTML 只允许文档流标签,脚本、外链与目录穿越一律拒绝,坏模板只让自己不可用。
在 data/plugins/<id>/plugin.json 里写清单,就能扩展规则集、道具模板、Agent 工具、HTTP 接口与页面。默认全部不启用,失败只影响自己;需要回滚时用 --no-plugins 或一个环境变量,主程序照常启动。附带可运行示例与开发文档。
档案卷宗、手记信纸、极简排版三套版式,离线生成 PDF;中文可搜索、有目录页码、页脚印「第 n 页 / 共 m 页」。可选是否收录骰子、OOC 与图片,成员能否导出由房主与管理员决定。
另外:Markdown 渲染、LaTeX 公式与实时通信库已全部改为本地托管,随发布包分发;不依赖 CDN,断网也能正常渲染。
KP 从 12 套模板里挑一张,填内容、做旧、投递。玩家收到的不是一段会被刷走的文字,而是一件能放大、能下载、也能拿去向 KP 追问的东西。
潮水退下去以后,栈桥尽头那盏灯又亮了。我数过,它亮了三夜。
如果你还打算去码头,请不要一个人去。
— A. Voss ivory · stain · fold纸张有 ivory 与 aged 两档底色,再叠污渍、折痕、烧边、撕裂四种做旧;预览与导出共用同一套 HTML/CSS,所见即所得。需要留档就导出 PDF 或 PNG。
KP 可以把道具投递给指定玩家,也可以投给全房间;未揭示的道具对玩家直接返回 404,连存在性都不泄露,内容也不会进入玩家侧上下文。投递后还能把指定字段脱敏。
模板、纸纹、做旧与 PDF/PNG 导出全部在本机完成,不依赖外部服务;Markdown、LaTeX 与实时通信库也随发布包本地托管,页面不再向 CDN 取件。
两件事都只需要往目录里放文件:模板是纯数据,插件是一份清单。默认不启用、失败不扩散,也不会因为一个坏文件拖住整场团。
把清单、页面与样式放进 data/props/templates/<id>/,点一下「重新扫描」就生效,不用重启。HTML 只允许文档流标签,脚本、外链与目录穿越一律拒绝;校验失败只让这一套模板不可用。
在 data/plugins/<id>/plugin.json 里写清单,可以挂上规则集、道具模板、Agent 工具、HTTP 接口与页面。默认不启用;某个插件失败只会把自己和依赖它的插件标成 failed,主程序照常启动。
三套版式对应三种场合:档案卷宗适合长团归档,手记信纸适合氛围回顾,极简排版只留干净正文。离线生成,中文可搜索,目录与页码都对得上;骰子、OOC 与图片按需收录,成员能否导出由房主与管理员决定。
配乐、配图与配音都由叙事驱动:先保证一定有,再在后台精修;离线可用,失败就退回确定性方案,不打断对话。
潮水退去后,栈桥尽头多了一盏不该亮着的灯。
示意图:场景面板同时承载配乐档位、五段 cue、配图缓存与配音状态;实际界面里,它们就在右侧「房间成员」栏下方。
Web Audio 现场合成,不加载音频文件。8 档场景 × 3 档强度,五段 cue 从 bed 推到 tail,段落用枢轴和弦与动机 pickup 衔接;动机在陈述、应答、高潮与碎片之间接续,换场景时用内容签名续上当前段落。
规则分析器每一回合都先给出确定性乐谱并立即广播,导演在后台把叙事与当前音频状态拼成提示,产出结构化作曲谱。schema 校验、指纹缓存、每日预算与失败回退都是硬闸门。
需要画面时,KP 判断这一幕并自拟提示词。触发档位可设为关闭、仅重要转场、频繁或每 N 回合;进度在「正在思考」的位置回报,房间级与剧本级缓存让同一场景来回切换零调用;NPC 头像与剧本作者的跨房间复用开关也在这里。
9 个人设覆盖旁白与男/女 × 少年/青年/中年/老年。默认用系统音色兜底;启用本地 Kokoro int8 引擎后,103 个说话人跑在 CPU 独立子服务上。语音响起时,BGM 与实时配乐自动让位。
主题不再是零散的开关:管理员与个人两级配置,所有主题走同一份 ThemeDefinition 契约,浮层统一挂载到 body,弹窗再也不会被侧栏困住。
站点默认与可用范围由管理员设置,个人在允许范围内覆盖;优先级为站点默认 < 个人覆盖。参数有默认值、范围与步进,越界自动钳制,拖动即时预览,保存前确认。
房间聊天、剧本编辑器、世界书、COC7 角色卡、角色卡编辑器与规则书知识库,全部照程序的实际界面绘制。
AI 守秘人推进叙事,玩家掷骰、检定,结果直接写回角色卡——全在同一张聊天里,右侧还能看到谁在线、绑定了哪张卡。
场景卡、结局、时间线、NPC、怪物与道具在同一个编辑器里编排,封面与简介跟着剧本走;写完存草稿或直接发布。
每条知识块都能调触发词、副键、常驻、概率与粘滞 / 冷却轮数:命中即注入,冷却即剔除,剧本再大也不会串味。
9 项属性、三档成功率(普通 / 困难 / 噩梦)、技能上限与武器清单一并呈现,技能名按角色卡自己的本地化名称显示。
职业点数与兴趣点数实时汇总剩余,分类筛选快速定位技能;带专精的技能选好专精,基础值随之切换。
上传 COC7 规则文本后立即可检索,AI 回答规则问题时以它为依据;剧本知识库删除只清向量与索引,不动剧本本身。
玩家看到的是干净的叙事,背后每一次检定、技能变动与存档都由引擎处理。
「世界书」装的是这个剧本的线索、NPC 与触发器;「规则书知识库」装的是 COC7 规则本身。两者分开检索——剧情线索不会被规则条文挤掉,规则问题也不用你现场翻书。
规则文本支持 .txt / .md / .doc / .docx,上传后立即生效;换一份规则书不用重跑剧本。
解压 release 包,双击 start.cmd 即起;Windows 会自动准备 Python 与依赖。macOS / Linux 用 python3 server.py。
打开首页会弹出部署向导:选平台、填 Key、测试连接、创建 Owner、进入系统,全程不用手改配置文件。
手写模组,或把文档导进来;再在剧本编辑器里调场景卡、在世界书里逐条设触发词,顺手建几张 COC7 角色卡,上传规则书建起知识库。
建房、发房间码、朋友加入。AI 开场并推进剧情,玩家掷骰、检定、行动。
发布包已带构建好的前端与自托管指南。Windows 双击 start.cmd 即可;macOS / Linux 装好 Python 3.11+ 后运行 python3 server.py。
:: Windows「发布包」:解压后双击 start.cmd :: 指定其它端口 start.cmd 8090 :: macOS / Linux「发布包」 python3 server.py :: 从源码运行(可选) git clone https://github.com/Nobook1121/the-veil cd the-veil python -m venv .venv .venv\Scripts\activate.bat pip install -r requirements.txt npm install && npm run build:frontend python server.py
启动日志(示例)
第一次启动会自动创建运行环境并下载依赖,可能需要几分钟;之后启动只需几秒。遇到问题先看发布包里的 SELF-HOSTING-GUIDE.txt。
想随时开一局,但没人愿意、或者没空来当守秘人。一套能立刻补位的线上跑团工具。
手里压着一堆 Word / PDF 模组,想把它们变成可对话、可检索、能反复开的线上跑团。
在自家电脑或一台小服务器上自建一套跑团工具,只对自己的朋友开放,账号自己管。
程序可以配合内网穿透等方式使用:在一台普通电脑上跑起来,把地址分享出去,朋友就能加入。零成本、无需云服务器,也不用先准备域名和证书。
python server.py,浏览器打开 127.0.0.1:8086,先自己开一局。$env:AI_TRPG_SECRET_KEY,不要沿用默认开发密钥。python server.py,先自己开一局试试。前端没有构建。执行 npm install && npm run build:frontend,或者改用已经带构建产物的 release 压缩包。
依次检查三件事:主机防火墙有没有放行端口、IP 对不对(异地组网要用虚拟网卡 IP)、启动日志里有没有对方能访问到的 listening 地址。
多数是模型接口超时。可以在设置页调大「AI 请求超时」和「最大工具调用轮数」,再确认 API Key 与模型 ID 没写错。
默认只处理文本型 PDF。扫描件需要额外装 OCR 依赖(PaddleOCR),见开发文档里的进阶可选项。
这是刻意的。标题、作者、推荐人数、简介、封面都属于基础信息,改它们不会升版本、也不会重算索引;只有改动剧本内容才会生成新版本。
不用。配乐由浏览器 Web Audio 现场合成,离线也能听;AI 音乐导演只是可选精修层,关掉或失败时会回到规则分析器给出的确定性乐谱。
不会。触发档位可设为关闭、仅重要转场、频繁或每 N 回合;房间与剧本两级缓存会让同一场景来回切换零调用,普通玩家没有触发权限,每日预算与每小时上限在管理员侧设定。
不需要。道具的纸纹、做旧与 PDF/PNG 导出都在本地渲染,团录 PDF 也在本机生成,中文可搜索;只有「让 AI 起草」与老照片模板生图会调用你自己配置的模型或生图平台,两者都可以关闭,预算耗尽时会降级而不是中断。
默认不启用:未启用的插件只读取清单用于展示,不读资源也不执行代码,只有管理员显式写入 data/plugins/enabled.json 才会加载。单个插件失败只会把自己和依赖它的插件标成 failed,主程序照常启动;需要完全回滚时用启动参数 --no-plugins 或环境变量 TRPG_PLUGINS_DISABLED=1。插件以宿主进程权限运行,请只安装信任来源。
AI 跑团就是用 AI 当守秘人(KP)来带的跑团。这里把叙事交给模型、把检定与角色卡交给引擎:模型负责讲故事、扮演 NPC,引擎让 1D100 的结果真正落在角色卡上。你不用备课,也不用凑齐固定的时间。
房主在自己电脑上运行程序,新建房间后把房间码发给朋友;朋友用浏览器打开同一个地址、输入房间码就能加入。页面和实时聊天共用同一个端口,再配合内网穿透,异地朋友也能连上,不需要云服务器。
房主与房间管理员会在房间右上角、房间管理页看到本房间累计的 token 与花费。金额按「AI 平台设置」里每个模型的输入/输出单价和平台币种计算;没填单价的模型只统计 token,金额显示「未配置单价」。数据只对本房间可管理的人可见。
不会。Agent 的每次写操作都会先弹出确认卡片,后端在生成和执行两步分别鉴权:网站设置只有管理员与 Owner 能用,网络与 Agent 自身配置只有 Owner 能改,密钥字段读取时打码、写入时拒绝;房间消息的删除与清空还要求房主或房间管理员身份。权限不足时会直接拒绝并写入日志。
帷幕(The Veil)本身就是开源免费的跑团工具(Apache-2.0),在 aitrpg.top 或 release 页下载解压即可运行。唯一可能产生费用的是你自己选的 AI 模型接口,也可以先用本地模型跑;服务器就用你自己的电脑。