diff --git a/.claude/settings.local.json b/.claude/settings.local.json index 0a37a01..c602959 100644 --- a/.claude/settings.local.json +++ b/.claude/settings.local.json @@ -1,7 +1,8 @@ { "permissions": { "allow": [ - "WebSearch" + "WebSearch", + "WebFetch(domain:mintlify.com)" ] } } diff --git a/docs.json b/docs.json index 9049967..da0387b 100644 --- a/docs.json +++ b/docs.json @@ -3,9 +3,9 @@ "theme": "mint", "name": "AutoLibrary Manuals", "colors": { - "primary": "#64ffda", + "primary": "#0d9488", "light": "#64ffda", - "dark": "#64ffda" + "dark": "#0d9488" }, "favicon": "/favicon.svg", "fonts": { @@ -24,7 +24,8 @@ "group": "开始", "icon": "book-open", "pages": [ - "zh/index" + "zh/index/beforestart", + "zh/index/intro" ] }, { diff --git a/zh/configuration/file.mdx b/zh/configuration/file.mdx index 7ba97e4..8bb1196 100644 --- a/zh/configuration/file.mdx +++ b/zh/configuration/file.mdx @@ -13,7 +13,7 @@ C:\Users\<用户名>\AppData\Roaming\AutoLibrary\config 任何情况下都不建议在该目录下修改除运行配置文件和用户配置文件以外的任何文件。 - 即使是修改配置文件，也请务必保持 JSON 格式正确，否则可能导致软件无法正常启动或运行。 + 即使是修改配置文件，也请务必保持 [JSON 格式](https://www.json.org/json-zh.html)正确，否则可能导致软件无法正常启动或运行。 ## 运行配置文件 (run.json) diff --git a/zh/configuration/ui.mdx b/zh/configuration/ui.mdx index 067db00..b1038c7 100644 --- a/zh/configuration/ui.mdx +++ b/zh/configuration/ui.mdx @@ -3,7 +3,7 @@ title: "通过界面配置" description: "AutoLibrary 界面配置指南 - 用户、预约、系统设置与运行模式" --- -点击主界面窗口右上角的配置按钮，打开配置窗口。 +点击主界面窗口右上角的 [**配置**] 按钮，打开配置窗口。 @@ -15,7 +15,7 @@ description: "AutoLibrary 界面配置指南 - 用户、预约、系统设置与 | 功能 | 说明 | 备注 | | --- | --- | --- | - | 用户列表 | 显示当前配置文件中的所有用户 | 支持添加、删除用户操作，选中用户项进行详细配置 | + | 用户列表 | 显示当前配置文件中的所有用户 | 支持 [**添加**]、[**删除**] 用户操作，选中用户项进行详细配置 | ### 用户信息 @@ -56,7 +56,7 @@ description: "AutoLibrary 界面配置指南 - 用户、预约、系统设置与 | 参数 | 说明 | 默认值/可选值 | | --- | --- | --- | | 浏览器类别 | 使用的浏览器类型 | Microsoft Edge / Google Chrome / Mozilla Firefox | - | 浏览器驱动路径 | 驱动程序路径 | 通过浏览按钮选择 | + | 浏览器驱动路径 | 驱动程序路径 | 通过[**浏览**] 按钮选择 | | 无头模式 | 是否隐藏浏览器窗口 | `false`（显示窗口），`true` 为隐藏运行 | ### 登录设置 @@ -81,17 +81,17 @@ description: "AutoLibrary 界面配置指南 - 用户、预约、系统设置与 | 参数 | 说明 | | --- | --- | - | 运行配置文件路径 | 可通过浏览按钮选择新的配置文件 | - | 用户配置文件路径 | 可通过浏览按钮选择新的配置文件 | + | 运行配置文件路径 | 可通过 [**...**] 按钮选择新的配置文件 | + | 用户配置文件路径 | 可通过 [**...**] 按钮选择新的配置文件 | ### 导出配置 - 支持将当前配置导出为文件，选择目标路径和文件名后点击导出按钮。 + 支持将当前配置导出为文件，选择目标路径和文件名后点击 [**导出配置文件**] 按钮。 ## 运行工具 -配置完成后，点击主界面窗口顶部右侧的绿色按钮 **"启动脚本"**，工具将按配置自动执行预约、签到、续约等操作。 +配置完成后，点击主界面窗口顶部右侧的绿色按钮 [**启动脚本**]，工具将按配置自动执行预约、签到、续约等操作。 AutoLibrary 将按照配置文件处理所有启用的用户组中的可用用户。 diff --git a/zh/faq/faq.mdx b/zh/faq/faq.mdx index 7bc8acf..ff4ae19 100644 --- a/zh/faq/faq.mdx +++ b/zh/faq/faq.mdx @@ -11,5 +11,5 @@ description: "AutoLibrary 使用问答" 本工具旨在辅助用户正常使用图书馆服务，请勿滥用影响他人及图书馆正常运行。 - 可以正常使用电脑，但请**勿操作工具自动打开的浏览器窗口**，否则可能会干扰工具正常运行。如需完全后台运行，可启用无头模式并最小化到托盘。 + 可以正常使用电脑，但**请勿操作工具自动打开的浏览器窗口**，否则可能会干扰工具正常运行。如需完全后台运行，可启用无头模式并最小化到托盘。 diff --git a/zh/faq/troubleshooting.mdx b/zh/faq/troubleshooting.mdx index cd0298c..cd875b7 100644 --- a/zh/faq/troubleshooting.mdx +++ b/zh/faq/troubleshooting.mdx @@ -49,7 +49,7 @@ description: "AutoLibrary 故障排除与常见问题解决方法" 确认座位编号、楼层、区域是否正确。 - 尝试预约其它座位或调整时间参数。增大 **最大时间偏差** 让工具在允许的时间范围内自动选择最佳起始时间。 + 尝试预约其它座位或调整时间参数。增大 [**最大时长偏差**] 让工具在允许的时间范围内自动选择最佳起始时间。 @@ -66,7 +66,7 @@ description: "AutoLibrary 故障排除与常见问题解决方法" 检查界面中正在运行的定时任务，记住任务名称或运行时间等可用于定位的信息。 - 在 AutoLibrary 配置界面的「其它」选项卡中，找到「当前运行配置文件的路径」显示的文件夹路径，使用文件管理器打开该目录。 + 在 AutoLibrary 配置界面的 [**其它**] 选项卡中，找到 [**当前运行配置路径**] 显示的文件夹路径，使用文件管理器打开该目录。 在该目录中找到名为 `timer_task.json` 的文件，使用文本编辑器打开（推荐 [VS Code](https://code.visualstudio.com/)、[Notepad++](https://notepad-plus-plus.org/)，也可直接使用记事本）。 diff --git a/zh/features/timer.mdx b/zh/features/timer.mdx index 4cfe301..42a4bd7 100644 --- a/zh/features/timer.mdx +++ b/zh/features/timer.mdx @@ -8,7 +8,7 @@ description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任 ## 打开定时任务管理 -点击主界面窗口底部左侧的 **"定时任务管理"** 按钮，打开定时任务管理窗口。 +点击主界面窗口底部左侧的 [**定时任务管理**] 按钮，打开定时任务管理窗口。 ![定时任务管理窗口](/images/v1.3.0/定时任务管理窗口.png) @@ -17,7 +17,7 @@ description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任 ## 添加定时任务 -点击 **"添加定时任务"** 按钮，在弹出的对话框中配置任务参数： +点击 [**添加任务**] 按钮，在弹出的对话框中配置任务参数： ![添加定时任务对话框](/images/v1.3.0/添加定时任务对话框.png) @@ -27,23 +27,23 @@ description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任 | 选项 | 说明 | 示例 | | --- | --- | --- | -| 特定时间 | 指定任务开始的绝对时间 | `2025-10-30 08:00:00` | -| 相对时间 | 相对当前时间的偏移量 | 提前 1 天、提前 2 小时、提前 30 分钟 | +| [**特定时间**] | 指定任务开始的绝对时间 | `2025-10-30 08:00:00` | +| [**相对时间**] | 相对当前时间的偏移量 | 提前 1 天、提前 2 小时、提前 30 分钟 | ### 运行模式 | 选项 | 行为 | 适用场景 | | --- | --- | --- | -| 静默运行 | 任务执行时不会弹出窗口，完成后右下角通知 | 完全自动化，无需人工干预 | -| 运行前提示 | 任务执行前显示提示信息 | 需要在运行前确认或查看进度 | +| [**静默运行**] | 任务执行时不会弹出窗口，完成后右下角通知 | 完全自动化，无需人工干预 | +| [**运行前提示**] | 任务执行前显示提示信息 | 需要在运行前确认或查看进度 | - 如需完全静默运行：在配置界面的系统设置中勾选 **"无头模式"**，并在程序托盘中右键选择 **"最小化到托盘"**。这样定时任务运行时不会显示主界面和浏览器窗口，仅在完成时弹出系统通知。 + 如需完全静默运行：在配置界面的系统设置中勾选 [**无头模式**]，并在程序托盘中右键选择 [**最小化到托盘**]。这样定时任务运行时不会显示主界面和浏览器窗口，仅在完成时弹出系统通知。 ### 重复执行 -勾选 **"启用重复执行"** 后，可以按周循环执行任务： +勾选 [**启用重复执行**] 后，可以按周循环执行任务： - 选择需要运行的天（如：每周一、周三、周五） - 需要每天运行则勾选全部（周一至周日） @@ -55,7 +55,7 @@ description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任 - 在定时任务管理窗口中，在任务列表中的任意任务项上单击**鼠标右键**，在弹出的菜单中选择**"编辑"**。 + 在定时任务管理窗口中，在任务列表中的任意任务项上单击**鼠标右键**，在弹出的菜单中选择 [**编辑**]。 ![定时任务右键编辑菜单](/images/v1.3.0/定时任务-右键编辑.png) @@ -74,7 +74,7 @@ description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任 可通过以下两种方式移除定时任务： -- 右键菜单选择 **"删除"** -- 点击任务项右侧的 **"删除"** 按钮 +- 右键菜单选择 [**删除**] +- 点击任务项右侧的 [**删除**] 按钮 删除可重复性任务将同时清除该任务的所有执行历史记录。 diff --git a/zh/index/beforestart.mdx b/zh/index/beforestart.mdx new file mode 100644 index 0000000..ac0ffee --- /dev/null +++ b/zh/index/beforestart.mdx @@ -0,0 +1,19 @@ +--- +title: "开始之前" +description: "阅读文档前的格式约定与说明" +--- + +在开始使用 AutoLibrary 之前，建议先了解本文档的一些格式约定，帮助你更高效地阅读文档内容。 + +## 文档约定 + +### 软件控件 + +文档中所有涉及 AutoLibrary 软件界面的控件（如按钮、菜单项、选项卡、输入框、复选框等），统一使用 [**加粗字体**] 的格式表示（即中括号包裹的加粗文字）。例如： + +- 点击 [**启动脚本**] 按钮开始运行 +- 在配置窗口中切换到 [**用户配置**] 选项卡 +- 右键菜单中选择 [**编辑**] +- 勾选 [**启用重复执行**] 以开启周期任务 + +当你看到一段 [**加粗**] 格式的文字时，即表示这是 AutoLibrary 中的某个可交互元素，你可以在软件中找到对应的操作入口。 diff --git a/zh/index.mdx b/zh/index/intro.mdx similarity index 100% rename from zh/index.mdx rename to zh/index/intro.mdx diff --git a/zh/installation/driver.mdx b/zh/installation/driver.mdx index ca2cc98..7f778b8 100644 --- a/zh/installation/driver.mdx +++ b/zh/installation/driver.mdx @@ -11,7 +11,7 @@ description: "AutoLibrary 浏览器驱动配置指南 - 自动下载与手动安 - 在 [AutoLibrary 配置界面](/zh/configuration/ui#%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE)中，点击"浏览器驱动自动下载"按钮。 + 在 [AutoLibrary 配置界面](/zh/configuration/ui#%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE)中，点击 [**浏览器驱动自动下载**] 按钮。 ![浏览器驱动自动下载窗口](/images/v1.2.1/浏览器驱动自动下载窗口.png) @@ -19,12 +19,12 @@ description: "AutoLibrary 浏览器驱动配置指南 - 自动下载与手动安 工具会自动检测您电脑上已安装的浏览器，并列出可用的驱动版本。 - 从窗口中的下拉列表中选择需要的浏览器驱动版本，点击"开始下载"按钮。 + 从窗口中的下拉列表中选择需要的浏览器驱动版本，点击 [**下载驱动**] 按钮。 ![开始下载浏览器驱动](/images/v1.2.1/浏览器驱动自动下载窗口-开始下载.png) - 下载完成后，点击"确定"将驱动类型与驱路径保存到配置窗口中并退出下载对话框。 + 下载完成后，点击 [**确认**] 将驱动类型与驱路径保存到配置窗口中并退出下载对话框。 ![浏览器驱动下载完成](/images/v1.2.1/浏览器驱动自动下载窗口-下载完成.png)