部署与上手
装客户端、一键开服、拉朋友入桌、建角色、核心游戏循环——从零到开团的一条路。全部掷骰/检定/角色卡/守秘人命令,单独放在玩家指令手册里查。
English readers: the canonical docs live in the GitHub README and docs/. This guide is the hands-on 中文 play manual.
一总览
Loreweaver 是一场游戏,不是一次聊天。一位 AI 守秘人(KP) 主持,一名或多名玩家扮演调查员。KP 负责叙事、裁定、扮演 NPC——但骰子由引擎真掷,不是它编的。一局的角色:
- 守秘人(keeper):用守秘人 key 连入,能导模组、切模型、发邀请码、管理房间。同一时刻通常只有一个。
- 玩家(player):用玩家 key 连入,扮演一名调查员,建卡、掷骰、行动。
- AI 队友:空座位可由 AI 同伴补上,用它自己的角色卡、掷自己的骰、只凭它该知道的信息行动。
客户端只有终端版一种——跨平台(macOS / Linux / Windows)、一行装好,连的是同一台服务器、同一张牌桌。
二连接入桌
开局:点一个按钮就够
装好客户端,点连接屏上的绿色按钮「本地开服并开玩」——就这样,没有第二步。
它会自动下载对应你系统的服务器程序(自包含,不用装 Python、不用配环境),起服、发钥匙,然后把你以守秘人身份直接送进主菜单。纯净的 Windows 10/11、macOS(Apple silicon)、Linux,我们都从裸系统一键点到进桌验证过。
装客户端
一行装好(macOS / Linux):
Windows(PowerShell):irm https://1a7432.site/trpg/install.ps1 | iex。日后更新客户端:loreweaver update。
加入朋友的团(填 ticket + 邀请码)
装好后运行 loreweaver,在连接屏填:
长期自托管(可选)
服务器程序也可以自己拿去服务器上长期部署:GitHub Releases 上有 Windows / macOS / Linux(x64 + arm64)四份 loreweaver-server-*,解压即跑,--doctor 一键体检。
| 平台 | 文件 |
|---|---|
| Windows | loreweaver-server-windows-x64.zip |
| macOS(Apple silicon) | loreweaver-server-macos-arm64.tar.gz |
| Linux x64 | loreweaver-server-linux-x64.tar.gz |
| Linux arm64 | loreweaver-server-linux-arm64.tar.gz |
三建角色
连上后进主菜单,选「我的角色 → 建卡」。或直接用命令建。四种方式,哪一种最后都要过规则这关——数值超了范围、超了预算,一律拦下,AI 说了不算。
| 方式 | 怎么做 |
|---|---|
| 掷骰生成 | .coc(克苏鲁 7 版)或 .dnd(D&D 5e)按规则公式自动掷属性 |
| 逐项手动 | 建卡后用 .st 力量60 侦查70 逐项设置(带实时点数/技能点预算);设完用 .st 定稿 让当前 HP/MP/理智按最终属性归位 |
| 描述→AI 起草 | .genchar <一段人设描述>,AI 起草卡,再由校验器钳到合规 |
| 导入酒馆卡 | .import <服务端角色卡文件> 导入 SillyTavern 角色卡 |
房规:.setcoc 2 设置 CoC 的大成功/大失败判定线(不同版本习惯)。改名:.nn 新名字(或 .rename)。
四核心循环:说你想做什么
玩起来其实很简单——直接用自然语言说出你的调查员做什么,不用记命令:
有一条规矩永远不破:先掷骰,后叙事。你一尝试结果不确定的行动,引擎先掷真骰,KP 再按成功等级讲后果——绝不先写好结局,也绝不光说不掷。你也可以主动用指令手册里的命令掷。
五小贴士
- 模型选得对很关键。KP 极度依赖工具调用与指令遵从。能力强的模型(开思考的 deepseek-v4-pro、GPT-4 级、Claude)会真掷骰、忠实跑模组;便宜小模型往往光叙述不掷、还跑偏。
- 导模组慢是正常的。真模型分析一个大模组要几分钟——盯着进度条走完即可,不是卡死。
- 点名 AI 同伴让它行动。KP 想让 AI 队友说话时会通过工具"点将",它便以自己的卡登场。
- 终端体验拉满。骰面光标、动画、快捷键、顶栏 HUD(场景/时钟/上下文占用/连接灯)一应俱全,一行装好、跨平台都能跑。
- 更新客户端:
loreweaver update。