> ## 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 用量与 Token 缓存

> 查看 AI 调用消耗、理解 Token 缓存机制与单章用量保护

AI 用量与 Token 缓存是理解创作成本和优化调用效率的重要模块。工作台在写作过程中会详细记录每次 AI 调用的消耗，并通过缓存机制减少重复成本。

> [!NOTE]
>
> 用量页覆盖已记录的调用；未记录的旧历史不会被估算补齐。实际费用以厂商账单为准。

## AI 用量怎么看

在 V2 本书顶部或书架打开 **「AI 用量」**，可以查看和筛选调用记录。

### 查看维度

| 筛选维度 | 说明 |
| - | - |
| 全书总计 | 整本小说已记录的输入与输出 Tokens |
| 章节 | 按章节查看该章累计消耗 |
| 步骤 | 规划、正文、审阅、修文等不同阶段的消耗 |
| 厂商 | 按供应商分组，适合多厂商配置时核对 |
| 模型 | 不同模型在各步骤的消耗对比 |
| 状态 | 成功、失败或重试的调用统计 |

### 理解总 Tokens

**总 Tokens = 输入 Tokens + 输出 Tokens。** 缓存命中与未命中都属于输入，不要再加一次。

规划、正文、审阅和修文都可能产生消耗，不能只按最终正文长度判断费用。

## Token 缓存与调用优化

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

### 哪些部分做了优化

* **稳定资料前置**：表达规则、作品约定和适用的世界规则按复用范围组织；每次读取当前资料，修改设置后后续调用使用新内容。
* **同章修文复用前缀**：局部修文把本次修复重点放在同章资料和正文之后，资料与正文未变化时更容易复用前缀。
* **有效审校结果复用**：正文、创作约定、检查规则、模型与参数等相关条件一致时，复用有效的检查结果，减少重复调用。
* **减少无效修文与复验**：检查区分必须修复的缺口和普通表达建议，残余局部问题保留为质量提醒，避免反复改整章。

### 不同步骤的复用空间

| 步骤 | 可以复用的主要资料 | 必须随创作更新的内容 |
| - | - | - |
| 章节规划 | 书级定位、作品约定、适用的卷级目标 | 本章任务、近期结果、人物状态 |
| 正文生成 | 写法与表达规则、作品约定、适用的世界规则 | 上章接续、本章事件、场景和人物状态 |
| 章节检查 | 检查标准、同章任务与约定 | 当前待检查正文与修文结果 |
| 局部修文 | 本书写法、同章资料、未变化的正文 | 本次问题证据、修复重点和追加要求 |
| 写后资料整理 | 抽取规则、确实未变化的相关资料 | 新正文、角色变化、资源与伏笔状态 |

正文需要输入新的剧情和状态，这部分未命中是正常成本。首次调用、切换模型或通道、修改书级资料，也可能让命中量发生变化。

### 查看实际效果

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

缓存统计以厂商实际返回为准；未提供的字段显示「未知」。实际费用以厂商账单为准。

## 单章用量保护

V2 单章默认用量保护上限为 **100,000 Tokens**，累计包含该章的生成、检查、修文与资料整理调用。

### 计算方式

* **新章节**：按输入扣除供应商已报告的缓存命中后，加输出计数。
* **历史章节**：保留原计量方式。

达到上限时，系统会在本书导演台暂停并展示原因，你可以按建议额度或自定额度继续本章；正文、累计用量和恢复位置都会保留。

### 触发上限后的处理流程

```mermaid theme={null}
flowchart TD
  A["单章累计调用"] --> B{"达到 100000<br/>Tokens 上限？"}
  B -->|是| C["导演台暂停执行"]
  C --> D["展示暂停原因"]
  D --> E{"用户选择继续方式"}
  E -->|建议额度| F["追加并恢复本章"]
  E -->|自定额度| G["新上限需大于<br/>已用与预留"]
  G --> F
  F --> H["保留正文与累计用量"]
  B -->|否| I["正常推进"]
```

### 用量筛选路径

你可以从以下维度穿透查看调用记录：

```mermaid theme={null}
flowchart LR
  A["AI 用量页"] --> B["全书总计"]
  A --> C["按章节"]
  A --> D["按步骤"]
  A --> E["按厂商"]
  A --> F["按模型"]
  A --> G["按状态"]
  C --> H["该章累计消耗"]
  D --> I["规划 正文 审校 修文 资料整理"]
```

### 用量计算器

下面的计算器帮助你理解单章用量的构成与保护上限的关系。输入各参数后，它会按规则计算计费 Tokens 和占默认上限的比例。

输入 Tokens

包含缓存命中与未命中的全部输入

缓存命中 Tokens

供应商已报告的缓存命中部分

输出 Tokens

计费 Tokens（输入扣命中 + 输出）

占默认上限（）

%

规则说明：新章节按输入扣除供应商已报告的缓存命中后加输出计数；历史章节保留原计量方式。

> [!NOTE]
>
> 此计算器为示意工具，用于理解用量构成规则。实际用量与费用以工作台 AI 用量页记录和厂商账单为准。

## 常见问题

> [accordion] 缓存命中为什么能减少成本
>
> 厂商对缓存命中部分通常收取较低单价。缓存复用的是已处理过的输入前缀，因此新调用只需为新增内容和输出付费。

> [accordion] 命中率低怎么办
>
> 先看是否频繁切换模型或修改书级资料，再看章节任务是否变化过大。稳定资料前置和固定写法规则有助于提升命中。

> [accordion] 单章上限可以调整吗
>
> 达到上限时可在本书导演台按建议或自定额度继续，系统会保留已有正文和累计用量。

> [accordion] 为什么实际费用和用量页不同
>
> Tokens 是调用计数，不同厂商对输入、输出和缓存的定价不同。实际费用以厂商账单为准。

> [accordion] 用量页显示「未知」是什么意思
>
> 缓存统计依赖厂商返回。若厂商未提供命中/未命中数据，则显示「未知」，不应当作零。

> [card] [自动导演](https://ai-novel-writing-assistant.mintlify.site/features/auto-director.md)
>
> 了解长篇推进中各阶段的调用来源

> [card] [模型配置](https://ai-novel-writing-assistant.mintlify.site/model-configuration.md)
>
> 配置供应商、模型路由与输出上限


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