哔哩哔哩漫画下载器使用手册
1. 项目目录结构及介绍
以下是BiliBili-Manga-Downloader
项目的基本目录结构及其简介:
BiliBili-Manga-Downloader/
├── app.py # 主运行文件,启动应用程序
├── build.sh # 打包编译脚本
├── gitignore # Git忽略文件配置
├── LICENSE # 许可证文件,遵循AGPL-3.0
├── macos.spec # MacOS相关构建配置
├── poetry.lock # 项目依赖锁定文件
├── pylintrc # Pylint配置文件,用于代码质量检查
├── pyproject.toml # 项目元数据和依赖管理配置
├── README.md # 项目说明文件,包括功能介绍和使用指南
├── setup.sh # 本地构建初始化脚本
├──汤姆猫.txt #(假设遗漏,实际中不存在)
├── update.md # 更新日志文件
└── windows.spec # Windows平台构建配置
app.py
: 程序的核心入口,负责启动图形界面及处理主要业务逻辑。build.sh
和setup.sh
: 分别用于自动化打包和初始化设置,方便开发者和用户构建和使用。pyproject.toml
: 使用Poetry管理Python项目的配置文件,定义了项目依赖和元数据。README.md
: 用户的主要指南,包含了项目介绍、特性、使用方法及注意事项。
2. 项目的启动文件介绍
- 主要启动文件:
app.py
- 功能:这个文件是应用的启动点,它初始化图形界面,实现漫画的搜索、下载等功能。用户无需直接编辑此文件,只需通过命令行运行即可启动软件。
- 运行命令(在项目根目录下):
poetry shell python3 app.py
- 此命令首先激活项目环境,然后运行应用程序。
3. 项目的配置文件介绍
配置信息主要是通过用户交互界面进行设置,例如输入Cookie等,没有直接的配置文件。但是,如果要理解如何配置运行环境,关注以下几个方面:
-
用户数据与设置:应用运行时会创建或读取缓存和用户数据,这些数据默认存储在用户AppData目录下(如
C:\Users\AppData\Roaming\BiliBili-Manga-Downloader
\),但具体配置是在程序内部通过用户界面操作来实现的,比如输入B站Cookie或BiliPlus的Cookie。 -
环境配置:对于开发者或想要自定义部署的情况,项目依赖管理通过
pyproject.toml
和poetry.lock
来保证一致性,无需手动创建额外的配置文件。首次运行前,需运行setup.sh
初始化环境。
综上所述,BiliBili-Manga-Downloader
项目通过简洁的目录结构和明确的脚本分工,提供了易于理解和操作的环境,确保用户可以轻松地下载和管理哔哩哔哩上的漫画资源。