From c77262668968ba1cdbe72b44788fba3ef5dcc08f Mon Sep 17 00:00:00 2001 From: Gogs Date: Thu, 21 May 2026 23:56:25 +0800 Subject: [PATCH] =?UTF-8?q?Reorganize=20docs=20into=204=20sections:=20?= =?UTF-8?q?=E5=AE=89=E8=A3=85/=E9=85=8D=E7=BD=AE/=E5=8A=9F=E8=83=BD/FAQ?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Merge 预约信息 into 用户配置 tab, combine 系统设置 and 运行模式, move config save/load to 其它配置 tab - Merge scheduled-tasks content into introduction as 功能 page - Unify all troubleshooting entries to Steps format - Update navigation groups and index links to 4-part structure Co-Authored-By: Claude Opus 4.7 --- configuration.mdx | 19 +++++---- docs.json | 18 +++++--- favicon.svg | 17 +++++--- index.mdx | 25 ++++------- installation.mdx | 8 +++- introduction.mdx | 101 +++++++++++++++++++++++++++++++++++--------- scheduled-tasks.mdx | 75 -------------------------------- troubleshooting.mdx | 44 +++++++++++++------ 8 files changed, 160 insertions(+), 147 deletions(-) delete mode 100644 scheduled-tasks.mdx diff --git a/configuration.mdx b/configuration.mdx index eaba658..09c7a5d 100644 --- a/configuration.mdx +++ b/configuration.mdx @@ -34,9 +34,8 @@ icon: "sliders" | --- | --- | --- | | 学号 | 用户的学号 | 必填项，用于登录图书馆系统 | | 密码 | 用户的密码 | 默认值为 `000000`，请根据实际情况修改 | - - - ![配置窗口-运行配置](/images/v1.2.1/配置窗口-运行配置.png) + + ### 预约信息 | 参数 | 说明 | 默认值/可选值 | | --- | --- | --- | @@ -53,7 +52,9 @@ icon: "sliders" | 期望续约时长 | 续约期望时长 | 0-4 小时，默认 1 小时 | | 优先满足期望时长 | 是否优先满足时长限制 | 勾选后尽量满足，但可能因座位紧张导致预约失败 | - + + ![配置窗口-运行配置](/images/v1.2.1/配置窗口-运行配置.png) + ### 图书馆设置 | 参数 | 说明 | 默认值 | @@ -75,17 +76,19 @@ icon: "sliders" | --- | --- | --- | | 自动识别验证码 | 是否自动处理验证码 | 勾选（推荐） | | 登录尝试次数 | 登录失败后最大重试次数 | 3 次 | - - + + ### 运行模式 + | 功能 | 说明 | 触发条件 | | --- | --- | --- | | 自动预约 | 按配置进行座位预约 | 用户当天无有效预约时执行 | | 自动签到 | 自动完成图书馆签到 | 满足条件时执行，否则跳过 | | 自动续约 | 自动延长座位使用时间 | 满足条件时执行，否则跳过 | - + + ![配置窗口-其它](/images/v1.2.1/配置窗口-其它.png) - ### 配置管理 + ### 配置文件的保存与读取 | 参数 | 说明 | | --- | --- | diff --git a/docs.json b/docs.json index a82d4f1..1a16e8b 100644 --- a/docs.json +++ b/docs.json @@ -14,21 +14,25 @@ "tab": "用户手册", "groups": [ { - "group": "快速入门", + "group": "安装", "pages": [ - "introduction", "installation" ] }, { - "group": "使用指南", + "group": "配置", "pages": [ - "configuration", - "scheduled-tasks" + "configuration" ] }, { - "group": "帮助支持", + "group": "功能", + "pages": [ + "introduction" + ] + }, + { + "group": "FAQ", "pages": [ "troubleshooting" ] @@ -64,7 +68,7 @@ "links": [ { "label": "Support", - "href": "mailto:support@autolibrary.kenanzhu.com" + "href": "mailto:nanoki_zh@163.com" } ], "primary": { diff --git a/favicon.svg b/favicon.svg index d50ceed..d2bf063 100644 --- a/favicon.svg +++ b/favicon.svg @@ -1,5 +1,12 @@ - - - - - + + + + + + + + + + + + \ No newline at end of file diff --git a/index.mdx b/index.mdx index ba7211a..3b8c798 100644 --- a/index.mdx +++ b/index.mdx @@ -8,45 +8,36 @@ icon: "book-open" AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具，帮助您简化图书馆座位操作流程。 - - 了解 AutoLibrary 的核心功能：自动预约、自动签到、自动续约与定时任务。 - - ## 快速导航 下载安装工具，配置浏览器驱动 —— 支持一键自动下载。 完整参数参考：用户信息、预约参数、系统设置与配置文件详解。 - 添加、编辑、删除定时任务，支持重复执行与静默运行。 + 核心功能概览：自动预约、签到、续约，以及定时任务管理。 - 常见问题解决方法与 FAQ，快速排查使用问题。 + 常见问题解决方法与使用问答，快速排查使用问题。 diff --git a/installation.mdx b/installation.mdx index 83eb6dd..9a58855 100644 --- a/installation.mdx +++ b/installation.mdx @@ -1,9 +1,13 @@ --- -title: "安装与配置" +title: "安装" description: "AutoLibrary 下载安装与浏览器驱动配置指南" icon: "download" --- +AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具，帮助您简化图书馆座位操作流程，节省宝贵时间。工具完全模拟人工操作，通过简单的界面配置即可使用。 + +本文主要概述了在 Windows 11/10 环境下的 AutoLibrary 工具的安装、配置和使用方法。 + ## 安装工具 ### 下载软件 @@ -67,6 +71,6 @@ icon: "download" | 浏览器 | 适用系统 | 下载链接 | | --- | --- | --- | -| Microsoft Edge | Windows 10/11 | [下载 Edge 驱动](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/) | +| 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/introduction.mdx b/introduction.mdx index 5f89c09..3db6449 100644 --- a/introduction.mdx +++ b/introduction.mdx @@ -1,7 +1,7 @@ --- -title: "概述" -description: "AutoLibrary 北京建筑大学图书馆自动化工具 - 功能介绍与快速了解" -icon: "book-open" +title: "功能" +description: "AutoLibrary 核心功能介绍与定时任务使用指南" +icon: "bolt" --- ## 工具简介 @@ -16,21 +16,21 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 如果用户当前没有有效预约，工具会自动为您预约指定座位。适用于提前预约第二天的座位。 在可签到时间范围（开始时间的前后30分钟）内，自动完成签到，避免因忘记签到导致失约。 到达可续约时间（结束时间前的120分钟），自动延长座位使用时间。 @@ -42,36 +42,95 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 推荐同时启用三种模式，让工具自动处理预约、签到、续约的完整流程。 -### 定时任务 +## 定时任务 使用内置定时任务管理，添加定时任务后在指定时间按当前预约信息自动运行。支持设置重复周期，如每周一、周三、周五自动执行。 ![功能介绍-定时任务](/images/v1.2.1/功能介绍-定时任务.png) +### 打开定时任务管理 + +点击主界面窗口底部左侧的 **"定时任务管理"** 按钮，打开定时任务管理窗口。 + +![定时任务管理窗口](/images/v1.3.0/定时任务管理窗口.png) + +### 添加定时任务 + +点击 **"添加定时任务"** 按钮，在弹出的对话框中配置任务参数： + +![添加定时任务对话框](/images/v1.3.0/添加定时任务对话框.png) + +添加后任务将显示在列表中，状态为"等待中"。到达指定时间后自动执行。 + +#### 定时类型 + +| 选项 | 说明 | 示例 | +| --- | --- | --- | +| 特定时间 | 指定任务开始的绝对时间 | `2025-10-30 08:00:00` | +| 相对时间 | 相对当前时间的偏移量 | 提前 1 天、提前 2 小时、提前 30 分钟 | + +#### 运行模式 + +| 选项 | 行为 | 适用场景 | +| --- | --- | --- | +| 静默运行 | 任务执行时不会弹出窗口，完成后右下角通知 | 完全自动化，无需人工干预 | +| 运行前提示 | 任务执行前显示提示信息 | 需要在运行前确认或查看进度 | + + + 如需完全静默运行：在配置界面的系统设置中勾选 **"无头模式"**，并在程序托盘中右键选择 **"最小化到托盘"**。这样定时任务运行时不会显示主界面和浏览器窗口，仅在完成时弹出系统通知。 + + +#### 重复执行 + +勾选 **"启用重复执行"** 后，可以按周循环执行任务： + +- 选择需要运行的天（如：每周一、周三、周五） +- 需要每天运行则勾选全部（周一至周日） +- 全选和全不选均视为每日执行 + +### 编辑定时任务 + +支持对已创建的定时任务进行编辑修改，无需删除重建。 + + + + 在定时任务管理窗口中，在任务列表中的任意任务项上单击**鼠标右键**，在弹出的菜单中选择**"编辑"**。 + + ![定时任务右键编辑菜单](/images/v1.3.0/定时任务-右键编辑.png) + + + 编辑对话框将显示任务的当前配置。您可以修改： + - 任务名称 + - 定时时间 + - 运行模式 + - 将普通任务转换为可重复性任务（反之亦然） + + + +编辑任务时，任务的 UUID 和执行历史（可重复性任务）将被保留。修改执行时间后，状态将重置为"等待中"。 + +### 删除定时任务 + +可通过以下两种方式移除定时任务： + +- 右键菜单选择 **"删除"** +- 点击任务项右侧的 **"删除"** 按钮 + +删除可重复性任务将同时清除该任务的所有执行历史记录。 + ## 核心亮点 自动检测本地浏览器并匹配对应驱动版本，一键下载安装。 - + 支持对已创建的定时任务进行编辑修改，无需删除重建，保留任务 UUID 和执行历史。 - + 按周循环执行，灵活选择周一至周日任意组合。 - + 配合无头模式和托盘最小化，后台完全静默执行。 - -## 开始使用 - - - 从下载安装到浏览器驱动配置，几步即可开始使用 AutoLibrary。 - diff --git a/scheduled-tasks.mdx b/scheduled-tasks.mdx deleted file mode 100644 index 1a310bf..0000000 --- a/scheduled-tasks.mdx +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: "定时任务" -description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任务，实现自动化预约" -icon: "clock" ---- - -## 打开定时任务管理 - -点击主界面窗口底部左侧的 **"定时任务管理"** 按钮，打开定时任务管理窗口。 - -![定时任务管理窗口](/images/v1.3.0/定时任务管理窗口.png) - -## 添加定时任务 - -点击 **"添加定时任务"** 按钮，在弹出的对话框中配置任务参数： - -![添加定时任务对话框](/images/v1.3.0/添加定时任务对话框.png) - -添加后任务将显示在列表中，状态为"等待中"。到达指定时间后自动执行。 - -### 定时类型 - -| 选项 | 说明 | 示例 | -| --- | --- | --- | -| 特定时间 | 指定任务开始的绝对时间 | `2025-10-30 08:00:00` | -| 相对时间 | 相对当前时间的偏移量 | 提前 1 天、提前 2 小时、提前 30 分钟 | - -### 运行模式 - -| 选项 | 行为 | 适用场景 | -| --- | --- | --- | -| 静默运行 | 任务执行时不会弹出窗口，完成后右下角通知 | 完全自动化，无需人工干预 | -| 运行前提示 | 任务执行前显示提示信息 | 需要在运行前确认或查看进度 | - - - 如需完全静默运行：在配置界面的系统设置中勾选 **"无头模式"**，并在程序托盘中右键选择 **"最小化到托盘"**。这样定时任务运行时不会显示主界面和浏览器窗口，仅在完成时弹出系统通知。 - - -### 重复执行 - -勾选 **"启用重复执行"** 后，可以按周循环执行任务： - -- 选择需要运行的天（如：每周一、周三、周五） -- 需要每天运行则勾选全部（周一至周日） -- 全选和全不选均视为每日执行 - -## 编辑定时任务 - -支持对已创建的定时任务进行编辑修改，无需删除重建。 - - - - 在定时任务管理窗口中，在任务列表中的任意任务项上单击**鼠标右键**，在弹出的菜单中选择**"编辑"**。 - - ![定时任务右键编辑菜单](/images/v1.3.0/定时任务-右键编辑.png) - - - 编辑对话框将显示任务的当前配置。您可以修改： - - 任务名称 - - 定时时间 - - 运行模式 - - 将普通任务转换为可重复性任务（反之亦然） - - - -编辑任务时，任务的 UUID 和执行历史（可重复性任务）将被保留。修改执行时间后，状态将重置为"等待中"。 - -## 删除定时任务 - -可通过以下两种方式移除定时任务： - -- 右键菜单选择 **"删除"** -- 点击任务项右侧的 **"删除"** 按钮 - -删除可重复性任务将同时清除该任务的所有执行历史记录。 diff --git a/troubleshooting.mdx b/troubleshooting.mdx index 0d5f9bd..6685395 100644 --- a/troubleshooting.mdx +++ b/troubleshooting.mdx @@ -1,6 +1,6 @@ --- -title: "故障排除与 FAQ" -description: "AutoLibrary 常见问题解决方法与使用问答" +title: "常见问题" +description: "AutoLibrary 故障排除与使用问答" icon: "circle-question" --- @@ -10,26 +10,46 @@ icon: "circle-question" 这大概率是因为浏览器驱动未正确安装或版本不匹配。 -**解决方法：** - -- **检查驱动位置** — 确认驱动文件是否放置在正确位置 -- **确认版本匹配** — 驱动版本必须与浏览器版本完全匹配（如 Chrome 需对应版本的 `chromedriver.exe`，切勿混用） -- **重新安装驱动** — 使用 [浏览器驱动自动下载功能](/installation#方式一使用浏览器驱动自动下载功能推荐) 重新安装 + + + 确认驱动文件是否放置在正确位置。 + + + 驱动版本必须与浏览器版本完全匹配（如 Chrome 需对应版本的 `chromedriver.exe`，切勿混用）。 + + + 使用 [浏览器驱动自动下载功能](/installation#方式一使用浏览器驱动自动下载功能推荐) 重新安装。 + + ### 登录失败，提示账号密码错误 请检查配置界面中的账号密码是否正确。 -- **确认账号密码** — 确认学号和密码无误 -- **检查特殊字符** — 检查是否有不支持的特殊字符需要转义 -- **手动验证** — 尝试手动登录图书馆系统确认账号可用 + + + 确认学号和密码无误。 + + + 检查是否有不支持的特殊字符需要转义。 + + + 尝试手动登录图书馆系统确认账号可用。 + + ### 预约失败，提示座位不可用 目标座位可能已被他人预约或不在可预约时间。 -- **确认座位信息** — 确认座位编号、楼层、区域是否正确 -- **调整预约策略** — 尝试预约其它座位或调整时间参数。增大 **最大时间偏差** 让工具在允许的时间范围内自动选择最佳起始时间 + + + 确认座位编号、楼层、区域是否正确。 + + + 尝试预约其它座位或调整时间参数。增大 **最大时间偏差** 让工具在允许的时间范围内自动选择最佳起始时间。 + + ### 定时任务显示"已就绪"或"执行中"且无法删除