diff --git a/configuration.mdx b/configuration.mdx deleted file mode 100644 index 09c7a5d..0000000 --- a/configuration.mdx +++ /dev/null @@ -1,238 +0,0 @@ ---- -title: "配置指南" -description: "AutoLibrary 完整配置参考 - 用户信息、预约参数、浏览器设置、运行模式" -icon: "sliders" ---- - -## 启动工具 - -双击运行 `AutoLibrary.exe` 文件，工具将启动主界面。 - -软件首次启动时，未初始化配置文件，直接运行脚本会提示失败。请先完成下方配置。 - -![运行主界面](/images/v1.2.1/运行主界面.png) - -## 界面配置 - -点击主界面窗口右上角的配置按钮，打开配置窗口。 - - - - ![配置窗口-用户配置](/images/v1.2.1/配置窗口-用户配置.png) - - 初次运行软件时，用户配置默认为空，需要手动添加。 - - ### 用户列表 - - | 功能 | 说明 | 备注 | - | --- | --- | --- | - | 用户列表 | 显示当前配置文件中的所有用户 | 支持添加、删除用户操作，选中用户项进行详细配置 | - - ### 用户信息 - - | 参数 | 说明 | 默认值/可选值 | - | --- | --- | --- | - | 学号 | 用户的学号 | 必填项，用于登录图书馆系统 | - | 密码 | 用户的密码 | 默认值为 `000000`，请根据实际情况修改 | - - ### 预约信息 - - | 参数 | 说明 | 默认值/可选值 | - | --- | --- | --- | - | 日期 | 座位预约日期 | 格式 `yyyy-MM-dd`，18:00-23:00可预约次日 | - | 地点 | 预约座位的地点 | 默认值：`图书馆` | - | 楼层 | 预约座位的楼层 | `二层` `三层` `四层` `五层` | - | 区域 | 预约座位的区域 | 默认值：`二层内环`，可选随楼层变化 | - | 座位号 | 预约座位的座位号 | 例如：`12A` `012a` | - | 开始时间 | 预约开始时间 | 格式 `HH:mm`，可选范围 7:30-23:30 | - | 结束时间 | 预约结束时间 | 格式 `HH:mm`，默认当前时间+2小时 | - | 最大时间偏差 | 时间不可用时的偏差范围 | 0-120分钟，0 表示严格按选择时间 | - | 优先最早/晚 | 多可选时间时的优先选择 | 开始时间优先最早，结束/续约时间优先最晚 | - | 期望预约时长 | 预约期望时长 | 0-8 小时，默认 2 小时 | - | 期望续约时长 | 续约期望时长 | 0-4 小时，默认 1 小时 | - | 优先满足期望时长 | 是否优先满足时长限制 | 勾选后尽量满足，但可能因座位紧张导致预约失败 | - - - ![配置窗口-运行配置](/images/v1.2.1/配置窗口-运行配置.png) - - ### 图书馆设置 - - | 参数 | 说明 | 默认值 | - | --- | --- | --- | - | 访问网址 | 图书馆系统的主机URL | `http://10.1.20.7`（无需更改） | - | 登录页面 | 登录页面的URL路径 | `/login`（无需更改） | - - ### 浏览器设置 - - | 参数 | 说明 | 默认值/可选值 | - | --- | --- | --- | - | 浏览器类别 | 使用的浏览器类型 | Microsoft Edge / Google Chrome / Mozilla Firefox | - | 浏览器驱动路径 | 驱动程序路径 | 通过浏览按钮选择 | - | 无头模式 | 是否隐藏浏览器窗口 | `false`（显示窗口），`true` 为隐藏运行 | - - ### 登录设置 - - | 参数 | 说明 | 默认值 | - | --- | --- | --- | - | 自动识别验证码 | 是否自动处理验证码 | 勾选（推荐） | - | 登录尝试次数 | 登录失败后最大重试次数 | 3 次 | - - ### 运行模式 - - | 功能 | 说明 | 触发条件 | - | --- | --- | --- | - | 自动预约 | 按配置进行座位预约 | 用户当天无有效预约时执行 | - | 自动签到 | 自动完成图书馆签到 | 满足条件时执行，否则跳过 | - | 自动续约 | 自动延长座位使用时间 | 满足条件时执行，否则跳过 | - - - ![配置窗口-其它](/images/v1.2.1/配置窗口-其它.png) - - ### 配置文件的保存与读取 - - | 参数 | 说明 | - | --- | --- | - | 运行配置文件路径 | 可通过浏览按钮选择新的配置文件 | - | 用户配置文件路径 | 可通过浏览按钮选择新的配置文件 | - - ### 导出配置 - - 支持将当前配置导出为文件，选择目标路径和文件名后点击导出按钮。 - - - -## 手动运行任务 - -配置完成后，点击主界面窗口底部左侧的 **"开始运行脚本"** 按钮，工具将按配置自动执行预约、签到、续约等操作。 - -任务将同时处理所有启用的用户及任务组。 - -## 配置文件方式 - -软件启动时，将自动在用户主目录下创建运行配置文件 `run.json` 和用户配置文件 `user.json`。 - - - 配置文件统一存放于用户主目录下的 `AutoLibrary/config` 文件夹中。以 Windows 系统为例： - - ```text - C:\Users\<用户名>\AppData\Roaming\AutoLibrary\config - ``` - - 此项调整使得无论通过安装器还是便携版，软件均能正确读取同一套配置。 - - - - 任何情况下都不建议在该目录下修改除运行配置文件和用户配置文件以外的任何文件。修改配置文件时请务必保持 JSON 格式正确，否则可能导致软件无法正常启动或运行。 - - -### run.json - -控制工具的基本运行参数： - -```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": "", - "headless": false - } -} -``` - -**参数说明：** - -| 参数路径 | 类型 | 说明 | -| --- | --- | --- | -| `library.host_url` | string | 图书馆主机URL，无需更改 | -| `library.login_url` | string | 登录页面URL，无需更改 | -| `mode.run_mode` | number | 运行模式组合（+1 预约, +2 签到, +4 续约） | -| `login.auto_captcha` | boolean | 自动验证码识别，建议保持 `true` | -| `login.max_attempt` | number | 登录尝试次数，默认 3 次 | -| `web_driver.driver_type` | string | 浏览器类型：`edge` / `chrome` / `firefox` | -| `web_driver.driver_path` | string | 驱动文件路径，为空则运行失败 | -| `web_driver.headless` | boolean | 无头模式，默认 `false` | - -### user.json - -控制用户的预约和签到参数： - -```json -{ - "groups": [ - { - "name": "分组名", - "enable": true, - "users": [ - { - "username": "您的学号", - "password": "您的密码", - "enable": true, - "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 - }, - "renew_time": { - "expect_duration": 1.0, - "max_diff": 30, - "prefer_early": false - }, - "seat_id": "31A", - "expect_duration": 6, - "satisfy_duration": true - } - } - ] - } - ] -} -``` - - - 可以添加多个用户和分组，工具会按顺序处理每个用户的预约请求。如果只添加用户而不添加分组，AutoLibrary 会自动创建默认兼容分组。 - - -**用户参数说明：** - -| 参数路径 | 类型 | 说明 | -| --- | --- | --- | -| `username` | string | 学号 | -| `password` | string | 密码 | -| `enable` | bool | 是否启用该用户，`false` 时跳过 | -| `reserve_info.date` | string | 预约日期（格式 `yyyy-MM-dd`） | -| `reserve_info.place` | string | `"图书馆"` 或 `"1"` | -| `reserve_info.floor` | string | 楼层：`2`=二层 `3`=三层 `4`=四层 `5`=五层 | -| `reserve_info.room` | string | 区域：`1`=二层内环 `2`=二层西区 `3`=三层内环 `4`=三层外环 `5`=四层内环 `6`=四层外环 `7`=期刊区 `8`=五层考研 | -| `reserve_info.seat_id` | string | 座位编号，如 `12A` `012a` | -| `reserve_info.expect_duration` | number | 期望预约时长（分钟） | -| `reserve_info.satisfy_duration` | bool | 是否满足期望时长 | -| `reserve_info.begin_time.time` | string | 开始时间（格式 `HH:mm`） | -| `reserve_info.begin_time.max_diff` | number | 最大时间差（分钟） | -| `reserve_info.begin_time.prefer_early` | bool | 是否优先较早时间 | -| `reserve_info.end_time.time` | string | 结束时间（格式 `HH:mm`） | -| `reserve_info.end_time.max_diff` | number | 最大时间差（分钟） | -| `reserve_info.end_time.prefer_early` | bool | 结束时间优先较晚 | -| `reserve_info.renew_time.expect_duration` | number | 期望续约时长（小时） | -| `reserve_info.renew_time.max_diff` | number | 最大时间差（分钟） | -| `reserve_info.renew_time.prefer_early` | bool | 续约时间优先较晚 | diff --git a/configuration/file.mdx b/configuration/file.mdx new file mode 100644 index 0000000..7ba97e4 --- /dev/null +++ b/configuration/file.mdx @@ -0,0 +1,206 @@ +--- +title: "通过文件配置" +description: "AutoLibrary JSON 配置文件参考 - run.json 与 user.json" +--- + +软件启动时，将自动在用户主目录下创建运行配置文件 `run.json` 和用户配置文件 `user.json`。 +配置文件统一存放于用户主目录下的 `AutoLibrary/config` 文件夹中。以 Windows 系统为例： + +```path +C:\Users\<用户名>\AppData\Roaming\AutoLibrary\config +``` + + + 任何情况下都不建议在该目录下修改除运行配置文件和用户配置文件以外的任何文件。 + + 即使是修改配置文件，也请务必保持 JSON 格式正确，否则可能导致软件无法正常启动或运行。 + + +## 运行配置文件 (run.json) + +```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": "", + "headless": false + } +} +``` + +### 字段 (library) + +关于图书馆的相关配置，目前版本下无需更改 + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `host_url` | String | 图书馆主机URL，无需更改 | +| `login_url` | String | 登录页面URL，无需更改 | + +### 字段 (mode) + +AutoLibrary 的运行模式 + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `run_mode` | Number | 运行模式组合（+1 预约, +2 签到, +4 续约） | + +### 字段 (login) + +AutoLibrary 处理登录时的相关配置 + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `auto_captcha` | Boolean | 自动验证码识别，建议保持 `true` | +| `max_attempt` | Number | 登录尝试次数，默认 3 次 | + +### 字段 (web_driver) + +AutoLibrary 使用的浏览器及其驱动的相关配置 + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `driver_type` | String | 浏览器类型：`edge` / `chrome` / `firefox` | +| `driver_path` | String | 驱动文件路径，为空则运行失败 | +| `headless` | Boolean | 无头模式，默认 `false` | + +## 用户配置文件 (user.json) + +```json +{ + "groups": [ + { + "name": "分组名", + "enable": true, + "users": [ + { + "username": "您的学号", + "password": "您的密码", + "enable": true, + "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 + }, + "renew_time": { + "expect_duration": 1.0, + "max_diff": 30, + "prefer_early": false + }, + "seat_id": "31A", + "expect_duration": 6, + "satisfy_duration": true + } + } + ] + } + ] +} +``` + +### 字段 (groups) + +这是用户配置的最外层的用户分组，分组中会包含一个用户列表， + + + 即使只添加用户列表而不使用分组包裹，AutoLibrary 也会默认为该用户列表创建兼容分组。 + + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `name` | String | 分组名称 | +| `enable` | Boolean | 是否启用该分组，`false` 时跳过 | + +### 字段 (users) + +用户分组中的用户列表 + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `username` | String | 学号 | +| `password` | String | 密码 | +| `enable` | Boolean | 是否启用该用户，`false` 时跳过 | + +### 字段 (reserve_info) + +该字段包含了用户的座位预约信息 + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `date` | String | 预约日期（格式 `yyyy-MM-dd`） | +| `place` | String | `"图书馆"` 或 `"1"` | +| `floor` | String | 楼层代码，详见下方楼层映射 | +| `room` | String | 区域代码，详见下方区域映射 | +| `seat_id` | String | 座位编号，如 `12A` `012a` | +| `expect_duration` | Number | 期望预约时长（分钟） | +| `satisfy_duration` | Boolean | 是否满足期望时长 | + + + | 代码 | 楼层 | + | --- | --- | + | `2` | 二层 | + | `3` | 三层 | + | `4` | 四层 | + | `5` | 五层 | + + + | 代码 | 区域 | + | --- | --- | + | `1` | 二层内环 | + | `2` | 二层西区 | + | `3` | 三层内环 | + | `4` | 三层外环 | + | `5` | 四层内环 | + | `6` | 四层外环 | + | `7` | 期刊区 | + | `8` | 五层考研 | + + +#### 子字段 begin_time + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `time` | String | 开始时间（格式 `HH:mm`） | +| `max_diff` | Number | 最大时间差（分钟） | +| `prefer_early` | Boolean | 是否优先较早时间 | + +#### 子字段 end_time + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `time` | String | 结束时间（格式 `HH:mm`） | +| `max_diff` | Number | 最大时间差（分钟） | +| `prefer_early` | Boolean | 结束时间优先较晚 | + +#### 子字段 renew_time + + + 该子字段只在用户的续约模式下才会被 AutoLibrary 读取 + + +| 参数 | 类型 | 说明 | +| --- | --- | --- | +| `expect_duration` | Number | 期望续约时长（小时） | +| `max_diff` | Number | 最大时间差（分钟） | +| `prefer_early` | Boolean | 续约时间优先较晚 | diff --git a/configuration/start.mdx b/configuration/start.mdx new file mode 100644 index 0000000..5d8df12 --- /dev/null +++ b/configuration/start.mdx @@ -0,0 +1,12 @@ +--- +title: "启动工具" +description: "AutoLibrary 启动与运行说明" +--- + +运行 AutoLibrary 文件，工具将启动主界面。 + +![运行主界面](/images/v1.2.1/运行主界面.png) + +软件首次启动时，未初始化配置文件，直接运行脚本会提示配置文件未找到。这属于预期行为，请先完成下方配置。 + + 为适应不同的用户需求，这里分别提供了通过界面与直接修改配置文件两种方式，请按照需求参考选择 diff --git a/configuration/ui.mdx b/configuration/ui.mdx new file mode 100644 index 0000000..067db00 --- /dev/null +++ b/configuration/ui.mdx @@ -0,0 +1,97 @@ +--- +title: "通过界面配置" +description: "AutoLibrary 界面配置指南 - 用户、预约、系统设置与运行模式" +--- + +点击主界面窗口右上角的配置按钮，打开配置窗口。 + + + + ![配置窗口-用户配置](/images/v1.2.1/配置窗口-用户配置.png) + + 初次运行软件时，用户配置默认为空，需要手动添加。 + + ### 用户列表 + + | 功能 | 说明 | 备注 | + | --- | --- | --- | + | 用户列表 | 显示当前配置文件中的所有用户 | 支持添加、删除用户操作，选中用户项进行详细配置 | + + ### 用户信息 + + | 参数 | 说明 | 默认值/可选值 | + | --- | --- | --- | + | 学号 | 用户的学号 | 必填项，用于登录图书馆系统 | + | 密码 | 用户的密码 | 默认值为 `000000`，请根据实际情况修改 | + + ### 预约信息 + + | 参数 | 说明 | 默认值/可选值 | + | --- | --- | --- | + | 日期 | 座位预约日期 | 格式 `yyyy-MM-dd`，18:00-23:00可预约次日 | + | 地点 | 预约座位的地点 | 默认值：`图书馆` | + | 楼层 | 预约座位的楼层 | `二层` `三层` `四层` `五层` | + | 区域 | 预约座位的区域 | 默认值：`二层内环`，可选随楼层变化 | + | 座位号 | 预约座位的座位号 | 例如：`12A` `012a` | + | 开始时间 | 预约开始时间 | 格式 `HH:mm`，可选范围 7:30-23:30 | + | 结束时间 | 预约结束时间 | 格式 `HH:mm`，默认当前时间+2小时 | + | 最大时间偏差 | 时间不可用时的偏差范围 | 0-120分钟，0 表示严格按选择时间 | + | 优先最早/晚 | 多可选时间时的优先选择 | 开始时间优先最早，结束/续约时间优先最晚 | + | 期望预约时长 | 预约期望时长 | 0-8 小时，默认 2 小时 | + | 期望续约时长 | 续约期望时长 | 0-4 小时，默认 1 小时 | + | 优先满足期望时长 | 是否优先满足时长限制 | 勾选后尽量满足，但可能因座位紧张导致预约失败 | + + + ![配置窗口-运行配置](/images/v1.2.1/配置窗口-运行配置.png) + + ### 图书馆设置 + + | 参数 | 说明 | 默认值 | + | --- | --- | --- | + | 访问网址 | 图书馆系统的主机URL | `http://10.1.20.7`（无需更改） | + | 登录页面 | 登录页面的URL路径 | `/login`（无需更改） | + + ### 浏览器设置 + + | 参数 | 说明 | 默认值/可选值 | + | --- | --- | --- | + | 浏览器类别 | 使用的浏览器类型 | Microsoft Edge / Google Chrome / Mozilla Firefox | + | 浏览器驱动路径 | 驱动程序路径 | 通过浏览按钮选择 | + | 无头模式 | 是否隐藏浏览器窗口 | `false`（显示窗口），`true` 为隐藏运行 | + + ### 登录设置 + + | 参数 | 说明 | 默认值 | + | --- | --- | --- | + | 自动识别验证码 | 是否自动处理验证码 | 勾选（推荐） | + | 登录尝试次数 | 登录失败后最大重试次数 | 3 次 | + + ### 运行模式 + + | 功能 | 说明 | 触发条件 | + | --- | --- | --- | + | 自动预约 | 按配置进行座位预约 | 用户当天无有效预约时执行 | + | 自动签到 | 自动完成图书馆签到 | 满足条件时执行，否则跳过 | + | 自动续约 | 自动延长座位使用时间 | 满足条件时执行，否则跳过 | + + + ![配置窗口-其它](/images/v1.2.1/配置窗口-其它.png) + + ### 配置文件的保存与读取 + + | 参数 | 说明 | + | --- | --- | + | 运行配置文件路径 | 可通过浏览按钮选择新的配置文件 | + | 用户配置文件路径 | 可通过浏览按钮选择新的配置文件 | + + ### 导出配置 + + 支持将当前配置导出为文件，选择目标路径和文件名后点击导出按钮。 + + + +## 运行工具 + +配置完成后，点击主界面窗口顶部右侧的绿色按钮 **"启动脚本"**，工具将按配置自动执行预约、签到、续约等操作。 + +AutoLibrary 将按照配置文件处理所有启用的用户组中的可用用户。 diff --git a/docs.json b/docs.json index 1a16e8b..61c8e87 100644 --- a/docs.json +++ b/docs.json @@ -1,6 +1,6 @@ { "$schema": "https://mintlify.com/docs.json", - "theme": "mint", + "theme": "almond", "name": "AutoLibrary", "colors": { "primary": "#0EA5E9", @@ -11,30 +11,39 @@ "navigation": { "tabs": [ { - "tab": "用户手册", + "tab": "用户手册 v1.3.0", "groups": [ { "group": "安装", + "icon": "download", "pages": [ - "installation" + "installation/install", + "installation/driver" ] }, { "group": "配置", + "icon": "sliders", "pages": [ - "configuration" + "configuration/start", + "configuration/ui", + "configuration/file" ] }, { "group": "功能", + "icon": "bolt", "pages": [ - "introduction" + "features/core", + "features/timer" ] }, { "group": "FAQ", + "icon": "circle-question", "pages": [ - "troubleshooting" + "faq/troubleshooting", + "faq/faq" ] } ] @@ -43,18 +52,13 @@ "global": { "anchors": [ { - "anchor": "下载", - "href": "https://autolibrary.kenanzhu.com/downloads", - "icon": "download" + "anchor": "Support", + "href": "mailto:nanoki_zh@163.com", + "icon": "envelope" }, { - "anchor": "更新日志", - "href": "https://autolibrary.kenanzhu.com/changelog", - "icon": "clock" - }, - { - "anchor": "GitHub", - "href": "https://github.com/AutoLibrary", + "anchor": "Github Issues", + "href": "https://github.com/KenanZhu/AutoLibrary/issues", "icon": "github" } ] @@ -67,29 +71,33 @@ "navbar": { "links": [ { - "label": "Support", - "href": "mailto:nanoki_zh@163.com" + "label": "下载", + "href": "https://autolibrary.kenanzhu.com/downloads", + "icon": "download" + }, + { + "label": "更新日志", + "href": "https://autolibrary.kenanzhu.com/changelog", + "icon": "clock" + }, + { + "label": "GitHub", + "href": "https://github.com/KenanZhu/AutoLibrary", + "icon": "github" } - ], - "primary": { - "type": "button", - "label": "下载", - "href": "https://autolibrary.kenanzhu.com/downloads" - } + ] }, "contextual": { "options": [ "copy", "view", - "chatgpt", "claude", - "cursor", "vscode" ] }, "footer": { "socials": { - "github": "https://github.com/AutoLibrary" + "github": "https://github.com/KenanZhu/AutoLibrary" } } } diff --git a/faq/faq.mdx b/faq/faq.mdx new file mode 100644 index 0000000..7bc8acf --- /dev/null +++ b/faq/faq.mdx @@ -0,0 +1,15 @@ +--- +title: "常见问题" +description: "AutoLibrary 使用问答" +--- + + + AutoLibrary 完全模拟人工操作，不干扰图书馆系统正常运行。工具**不会收集或上传您的个人信息**，所有数据仅保存在本地配置文件中。 + + + 根据图书馆规定，每个账号同一时间段只能预约一个座位。但您可以在配置中添加多个账号，工具会依次处理每个账号的预约请求。 + 本工具旨在辅助用户正常使用图书馆服务，请勿滥用影响他人及图书馆正常运行。 + + + 可以正常使用电脑，但请**勿操作工具自动打开的浏览器窗口**，否则可能会干扰工具正常运行。如需完全后台运行，可启用无头模式并最小化到托盘。 + diff --git a/troubleshooting.mdx b/faq/troubleshooting.mdx similarity index 67% rename from troubleshooting.mdx rename to faq/troubleshooting.mdx index 6685395..a39e751 100644 --- a/troubleshooting.mdx +++ b/faq/troubleshooting.mdx @@ -1,14 +1,16 @@ --- -title: "常见问题" -description: "AutoLibrary 故障排除与使用问答" -icon: "circle-question" +title: "疑难解答" +description: "AutoLibrary 故障排除与常见问题解决方法" --- -## 故障排除 +## 工具启动时报错"无法找到驱动" -### 工具启动时报错"无法找到驱动" + + 这大概率是因为浏览器驱动未正确安装或版本不匹配。 -这大概率是因为浏览器驱动未正确安装或版本不匹配。 + 因此我们强烈建议使用 AutoLibrary 的[浏览器驱动自动下载功能](/installation/driver#%E6%96%B9%E5%BC%8F%E4%B8%80%EF%BC%9A%E4%BD%BF%E7%94%A8%E6%B5%8F%E8%A7%88%E5%99%A8%E9%A9%B1%E5%8A%A8%E8%87%AA%E5%8A%A8%E4%B8%8B%E8%BD%BD%E5%8A%9F%E8%83%BD%EF%BC%88%E6%8E%A8%E8%8D%90%EF%BC%89)。 + 这可以很大程度上减少此类问题的发生。 + @@ -18,11 +20,11 @@ icon: "circle-question" 驱动版本必须与浏览器版本完全匹配（如 Chrome 需对应版本的 `chromedriver.exe`，切勿混用）。 - 使用 [浏览器驱动自动下载功能](/installation#方式一使用浏览器驱动自动下载功能推荐) 重新安装。 + 使用浏览器驱动自动下载窗口重新安装。 -### 登录失败，提示账号密码错误 +## 登录失败，提示账号密码错误 请检查配置界面中的账号密码是否正确。 @@ -38,7 +40,7 @@ icon: "circle-question" -### 预约失败，提示座位不可用 +## 预约失败，提示座位不可用 目标座位可能已被他人预约或不在可预约时间。 @@ -51,7 +53,7 @@ icon: "circle-question" -### 定时任务显示"已就绪"或"执行中"且无法删除 +## 定时任务显示"已就绪"或"执行中"且无法删除 此解决方法需要直接操作 AutoLibrary 的核心配置文件，需要操作者对 JSON 文件格式有一定了解。**操作前请务必备份相关文件**，以免误操作导致配置丢失。 @@ -87,21 +89,3 @@ icon: "circle-question" 如果操作后 JSON 格式出错，软件可能会覆写原有配置文件。请确保备份，并检查 JSON 语法是否正确（注意最后一个元素后不要有多余的逗号）。 - -## 常见问题 - - - - AutoLibrary 完全模拟人工操作，不干扰图书馆系统正常运行。工具**不会收集或上传您的个人信息**，所有数据仅保存在本地配置文件中。 - - - - 根据图书馆规定，每个账号同一时间段只能预约一个座位。但您可以在配置中添加多个账号，工具会依次处理每个账号的预约请求。 - - 本工具旨在辅助用户正常使用图书馆服务，请勿滥用影响他人及图书馆正常运行。 - - - - 可以正常使用电脑，但请**勿操作工具自动打开的浏览器窗口**，否则可能会干扰工具正常运行。如需完全后台运行，可启用无头模式并最小化到托盘。 - - diff --git a/features/core.mdx b/features/core.mdx new file mode 100644 index 0000000..5c6c6ad --- /dev/null +++ b/features/core.mdx @@ -0,0 +1,36 @@ +--- +title: "核心功能" +description: "AutoLibrary 核心功能 - 自动预约、签到、续约与模式组合" +--- + +## 运行模式 + + + + 如果用户当前没有有效预约，工具会自动为您预约指定座位。适用于提前预约第二天的座位。 + + + 在可签到时间范围（开始时间的前后30分钟）内，自动完成签到，避免因忘记签到导致失约。 + + + 到达可续约时间（结束时间前的120分钟），自动延长座位使用时间。 + + + +## 模式组合 + +运行模式可以组合使用，只需在配置窗口中勾选对应模式即可。同时启用三种模式后，工具会自动判断当前状态并执行相应操作。 + +推荐同时启用三种模式，让工具自动处理预约、签到、续约的完整流程。 diff --git a/introduction.mdx b/features/timer.mdx similarity index 50% rename from introduction.mdx rename to features/timer.mdx index 3db6449..4cfe301 100644 --- a/introduction.mdx +++ b/features/timer.mdx @@ -1,60 +1,21 @@ --- -title: "功能" -description: "AutoLibrary 核心功能介绍与定时任务使用指南" -icon: "bolt" +title: "定时任务" +description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任务" --- -## 工具简介 +使用内置定时任务管理，添加定时任务后在指定时间按当前预约信息自动运行。 +支持设置重复周期，如每周一、周三、周五自动执行。 -AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具，帮助您简化图书馆座位操作流程，节省宝贵时间。工具完全模拟人工操作，通过简单的界面配置即可使用。 - -本文主要概述了在 Windows 11/10 环境下的 AutoLibrary 工具的安装、配置和使用方法。 - -## 核心功能 - - - - 如果用户当前没有有效预约，工具会自动为您预约指定座位。适用于提前预约第二天的座位。 - - - 在可签到时间范围（开始时间的前后30分钟）内，自动完成签到，避免因忘记签到导致失约。 - - - 到达可续约时间（结束时间前的120分钟），自动延长座位使用时间。 - - - -## 模式组合使用 - -运行模式可以组合使用，只需在配置窗口中勾选对应模式即可。同时启用三种模式后，工具会自动判断当前状态并执行相应操作。 - -推荐同时启用三种模式，让工具自动处理预约、签到、续约的完整流程。 - -## 定时任务 - -使用内置定时任务管理，添加定时任务后在指定时间按当前预约信息自动运行。支持设置重复周期，如每周一、周三、周五自动执行。 - -![功能介绍-定时任务](/images/v1.2.1/功能介绍-定时任务.png) - -### 打开定时任务管理 +## 打开定时任务管理 点击主界面窗口底部左侧的 **"定时任务管理"** 按钮，打开定时任务管理窗口。 ![定时任务管理窗口](/images/v1.3.0/定时任务管理窗口.png) -### 添加定时任务 +![功能介绍-定时任务](/images/v1.2.1/功能介绍-定时任务.png) + + +## 添加定时任务 点击 **"添加定时任务"** 按钮，在弹出的对话框中配置任务参数： @@ -62,14 +23,14 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 添加后任务将显示在列表中，状态为"等待中"。到达指定时间后自动执行。 -#### 定时类型 +### 定时类型 | 选项 | 说明 | 示例 | | --- | --- | --- | | 特定时间 | 指定任务开始的绝对时间 | `2025-10-30 08:00:00` | | 相对时间 | 相对当前时间的偏移量 | 提前 1 天、提前 2 小时、提前 30 分钟 | -#### 运行模式 +### 运行模式 | 选项 | 行为 | 适用场景 | | --- | --- | --- | @@ -80,7 +41,7 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 如需完全静默运行：在配置界面的系统设置中勾选 **"无头模式"**，并在程序托盘中右键选择 **"最小化到托盘"**。这样定时任务运行时不会显示主界面和浏览器窗口，仅在完成时弹出系统通知。 -#### 重复执行 +### 重复执行 勾选 **"启用重复执行"** 后，可以按周循环执行任务： @@ -88,7 +49,7 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 - 需要每天运行则勾选全部（周一至周日） - 全选和全不选均视为每日执行 -### 编辑定时任务 +## 编辑定时任务 支持对已创建的定时任务进行编辑修改，无需删除重建。 @@ -109,7 +70,7 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 编辑任务时，任务的 UUID 和执行历史（可重复性任务）将被保留。修改执行时间后，状态将重置为"等待中"。 -### 删除定时任务 +## 删除定时任务 可通过以下两种方式移除定时任务： @@ -117,20 +78,3 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 - 点击任务项右侧的 **"删除"** 按钮 删除可重复性任务将同时清除该任务的所有执行历史记录。 - -## 核心亮点 - - - - 自动检测本地浏览器并匹配对应驱动版本，一键下载安装。 - - - 支持对已创建的定时任务进行编辑修改，无需删除重建，保留任务 UUID 和执行历史。 - - - 按周循环执行，灵活选择周一至周日任意组合。 - - - 配合无头模式和托盘最小化，后台完全静默执行。 - - diff --git a/index.mdx b/index.mdx index 3b8c798..283d3db 100644 --- a/index.mdx +++ b/index.mdx @@ -14,43 +14,29 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 下载安装工具，配置浏览器驱动 —— 支持一键自动下载。 完整参数参考：用户信息、预约参数、系统设置与配置文件详解。 核心功能概览：自动预约、签到、续约，以及定时任务管理。 常见问题解决方法与使用问答，快速排查使用问题。 - - -## 核心功能 - - - - 自动预约指定座位，支持定时任务批量处理。 - - - 可签到时间范围内自动签到，避免失约。 - - - 到达可续约时间自动延长使用时间。 - - + \ No newline at end of file diff --git a/installation.mdx b/installation.mdx deleted file mode 100644 index 9a58855..0000000 --- a/installation.mdx +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: "安装" -description: "AutoLibrary 下载安装与浏览器驱动配置指南" -icon: "download" ---- - -AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具，帮助您简化图书馆座位操作流程，节省宝贵时间。工具完全模拟人工操作，通过简单的界面配置即可使用。 - -本文主要概述了在 Windows 11/10 环境下的 AutoLibrary 工具的安装、配置和使用方法。 - -## 安装工具 - -### 下载软件 - -请从 AutoLibrary 下载页面获取最新版本。 - - - **Github** 下载：更新较为及时，但网络连接不稳定，速度较慢。 - **云盘下载**：版本更新略有延迟，但下载速度更快。 - - -### 版本类型 - -从 v1.1.0 版本开始，提供两种版本供您选择： - - - - 下载完成后，解压缩文件夹到任意位置，双击运行其中的 `AutoLibrary.exe` 即可启动工具。 - - - 下载完成后，双击运行安装程序，按照提示进行安装。安装完成后可在开始菜单中找到 AutoLibrary。 - - - - - 压缩包内的 `_internal` 文件夹与 `AutoLibrary.exe` 可执行文件需要位于同一目录下，请勿修改或移动这两个文件，否则可能导致工具无法正常运行。 - - -## 配置浏览器驱动 - -工具需要通过浏览器驱动来控制浏览器。以下两种方式可以帮助您快速配置驱动： - -AutoLibrary 支持自动检测本地安装的浏览器，并查找适配的驱动版本，大大简化了配置流程。 - -### 方式一：使用浏览器驱动自动下载功能（推荐） - -![浏览器驱动自动下载窗口](/images/v1.2.1/浏览器驱动自动下载窗口.png) - - - - 在 AutoLibrary 配置界面中，点击"浏览器驱动自动下载"按钮。 - - - 工具会自动检测您电脑上已安装的浏览器，并列出可用的驱动版本。 - - - 选择需要的浏览器驱动版本，点击"开始下载"按钮。 - - ![开始下载浏览器驱动](/images/v1.2.1/浏览器驱动自动下载窗口-开始下载.png) - - - 下载完成后，点击"确定"保存并退出对话框，即可在配置界面中使用该驱动。 - - ![浏览器驱动下载完成](/images/v1.2.1/浏览器驱动自动下载窗口-下载完成.png) - - - -### 方式二：手动下载浏览器驱动 - -如果您仍需手动下载驱动，请根据您使用的浏览器选择对应的驱动： - -| 浏览器 | 适用系统 | 下载链接 | -| --- | --- | --- | -| Microsoft Edge | 跨平台 | [下载 Edge 驱动](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/) | -| Google Chrome | 跨平台 | [下载 Chrome 驱动](https://developer.chrome.google.cn/docs/chromedriver/downloads) | -| Mozilla Firefox | 跨平台 | [下载 Firefox 驱动](https://github.com/mozilla/geckodriver/releases) | diff --git a/installation/driver.mdx b/installation/driver.mdx new file mode 100644 index 0000000..c21ef82 --- /dev/null +++ b/installation/driver.mdx @@ -0,0 +1,41 @@ +--- +title: "安装浏览器驱动" +description: "AutoLibrary 浏览器驱动配置指南 - 自动下载与手动安装" +--- + +工具需要通过浏览器驱动来控制浏览器。以下两种方式可以帮助您快速配置驱动： + +AutoLibrary 支持自动检测本地安装的浏览器，并查找适配的驱动版本，大大简化了配置流程。 + +## 方式一：使用浏览器驱动自动下载功能 + + + + 在 [AutoLibrary 配置界面](/configuration/ui#%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE)中，点击"浏览器驱动自动下载"按钮。 + + ![浏览器驱动自动下载窗口](/images/v1.2.1/浏览器驱动自动下载窗口.png) + + + 工具会自动检测您电脑上已安装的浏览器，并列出可用的驱动版本。 + + + 从窗口中的下拉列表中选择需要的浏览器驱动版本，点击"开始下载"按钮。 + + ![开始下载浏览器驱动](/images/v1.2.1/浏览器驱动自动下载窗口-开始下载.png) + + + 下载完成后，点击"确定"将驱动类型与驱路径保存到配置窗口中并退出下载对话框。 + + ![浏览器驱动下载完成](/images/v1.2.1/浏览器驱动自动下载窗口-下载完成.png) + + + +## 方式二：手动下载浏览器驱动 + +如果仍需手动下载驱动，请根据您使用的浏览器选择对应的驱动： + +| 浏览器 | 适用系统 | 下载链接 | +| --- | --- | --- | +| Microsoft Edge | 跨平台 | [下载 Edge 驱动](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/) | +| Google Chrome | 跨平台 | [下载 Chrome 驱动](https://developer.chrome.google.cn/docs/chromedriver/downloads) | +| Mozilla Firefox | 跨平台 | [下载 Firefox 驱动](https://github.com/mozilla/geckodriver/releases) | diff --git a/installation/install.mdx b/installation/install.mdx new file mode 100644 index 0000000..2f30251 --- /dev/null +++ b/installation/install.mdx @@ -0,0 +1,35 @@ +--- +title: "安装 AutoLibrary" +description: "AutoLibrary 下载与安装指南" +--- + +AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具，帮助您简化图书馆座位操作流程，节省宝贵时间。工具完全模拟人工操作，通过简单的界面配置即可使用。 + +本文主要概述了在 Windows 11/10 环境下的 AutoLibrary 工具的安装、配置和使用方法。 + +## 下载软件 + +请从 [AutoLibrary 下载页面](https://autolibrary.kenanzhu.com/downloads)获取最新版本。 + + + [**Github Releases**](https://github.com/kenanZhu/AutoLibrary/releases)：更新较为及时，但网络连接不稳定，速度较慢。 + + **云盘链接**：版本更新略有延迟，但下载速度更快。 + + +## 安装类型 + +从 v1.1.0 版本开始，提供两种版本可供选择： + + + + 解压下载好的压缩包文件到任意位置，双击运行其中的 `AutoLibrary.exe` 即可启动工具。 + + + 压缩包内的 `_internal` 文件夹与 `AutoLibrary.exe` 可执行文件需要位于同一目录下，请勿修改或移动这两个文件，否则可能导致工具无法正常运行。 + + + + 双击运行安装程序，按照步骤提示进行安装。安装完成后即可在桌面快捷方式或开始菜单中找到 AutoLibrary。 + + diff --git a/style.css b/style.css new file mode 100644 index 0000000..d79d64e --- /dev/null +++ b/style.css @@ -0,0 +1,3 @@ +html { + font-size: 15px; +}