> ## Documentation Index
> Fetch the complete documentation index at: https://ai-novel-writing-assistant.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 从安装到写出第一段正文

## 选择创作入口

| 想写什么 | 从哪里进入 |
| - | - |
| 连续推进的长篇小说 | 小说列表或首页的「AI 自动导演开书」，新书可选择 V2 |
| 一次读完、有完整结局的短篇 | 小说列表或首页的「创作短篇」，由 AI 整理方向与篇幅 |
| 参考一本作品开新书 | 先完成拆书，再从「照着一本书写」进入开书 |
| 先整理好大纲再写 | 在 [大纲工作台](https://ai-novel-writing-assistant.mintlify.site/features/outline-workbench.md) 建立大纲，确认后按大纲开书 |

```mermaid theme={null}
flowchart TD
  Q{你想写什么?}
  Q -- 连续推进的长篇 --> L[AI 自动导演开书<br/>新书可选 V2]
  Q -- 有完整结局的短篇 --> S[创作短篇]
  Q -- 参考一本作品 --> B[拆书] --> B2[照着一本书写]
  Q -- 已有大纲 --> O[大纲工作台] --> O2[按大纲开书]
  B2 --> L
```

## 导演 V1 与 V2 怎么选

| | 导演 V1 | 导演 V2 |
| - | - | - |
| 使用入口 | 原导演与小说工作台，保留分阶段创作入口 | 本书导演台，集中阅读目录、正文和资料 |
| 适合情况 | 继续原有小说，或沿用原工作台操作 | 从新书开始，按授权范围连续规划和生成 |
| 任务与恢复 | 使用自己的任务、检查点与恢复流程 | 使用自己的运行、阶段结果与保存进度 |

新书在 V2 可用时默认优先选择 V2。已有小说切换版本前需要先结束当前创作；已保存正文与历史记录会保留，切换只保存选择，不会自动开始生成。

```mermaid theme={null}
flowchart TD
  A{这是哪本书?}
  A -- 新书 --> V2[选 V2<br/>本书导演台]
  A -- 已有小说 --> K{想沿用原版本?}
  K -- 是 --> KEEP[继续原版本]
  K -- 否 --> SW[先结束当前创作<br/>再切换版本]
  V2 --> M{推进方式}
  M -- 让 AI 连续推进 --> FA[全自动<br/>授权范围内连续完成]
  M -- 想核对阶段结果 --> SA[按阶段确认<br/>需要确认时停下]
  FA --> END([范围完成后停下<br/>等你提交下一段])
  SA --> END
```

**推进方式**：全自动会在本次授权范围内连续规划、写正文、检查和保存；按阶段确认（半自动）会在需要确认的阶段停下来等你核对。全自动在授权范围完成后也会停下，例如提交第 1—3 章，完成后不会擅自写第 4 章。

## 用 V2 写出第一段正文

1. **配置模型。** 首次启动会弹出快捷配置，填写供应商、API Key、API 地址和文本模型并通过检测；首次使用先确保一个模型可用（见 [创作向导](https://ai-novel-writing-assistant.mintlify.site/onboarding.md) 与 [模型配置](https://ai-novel-writing-assistant.mintlify.site/model-configuration.md)）。
2. **输入灵感。** 从小说开书入口选择 V2，输入故事想法。没有想法时可先看热门题材，有参考作品时可从完成的拆书进入。
3. **选择方向。** 查看候选方案和标题，选定这本书想写成的样子，再进入本书导演台。
4. **选择推进方式与范围。** 想让 AI 连续推进就选全自动，想核对阶段结果就选按阶段确认；先提交一小段章节，观察正文效果与用量。
5. **查看并继续。** 勾选「跟随生成」观看正文流式输出。范围结束后检查已保存章节，选择下一段；出现暂停时阅读原因，从本书导演台处理。

```mermaid theme={null}
sequenceDiagram
  actor 你
  participant 工作台
  participant AI
  你->>工作台: 1. 配置模型并通过检测
  你->>工作台: 2. 选择 V2，输入灵感
  工作台->>AI: 生成候选方向与标题
  AI-->>你: 3. 候选方案
  你->>工作台: 选定方向，进入本书导演台
  你->>工作台: 4. 选推进方式，提交一小段章节
  loop 授权范围内每一章
    工作台->>AI: 规划、写正文、检查
    AI-->>工作台: 保存章节
  end
  工作台-->>你: 5. 范围结束，查看成稿与用量
  你->>工作台: 选择下一段，或处理暂停原因
```

写法引擎、知识库和高级模型路由可以在跑通第一段正文后逐步配置。

## 写一篇完整短篇

配置好模型后，打开「创作短篇」，输入想法，让 AI 推荐方向与篇幅；选择方向后开始生成。成稿后会进行全篇检查和至多一次必要修复；你可以直接编辑，也可以提出修改要求，核对 AI 的修改范围后确认。「发展成长篇」会创建新作品，保留原短篇。

```mermaid theme={null}
flowchart LR
  A[输入想法] --> B[AI 推荐方向与篇幅] --> C[选择方向] --> D[生成成稿]
  D --> E[全篇检查<br/>至多一次必要修复]
  E --> F{还想改?}
  F -- 直接编辑 --> G[手动修改]
  F -- 提出修改要求 --> H[核对 AI 修改范围后确认]
  F -- 发展成长篇 --> I[新建长篇<br/>原短篇保留]
```

## AI 用量怎么看

在 V2 本书顶部或书架打开「AI 用量」，可以按章节、步骤、厂商、模型或状态筛选调用。规划、正文、审阅和修文都可能产生消耗，不能只按最终正文长度判断。总 Tokens = 输入 + 输出，Tokens 是调用计数，实际费用以厂商账单为准。

V2 单章默认用量保护上限为 100,000 Tokens（累计该章的生成、检查、修文与资料整理调用）。达到上限时可在本书导演台查看原因，并按建议或自定额度继续本章，正文、累计用量和恢复位置都会保留。

## 遇到暂停或错误

```mermaid theme={null}
flowchart TD
  A[生成停下了] --> B[打开本书导演台<br/>阅读暂停原因]
  B --> C{原因类型}
  C -- 达到单章用量上限 --> D[按建议或自定额度继续本章]
  C -- 需要确认阶段结果 --> E[核对后确认继续]
  C -- 模型或其他错误 --> F[按提示到对应工作台处理]
  F --> G[需要追溯时打开运行记录]
  D --> H([从保存的进度继续])
  E --> H
  G --> H
```

先查看本书导演台的暂停原因，再从对应工作台处理；需要追溯时打开「运行记录」查看状态和来源。保存的正文与任务进度有独立边界，重复点击生成不能代替恢复。更多问题见 [常见问题](https://ai-novel-writing-assistant.mintlify.site/faq.md)，或到 [Issues](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/issues) 反馈。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.