# AutoLibrary

## 工具简介

AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具，旨在帮助学生简化图书馆座位操作流程，节省宝贵时间。

本工具模拟人工操作，通过简单的界面配置并交互使用。

### 工具特点

模拟人工操作，不干扰图书馆系统正常运行

支持多种预约模式，满足不同使用场景

支持多账号批量预约

自动处理验证码，减少人工干预

## 准备工作

### 下载浏览器驱动

工具需要通过浏览器驱动来控制浏览器，请根据您使用的浏览器下载对应版本的驱动：

#### Microsoft Edge

适用于Windows 10/11系统

下载驱动

#### Google Chrome

最常用的浏览器

下载驱动

#### Mozilla Firefox

开源浏览器

下载驱动
提示： 浏览器驱动版本必须与您的浏览器版本兼容，否则本工具将无法正常工作。

### 确认驱动路径

下载驱动后，将浏览器驱动程序的路径通过配置窗口加载到AutoLibrary中。

例如：C:\Users\Administrator\Downloads\msedgedriver.exe

## 使用步骤

### 启动工具

双击运行AutoLibrary.exe文件，工具将启动主界面。

提示：软件首次启动，未初始化配置文件，直接运行脚本会提示失败。

### 配置工具

对于不同用户的需求，你可以使用两种不同的方式来配置工具

1. 使用界面配置：点击主界面窗口右上角的配置按钮，打开配置窗口。

提示：初次运行软件时，用户配置默认为空，需要手动添加。

#### 用户列表

用户列表显示当前配置文件中的所有用户，你可以添加、删除用户。选中用户项以进行详细的配置。

#### 用户信息

-学号：用户的学号。

-密码：用户的密码，用户默认密码为000000。

#### 预约信息

-日期（YYYY-MM-DD）：座位预约日期，默认显示当前日期，无法更改（图书馆19:00-23:00可以预约第二天座位，软件将在18:00-23:00允许用户选择第二天的日期）。

-地点：预约座位的地点，默认值为“图书馆”。

-楼层：预约座位的楼层，默认值为“二层”。

-区域：预约座位的区域，默认值为“二层内环”。

-座位号：预约座位的座位号。

-开始时间（HH:mm）：预约座位的开始时间，默认值为当前时间，可选时间范围为7:30-23:30。

-结束时间（HH:mm）：预约座位的结束时间，默认值为当前时间加上两个小时，可选时间范围与开始时间相同。

-最大时间偏差（分钟）：选择的开始/结束时间不可用时，会按照该时间偏差范围寻找最近的可用时间。选择0则表示严格按照选择的时间预约，可选范围为0-120分钟。

-优先选择最早/晚：当预约时间列表中存在多个相距最近的可用时间时，选择最早（开始时间）/最晚（结束时间）的时间，不勾选将会按照脚本默认行为选择。

-期望时长（小时）：预约座位的期望时长，默认值为“2小时”，可选范围为0-8小时。

-优先满足期望时长：勾选此项，会优先满足预约时长限制，当座位紧张时可能会导致预约失败。

#### 图书馆设置

这里主要包含了关于图书馆的访问网址设置，不需要更改。

#### 浏览器设置

主要包含浏览器类别选择（当前支持Edge Chromium和Mozilla Firefox），浏览器驱动路径选择以及无头模式设置。

-浏览器类别：选择您使用的浏览器类别（Edge Chromium或Mozilla Firefox）。

-浏览器驱动路径：点击浏览按钮选择对应浏览器类型和版本的浏览器驱动程序的路径。

-无头模式：如果您不希望看到浏览器窗口自动操作，可将无头模式设置为true。

#### 登录设置

-自动识别验证码：默认勾选。

-登录尝试次数：设置登录尝试的最大次数，默认值为3次。

#### 运行模式

-自动预约：脚本按照配置中起始时间和预期时长进行预约，用户如果当天存在有效预约，将自动跳过预约步骤。

-自动签到：如果用户在脚本启动时满足图书馆预约条件，将自动签到，如果用户当天无有效预约或不在可签到时间内，则自动跳过。

-自动续约：如果用户在脚本启动时满足图书馆预约条件，将自动续约，如果用户当天无有效预约或不在可续约时间内，则自动跳过。

#### 当前配置：

这里主要显示脚本当前使用的系统配置文件和用户配置文件的路径。你可以使用右侧浏览按钮选择新的配置文件路径。

#### 导出配置：

选择导出配置文件的目标路径和文件名，点击‘导出配置文件’按钮，将当前的配置项导出。

2. 使用配置文件：在脚本可执行文件的根目录创建系统配置文件system.json和用户配置文件users.json。

系统配置文件
用户配置文件

system.json文件控制工具的基本运行参数：

{ "library": { "host_url": "http://10.1.20.7", "login_url": "/login" }, "mode": { "run_mode": 1 }, "login": { "auto_captcha": true, "max_attempt": 3 }, "web_driver": { "driver_type": "edge", "driver_path": "msedgedriver.exe", "headless": false } }

#### 参数说明

library/host_url: 图书馆主机URL，无需更改。

library/login_url: 登录页面URL，无需更改。

mode/run_mode: 运行模式，可组合使用（+1：自动预约/+2：自动签到/+4：自动续约）

login/auto_captcha: 自动验证码识别，建议保持true

login/max_attempt: 登录尝试次数，默认3次

web_driver/driver_type: 浏览器类型（edge/chrome/firefox）

web_driver/driver_path: 驱动文件路径

web_driver/headless: 无头模式，默认false运行时显示浏览器窗口

users.json文件控制用户的预约和签到参数：

{ "users": [ { "username": "您的学号", "password": "您的密码", "reserve_info": { "date": "2025-10-30", "place": "1", "floor": "4", "room": "5", "begin_time": { "time": "09:30", "max_diff": 30, "prefer_early": true }, "end_time": { "time": "21:23", "max_diff": 30, "prefer_early": false }, "seat_id": "31A", "expect_duration": 6 "satisfy_duration": true } }, /* 可以添加多个上述的配置块，每个用户预约信息独立配置 */ ] }

#### 参数说明

username: 学号

password: 密码

reserve_info/date: 预约日期（格式：YYYY-MM-DD）

reserve_info/place: 图书馆或者字符“1”

reserve_info/floor: 预约楼层（“2”：二层，“3”：三层，“4”：四层，“5”：五层）

reserve_info/room: 预约房间（）

reserve_info/seat_id: 座位编号（例如：“12A/12a/012A/012a”）

reserve_info/begin_time: 预约开始时间（格式：HH:mm）

reserve_info/begin_time/max_diff: 最大时间差（分钟）

reserve_info/begin_time/prefer_early: 是否优先预约较早时间（默认true）

reserve_info/end_time: 预约结束时间（格式：HH:mm）

reserve_info/end_time/max_diff: 最大时间差（分钟）

reserve_info/end_time/prefer_early: 是否优先预约较早时间（默认true）

reserve_info/expect_duration: 期望使用时长（小时）

reserve_info/satisfy_duration: 是否满足期望时长（默认true）

提示： 可以添加多个用户，工具会按顺序处理每个用户的预约请求。

### 监控运行状态

如果系统设置中没有勾选浏览器无头模式运行，工具会在运行过程中打开浏览器窗口，显示自动运行过程。

除此之外，你还可以通过软件的运行日志输出区域查看详细的运行状态和错误信息。

### 查看运行结果

软件运行结束后日志会显示本次运行结果：“处理完成, 共计 n 个用户, 成功 n 个用户, 失败 m 个用户”。

## 功能介绍

⏰

### 自动预约

如果用户当前没有有效预约时，工具会自动为您预约指定座位。

适用场景： 提前预约第二天的座位
✅

### 自动签到

如果用户当前已有预约，且在可签到时间范围（开始时间的前后30分钟）内，工具会自动完成签到。

适用场景： 因忘记签到而导致失约，影响正常使用
🔄

### 自动续约

如果用户当前正在使用座位，且到达可续约时间（结束时间前的120分钟），工具会自动延长使用时间。

适用场景： 需要长时间使用座位

### 模式组合使用

运行模式可以组合使用，只需在配置窗口中勾选对应模式即可：

- 自动预约 + 自动签到 + 自动续约（推荐）
  自动预约
  自动预约 + 自动签到

## 故障排除

### 常见问题及解决方法

工具启动时报错"无法找到驱动/Unable to obtain driver"等类似报错信息

这是大概率是因为浏览器驱动未正确安装或版本不匹配。

1，检查驱动文件是否放置在正确位置

2，确认驱动版本与浏览器版本完全匹配，例如：Chrome浏览器需要对应版本的chromedriver.exe，切勿混用

3，尝试重新下载并安装驱动

登录失败，提示账号密码错误

请检查配置界面中的账号密码是否正确。

1，确认学号和密码无误

2，检查是否有不支持的特殊字符需要转义

3，尝试手动登录图书馆系统确认账号可用

预约失败，提示座位不可用

目标座位可能已被他人预约或不在可预约时间。

1，确认座位编号是否正确，是否在该楼层指定区域

2，尝试预约其它座位或调整预约时间，例如调整允许的开始或结束时间的最大偏差，位置紧张情况下可以让脚本根据允许的时间范围选择最佳起始时间

## 常见问题

使用AutoLibrary是否安全？

AutoLibrary完全模拟人工操作，不干扰图书馆系统正常运行。工具不会收集或上传您的个人信息，所有数据仅保存在本地配置文件中。

可以同时预约多个座位吗？

根据图书馆规定，每个账号同一时间段只能预约一个座位。但您可以在配置界面中添加多个账号，工具会依次处理每个账号的预约请求。

重要：本工具软件旨在简化并辅助用户正常使用时的图书馆服务流程，请勿滥用影响他人及图书馆正常运行。

工具运行期间可以操作电脑吗？

可以正常使用电脑，但请勿操作工具自动打开的浏览器窗口，否则可能会干扰工具的正常运行。

## 下载安装

### 获取AutoLibrary

点击下方按钮下载最新版本的AutoLibrary压缩包：

下载 AutoLibrary alpha-v0.03

文件大小：约98MB

系统要求：Windows 10/11，支持Edge/Chrome/Firefox浏览器

### 安装步骤

下载压缩包并解压到任意文件夹

根据您使用的浏览器下载对应版本的驱动

按照本手册说明配置账号密码等参数

点击启动脚本，即可开始自动预约和使用座位