一、环境准备
在开始之前，您的电脑需要满足以下基础要求。这就像要做饭，得先有厨房一样。
- Python 3.10+：程序运行的语言环境，版本不能太低。
- Conda（推荐）或 pip：用于管理各种代码库。强烈建议使用 Conda，它能帮您把项目环境隔离起来，避免和其他软件冲突。
二、第一次安装：给代码安个家
如果您是第一次拿到这个项目，请按顺序操作。只需要复制粘贴命令即可。
第一步：把项目'搬'回家
打开终端（Windows 用户推荐用 Anaconda Prompt），输入以下命令，将项目代码克隆到本地：
git clone https://github.com/yourusername/ai-novel-generator-4.0.git
cd ai-novel-generator-4.0
注：这步做完，您就已经进入了项目文件夹。
第二步：造一个专属'房间'
为了不弄乱电脑里的其他环境，我们要用 Conda 创建一个专属的虚拟空间，名字就叫 ai-novel-generator，指定 Python 版本为 3.10。
conda create -n ai-novel-generator python=3.10
conda activate ai-novel-generator
第三步：安装依赖
这就好比给你的软件安装各种零件，运行以下命令，等待进度条走完即可：
pip install -r requirements.txt
第四步：点火启动
一切就绪，输入最后一行命令：
python run.py
当看到终端不再跳动，出现网址提示时，恭喜您，服务已经跑起来了！
三、关机重启后：如何再次开启？
这是很多新手最容易卡住的地方：第一次安装好了，电脑关机第二天想用，却发现不知道怎么进去了。其实，您不需要重复上面的安装步骤，只需要简单的'三步走'。
假设您的项目放在了 C 盘的用户目录下，具体操作如下：
- 切换位置：您得先告诉电脑您的文件在哪。输入
cd命令进入项目目录。
cd C:\Users\LING\ai-novel-generator-4.5
注意：这里的路径要根据您实际存放的位置修改，版本号也要对应（比如您是 4.0 就写 4.0）。
- 激活环境：看一下您的命令行提示符前面有没有
(ai-novel)这几个字？如果没有，说明'房间'没开门，输入：
conda activate ai-novel
- 此时，您的提示符应该变成类似这样的状态：
(ai-novel) C:\Users\LING\ai-novel-generator-4.5>
- 运行程序：最后，老规矩，输入启动命令：
python run.py
访问界面：无论是新安装还是重启，只要程序跑起来，打开浏览器，输入地址 http://127.0.0.1:7860，您就能看到 AI 写作的界面了。
四、关键一步：配置'大脑'（API 接口）
界面出来了，但此刻它还只是个空壳，我们需要给它接上'大脑'。建议配置一个兼容 OpenAI 格式的 API 接口提供商，性价比和稳定性都不错。
操作流程详解： 获取密钥：进入模型管理平台，找到创建 API 密钥的选项，创建并复制好您的 API Key。这相当于您的通行证。
界面配置：
- 回到本地 AI 写作界面，找到'API 配置与负载均衡'区域。
- 供应商：下拉选择'openAI 兼容接口'。
- API Key：把刚才从模型管理平台复制的密钥粘贴进去。
高级设置（重点！）：这里有个坑要注意，必须选择'高级设置'。
- 自定义 URL：填写模型平台提供的地址，例如
<API_ENDPOINT>。 - 模型名称：回到模型管理平台，您想用的哪个模型（比如 deepseek 或其他），就把它的名字复制过来填进去。
配置好后，点击'保存配置'。至此，您的 AI 写作助手才算真正'活'了过来。
五、开始你的创作
一切准备就绪，接下来的事情就简单了。在界面上填写您想要的素材、大纲或者简单的构思，创建项目并等待生成。
填写自己想要的素材与内容
创建项目并等待生成
虽然看起来步骤不少，但只要第一次跑通了，后面日常使用其实就只有'进目录 -> 激活环境 -> 运行'这三步。技术的门槛虽然存在，但只要跨过去，等待您的就是无限的生产力。快去试试吧！
