AI_NovelGenerator 本地部署与使用教程

安装完依赖后，我们需要配置 API 密钥和模型参数。项目提供了一个示例配置文件 config.example.json，我们可以将其复制一份并改名为 config.json，然后在其中填写自己的 API 密钥和其他配置信息。

首先，复制示例配置文件：

cp config.example.json config.json

然后用文本编辑器打开 config.json 文件，根据你的实际情况填写 API 密钥、base_url、模型名称等信息。以下是一个配置示例：

{
  "api_key": "sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "base_url": "https://api.openai.com/v1",
  "interface_format": "OpenAI",
  "model_name": "gpt-4o-mini",
  "temperature": 0.7,
  "max_tokens": 4096,
  "embedding_api_key": "sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "embedding_interface_format": "OpenAI",
  "embedding_url": "https://api.openai.com/v1",
  "embedding_model_name": "text-embedding-ada-002",
  "embedding_retrieval_k": 4,
  "topic": "星穹铁道主角星穿越到原神提瓦特大陆，拯救提瓦特大陆，并与其中的角色展开爱恨情仇的小说",
  "genre": "玄幻",
  "num_chapters": 120,
  "word_number": 4000,
  "filepath": "D:/AI_NovelGenerator/filepath"
}

在这个配置文件中，你需要重点填写 api_key 和 base_url，这是连接 AI 模型的关键。同时，你还可以根据自己的需求调整 temperature（创意度参数，0-1，越高越有创造性）、max_tokens（模型最大回复长度）等参数。对于小说参数，如 topic（核心故事主题）、genre（作品类型）、num_chapters（总章节数）、word_number（单章目标字数）和 filepath（生成文件存储路径），也需要根据你的创作计划进行设置。

启动应用程序

配置完成后，就可以启动 AI_NovelGenerator 应用程序了。在终端中运行以下命令：

python main.py

执行后，GUI 界面将会启动，你可以在图形界面中进行各项操作，开始你的 AI 辅助小说创作之旅。

配置优化：让 AI 创作更符合你的需求

模型选择与参数调整

AI_NovelGenerator 支持多种 AI 模型，你可以根据自己的需求和预算选择合适的模型。在 config.json 文件中，你可以通过修改 model_name 来选择不同的模型。例如，如果你想使用 GPT-4 模型，可以将 model_name 设置为"gpt-4"。

除了模型选择，temperature 和 max_tokens 这两个参数也需要根据你的创作需求进行调整。temperature 控制生成文本的创造性，值越高，生成的文本越有创意，但也可能越不稳定；值越低，生成的文本越保守，但也越稳定。max_tokens 则决定了模型每次回复的最大长度，如果你需要生成较长的文本，可以适当增大这个值。

本地向量数据库配置（可选）

如果你希望提高剧情的连贯性和上下文的理解能力，可以配置本地向量数据库。向量数据库可以帮助 AI 更好地回顾之前的剧情，确保上下文连贯。在项目目录中，vectorstore 目录是用于存储本地向量数据库的，你可以根据需要进行配置。具体的配置方法可以参考项目的 README.md 文件。

使用入门：快速上手 AI 小说创作

启动 GUI 界面后，你就可以开始使用 AI_NovelGenerator 进行小说创作了。下面简要介绍一下基本的使用流程：

1. 生成设定：点击「Step1. 生成设定」按钮，系统将基于你在配置文件中设置的主题、类型、章节数等信息，生成 Novel_setting.txt 文件，包含世界观、角色信息、雷点暗线等。
2. 生成目录：点击「Step2. 生成目录」按钮，系统会根据已完成的 Novel_setting.txt 内容，为全部章节生成 Novel_directory.txt 文件，包括每章标题和简要提示。
3. 生成章节草稿：在生成章节之前，你可以设置章节号，并在'本章指导'输入框中提供对本章剧情的期望或提示。点击「Step3. 生成章节草稿」按钮，系统将自动读取前文设定、Novel_directory.txt 以及已定稿章节，调用向量检索回顾剧情，生成本章大纲和正文。
4. 定稿当前章节：点击「Step4. 定稿当前章节」按钮，系统将更新全局摘要、角色状态、向量检索库和剧情要点，完成本章的定稿。
5. 一致性检查（可选）：点击「[可选] 一致性审校」按钮，对最新章节进行冲突检测，如角色逻辑、剧情前后矛盾等。

通过以上步骤，你可以逐步完成小说的创作。在使用过程中，你可以随时编辑和修改生成的内容，让小说更符合你的预期。

常见问题与解决方案

在使用 AI_NovelGenerator 的过程中，你可能会遇到一些常见问题。下面列举一些常见问题及其解决方案：

Q1: Expecting value: line 1 column 1 (char 0)

这个问题大概率是由于 API 未正确响应造成的，可能是 API 密钥错误、网络问题或服务端故障等原因。你可以检查 API 密钥是否正确，网络连接是否正常，或者尝试更换 API 服务提供商。

Q2: HTTP/1.1 504 Gateway Timeout？

出现这个错误通常是由于接口不稳定或网络延迟导致的。你可以检查网络连接，或者尝试更换 API 服务的 base_url，选择更稳定的接口。

Q3: 如何切换不同的 Embedding 提供商？

在 GUI 界面中，你可以找到对应的输入框，直接输入新的 Embedding 提供商的相关信息，如 api_key、base_url、model_name 等，即可切换不同的 Embedding 提供商。

如果你遇到其他问题，可以参考项目的 README.md 文件，或者在项目的 Issues 中提出，寻求社区的帮助。

总结

通过本文的教程，你已经掌握了 AI_NovelGenerator 的部署方法，包括环境准备、项目部署、配置优化和基础使用。现在，你可以在本地搭建起专属的小说创作平台，利用 AI 的力量辅助你创作长篇小说。

AI_NovelGenerator 作为一款开源项目，还有很大的发展空间。未来，随着 AI 技术的不断进步，项目可能会支持更多的 AI 模型，提供更丰富的创作功能，让 AI 辅助创作变得更加智能和高效。