mirror of
https://github.com/KenanZhu/AutoLibrary.git
synced 2026-06-17 23:13:03 +08:00
KenanZhu
f3360423e5
- 重命名 requirement.txt → requirements.txt - 更新 build.yml 和 build-test.yml 中的 pip cache 和 install 路径引用 - README.md 恢复 pip install -r requirements.txt 构建步骤 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
123 lines
8.6 KiB
Markdown
123 lines
8.6 KiB
Markdown
|
||
# AutoLibrary
|
||
---
|
||
|
||
|
||
|
||
[](https://github.com/KenanZhu/AutoLibrary)
|
||
|
||
[](https://github.com/KenanZhu/AutoLibrary/actions/workflows/build-test.yml)
|
||
[](https://github.com/KenanZhu/AutoLibrary/actions/workflows/release.yml)
|
||
[](https://github.com/KenanZhu/AutoLibrary/releases/latest)
|
||
|
||
|
||
了解更多请访问 [_AutoLibrary 网站_](http://www.autolibrary.kenanzhu.com)
|
||
|
||
---
|
||
|
||
### 功能
|
||
|
||
1. 自动预约 - 支持自动预约
|
||
2. 自动续约 - 支持自动续约
|
||
3. 自动签到 - 支持自动签到
|
||
4. 远程签到 - 支持远程签到，无需在图书馆网络环境下即可签到
|
||
5. 批量操作 - 支持同时预约多个用户，可以指定当前需要跳过的用户，并将用户分成多个组
|
||
6. 定时任务 - 使用内置定时任务管理，添加定时任务，指定时间后按当前预约信息自动运行，支持设置重复任务
|
||
7. 驱动管理 - 内置浏览器驱动自动管理，支持自动检测浏览器版本并下载对应驱动，无需手动下载
|
||
|
||
*具体操作方法和注意事项请访问我们的 [帮助手册](https://manuals.autolibrary.kenanzhu.com)*
|
||
|
||
### 如何使用
|
||
|
||
1. 下载最新版本的 [AutoLibrary 安装程序](https://github.com/KenanZhu/AutoLibrary/releases/latest) 或 [压缩包](https://github.com/KenanZhu/AutoLibrary/releases/latest) 。
|
||
2. 双击运行安装程序进行安装，或将压缩包解压到任意目录。
|
||
3. 运行 `AutoLibrary`，即可打开主界面。
|
||
4. 点击 [配置] 按钮，在配置界面填写好预约信息和运行配置后，点击 [确认] 按钮。
|
||
5. 点击 [启动脚本] 按钮，即可开始自动预约、续约、签到等操作。
|
||
|
||
*注意 1*: 工具内置浏览器驱动自动管理功能，会自动检测本地浏览器版本并下载对应的驱动文件。如果自动下载失败，也可以手动下载驱动文件并在配置界面的运行配置选项卡对应位置选择驱动文件路径。
|
||
|
||
#### 平台支持 & 编译步骤
|
||
|
||
本工具目前仅支持 Windows 平台，由于使用 PySide6 库开发，理论上是可以自行编译并在 Linux 和 macOS 上运行，这里提供简单的编译步骤：
|
||
|
||
1. 确保系统安装了 Python 3.13 版本 （推荐，过低或高版本会导致兼容问题）。
|
||
2. 安装所有依赖库，命令为 `pip install -r requirements.txt` （建议在虚拟环境下操作）。
|
||
3. 在 `batchs` 目录下运行 `compile_ui.bat` （linux 和 macOS 系统使用 `compile_ui.sh`） 文件来编译 Qt 的 UI 文件。
|
||
4. 在上一步相同目录内运行 `compile_rc.bat` （linux 和 macOS 系统使用 `compile_rc.sh`） 文件来编译 Qt 的资源文件。
|
||
5. 待上述步骤完成后，运行 `src/Main.py` 文件即可。
|
||
|
||
*注意 1*：如果 python 使用的是虚拟环境，请在虚拟环境安装依赖后，在激活的虚拟环境终端中使用 `cd batchs` 命令切换到 `batchs` 目录下，再运行编译脚本。否则会提示缺少必要的 Qt PySide 依赖库。
|
||
|
||
*注意 2*：由于 ddddocr 的代码版本问题，其中 `__init__.py` 文件中的函数 `def classification(self, img: bytes):` 中的 `image.resize` 方法传入了不符合当前 pillow 版本的 `resample` 参数 `Image.ANTIALIAS`，该重采样常量已经在 10.0.0 版中删除 [1](@ref)。请将 `image.resize` 方法中的参数替换为 `resample=Image.Resampling.LANCZOS`，具体函数如下：
|
||
```python
|
||
def classification(self, img: bytes):
|
||
image = Image.open(io.BytesIO(img))
|
||
image = image.resize((int(image.size[0]*(64/image.size[1])), 64), Image.ANTIALIAS).convert('L')
|
||
^^^^^
|
||
请将上述参数替换为 `Image.Resampling.LANCZOS`
|
||
|
||
...
|
||
```
|
||
|
||
[1](@ref)：[pillow 中已经删除或已经弃用的常量](https://pillow.ac.cn/en/stable/deprecations.html#constants)
|
||
|
||
### 注意事项
|
||
|
||
#### 关于预约等操作
|
||
|
||
工具会自动处理登录过程的验证码识别过程，正常情况下单次识别准确率在 90% 以上，如遇验证码识别错误，大概率是校园网网络环境不佳导致的。
|
||
|
||
只要确保处于校园网网络环境内，工具都是可以正常运行的。操作处理速度基本上取决于校园网的网络环境，一般情况下在 3-4 秒（不考虑硬件差异）左右即可完成一个用户的操作，完全满足正常使用需求。
|
||
|
||
> [!NOTE]
|
||
> 工具仅作为正常的预约，签到和续约的图书馆辅助工具，请勿干扰图书馆的正常运行（如故意预约多个座位，或同时预约大量的用户等，对此影响图书馆正常运行本工具概不负责，请在善用工具方便自己的情况下尽量不用影响其他同学的使用）。
|
||
|
||
#### 关于批量操作
|
||
|
||
批量操作时，建议将需要操作的用户分成多个组，每个组的用户数量不要超过 4 人（即一整张桌子的数量），否则会影响操作效率，大量用户同时预约会一定程度上增加图书馆服务器的压力，影响正常使用。根据需要在用户管理界面中可以勾选本次操作是否跳过该用户，以提高运行效率。
|
||
|
||
#### 关于定时任务
|
||
|
||
定时任务会在指定的时间自动运行，运行时会根据当前预约信息进行操作。一般情况下不建议设置两个运行开始时间比较接近的定时任务，否则后一个任务会等待前一个任务完成后才会运行，按照队列的顺序执行。
|
||
|
||
### Q&A
|
||
|
||
#### 为什么开发这个工具？
|
||
|
||
当前图书馆的座位预约系统在使用中确实会遇到一些不便。例如，系统登录界面较为陈旧，在输入验证码时，若出现错误常常需要全部重新填写，过程繁琐。尤其在网络环境不稳定的情况下，登录和加载速度缓慢，让人难以快速完成当天的签到或预约次日座位。
|
||
此外，当朋友需要帮忙预约座位时，手动操作也会分散自己学习和工作的注意力。
|
||
因此，很希望有一个便捷的工具能自动处理这些预约、续约和签到等操作，从而让自己从这些琐碎事务中解脱出来，更专注于手头的重要事项。
|
||
|
||
#### 工具后续会收费吗？
|
||
|
||
不会，本工具完全免费使用，也不会有任何额外收费项。如果你觉工具对你很有帮助，可以为我捐助一瓶饮料的价格，以用于 AutoLibrary 网站的维护和软件的稳定更新。
|
||
|
||
<a href="https://afdian.com/a/autolibrary" style="display:inline-block;padding:10px 30px;background:linear-gradient(135deg,#946CE6,#946CE6);color:white;text-decoration:none;border-radius:6px;font-weight:bold;">❤ 支持作者</a>
|
||
|
||
#### 会有手机端的版本吗？
|
||
|
||
暂时没有考虑，而且也没有足够的时间和能力开发多平台的版本并测试维护，所以暂时只提供 Windows 版本。
|
||
|
||
#### 后续会有哪些功能？
|
||
|
||
当前版本的功能对于正常使用已经足够，不过后续会着重完善预约时的使用体验，暂时有以下构想：
|
||
|
||
- 引入交互预约面板功能，预约时直接在座位分布图中选择可用座位，并按用户分配，无需事先配置预约信息。
|
||
- ~~优化定时任务管理功能，用户可以在定时任务管理界面设置重复运行的定时任务，如每日预约、每周预约等。~~ (已完成)
|
||
- 软件的自动更新以及公告栏功能，用户可以自动更新最新版本并获取最新公告事项。
|
||
|
||
不过由于本人的时间和能力有限，也需要考虑到图书馆的正常运行，所以后续功能会有所取舍，但也许会进行一些小的功能验证。
|
||
|
||
#### 其他功能建议？
|
||
|
||
如果你有其他功能建议，或者遇到了什么功能性，操作上的问题，欢迎提交 Issue 到本项目。
|
||
如果你有足够的开发能力，欢迎为本项目提交 PR，也可以 Fork 本项目，根据自己的需求进行修改和完善。
|
||
|
||
### 联系我
|
||
|
||
- 项目维护：[KenanZhu (Nanoki)](https://github.com/KenanZhu)
|
||
- 电子邮箱：<nanoki_zh@163.com>
|
||
|
||
_**Free to use** —— AutoLibrary 是一个基于 MIT 协议免费开源的工具_
|