v1.0.0

Comic-Crawler

基于 Kavita UI 风格的现代化漫画下载器应用，采用 "静态前端 + Python FastAPI 后端" 的现代轻量架构。

快速启动

Windows

# 双击运行启动脚本
start.bat

Linux/Mac

# 运行启动脚本
python scripts/start.py

首次运行指南

第一步：安装 Python

如果还没有安装 Python，请按以下步骤操作：

1. 下载 Python

   • 访问 Python 官网
   • 下载 Python 3.8 或更高版本

2. 安装 Python (Windows)

   • 运行下载的安装程序
   • 重要: 勾选 "Add Python to PATH" 选项
   • 点击 "Install Now" 完成安装

3. 验证安装

   python --version

   如果显示版本号，说明安装成功。

第二步：克隆项目

git clone https://github.com/RSLN-creator/Comic-Crawler.git
cd Comic-Crawler

第三步：安装依赖

# 安装项目依赖
python -m pip install -r requirements.txt

第四步：启动应用

• Windows: 双击运行 start.bat
• Linux/Mac: 运行 python scripts/start.py

第五步：配置设置

• 在 "设置" 页面配置默认下载路径和其他参数
• 点击 "保存设置" 按钮持久化配置

第六步：开始下载

• 在 "下载管理" 页面输入专辑 ID（支持多行输入）
• 点击 "开始下载" 按钮启动下载任务
• 查看实时下载进度和日志

第七步：打包为 CBZ

• 在 "Kavita 打包" 页面选择下载目录
• 选择输出目录
• 点击 "开始打包" 按钮生成 CBZ 文件

第八步：导入到 Kavita

• 将生成的 CBZ 文件复制到 Kavita 的漫画库目录
• 在 Kavita 中扫描库以识别新漫画

手动启动

第一步：安装依赖

# 安装后端依赖
pip install -r src/web_app/backend/requirements.txt

第二步：启动后端 API 服务

cd src/web_app/backend
python -m uvicorn api_server:app --host 0.0.0.0 --port 8765 --reload

第三步：启动前端服务

cd src/web_app/frontend
python -m http.server 3000

第四步：访问应用

打开浏览器访问：http://localhost:3000

配置说明

环境变量

变量	描述	默认值
BACKEND_PORT	后端 API 服务端口	8765
FRONTEND_PORT	前端 Web 服务端口	3000

服务管理

启动服务

• Windows: 双击运行 start.bat
• Linux/Mac: 运行 python scripts/start.py

停止服务

• Windows:
  • 方法1: 在 Web UI 设置页面点击红色"停止服务"按钮
  • 方法2: 双击运行 end.bat
  • 方法3: 直接关闭后端和前端对应的命令行窗口
• Linux/Mac: 在终端按 Ctrl+C 停止服务

重启服务

• Windows:
  1. 先运行 end.bat 停止旧服务
  2. 重新双击运行 start.bat
• Linux/Mac:
  1. 按 Ctrl+C 停止旧服务
  2. 重新运行 python scripts/start.py

手动重启后端

# 进入后端目录
cd src/web_app/backend
# 停止旧服务（Ctrl+C），然后重新启动
python -m uvicorn api_server:app --host 0.0.0.0 --port 8765 --reload

手动重启前端

# 进入前端目录
cd src/web_app/frontend
# 停止旧服务（Ctrl+C），然后重新启动
python -m http.server 3000

许可证

本项目仅供学习交流使用，请勿用于非法用途。

免责声明

• 本项目仅提供下载工具，不存储任何漫画内容
• 下载内容的版权归原作者所有
• 请遵守当地法律法规，合理使用本工具