notnotype/neuro-book

NeuroBook – AI 辅助写作环境

它是什么 – NeuroBook 是一款以桌面端为主的应用程序，让您在 AI 代理的协助下撰写长篇小说（或任何结构化叙事），同时保持故事世界的连贯性。它将小说视为一个软件项目：世界状态、情节大纲和手稿皆以纯文本 Markdown 和本地 SQLite 数据库存储，而 World Engine 可以重新计算时间轴上任何时间点的角色、地点或资源的确切状态。

为什么它很重要 – 大型语言模型擅长生成短篇段落，但在长篇作品中容易出现漂移、遗忘埋下的伏笔，并在散文中留下机械式的“AI 味”。NeuroBook 通过以下方式解决这些问题：

• 持久化一个随时间演变的 world state，而非依赖对话记忆。
• 提供一个 commit-style 的“承诺账本”（promise ledger），追踪从埋设到回收的每一个伏笔元素。
• 运行一个包含 360 条规则的检查工具 (llmlint)，以检测并自动修复典型的 AI 生成写作瑕疵。
• 赋予作者对 AI 代理（领导者、写作者、研究员）的细粒度控制，以及需要明确批准才能进行变更的三模式工作流程（讨论 → 规划 → 应用）。

核心组件

组件	角色
World Engine	存储带有时间戳快照的主体（角色、王国等）；任何时刻的状态皆可从事件溯源日志中重新计算。
Plot Workbench	用于排列章节、场景和因果链的视觉化「承载树」（story-structure tree）与「因果树」（causality tree）。
Multi-Agent Studio	一个执行独立 AI 代理（领导者、写作者、研究员）的框架，具有可配置的权限与提示词。
llmlint	标记冗余词汇、机械式转折、公式化语句等的检查工具；可自动修复许多问题。
Profile & Workflow editor	基于 TSX 的视觉化编辑器，用于定义代理的上下文、工具和逐步工作，无需编写代码。

如何获取

• Windows – 从 Releases 页面下载可携式 zip 并运行 Start Neuro Book.cmd。
• Linux / macOS – 运行提供的安装脚本 (curl … | sh)。
• Docker / 多实例 – 使用 NeuroBook Manager (bunx @notnotype/neuro-book-manager@canary)，它可以启动隔离实例、处理更新，并透过网页 UI 公开应用程序。
• 所有安装皆会执行环境检查，并让您选择偏好的 LLM 提供者与 API 密钥。

典型工作流程

1. 初始化 一本新“书” – 工具会创建 lorebook/、manuscript/ 和 world-engine/ 文件夹，内含 Markdown/TS 文件。
2. 定义世界 – 在 World Engine UI 中新增角色、派系、历法等；每次变更皆会记录时间戳。
3. 规划情节 – 使用 Plot Workbench 映射章节 → 场景并附加伏笔承诺。
4. 邀请 AI 代理 – 配置 leader（情节规划）、writer（草稿生成）和 researcher（事实查核）。UI 会显示内嵌建议；您需在写入前进行批准。
5. 写作 – 直接编辑 Markdown 手稿；整合的 AI 可以重写选定文字、建议续写或执行检查流程。
6. 审核 – 您可以随时查询过去某个时间点的世界状态、检视承诺账本，或运行 llmlint 来清理散文。
7. 导出 – 完成的书籍以纯 Markdown 存储，可编译为 PDF、ePub 或任何您喜欢的格式。

适合对象

• 希望在不失去叙事控制权的情况下获得 AI 协助的小说家与世界构建者。
• 需要连贯设定与可追踪情节伏笔的游戏设计师或桌上角色扮演游戏创作者。
• 喜欢将故事视为软件项目（版本化状态、检查工具、自动化检查）的人。

社区与贡献

• 官方 Discord、QQ 群组以及公开文档网站（中英文皆有）。
• 该仓库是一个包含约 15 个工作区的 monorepo（核心应用、管理器、各种库、llmlint 包等）。
• 欢迎贡献：提示工程、UI 重设计、文档编写、测试，甚至是非技术性的社区工作。

授权 – AGPL-3.0-only。您自己的作品仍归您所有；仅对 NeuroBook 本身的修改受 copyleft 条款约束。

---

以上所有细节均直接取自仓库的 README；未推论任何额外功能。