AI 小说引擎使用手册

这插件只有一个目标：让长篇写作别靠脑子硬记。

它会把你的内容拆成两类：

• 正文：你正在写的章节内容
• 资料：世界设定、角色卡、人物关系、章节大纲、进度脉络

然后用“资料 + 前文 + 检索”去辅助你做：走向、续写、整理进度、审计冲突、改稿。

0. 开始前你必须搞清楚的事

0.1 菜单入口

插件入口在菜单：小说。

菜单项（不包含“兑换充值卡”）：

• 设置
• 项目管理
• 一键开坑（从 0 开始）
• 导入现有文稿（初始化资料）
• 写作咨询（不续写）
• 开始下一章（新建章节文件）
• 走向及续写
• 审阅/修改草稿（对话）
• 更新资料文件（提议）
• 更新进度脉络
• RAG 索引（向量检索）
• 一致性审计

0.2 必要前置条件（不满足就别问为什么按钮报错）

• 先在“设置”登录：大部分功能都要求已登录。
• 配置上游模型地址与模型名：生成走向/续写/审计/改稿/进度更新都需要。
• 配置 embedding 地址与模型名：资料检索与导入现有文稿需要（用于建立检索索引）。

0.3 “当前项目”怎么确定

插件必须知道你正在写哪部小说（哪个项目目录），否则它不知道去读资料文件、也不知道把进度写到哪。

确定方式只有两种：

1. 在 项目管理 里选择并“设为当前项目”
2. 你当前打开的文件本身就在项目目录里（例如打开某一章文件）

1. 项目与文件结构（这就是插件的“记忆”）

一个项目就是一部小说的工作区。默认目录形态类似这样：

• 小说/<项目名>/00_项目.md：项目说明
• 小说/<项目名>/01_进度脉络.md：全书进度摘要（越勤更新越不跑偏）
• 小说/<项目名>/02_世界设定.md（或 02_故事圣经.md）：世界观与规则
• 小说/<项目名>/03_主要角色.md：人物卡
• 小说/<项目名>/04_人物关系.md：关系网
• 小说/<项目名>/05_章节大纲.md：大纲/节奏/主线
• 小说/<项目名>/03_章节/001_第一章.md：章节文件（后续章节按序号递增）

• 小说/<项目名>/.ainovel/：插件内部文件（索引与元数据），一般别手动改

  • .ainovel/rag_meta.json：检索索引元数据
  • .ainovel/rag_vectors.f32：检索索引向量文件

2. 两条“正确的开局”

2.1 从 0 开坑（新项目）

1. 一键开坑（从 0 开始） → 填“故事概念”
2. 点“AI 生成资料”（可多轮补充回答）→ 把资料先改到满意
3. 点“生成第一章”→ 得到第一章草稿
4. 点“创建项目并写入文件”→ 真正创建项目目录，写入资料文件与 001_第一章.md

重要提示：新项目“生成第一章”主要依据你的故事概念生成，不一定完整吸收刚刚生成的资料。你要么自己改草稿，要么在后续写作里用“走向及续写”把关键设定写进硬性要求再续写。

2.2 从已有正文开坑（你已经写了一堆）

1. 把章节文件放到 小说根目录/项目名/03_章节/…（否则先去设置里改“小说根目录”，或移动文件）
2. 导入现有文稿（初始化资料） → 选择项目 → 点“构建/更新 RAG 索引”
3. 点“生成初始化提议”→ 它会给出进度/设定/角色/关系/大纲的“提议版本”
4. 你审阅后点“写入所选资料文件”→ 覆盖写入资料文件，并可选择是否更新索引

3. 每个按钮到底干什么（按菜单顺序）

3.1 设置

你在这里做三件事：

1. 登录/注册账号，并查看余额与计费说明
2. 设置“小说根目录”（默认 小说/）
3. 配置上游模型与 embedding（地址、模型名、可选密钥）

另外还有两类重要设置：

• 上下文预算：控制“前文尾部/进度脉络/资料”各自最多带多少内容
• 全局硬性要求：每一次生成都会默认遵守（你在其它窗口写的“本次硬性要求”会叠加在后面）

3.2 项目管理

你在这里管理项目目录：

• “设为当前项目”：告诉插件你现在写哪部小说
• “打开资料文件”：依次打开 01_进度脉络.md 到 05_章节大纲.md（缺文件会自动创建空壳）
• “弃坑（删除项目）”：删除整个项目目录（不可恢复）

3.3 一键开坑（从 0 开始）

这个窗口有三步：

• “AI 生成资料”：只生成资料（世界/角色/关系/大纲），不会写正文；支持“补充回答”多轮完善
• “生成第一章”：生成第一章草稿（不自动写入文件）
• “创建项目并写入文件”：创建项目目录、写入资料文件、写入 001_第一章.md，并自动更新一次进度脉络、后台更新检索索引

3.4 导入现有文稿（初始化资料）

这不是“导入正文到编辑器”，而是：把你已有章节反向提炼成资料文件。

你会看到四个关键按钮：

• “设为当前项目”：先锁定目标项目
• “构建/更新 RAG 索引”：先把章节做成可检索记忆库（这是必要前置）
• “生成初始化提议”：生成进度/设定/角色/关系/大纲的提议版本（不自动写入）
• “写入所选资料文件”：确认后覆盖写入所选资料文件，并可选择是否更新索引

注意：

• 这是覆盖写入（不是追加），写之前先自己看一遍提议内容
• 提议里只要有某个文件为空，插件会拒绝写入，避免把你原来的资料清空

3.5 写作咨询（不续写）

它只给建议，不写正文。适合你卡文、要结构、要节奏、要人物动机时用。

• 你提供：咨询问题 +（可选）本次硬性要求
• 它会参考：进度脉络、资料文件、前文末尾、检索命中的相关片段
• 它会写入：默认不写；只有你点“把建议追加到文末”才会写进当前文档

3.6 开始下一章（新建章节文件）

它会在 03_章节/ 下自动创建一个新文件并打开，文件名形如：

• 003_第三章.md

文件内容只有一个标题：

• # 第三章

重要提示：打开这个新章节文件后，再去用“走向及续写”并选择“追加到文末”，正文就会写入这个章节文件。

3.7 走向及续写

这是日常写作的主力窗口，包含五类动作：

• “生成走向候选”：给出多个下一步走向（最多等 3 分钟）
• “按选中走向续写”：按你选中的走向生成正文
• “直接按指令续写”：不走候选，直接按你的要求续写
• “插入候选 JSON 到文末”：把候选清单以结构化格式写到文末（可选，一般只用于留档）
• “追加到文末（立即生效）”：把生成的正文追加到当前文档末尾，并触发自动更新进度脉络与索引

这窗口还有两件非常关键的事（很多人会忽略）：

• “追加为草稿（可审阅）”：把正文作为“草稿块”追加到文末（用于后续对话改稿）；草稿阶段不会自动更新进度
• “审阅/修改草稿（对话）”：直接打开草稿对话改稿窗口

它会参考的内容（你不需要手动拼）：

• 你的写作要求（本章目标）
• 你的硬性要求（语气/节奏/视角/禁写项/变更单等）
• 当前文档末尾（正文太短时会回退去读上一章末尾）
• 进度脉络、资料文件、检索命中片段

3.8 审阅/修改草稿（对话）

这是“改稿窗口”，只改你选定的草稿块，不会乱改整篇。

工作方式很简单：

1. 先用“走向及续写”生成正文，并选择“追加为草稿（可审阅）”
2. 打开“审阅/修改草稿（对话）”
3. 一条条写修改要求（越具体越好），让它输出修订版本
4. 你满意后点“覆盖草稿块（定稿）”

定稿时才会触发自动更新进度脉络（避免反复改稿把进度污染成垃圾）。

3.9 更新资料文件（提议）

当你“改设定/加角色/重排大纲”时用这个，而不是把设定散落在聊天里。

• 你提供：变更目标/要求（必填）+（可选）本次硬性要求
• 它会参考：当前资料文件 + 进度脉络 + 前文末尾 + 检索命中片段
• 它会产出：每个资料文件的“更新提议”（你可以手动再改）
• 只有你点“写入所选资料文件”才会覆盖写入，并可选择是否更新索引

3.10 更新进度脉络

它会从你选中的文本（优先）或当前文档内容中，生成“进度脉络更新提议”，你确认后写入 01_进度脉络.md。

流程：

1. 点“生成更新（优先选中文本）”→ 看到更新提议
2. 点“写入进度脉络文件”→ 追加写入 01_进度脉络.md
3. 写入后会尝试更新检索索引（失败不影响写入）

3.11 RAG 索引（向量检索）

这是“建立/更新检索索引”的工具窗口：

• “构建/更新索引”：扫描项目里的文本并更新索引文件
• “打开索引文件”：打开 .ainovel/rag_meta.json

你不更新索引也能写，但索引越新，检索命中越准。

3.12 一致性审计

它会检查冲突（人设、时间线、设定、关系网、已发生事件是否被改写等）。

• 输入：优先审计你选中的段落；没选中就审计全文
• 输出：审计报告会直接追加到当前文档末尾

4. “读/写”速查表（别猜，按这个来）

5. 推荐工作流（按这套走，长篇就不乱）

1. 打开当前章节文件（确保插件能推断当前项目）
2. 写作前：更新进度脉络 把“当前状态”补齐（可选，但强烈建议）
3. 走向及续写：先候选、再续写，满意就“追加到文末”
4. 需要精修：用“追加为草稿” → 审阅/修改草稿（对话） → 定稿覆盖
5. 章节收尾：一致性审计 先审一段再审全章

6. 硬性要求怎么写（写成规则，不要写成愿望）

硬性要求就是“必须遵守的约束”。分两层：

• 全局硬性要求：在“设置”里写，所有功能都会默认遵守
• 本次硬性要求：在具体窗口里写，只对本次请求生效（会叠加在全局硬性要求后面）

写法建议：

• 用短句、可检查：例如“第一人称现在时”“不出现网络热梗”“主角不杀无辜”
• 禁止项优先：例如“禁止新增主要角色”“禁止改写已发生剧情”
• 改设定要写成变更单：例如“从本章起，女主已知道真相（第 12 章回收伏笔）”

7. 费用与写入规则（避免误会）

• 可能消耗额度：生成第一章、走向候选、续写正文、进度脉络更新、一致性审计、对话改稿
• 通常不消耗额度：生成资料、写作咨询、更新资料文件（提议）、导入现有文稿（初始化资料）、建立/更新索引（但会调用 embedding）
• 默认不会改你文档：咨询/走向/续写/资料更新都要你点“追加/写入”才会落地；一致性审计是直接追加到文末（别惊讶）

8. 常见问题（都是你自己没按规则来）

8.1 提示“无法推断当前项目”

• 先在“项目管理”设为当前项目
• 或者打开项目目录下任意文件（章节/资料都行），再重试

8.2 续写跑偏/忘设定

• 先更新 01_进度脉络.md（你不更新，它就只能猜）
• 资料大改后手动更新一次索引
• 把关键禁写项写进硬性要求，不要写成“希望你…”

8.3 检索命中不准/像没起作用

• 确保章节与资料是 md/markdown/txt 文本
• 确保索引是新的：在 RAG 索引（向量检索） 里构建/更新一次