环境准备
在开始之前，先把运行环境准备好。这个项目本质上还是一套本地 Python 应用，环境没配稳，后面再怎么折腾接口也白搭。
你需要准备：
- Python 3.10 或更高版本
- Conda，或者至少有可用的
pip
如果你平时已经装好了 Anaconda 或 Miniconda，后面的步骤会顺手很多，因为它能把项目环境单独隔离出来，避免和系统里其他 Python 包互相打架。
第一次安装：把项目跑起来
如果这是你第一次接触这个项目，照着下面的顺序来就行，不需要理解每一条命令的细节，先把服务启动起来更重要。
拉取项目代码
先打开终端。Windows 用户一般直接用 Anaconda Prompt 更省事，然后把仓库克隆到本地，再切换到项目目录。
git clone https://github.com/yourusername/ai-novel-generator-4.0.git
cd ai-novel-generator-4.0
这里要注意，git clone 和 cd 最好分两行写。很多新手喜欢把它们连在一起复制，虽然有时也能跑，但出问题时不容易排查。
创建独立环境
接下来创建一个专属的 Conda 环境，Python 版本建议固定在 3.10。这样做的好处很直接：依赖冲突少，后续维护也省心。
conda create -n ai-novel-generator python=3.10
conda activate ai-novel-generator
激活成功后，命令行前面通常会多出环境名，比如 (ai-novel-generator)。看到这个提示，说明你已经进入正确的'房间'了。
安装依赖
项目依赖统一写在 requirements.txt 里，直接安装即可：
pip install -r requirements.txt
这一步一般会持续一会儿，尤其是网络不太稳定的时候，耐心等它跑完。只要没有报错，后面就顺很多。
启动服务
依赖装好后，启动项目：
python run.py
如果一切正常，终端会提示本地服务地址。通常打开浏览器访问 http://127.0.0.1:7860，就能看到界面了。
关机后怎么重新启动
很多人第一次能跑通，第二天再打开就卡住，原因其实很简单：你不需要重装，只要重新进入项目目录并激活环境就行。
假设你的项目放在 Windows 用户目录下，重新开启时可以按这个思路来：
cd C:\Users\LING\ai-novel-generator-4.5
conda activate ai-novel
python run.py
这里有两个地方值得留意：
- 路径要换成你自己的实际路径
- 环境名也要和你创建时保持一致
只要命令行前面出现了对应的环境名，再执行 python run.py，服务就会重新起来。
配置 API 接口
界面出来以后，工具还不能直接工作，因为它还缺一个'大脑'——也就是大模型接口。
这类本地写作工具的核心思路都差不多：前端负责输入和展示，真正的生成能力交给外部模型服务。你只需要把 API Key、接口地址和模型名称填对，后面就能正常调用。
获取 API Key
先去对应平台创建 API 密钥。拿到的这串 Key，本质上就是程序调用模型时的身份凭证，配置错了或者填漏了，接口就没法正常返回结果。
