novel-downloader 可视化操作流程（Web 界面版）

一、准备工作：安装工具

1. 确保电脑已安装 Python 3.11 及以上版本（可在Python 官网下载，安装时勾选 “Add Python to PATH”）。
2. 打开电脑的 “终端”（Windows 用 CMD 或 PowerShell，Mac 用终端），输入以下命令安装工具：

pip install novel-downloader

（如果提示 “pip 不是内部命令”，检查 Python 是否添加到环境变量，或重新安装 Python 并勾选对应选项）

二、启动 Web 可视化界面

1. 继续在终端输入命令，启动 Web 界面：

novel-web

2. 启动成功后，终端会显示类似 Running on http://127.0.0.1:8080 的提示。
3. 打开任意浏览器（如 Chrome、Edge），在地址栏输入上面的网址（通常是 http://127.0.0.1:8080），按回车进入 Web 界面。

三、使用 Web 界面下载小说

方法 1：通过搜索添加（推荐新手）

1. 进入 Web 界面后，默认是「搜索页面」（路由 /）。
2. 在顶部搜索框输入小说名称（如 “三体”），点击 “搜索” 按钮或按回车。
3. 等待片刻，页面会逐步显示各站点的搜索结果（包含小说封面、标题、作者等信息）。
4. 找到想下载的小说，点击其右侧的 “下载” 按钮，即可将小说加入下载队列。

方法 2：通过网址 / 站点 + ID 添加

如果知道小说在某站点的详情页网址，或知道 “站点名称 + 书籍 ID”：

1. 点击顶部导航栏的「下载」（路由 /download）。
2. 通过 URL 添加：在 “URL” 输入框粘贴小说详情页网址（如某小说的网页链接），点击 “添加到下载列表”。
3. 通过站点 + ID 添加：在 “站点” 下拉框选择站点（如 “qidian”），在 “Book ID” 输入该站点的书籍 ID（通常在网址中能找到，如https://xxx.com/book/12345中的 “12345”），点击 “添加到下载列表”。

四、查看下载进度

1. 点击顶部导航栏的「进度」（路由 /progress），可看到所有下载任务：

• 正在下载 / 排队的任务会显示进度条和已完成章节数。
• 若想取消任务，点击对应任务的 “Cancel” 按钮。

五、获取下载好的小说

1. 当任务显示 “Completed”（完成）后，点击顶部导航栏的「历史」（路由 /history）。
2. 在历史记录中找到对应小说，会显示 “下载” 按钮（支持 TXT 和 EPUB 格式）。
3. 点击 “下载” 按钮，即可将小说保存到电脑本地。

小贴士

• 不同站点的任务会同时下载，同一站点的任务会排队进行，避免一次性添加太多任务。
• 若页面没反应，可按 F5 刷新，或在终端按Ctrl+C停止服务后，重新输入novel-web启动。