🚀 快速上手

⚠️ CGS 代码/解压的路径不能含有中文/中标

1. 下载 / 部署

• 直接下载 📦绿色包，并解压，初次打开应用时会进入自动部署流程

macOS用户须阅读 macOS 部署 文档

⚠️ 初始自动部署流程异常处理方法

点击展开

• 过一遍 faq
• 参考解压包内的 异常处理提示.txt (仅win绿色包)
• 开终端参考./CGS.exe --help，使用参数重新部署，例子：下方更新第三种方法

• 或使用 uv tool

uv tool 细节部署流程：⇩

1. 安装 uv，使用 brew 安装最简单，或者使用官方的 远程安装脚本
2. 安装 python，（如没安装）

uv python install 3.13 --mirror https://mirror.nju.edu.cn/github-release/astral-sh/python-build-standalone

3. （可选）C盘洁癖飘红：将以下 D:\uv 改为你想要放的位置，创建子目录cache,tools,bin,
   然后控制台开 powershell 执行以下命令，重启控制台生效

[System.Environment]::SetEnvironmentVariable("UV_CACHE_DIR", "D:\uv\cache", "User")
[System.Environment]::SetEnvironmentVariable("UV_TOOL_DIR", "D:\uv\tools", "User")
[System.Environment]::SetEnvironmentVariable("UV_TOOL_BIN_DIR", "D:\uv\bin", "User")
uv tool update-shell

4. uv 安装 CGS

uvx ComicGUISpider --index-url https://pypi.tuna.tsinghua.edu.cn/simple

若需要用 git 克隆源码方式，需要自行管理环境 uv sync

2. 运行

以下非绿色包命令均基于已执行 uv tool update-shell

否则为 uvx --from comicguispider cgs

常规 GUI 运行

cgs

或直接使用📦绿色包程序

命令行工具

cgs-cli --help

或使用绿色包的环境，在解压目录打开终端执行

.\bin\cgs-cli.exe --help

使用方法进help看说明

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

3. 配置

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

4. 更新

• CGS 内置了 更新模块 和 每日检测

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

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

• 或 uv tool 管理的指定版本，例如 2.9.0

uv tool install ComicGUISpider==2.9.0 --force --reinstall --index-url https://pypi.tuna.tsinghua.edu.cn/simple

• 或 win-绿色包 安装指定版本，例如 2.9.0

.\CGS.exe -v 2.9.0 -i https://pypi.tuna.tsinghua.edu.cn/simple

5. 搭配阅读器

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