AI-Novel-Writing-Assistant

AI 小说创作工作台

Biz Novel Studio · 从一句灵感，走向一本完整小说

AI 帮你规划世界与角色、逐章写作、检查和保存，让长篇创作有一条可以继续走下去的路。

Open-source AI novel writing assistant and long-form production studio.

下载 Windows 桌面版 · 项目介绍与文档 · 第一次使用 · 源码运行 · 问题反馈

你只需要先有一个想法。这个工作台会帮你把方向、人物、世界和章节接起来，在创作过程中保留正文、设定与进度。长篇由自动导演持续推进，短篇走独立的完整成稿流程。它面向第一次写小说的人，也为需要维护长期资料、研究 AI 创作流程的作者与开发者提供更细的工具。

桌面版适合直接开始写作；源码版适合开发和自行部署。 模型需要使用你自己的 API 配置，知识库检索可按需启用。

最新更新 · 能做什么 · 导演版本与模式 · Token 缓存优化 · 功能预览 · 文档导航 · 参与项目

最新更新

2026-10-11

新增

• 正式版本 v0.5.6 聚合正文候选局部采纳、半自动导演步骤校准和本章版本安全入口，继续完善正文编辑与半自动创作的可控性。
• 正式版本 v0.5.5 完善章节问题卡来源页闭环：可完成“定位、修改、保存、确认已处理、重新分析”，没有可靠对应问题的 AI 建议不会被误标为已解决。
• 正式版本 v0.5.4 增加正文光标 AI 续写：可选择继续下一段、生成过渡、增加对话、环境描写、心理描写或推进冲突，并先比较多个候选再写回正文。

优化

• 正式版本 v0.5.7 提供正文快捷保存与历史正文保护，并修复章节资料整理和重复序号的卷规划保存问题，发布包可从 GitHub Releases 获取。
• 半自动导演停在步骤审核时，可以从步骤清单选择其他已有结果重新完善或生成，并带上自己的调整要求；生成后回到审核节点确认，再继续后续流程。
• 正文 AI 候选会把连续的删除、新增合并为一个替换项，支持只选择需要采纳的改动写回正文，未选部分保留原文，减少反复手动修整。
• 正文编辑器新增“本章版本”入口，可以在当前页面预览历史正文并载入编辑区；保存前不会改动已保存正文，避免为了找回一章内容而误恢复整本小说。
• 正文编辑器支持 Ctrl/Cmd+S 快捷保存，接受 AI 修改后本章版本列表会立即更新，连续修改时少一次来回操作。
• 从历史版本载入正文后，首次保存会先保护当前已保存内容，载入前的正文仍可回看，版本调整更安心。
• 正式版本 v0.5.3 聚合正文编辑草稿保护、AI 按需诊断和半自动导演修改回填，发布包可从 GitHub Releases 获取。
• 正文编辑器会保留未保存草稿和外部新版本，AI 改写候选只在原文未变化时应用；保存或接受修改后不会自动重复触发章节诊断，作者可按需重新分析本章。
• 半自动导演停在步骤确认时，章节执行台会在正文上下文中提供“确认本章修改并继续”，作者保存正文后可直接把修改交还给导演推进。
• 正式版本 v0.5.2 聚合自动导演的用量统计、角色出场安排、参考仿写版本选择和模型设置优化，发布包可从 GitHub Releases 获取。
• 正式版本 v0.5.1 聚合本轮自动导演稳定性与用量优化，发布包可从 GitHub Releases 获取。
• 自动导演按章节统计正文 AI 用量时，会把服务后续章节的规划调用单独计算，不再让规划 Token 挤占当前章节的正文预算；章节资产整理切换备用模型时减少重复生成，降低不必要的 AI 用量；达到预算时仍保留已保存正文和恢复位置。

修复

• 章节资料整理对模型输出的数字格式更兼容，伏笔漏写标题时保留已有线索，减少格式差异导致的创作中断。
• 卷规划保存时会提示重复的卷序号或本卷章节序号，并保留已有规划，便于调整后重新保存。

完整历史更新见 版本更新说明。

现在已经能做什么

创作中枢 Creative Hub 也提供对话式的创作引导、规划和工具调用，帮助你找到下一步。漫画与短剧适合在小说主线、角色和章节内容明确之后使用。了解创作中枢

导演版本与运行模式

长篇创作先选导演版本，再选这次怎样推进。V2 不等于全自动，V1 也不等于手动。 短篇使用独立流程，不参与导演版本选择。

V1 与 V2 怎么选

开书页可以选择可用的导演版本。已有小说需要先结束当前创作，再在本书设置切换；已保存正文与历史记录会保留。切换版本只保存选择，不会自动开始生成，也不会恢复另一个版本的旧任务。

桌面版和源码部署默认提供 V1/V2 选择；如需暂时关闭 V2，可显式设置 DIRECTOR_NEXT_ENABLED=false。此开关只控制 V2 是否可用，不会替已有小说更换导演。

V2 的全自动与按阶段确认

书名旁与导演台顶部会显示当前方式，后续正文批次沿用所选模式。V2 的阶段确认在本书导演台完成；“运行记录”负责查看状态和打开来源页，继续、恢复、取消等操作在来源工作台处理。

全自动为什么也可能停下

全自动会继续执行你授权的范围，范围完成后需要你选择下一段。例如提交第 1—3 章，完成后不会擅自写第 4 章。

遇到模型不可用、需要重新规划、用量保护或数据完整性问题时，系统也可能暂停。普通局部质量问题默认记录为章节提醒并继续；如果明确选择“质量优先”的处理策略，则可能在正文保存后等待人工处理。

V2 单章安全上限为 100,000 Tokens，累计包含该章的生成、检查与修文调用，也包含缓存命中的输入。它不是“正文应消耗的目标值”，与整次创作预算不同。达到上限时应结合本书用量查看原因；已有保存结果会保留，继续操作从本书导演台进行。

快速开始

下载安装

普通写作使用推荐 Windows 桌面版，无需安装 Node.js、pnpm 或手动启动服务端。

前往最新桌面版下载页 →

选择创作入口

用 V2 写出第一段正文

1. 配置模型。 在系统设置填写供应商、API Key、API 地址和文本模型，完成连接测试；首次使用先确保一个模型可用。
2. 输入灵感。 从小说开书入口选择 V2，输入故事想法。没有想法时可先看热门题材，有参考作品时可从完成的拆书进入。
3. 选择方向。 查看候选方案和标题，选定这本书想写成的样子，再进入本书导演台。
4. 选择推进方式与范围。 想让 AI 连续推进就选全自动，想核对阶段结果就选按阶段确认；先提交一小段章节，观察正文效果与用量。
5. 查看并继续。 勾选“跟随生成”观看正文流式输出。范围结束后检查已保存章节，选择下一段；出现暂停时阅读原因，从本书导演台处理。

写法引擎、知识库和高级模型路由可以在跑通第一段正文后逐步配置。安装与准备 · 热门题材雷达 · 参考作品开书

写一篇完整短篇

配置好模型后，打开“创作短篇”，输入想法，让 AI 推荐方向与篇幅；选择方向后开始生成。调整篇幅或创作方向时，先让 AI 重新适配方案，再确认生产。

短篇按内部片段生成，阅读与导出呈现连续正文；成稿后进行全篇检查和至多一次必要修复。你可以直接编辑，也可以提出修改要求，核对 AI 的修改范围后确认。“发展成长篇”会创建新作品，保留原短篇。

AI 用量怎么看

在 V2 本书顶部或书架打开 “AI 用量”，先看全书已记录用量，再按章节、步骤、厂商、模型或状态筛选调用。规划、正文、审阅和修文都可能产生消耗，不能只按最终正文长度判断。

• 总 Tokens = 输入 Tokens + 输出 Tokens。 缓存命中与未命中属于输入，不要再加一次。
• 缓存统计以厂商返回为准；没有提供的统计显示未知，不能当作零。固定规则与稳定资料更容易复用，正文和章节任务变化时命中率可能不同。
• 用量页覆盖已记录的调用；未记录的旧历史不会被估算补齐。Tokens 是调用计数，实际费用以厂商账单为准。

遇到暂停或错误

先查看本书导演台的暂停原因，再从对应工作台处理；需要追溯时打开“运行记录”查看状态和来源。保存的正文与任务进度有独立边界，重复点击生成不能代替恢复。

常见问题 · 故障排查

Token 缓存与调用优化

长篇创作会反复使用本书约定、写法与世界规则。工作台把可复用的规则和书级、卷级资料放在输入前部，再附上本章任务、当前状态与正文，为模型供应商复用相同前缀提供条件。缓存复用的是已处理过的输入，正文仍由模型基于本次任务生成。

哪些部分做了优化

• 稳定资料前置。 表达规则、作品约定和适用的世界规则按复用范围组织；每次读取当前资料，修改设置后后续调用使用新内容。
• 同章修文复用前缀。 局部修文把本次修复重点放在同章资料和正文之后，资料与正文未变化时更容易复用前缀，同时保留写法、世界约束和秘密边界。
• 有效审校结果复用。 正文、创作约定、检查规则、模型与参数等相关条件一致时，复用有效的检查结果，减少相同请求的重复调用。这与厂商的输入缓存是两种机制。
• 减少无效修文与复验。 检查区分必须修复的缺口和普通表达建议，结合修改位置与实际效果处理局部问题，避免反复改整章；默认完成优先策略下，残余局部问题保留为质量提醒。

不同步骤，复用空间不同

正文需要输入新的剧情和状态，这部分未命中是正常成本。首次调用、切换模型或通道、修改书级资料，也可能让命中量发生变化。优化效果应结合正文质量、输入命中与未命中 Tokens、输出 Tokens、调用次数和单章总用量一起判断。

从哪里查看实际效果

在本书 “AI 用量” 中筛选同一章节、步骤与模型，比较连续调用的输入、输出、命中和未命中 Tokens。也可以在 AI 实况 中查看正在执行的调用。

缓存命中与未命中都属于输入 Tokens，不在总用量之外重复相加。 缓存统计以厂商实际返回为准，未提供的字段显示未知；缓存收益受厂商、模型与通道的机制影响，不能承诺固定命中率或节省比例。命中量仍计入单章安全预算，实际费用以厂商账单为准。

面向开发者的详细边界见模型输入缓存 Wiki与小说 AI 用量说明。

功能预览

以下截图展示现有功能示例，包含 V1 工作台与资料工具；界面与当前版本可能有差异。V2 的入口、模式与操作以上方使用说明为准。

章节写作与拆书

V1 章节执行工作台	拆书与参考资料
正文、章节任务与检查结果围绕同一章组织。	从作品结构和原文证据中整理可复用的创作资料。

展开：开书方向与 V1 分阶段工作台

开书方向选择

V1 的故事规划与角色准备

故事宏观规划	角色准备

V1 的卷规划与节奏拆章

卷战略	节奏与章节规划

展开：世界资料、写法与模型配置

世界资料与可视化

写法引擎与反 AI 规则

写法资产	表达规则

模型配置

从灵感到章节的创作链

下面展示长篇的持续创作路径。实线表示创作推进，虚线表示按需导入资料或提供约束；短篇进入独立的计划、生成与全篇检查流程。

flowchart TB
    subgraph Planning[开书与本书规划]
        IDEA[灵感与故事方向] --> CONTRACT[本书创作约定]
        CONTRACT -->|按题材需要准备| WORLD[本书世界 · 规则与舞台]
        WORLD --> CHARACTERS[本书角色 · 目标与关系]
        CHARACTERS --> PLAN[卷纲与近期章节规划]
    end

    subgraph Assets[可选外部资产与表达规则]
        REFERENCE[参考作品 · 拆书结果]
        WORLD_LIBRARY[外部世界 · 世界样本库]
        CHARACTER_LIBRARY[外部角色 · 基础角色库]
        STYLE_LIBRARY[写法引擎 · 写法资产]
        ANTI_AI[去 AI 化 · 反 AI 规则]
        KNOWLEDGE[知识库 · 参考资料]
        RULES[本书生效写法与表达规则]
    end

    subgraph Production[章节生产与持续创作]
        RANGE[授权正文范围] --> CONTEXT[组装本章上下文]
        CONTEXT --> DRAFT[正文生成]
        DRAFT --> REVIEW[章节检查]
        REVIEW -->|通过或按策略保留提醒| SAVE[保存正文与检查结果]
        REVIEW -->|按策略允许修正| PATCH[预算内局部修文]
        PATCH --> RECHECK[复验并选择保留稿]
        RECHECK --> SAVE
        SAVE --> STATE[同步角色 · 资源 · 伏笔状态]
        STATE -->|本次范围完成| RESULT[查看结果与质量提醒]
        STATE -->|授权范围内继续| CONTEXT
    end

    PLAN --> RANGE
    RESULT -->|选择下一批| PLAN
    REFERENCE -.->|参考结构与人物| CONTRACT
    REFERENCE -.->|提取文风与技法| STYLE_LIBRARY
    REFERENCE -.->|沉淀参考资料| KNOWLEDGE
    WORLD_LIBRARY -.->|导入为本书副本| WORLD
    CHARACTER_LIBRARY -.->|导入并适配本书| CHARACTERS
    STYLE_LIBRARY -.->|绑定本书写法| RULES
    ANTI_AI -.->|全局基线与写法专属规则| RULES
    WORLD -.->|世界规则与秘密边界| CONTEXT
    CHARACTERS -.->|人物事实与当前状态| CONTEXT
    KNOWLEDGE -.->|按需召回| PLAN
    KNOWLEDGE -.->|按需召回| CONTEXT
    RULES -.->|生成遵循表达约束| CONTEXT
    RULES -.->|专项检测按设置启用| REVIEW
    RULES -.->|修文遵循规则与权限| PATCH

• 外部世界与角色： 世界样本导入为本书世界副本，角色库资产导入为本书角色，按当前故事调整；本书剧情变化保留在书内，长期资产由你决定是否同步。
• 写法与去 AI 化： 写法引擎与反 AI 规则提供生效的表达约束。专项检测按设置加入章节检查；需要修正时，沿用局部修文流程与规则权限，只提醒的规则保留为质量提醒。
• 参考资料与状态回流： 拆书和知识库提供按需参考，每章写后同步的人物、资源和伏笔状态参与后续章节，帮助连续创作承接已发生的剧情。

V1 与 V2 分别编排这条链，已保存的小说资料可以复用。章节检查与修文按本次质量策略执行，暂停与恢复方式见使用说明。

查看生产链与交互架构图

打开交互架构图 · 图表源数据

交互图由 Archify 生成，展示产品生产链的细节；V2 的独立运行与恢复规则见开发 Wiki。

文档导航

也可以在在线文档站搜索模块与使用问题。

源码运行

环境要求

安装与启动

git clone https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant.git
cd AI-Novel-Writing-Assistant
pnpm install

复制服务端配置文件，任选与你的终端对应的一条：

# Windows PowerShell
Copy-Item server/.env.example server/.env

# macOS / Linux
cp server/.env.example server/.env

在 server/.env 中确认：

# 默认开放 V1/V2 选择；如需暂时关闭 V2，可设置为 false
DIRECTOR_NEXT_ENABLED=true

# 尚未配置 Qdrant 时关闭检索，先跑通创作
RAG_ENABLED=false

然后在仓库根目录启动：

pnpm dev

前端默认为 http://localhost:5173，服务端为 http://localhost:3000。首次开发启动会准备 Prisma Client 与数据库结构，通常无需先手动执行数据库命令；如需连接已有数据库，先核对配置并保留备份。启动后打开系统设置配置并测试模型。

Web 开发默认通过 Vite 的同源 /api 代理访问服务端，同机与局域网访问通常无需创建 client/.env。前后端分开部署或需要指定其他服务端时，才设置 VITE_API_BASE_URL。

常用命令

完整命令以根目录 package.json为准；测试范围与隔离规则见后端测试说明。

高级配置：环境变量、知识库与安装排查

配置文件在哪里

• 服务端读取 server/.env；前端读取 client/.env 或 client/.env.local。
• 根目录 .env.example 用作总览，不能代替子包配置。
• API Key 和模型可以在系统设置保存；模型路由用于分别配置规划、正文、审阅和拆书。
• 默认 SQLite 连接为 file:./dev.db；已有数据的位置由实际运行配置决定，桌面版与源码版的数据目录不同。

前后端分开运行

如果前端需要连接另一台机器上的 API，在 client/.env 中填写：

VITE_API_BASE_URL=http://your-server:3000/api

更改 Vite 环境变量后重新启动前端。服务端端口、绑定地址和跨域配置见 server/.env.example；正式 Web 部署还需要按实际域名设置访问边界。

启用知识库检索

准备 Qdrant 地址与凭据，在 server/.env 中配置：

RAG_ENABLED=true
QDRANT_URL=http://127.0.0.1:6333
QDRANT_API_KEY=

使用远程实例时替换地址和凭据。启动后在“知识库 → 向量设置”配置 Embedding 模型与集合，再导入并索引资料。知识库使用说明

安装卡住或桌面运行时未准备

先检查 Node 版本与包管理器配置：

node -v
pnpm -v
pnpm config get script-shell
npm config get script-shell

如果 script-shell 配置为 cmd.exe /k，安装脚本可能停在交互式提示符；移除该自定义设置后重开终端再安装。桌面开发首次需要下载 Electron 运行时，网络不可用时先处理代理或镜像；也可单独执行 pnpm run prepare:desktop-runtime。

技术栈与架构

client/   Web 界面、小说工作台与导演台
server/   API、模型调用、导演与章节生产
shared/   前后端共享类型与运行契约
desktop/  Electron 壳、桌面运行与打包
site/     公开介绍站与文档导航
docs/     使用文档、开发 Wiki、设计与发布记录
scripts/  启动、验证与工程脚本
images/   功能预览与文档截图

V2 内核位于 server/src/modules/director/，业务能力由应用层接入；V1 保留自己的编排模块。两者共用已保存的小说资产与底层章节能力，任务、恢复和版本归属独立管理。版本隔离规则 · 模块边界 · 章节生产链

参与项目

欢迎通过 Issues反馈问题，或提交 Pull Request。优先关注连续生成与恢复、新手开书体验、长篇一致性和可追溯的模型用量。反馈时附上使用版本、所选导演与模式、操作步骤和相关日志，会更容易定位问题。

提交贡献前请阅读 CONTRIBUTING.md 与 CLA.md，并说明第三方代码、素材及其许可证。感谢参与测试、提出建议和提交修复的朋友，也感谢贡献者 @ystyleb。

交流与支持

展开：QQ 交流群与支持项目

想交流创作体验、自动导演或项目开发，可以扫码加入 QQ 群。如果工作台对你有帮助，也欢迎支持持续开发与维护。

QQ 交流群	支持项目（支付宝）

在 Codex 中创作：Ani Book Skill

希望直接在 Codex 的本地文件工作区推进长篇，可以了解配套的 Ani Book Skill，通过阶段工件持续规划、写作和审校。本仓库提供可视化工作台，两种入口按你的使用习惯选择。

License

本项目采用双许可证授权模式：

• 默认基于 GNU Affero General Public License v3.0（AGPLv3）授权，详见 LICENSE；归属与附加说明见 NOTICE。
• 服务型商用：将本项目或其修改版本作为后端，以 SaaS、托管等形式向第三方提供服务，须通过作者获取商业授权许可。
• 新贡献默认按 CLA.md 提交，可随项目按 AGPL-3.0-only 分发，也可纳入维护者另行提供的商业授权。

贡献与授权说明 · LINUX DO