mirror of
https://gitlab.com/KenanZhu/AutoLibraryManuals.git
synced 2026-11-05 05:35:51 +08:00
KenanZhuandClaude Opus 4.7
451addb1c2
Remove all old version files. Split v1.3.0 manual into proper Mintlify chapters: - introduction.mdx: Overview with CardGroup for core features - installation.mdx: Download, version types (Tabs), driver setup (Steps) - configuration.mdx: Full config reference with Tabs (UI/file config), JSON blocks - scheduled-tasks.mdx: Timer task management with Steps and Warning callouts - troubleshooting.mdx: Common issues with Accordion FAQ and Warning callouts Enhanced with Mintlify components: CardGroup, Tabs, Steps, Accordion, AccordionGroup, Note, Tip, Warning, Info, CodeGroup with language-tagged code blocks. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
88 lines
4.3 KiB
Plaintext
88 lines
4.3 KiB
Plaintext
---
|
|
title: "故障排除与 FAQ"
|
|
description: "AutoLibrary 常见问题解决方法与使用问答"
|
|
icon: "circle-question"
|
|
---
|
|
|
|
## 故障排除
|
|
|
|
### 工具启动时报错"无法找到驱动"
|
|
|
|
<Note>这大概率是因为浏览器驱动未正确安装或版本不匹配。</Note>
|
|
|
|
**解决方法：**
|
|
|
|
- **检查驱动位置** — 确认驱动文件是否放置在正确位置
|
|
- **确认版本匹配** — 驱动版本必须与浏览器版本完全匹配（如 Chrome 需对应版本的 `chromedriver.exe`，切勿混用）
|
|
- **重新安装驱动** — 使用 [浏览器驱动自动下载功能](/installation#方式一使用浏览器驱动自动下载功能推荐) 重新安装
|
|
|
|
### 登录失败，提示账号密码错误
|
|
|
|
请检查配置界面中的账号密码是否正确。
|
|
|
|
- **确认账号密码** — 确认学号和密码无误
|
|
- **检查特殊字符** — 检查是否有不支持的特殊字符需要转义
|
|
- **手动验证** — 尝试手动登录图书馆系统确认账号可用
|
|
|
|
### 预约失败，提示座位不可用
|
|
|
|
目标座位可能已被他人预约或不在可预约时间。
|
|
|
|
- **确认座位信息** — 确认座位编号、楼层、区域是否正确
|
|
- **调整预约策略** — 尝试预约其它座位或调整时间参数。增大 **最大时间偏差** 让工具在允许的时间范围内自动选择最佳起始时间
|
|
|
|
### 定时任务显示"已就绪"或"执行中"且无法删除
|
|
|
|
<Warning>
|
|
此解决方法需要直接操作 AutoLibrary 的核心配置文件，需要操作者对 JSON 文件格式有一定了解。**操作前请务必备份相关文件**，以免误操作导致配置丢失。
|
|
</Warning>
|
|
|
|
这一般是因为定时任务已进入预约队列，但软件上次异常关闭未能处理完毕。请按以下步骤手动删除：
|
|
|
|
<Steps>
|
|
<Step title="记录异常任务信息">
|
|
检查界面中正在运行的定时任务，记住任务名称或运行时间等可用于定位的信息。
|
|
</Step>
|
|
<Step title="找到配置文件目录">
|
|
在 AutoLibrary 配置界面的「其它」选项卡中，找到「当前运行配置文件的路径」显示的文件夹路径，使用文件管理器打开该目录。
|
|
</Step>
|
|
<Step title="打开定时任务配置文件">
|
|
在该目录中找到名为 `timer_task.json` 的文件，使用文本编辑器打开（推荐 VS Code、Notepad++，也可使用记事本）。
|
|
</Step>
|
|
<Step title="定位异常任务">
|
|
在 JSON 文件中查找包含以下信息的任务配置块：
|
|
- `name`（任务名称）
|
|
- `execute_time`（执行时间）
|
|
|
|
如果任务名包含中文，在 JSON 中会以 Unicode 编码显示，如 `"name": "预约任务"`。可使用在线工具搜索「Unicode 转中文」进行转换确认。
|
|
</Step>
|
|
<Step title="删除异常任务">
|
|
将找到的任务配置块从 JSON 文件中完全删除。
|
|
|
|
<Warning>删除时请保持 JSON 格式完整：确保花括号 `{}`、方括号 `[]`、逗号等符号正确。不要删除其它正常任务配置。</Warning>
|
|
</Step>
|
|
<Step title="重启软件">
|
|
完全关闭 AutoLibrary 后重新打开，异常定时任务应已成功删除，界面状态恢复正常。
|
|
</Step>
|
|
</Steps>
|
|
|
|
<Tip>如果操作后 JSON 格式出错，软件可能会覆写原有配置文件。请确保备份，并检查 JSON 语法是否正确（注意最后一个元素后不要有多余的逗号）。</Tip>
|
|
|
|
## 常见问题
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="使用 AutoLibrary 是否安全？">
|
|
AutoLibrary 完全模拟人工操作，不干扰图书馆系统正常运行。工具**不会收集或上传您的个人信息**，所有数据仅保存在本地配置文件中。
|
|
</Accordion>
|
|
|
|
<Accordion title="可以同时预约多个座位吗？">
|
|
根据图书馆规定，每个账号同一时间段只能预约一个座位。但您可以在配置中添加多个账号，工具会依次处理每个账号的预约请求。
|
|
|
|
<Warning>本工具旨在辅助用户正常使用图书馆服务，请勿滥用影响他人及图书馆正常运行。</Warning>
|
|
</Accordion>
|
|
|
|
<Accordion title="工具运行期间可以操作电脑吗？">
|
|
可以正常使用电脑，但请**勿操作工具自动打开的浏览器窗口**，否则可能会干扰工具正常运行。如需完全后台运行，可启用无头模式并最小化到托盘。
|
|
</Accordion>
|
|
</AccordionGroup>
|