# AutoLibrary
---
了解更多请访问 [_AutoLibrary 网站_](http://autolibrary.cv)
---
### 功能
1. 自动预约 - 支持自动预约
2. 自动续约 - 支持自动续约
3. 自动签到 - 支持自动签到
4. 批量操作 - 支持同时预约多个用户，可以指定当前需要跳过的用户，并将用户分成多个组
5. 定时任务 - 使用内置定时任务管理，添加定时任务，指定时间后按当前预约信息自动运行
*1,2,3 的具体操作方法和注意事项请访问我们的 [帮助手册](https://autolibrary.cv/docs/manual_lists.html)*
### 特点
#### 关于预约等操作的注意事项
工具会自动处理登录过程的验证码识别过程，正常情况下单次识别准确率在 90% 以上，如遇验证码识别错误，大概率是校园网网络环境不佳导致的。
只要确保处于校园网网络环境内，工具都是可以正常运行的。操作处理速度基本上取决于校园网的网络环境，一般情况下在 3-4 秒（不考虑硬件差异）左右即可完成一个用户的操作，完全满足正常使用需求。
> [!NOTE]
> 工具仅作为正常的预约，签到和续约的图书馆辅助工具，请勿干扰图书馆的正常运行（如故意预约多个座位，或同时预约大量的用户等，对此影响图书馆正常运行本工具概不负责，请在善用工具方便自己的情况下尽量不用影响其他同学的使用）。
#### 关于批量操作的注意事项
批量操作时，建议将需要操作的用户分成多个组，每个组的用户数量不要超过 4 人（即一整张桌子的数量），否则会影响操作效率，大量用户同时预约会一定程度上增加图书馆服务器的压力，影响正常使用。根据需要在用户管理界面中可以勾选本次操作是否跳过该用户，以提高运行效率。
#### 关于定时任务的注意事项
定时任务会在指定的时间自动运行，运行时会根据当前预约信息进行操作。一般情况下不建议设置两个运行开始时间比较接近的定时任务，否则后一个任务会等待前一个任务完成后才会运行，按照队列的顺序执行。
### 如何使用
1. 下载最新版本的 [AutoLibrary 压缩包](https://github.com/KenanZhu/AutoLibrary/releases)。
2. 解压下载的文件到任意目录。
3. 下载对应浏览器的驱动文件，并在配置界面的运行配置选项卡对应位置选择你下载好的浏览器驱动
4. 运行 `AutoLibrary.exe` 文件。
5. 按照提示操作即可。
*注意 1*: 关于浏览器驱动的下载和其它相关问题，请参考我们的 [帮助手册](https://autolibrary.cv/docs/manual_lists.html) 中对应软件版本的内容。
#### 平台支持 & 编译步骤
本工具目前仅支持 Windows 平台，由于使用 PySide6 库开发，理论上是可以自行编译并在 Linux 和 macOS 上运行，这里提供简单的编译步骤：
1. 确保系统安装了 Python 3.13 版本 （推荐，过低或高版本会导致兼容问题）。
2. 安装 pyside6 selenium ddddocr 库，命令为 `pip install pyside6 selenium ddddocr`。
3. 在 `src/gui/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 src/gui/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)
### Q&A
#### 为什么开发这个工具？
当前图书馆的座位预约系统在使用中确实会遇到一些不便。例如，系统登录界面较为陈旧，在输入验证码时，若出现错误常常需要全部重新填写，过程繁琐。尤其在网络环境不稳定的情况下，登录和加载速度缓慢，让人难以快速完成当天的签到或预约次日座位。
此外，当朋友需要帮忙预约座位时，手动操作也会分散自己学习和工作的注意力。
因此，很希望有一个便捷的工具能自动处理这些预约、续约和签到等操作，从而让自己从这些琐碎事务中解脱出来，更专注于手头的重要事项。
#### 工具后续会收费吗？
不会，本工具完全免费使用，也不会有任何额外收费项。如果你觉工具对你很有帮助，可以为我捐助一瓶饮料的价格，以用于 AutoLibrary 网站的维护和软件的稳定更新。
❤ 支持作者
#### 会有手机端的版本吗？
暂时没有考虑，而且也没有足够的时间和能力开发多平台的版本并测试维护，所以暂时只提供 Windows 版本。
#### 后续会有哪些功能？
当前 v1.0.0 版本的功能对于正常使用已经足够，不过后续会着重考虑完善 2-4 人预约时的使用体验，暂时有以下构想：
1. 2-4 人一起预约时，往往会偏向于预约并排或对面的整个空座位，这时候工具会按照一定策略查询搜索符合条件的座位，并预约并排或对面的整个座位，而不是各自独立预约。
2. 预约时会考虑到组内用户的预约时间是否冲突，若冲突则会提示用户是否继续预约，若用户选择继续预约，则会按需要调整预约时间，再进行预约。
3. 对于比较固定的用户，会考虑在定时任务管理中添加如 ‘每日任务’ ‘每周任务’ 等选项，用户可以根据需要设置定时任务重复的日期范围，自动完成预约，签到，续约等操作。
不过由于本人的时间和能力有限，也需要考虑到图书馆的正常运行，所以后续功能会有所取舍，但也许会进行一些小的功能验证。
#### 其他功能建议？
如果你有其他功能建议，或者遇到了什么功能性，操作上的问题，欢迎提交 Issue 到本项目。
如果你有足够的开发能力，欢迎为本项目提交 PR，也可以 Fork 本项目，根据自己的需求进行修改和完善。
### 联系我
- 项目维护：[KenanZhu (Nanoki)](https://github.com/KenanZhu)
- 电子邮箱：
_**Free to use** —— AutoLibrary 是一个基于 MIT 协议免费开源的工具_