Holonovel

构建 Holodeck。加载你的战役。

holonovel 是《星际迷航》的全息甲板程序——一个交互式故事，你作为角色踏入其中，规则主导一切。Holonovel 构建服务器（即 Holodeck）。你的战役就是程序（即 Novel）。你的规则书成为引擎——D&D 5e、Starfinder，或你书架上的任何游戏。你的书。你的服务器。你的 Holodeck。

目录

• 快速开始

  • holonovel

• 功能

  • 你的规则书，跑起来

  • 真实的世界

  • 存续的故事

  • 强制的角色

  • 进化的游戏

• 对比

• 贡献

  • 运行服务器

  • 改进规范

Related MCP server: RPG Ledger MCP Server

快速开始

holonovel

基础服务器——一个世界模型 MCP，包含房间、物品、出口、解析器命令和叙事工具。安装它，然后安装任意数量的规则集包——每个包与基础服务器并列安装，绝不修改它。Build 工作流读取你的规则书，并将每本渲染为可安装的包。需要 Node.js 20+。

cd holonovel
npm install
npm run start

添加到你的 MCP 客户端：

"holonovel": {
  "type": "local",
  "command": ["npx", "tsx", "src/index.ts"],
  "cwd": "<path>/holonovel",
  "environment": {
    "TTRPG_NOVEL": "default"
  },
  "enabled": true
}

安装规则集

Build 工作流将规则书转化为声明式包。将包放入安装目录——默认为 .holonovel-state/rulesets/<slug>/——运行中的服务器即会注册它。包是惰性加载的：只有当你打开绑定到该规则集的战役时，规则集的工具和索引才会水合，因此堆叠多个包不会产生前期成本。通过服务器工具安装、移除和列出包，或直接移动文件并重启。

要开始构建，运行入口点——它记录输入并打印要遵循的工作流（完整快乐路径见规范的 Workflow Runbooks 附录）：

npm run build-ruleset dnd5e=ruleset/dnd5e/

你的战役数据和已安装的包存放在 .holonovel-state/ 下，位于服务器树之外——更新 holonovel 绝不会触碰它们。

功能

Holonovel 建立在五项能力之上。它们共同交付一个完整的桌面 RPG 服务器——你的规则书成为裁判，你主持牌桌。

你的规则书，跑起来

Convert 接收 PDF、HTML 和网页抓取内容，并将它们转化为干净的 Markdown。列检测跨分页重组表格。OCR 捕获嵌入在图像中的文本。输出在结构上是健全的——每个标题都已解析，每个引用都已追踪。

Build 读取该 Markdown 并提取每一条机制。骰子流程、战斗系统、法术目录、装备表、状态轨道——每个结构化元素都成为声明式规则集包中的工具、资源或提示。指导性文字成为叙事素材。发现引擎对源进行采样，衡量提取置信度，并迭代直到每个机制部分都被覆盖。无法建模的内容保持可搜索——绝不为了填补空白而编造。

"把《地下城主指南》——每一章、每一张表、每一个侧栏——变成服务器可以构建的干净源文件。" "从这些文件为我构建一个规则集包。"

一份规范。任意规则书。零代码。

真实的世界

世界模型是一个空间模拟层——房间、出口、容器、支撑物、门。每个物体都知道自己在哪里、包含什么。服务器维护一个真实的包含图，而不是一段希望 AI 记住的散文。世界模型由 Inform 编程语言驱动——数十年互动小说经典背后的同一引擎。

解析器命令以真实的容器逻辑导航世界。向北走。房间就在那里。拿起提灯。它从石棺移动到你的物品栏。打开容器，锁上门，检查周围环境。出口自动双向连接。大多数 AI RPG 工具没有空间模型——AI 假装记得东西在哪里。在这里，你的地图是真实的。

"向北走。" "从石棺中拿起提灯。" "环顾四周。" "打开铁门。" "检查刻在祭坛上的符文。"

你的地图是真实的。

经久不衰的故事

叙事模型是赋予你的世界深度的一切。场景搭建舞台。NPC 携带性格档案、倾向和对话语气。当关键词与展开的故事匹配时，传说条目自动触发。派系跟踪立场和议程。秘密将知识隐藏在发现之后。誓言通过里程碑跟踪将角色绑定到任务。倒计时按计划升级紧张感。故事日志记录决策、时刻和后果——一种在每次重建后依然存续的叙事记忆。

Novel 是你的整个战役——队伍、NPC、场景、传说、战斗状态、世界模型、故事日志、派系、秘密，一切。它存在于服务器上。它经受住重启、重建和会话中断。导出为 JSON 或 Markdown。以合并、替换或试运行模式导入。克隆以测试故事分支。在关键时刻之前设置检查点。撤销任何变更。Novel 不是聊天记录——它是一个结构化的存档文件。其他工具要求 AI 记住你的世界。Holonovel 将其写入服务器——结构化、可查询、永久。

"设置场景：旧大教堂下方一个被水淹没的藏骨堂。空气中弥漫着陈旧的焚香和某种更古老的气息。" "一个身影从阴影中浮现——莫拉修女，被埋葬教团的侍僧。她惊恐万分，而非敌意。" "每当有人说出藏骨堂守护圣人的名字时，提醒我：被淹死的牧师们仍在这里祈祷。" "我发誓在下一次满月之前取回圣人的圣物匣。" "记录这一刻：队伍尽管看到所有警告信号，仍选择信任莫拉修女。"

你的战役。在服务器上。永远。

强制执行的角色

每个 Novel 有四种徽章设置。玩家。游戏主持人。观察者。编辑者。随时切换——无需重启，无需重新加载。AI 自动承担相反角色：当你是玩家时，AI 是你的 GM。当你主持时，AI 扮演角色。观察者让 AI 同时运行双方，而你旁观。编辑者让你完全访问，在游戏开始前设置角色、构建世界和完善传说。

徽章门控不是提示指令。它在服务器端强制执行。GM 的秘密、传说条目和叙事指令从玩家徽章的工具表面消失。玩家看到的响应永远不会泄露 GM 所知的内容。玩家信号为你提供结构化、持久的控制——设置节奏、难度、基调、焦点和主题边界。每个信号都持续存在于 GM 的简报中，塑造每个响应，直到你更改它。你告诉服务器你想要什么。它倾听。

"切换到游戏主持人徽章。我需要设置下一个场景。" "切换回我的玩家徽章。我们继续。" "观察者模式。我想看 AI 运行双方。" "节奏：我希望事情进展更快。" "边界：不要身体恐怖。"

真正的强制执行。

不断进化的游戏

综合通过两个来源类别深化你的战役。规则集智慧在构建期间从你的规则书中提取——来自游戏示例对话的语音示例、来自设定描述的传说模板、来自解决序列的动作模式、来自灵感媒体引用的叙事语音档案。它作为一流的服务器行为持续存在——Holodeck 机械地渲染你规则书自身的类型惯例。规则集智慧在每次重建和综合回退后依然存续。

外部研究按需运行——来自网络的 GM 建议、实际游戏分析、设计师笔记。带有来源 URL、置信度分数和新鲜度时间戳的标签。每个综合项目默认是惰性的。GM 在运行时切换重要内容的开关。重新运行综合会替换非活动项目，同时保留 GM 已激活的一切。回退综合会移除外部研究——规则集智慧持续存在。游戏进化而不失去你已构建的内容。

"为我找到运行恐怖单次游戏的 GM 建议和游戏示例。"

游戏进化而不失去你已构建的内容。

对比

这个领域的每个工具都要求你做出选择。规则引擎服务于一个系统，然后就此止步。AI 讲故事者边进行边即兴发挥机制。SillyTavern 给你完美的提示控制——却仍然信任上下文窗口在三轮之后记住"中毒"的含义。Holonovel 不做选择。服务器强制执行每个机制。AI 叙述。Novel 保存一切。D&D 5e、Starfinder 或你自己的规则书。一个规范。任何游戏。零代码。你的书。你的服务器。你的 Holodeck。

贡献

运行服务器

按照上面的快速开始让 holonovel 运行起来。需要 Node.js 20+（nodejs.org）。

改进规范

npm install && npm run check   # lint + validate + assumption audit + ambiguity
                                # scan + cross-ref check + dupe detection

编辑 spec/ 中的文件。提交前运行 npm run assemble。不要直接编辑 holonovel.md——它由 spec/ 源文件生成。

规范来源：git.gay/flukeatzerocool/Holonovel。此 GitHub 仓库是只读镜像。

许可证：MIT。基于：Graham Nelson 的 Inform（Artistic License 2.0）、if-craft-corpus（CC BY 4.0）、dmcp（MIT，Shawn Rushefsky）、lonelog（CC BY-SA 4.0）、BitD SRD（CC BY 3.0，John Harper）。 RSS。最后更新：2026-08-09。