🚀 快速开始

1. 下载 / 部署

• 直接下载 📦绿色包，并解压

解压路径不能含有中文/中标

macOS用户

须阅读 macOS 部署 文档

• 或克隆此项目 git clone https://github.com/jasoneri/ComicGUISpider.git

部署流程参考 macOS 的 init.bash，以下节选要点

1. 安装 astral-sh/uv，示例使用的 brew ，或者使用官方的远程脚本
2. 使用 uv 安装 python3.12.11（可以在官方源加上加速外链的前缀）

uv python install 3.12.11 --mirror "https://github.com/astral-sh/python-build-standalone/releases/download" --no-cache

3. 在放源码位置的父目录创建 uv 虚拟环境 uv venv --python 3.12.11 .venv
4. 安装依赖命令示例 （CGS的 requirements/*.txt 都是用uv编译的，原生 pip 装你会发现各种麻烦）

source .venv/bin/activate  # 进虚拟环境
cd ComicGUISpider          # 一般 git clone 为项目名，否则是你改名的源码目录
uv pip install -r "requirements/win.txt" --index-url https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host https://pypi.tuna.tsinghua.edu.cn/simple

使用 git 克隆的话请忽视全篇文档中的 scripts/xxx 的 scripts，文档是基于绿色包的说明

2. 运行

常规 GUI 运行

source .venv/bin/activate  
cd ComicGUISpider  
python CGS.py

此后所有说明中非📦绿色包的python命令均默认进虚拟环境，不再赘述

或直接使用📦绿色包程序

命令行工具

python crawl_only.py --help
或使用绿色包的环境，在解压目录打开终端执行
.\runtime\python.exe .\scripts\crawl_only.py --help

使用方法进help看说明

当前版本能进行简单下载/调试功能（后续将逐步扩展）
命令行工具的配置可用GUI方式修改 或 直接修改conf.yml文件（📒3-配置系文件路径）

3. 配置

有自定义需求的，参考 🔨主配置文档 进行设置

4. 更新

• CGS 内置了更新模块，能在配置窗口中点击 检查更新 按钮进行更新

当 本地版本 < 最新稳定版 < 最新开发版 时

需更新到最新稳定版后，才能更新到最新开发版

• 也可以选择到 releases 手动下载最新版

5. 搭配阅读器

欢迎尝试使用 redViewer ，最适 CGS ！也希望能提供有创意的功能想法给 rV ！💑