AI Skill Hub 强烈推荐：叙事引擎 是一款优质的AI工具。AI 综合评分 8.0 分，在同类工具中表现稳健。如果你正在寻找可靠的AI工具解决方案，这是一个值得深入了解的选择。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
叙事引擎 依赖 TypeScript 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 TypeScript 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 叙事引擎 的版本更新，及时通知重要功能变化。
📋 工具概览
叙事引擎 是一款基于 TypeScript 开发的开源工具，专注于 AI、TTRPG、自托管 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
叙事引擎 是一款基于 TypeScript 开发的开源工具，专注于 AI、TTRPG、自托管 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：npm 全局安装 npm install -g narrativeengine-p # 方式二：npx 直接运行（无需安装） npx narrativeengine-p --help # 方式三：项目依赖安装 npm install narrativeengine-p # 方式四：从源码运行 git clone https://github.com/Sagesheep/NarrativeEngine-P cd NarrativeEngine-P npm install npm start
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
narrativeengine-p --help
# 基本用法
narrativeengine-p [options] <input>
# Node.js 代码中使用
const narrativeengine_p = require('narrativeengine-p');
const result = await narrativeengine_p.run(options);
console.log(result);
# narrativeengine-p 配置说明 # 查看配置选项 narrativeengine-p --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export NARRATIVEENGINE_P_CONFIG="/path/to/config.yml"
Narrative Engine
[
Your AI Dungeon Master. A self-hosted TTRPG engine that runs extended, multi-session campaigns with persistent memory, living NPCs, and automated world management — powered by any OpenAI-compatible LLM or local Ollama model.
No cloud. No subscription. Your campaigns stay on your machine.
📱 Android client available: NarrativeEngine-M
---
Getting Started
1. Clone the repo
git clone https://github.com/Sagesheep/NarrativeEngine-P.git
cd NarrativeEngine-P
- Install & run
Windows — double-click Start_Narrative_Engine.bat
Linux / macOS — run start.sh
Or manually:
npm install
npm run dev
- Open your browser at
http://localhost:5173
- Configure your LLM — open Settings and add your API key + endpoint. Supports OpenAI, Ollama, DeepSeek, and any OpenAI-compatible API.
That's it. Create a campaign, write your world lore, and start playing.
---
Writing your own setup
- Lore — write your world in Markdown with
##/###headers. Each section becomes a lore chunk the GM can recall. Use[CHUNK: TYPE -- NAME]prefixes to classify entries (world_overview,faction,location,character,power_system,economy,event,rules,culture,misc) - System Prompt — define how the GM behaves: tone, output format, NPC behaviour rules, dice resolution, event protocols. The engine handles memory and recall — you define the style
- First Message — set the scene, ask for character creation, or simply say "begin"
---
World Building Tools
World Lore Builder
A structured pre-game world editor:
- Dedicated fields for world background, languages, power systems, technology level, timeline, tone, and house rules
- Expandable lists for geography, factions, cultures, threats, and pre-seeded NPCs
- Export to Markdown with one click for backup or sharing
- Import Markdown with a smart review modal that merges changes without overwriting your work
- Multiple draft worlds — switch between them or delete old ones
Quick start with an example
- Create a new campaign
- Open World Info (Lore) and paste the contents of one of the lore files (e.g.
Spirit_Card_World_Lore.md) - Open Campaign Settings and paste the latest ruleset (
AI_GM_OS_v3_4_App_Optimized.md) into the System Prompt field - Start a new chat and paste the genre's start prompt as your first message
- The GM will walk you through character creation and then drop you into the world
Setting Up Your First Campaign
The Example_Setup/ folder contains ready-to-play campaigns across multiple genres — including a gritty survival fantasy (Spirit Card World), a Naruto-inspired setting, and more. Each comes with a world bible, a GM ruleset, and an opening prompt.
Quick Reference
| Action | Command |
|---|---|
| Install & run (Windows) | Double-click Start_Narrative_Engine.bat |
| Install & run (Linux) | Run start.sh |
| Install manually | npm install |
| Start the app | npm run dev |
| Run tests | npm run test |
| Lint | npm run lint |
---
高质量AI工具，支持自托管和智能记忆
- 需要 NarrativeEngine-P 解决具体问题的开发者与运营人员
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
- 本地部署：CPU 8GB 起，GPU 推荐 16GB+ 显存
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 需要 NarrativeEngine-P 解决具体问题的开发者与运营人员
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
总体来看，叙事引擎 是一款质量优秀的AI工具，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。
| 原始名称 | NarrativeEngine-P |
| 原始描述 | 开源AI工具：Self-hosted AI Dungeon Master - run extended TTRPG campaigns with smart memory, 。⭐17 · TypeScript |
| Topics | AITTRPG自托管 |
| GitHub | https://github.com/Sagesheep/NarrativeEngine-P |
| License | MIT |
| 语言 | TypeScript |
收录时间：2026-05-25 · 更新时间：2026-05-30 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。