部署与上手

一总览

Loreweaver 是一场游戏，不是一次聊天。一位 AI 守秘人（KP） 主持，一名或多名玩家扮演调查员。KP 负责叙事、裁定、扮演 NPC——但骰子由引擎真掷，不是它编的。一局的角色：

• 守秘人（keeper）：用守秘人 key 连入，能导模组、切模型、发邀请码、管理房间。同一时刻通常只有一个。
• 玩家（player）：用玩家 key 连入，扮演一名调查员，建卡、掷骰、行动。
• AI 队友：空座位可由 AI 同伴补上，用它自己的角色卡、掷自己的骰、只凭它该知道的信息行动。

客户端只有终端版一种——跨平台（macOS / Linux / Windows）、一行装好，连的是同一台服务器、同一张牌桌。

二连接入桌

开局：点一个按钮就够

装好客户端，点连接屏上的绿色按钮「本地开服并开玩」——就这样，没有第二步。

它会自动下载对应你系统的服务器程序（自包含，不用装 Python、不用配环境），起服、发钥匙，然后把你以守秘人身份直接送进主菜单。纯净的 Windows 10/11、macOS(Apple silicon)、Linux，我们都从裸系统一键点到进桌验证过。

装客户端

两个客户端说同一套协议，连接屏上是同一个按钮。桌面应用（推荐）：Loreweaver Studio ↗——图形界面、实时面板、模组自带的面板、守秘人的那几屏，外加制卡工作室；三平台安装包见最新 release ↗——macOS .dmg（Apple 芯片与 Intel）、Windows 安装器、Linux .AppImage / .deb；目前未签名，macOS 首次启动右键 →「打开」，Windows 选「仍要运行」。终端客户端一行装好（macOS / Linux）：

Windows(PowerShell):irm https://1a7432.site/trpg/install.ps1 | iex。日后更新客户端：loreweaver update。

开发版是作为普通 Release 发布的，所以这一行装的是最新的构建，不是最新的稳定版。想把一桌人钉在某个确定版本，运行安装脚本前设 TRPG_RELEASE_TAG=<tag>，或者直接取那个 Release 自带的安装脚本（它会把自己钉住）。TRPG_SERVER_RELEASE_TAG 只钉一键开服的服务器。

加入朋友的团（填 ticket + 邀请码）

打开 Studio，或运行 loreweaver，在连接屏填：

长期自托管（可选）

服务器程序也可以自己拿去服务器上长期部署：GitHub Releases 上有 Windows / macOS / Linux(x64 + arm64)四份 loreweaver-server-*，解压即跑，--doctor 一键体检。

三建角色

连上后进主菜单，选「我的角色 → 建卡」。或直接用命令建。四种方式，哪一种最后都要过规则这关——数值超了范围、超了预算，一律拦下，AI 说了不算。

房规：.rule 查看本房间可用的房规阶梯并切换（.rule 0 回默认）。可选项由规则包自己声明，所以换一个系统，能选的档位也不一样。改名：.nn 新名字（或 .rename）。

四核心循环：说你想做什么

玩起来其实很简单——直接用自然语言说出你的调查员做什么，不用记命令：

有一条规矩永远不破：先掷骰，后叙事。你一尝试结果不确定的行动，引擎先掷真骰，KP 再按成功等级讲后果——绝不先写好结局，也绝不光说不掷。你也可以主动用指令手册里的命令掷。

五导入模组与内容包守秘人

桌子搭好之后，内容从三个口进来：酒馆卡、内容包、预设。都是守秘人的活，玩家坐好等开场就行。

把一张酒馆卡当模组开团

结尾的 world 是关键——这是守秘人专用的世界导入：世界书全量入库（守秘条目保持只有 KP 可见）、[InitVar] 变量树落地、卡内角色进入可认领角色池（玩家用 .pc claim 名字 认领）。而玩家自己 .import 一张卡，只会拿到人物那一半——钩子、变量声明、秘密设定这些世界机制会被结构性剥掉，一张卡没法夹带私货改写房间。

导完用 .var list 看整棵变量树（KP 全可见），再把玩家该看到的子树暴露出去：

暴露的部分实时出现在所有玩家侧栏的状态量面板里；没暴露的在引擎内部就被过滤，永远不出服务器。

装内容包（.lwpack）

一部完整作品（卡+世界书+规则包+技能+界面面板+素材）是一个 .lwpack 文件，来源可以是本地文件、直链，或作者自己的 GitHub Release:

装之前会先看到信任卡片——包里多少张卡多少个技能、带不带沙箱脚本、素材多大——确认了才落盘，每个文件都过完整性校验。装好 ≠ 启用：进房后由守秘人逐项开，.skill enable 开技能，.panels enable 包id 开界面面板；导包里的卡不用打全路径：

预设与自己制卡

酒馆的 completion 预设可以整份导入当「风格层」：.preset import /路径/预设.json 后 .preset enable 名字——它塑造文风与框架，压不过骰子与守秘纪律。想自己做卡：桌面端 Loreweaver Studio（拆卡台 + 分阶段制卡机），做一次同时导出酒馆卡和原生卡两份；原生 .lorecard.json 同样 .import … world 直接开团，也能打进 .lwpack 分发。

六小贴士

• 模型选得对很关键。KP 极度依赖工具调用与指令遵从。能力强的模型（开思考的 deepseek-v4-pro、GPT-4 级、Claude）会真掷骰、忠实跑模组；便宜小模型往往光叙述不掷、还跑偏。
• 导模组慢是正常的。真模型分析一个大模组要几分钟——盯着进度条走完即可，不是卡死。
• 点名 AI 同伴让它行动。KP 想让 AI 队友说话时会通过工具“点将”，它便以自己的卡登场。
• 终端体验拉满。骰面光标、动画、快捷键、顶栏 HUD（场景/时钟/上下文占用/连接灯）一应俱全，一行装好、跨平台都能跑。
• 更新客户端：loreweaver update。

接着看哪一份

这一页讲的是部署和开局。下面几份是分角色写的，都有中文版：