在GitHub上拖了一个可以本地部署的剧本杀模拟器。试了试还可以

矢锋

A大可以研究下：

https://github.com/Sagesheep/NarrativeEngine-P


我这两天大体研究了一下，发现：
1、默认没有破甲，但可以自己在开场和指令集中加入破甲。
2、可以使用各种模型，而且支持本地模型，这意味着你有一个好显卡可以免费游玩。
3、文风相当棒，看来输出提示词这块调整得不错。
4、可以根据Example_Setup目录下的三个MD文件自行编写世界指南和游戏规则。
5、运行稳定性还可以，就是有点费token。

叙事引擎[color=var(--fgColor-accent,var(--color-accent-fg))]

您的AI地下城主。一款自托管的桌上角色扮演游戏引擎，可运行长时间、多回合的战役，具备持久化记忆、鲜活的NPC以及自动化的世界管理功能——由任何兼容OpenAI的大型语言模型或本地Ollama模型提供支持。

无需云端，无需订阅。您的营销活动将保存在您的本地设备上。

---

开始使用[color=var(--fgColor-accent,var(--color-accent-fg))]

• 克隆仓库
  [backcolor=var(--bgColor-muted,var(--color-canvas-subtle))]git clone https://github.com/Sagesheep/NarrativeEngine.gitcd NarrativeEngine
  
  
• 安装与运行
  Windows—只需双击Start_Narrative_Engine.bat
  或手动：
  [backcolor=var(--bgColor-muted,var(--color-canvas-subtle))]npm installnpm run dev
  
  
• 打开您的浏览器以http://localhost:5173
• 配置您的大语言模型— 打开设置，添加您的API密钥和端点。支持OpenAI、Ollama以及任何兼容OpenAI的API。
  
  

就这么简单。创建一场活动，撰写您的世界背景故事，然后开始游戏吧。

---

设置您的首个游戏系列[color=var(--fgColor-accent,var(--color-accent-fg))]

该文件夹包含一个完整且可直接游玩的战役：觉醒——一款 gritty 的生存奇幻游戏，讲述人类在一场陨石撞击导致所有非人形生物变异为怪物后，于百年之际蜷缩于巨大城墙之后的故事。这是体验这款引擎运作方式的绝佳途径。

What's in the example[color=var(--fgColor-accent,var(--color-accent-fg))]
文件它的作用
Spirit_Card_World_Lore.md世界圣经——各大洲、派系、地点、角色、规则。在创建你的战役时，将此内容粘贴到背景部分。
Rulebook v2.6.mdGM 的指令集——输出格式化、NPC 行为、骰子判定、事件处理。请将此内容粘贴到战役设置中的系统提示字段中。
starter_prompt.md开场场景 + 操作指南——请指示游戏主持人在故事开始前逐步引导角色创建。请将此内容作为您的第一条消息发送给游戏主持人。How to use it[color=var(--fgColor-accent,var(--color-accent-fg))]

• 创建新活动
• 打开世界信息（背景故事）选项卡并粘贴以下内容Spirit_Card_World_Lore.md
• 打开营销活动设置并把内容粘贴到Rulebook v2.6.md系统提示字段中
• 开始新聊天，并把内容粘贴为starter_prompt.md您的第一条消息
• GM会引导你完成角色创建，然后让你进入游戏世界
  

Writing your own setup[color=var(--fgColor-accent,var(--color-accent-fg))]

您可以将此示例用作任何设置的模板：

• 背景故事— 使用Markdown编写你的世界，运用##和###标题。每个部分都会成为GM可调用的背景故事片段。使用[CHUNK: TYPE -- NAME]前缀对条目进行分类。支持的类型：world_overview, faction, location, character, power_system, economy, event, relationship, rules, culture, misc
• 系统提示— 定义游戏主持人（GM）的行为方式：语气、输出格式、NPC行为规则、骰子判定、事件协议。引擎负责管理记忆与召回——你只需定义风格和规则即可
• 第一条消息— 设置场景或为游戏主持人提供一个初始指令。你可以描述一个开场情境，请求创建角色，或者直接说“开始”
  

---

功能[color=var(--fgColor-accent,var(--color-accent-fg))]
Your Campaign, Your World[color=var(--fgColor-accent,var(--color-accent-fg))]

• 并行运行多个活动，每个活动都有自己的世界、背景故事和状态
• 使用纯Markdown编写丰富的世界圣经（背景故事）——包括地点、派系、权力体系、文化、规则
• 传说条目会自动分类，并由对话中的关键词触发
• 固定关键背景知识（规则、经济、魔法体系），以便始终置于GM的语境中
  

Smart Memory That Actually Works[color=var(--fgColor-accent,var(--color-accent-fg))]

GM会记住你过去的会话，而无需你做任何操作：

• 会话摘要——旧聊天记录会自动浓缩为实时摘要，同时保留令人难忘的语录
• 场景存档— 每个场景都会以无损日志原样保存，绝不会被丢弃
• 章节— 游戏过程中，故事会自动按章节组织，并附上大语言模型生成的摘要
• 语义搜索——当通用汽车需要召回某事时，它会根据含义而非仅凭关键词搜索您的完整历史记录
  

Living NPCs[color=var(--fgColor-accent,var(--color-accent-fg))]

• NPCs会自动识别，随故事中出现而自动检测——无需手动输入数据
• AI会生成完整的人物档案：性格、声音、目标、派系、视觉描述
• 人像生成支持5种艺术风格：写实、动漫写实、动漫、西方RPG、Q版
• NPC们会记住他们所目睹的一切——GM清楚房间里都有谁，绝不会让酒馆老板提及他们从未见过的秘密
• 正在追踪性格漂移——如果NPC的态度发生转变，你将看到持续3回合的漂移警报
  

World State Tracking[color=var(--fgColor-accent,var(--color-accent-fg))]

引擎维护着一个记录世界真相的动态时间线：

• 谁在哪里，谁掌握什么，谁杀了谁，谁与谁结盟
• 矛盾会自动解决——如果角色死亡，其“位于”和“结盟于”条目将被覆盖
• 随时手动添加或删除时间线事件
• 实体规范化可识别别名和细微的名称差异
  

Dice & Randomness[color=var(--fgColor-accent,var(--color-accent-fg))]

三种打造涌现式叙事的引擎：

• 惊喜引擎——环境氛围事件（一种神秘的声音，一抹转瞬即逝的影子）
• 遭遇引擎— 中等赌注的钩子与挑战
• 世界事件引擎— 地震般的巨变（政变、自然灾害、神灵干预）
  

每个引擎的阈值会随时间降低，因此，什么都不发生的时间越长，发生某种情况的可能性就越大。所有参数均可配置。

此外，还采用了一种公平的骰子池系统用于技能检定，具备优势/劣势、暴击及灾难效果，涵盖7个技能类别。

AI Co-DMs[color=var(--fgColor-accent,var(--color-accent-fg))]

三个独立的AI角色每回合可使用各自的LLM端点行动：

• 敌方AI——与你为敌的对手
• 中立AI—旁观者和百搭牌
• Ally AI——伙伴与友好势力
  

每个都有自己的个性、提示和介入机会。它们无法取代GM或决定玩家的行动——它们以独立角色的身份，用自己的声音行事。

Image Generation[color=var(--fgColor-accent,var(--color-accent-fg))]

• 以5种艺术风格即时生成NPC肖像
• 在游戏过程中生成场景插图
• 兼容任何与OpenAI兼容的图像API
• 图像会下载并本地存储
  

Your Data, Your Control[color=var(--fgColor-accent,var(--color-accent-fg))]

• 加密的API密钥保管库— AES-256-GCM加密，可选密码
• 机器密钥模式— 无需密码，密钥在您的设备上自动解锁
• 密码模式— 使用10万次迭代的PBKDF2实现全面锁定
• 客户端加密— API密钥在进入服务器之前即已在您的浏览器中加密
• 所有活动数据均以文件形式本地存储——无需数据库、无需云端、无需厂商锁定
• 导出和导入您的保险库以进行备份
  

Backups & Rollback[color=var(--fgColor-accent,var(--color-accent-fg))]

• 自动备份在任何危险操作之前创建
• 手动标记备份随时进行
• 场景级回滚— 撤销任意场景，整个世界状态（时间线、章节、NPC）将级联回滚至该点
• 已失效的章节自动解封，时间线条目被清除，必要时冷凝器会重置
• 回滚前的安全备份，即使回滚也不会丢失数据
  

LLM Tool Calls[color=var(--fgColor-accent,var(--color-accent-fg))]

游戏主持人可在对话过程中使用工具：

• 查询战役背景——当需要某个细节时，GM会即时查阅你的世界圣经
• 更新场景笔记本——一种易变的工作记忆，用于追踪当前生效的法术、计时器、NPC位置及环境状况
  

适用于OpenAI函数调用和DeepSeek模型（支持DSML回退解析）。

---

支持的LLM提供商[color=var(--fgColor-accent,var(--color-accent-fg))]

任何与OpenAI兼容的API均可使用。每个预设最多可配置6个端点：

角色用途
故事AI主GM叙述
摘要AI浓缩旧历史（可使用更便宜的模型）
实用AINPC验证、重要性评分、上下文推荐（推荐使用廉价模型）
图像AI人像与场景生成
敌方/中立/盟友AI共同DM角色（若未设置则回退至故事AI）

与Ollama配合使用效果极佳，可完全本地游玩——设置完成后无需联网。

---

快速参考[color=var(--fgColor-accent,var(--color-accent-fg))]
操作命令
安装并运行（Windows）双击Start_Narrative_Engine.bat
手动安装npm install
启动应用npm run dev
运行测试npm run test
绒毛npm run lint