docs: add v1.4.0 manual with macOS support, AutoScript, and global settings

- Add v1.4.0 version manual with full structure (开始/安装/配置/设置/功能/FAQ)
- Add macOS platform installation instructions and troubleshooting
- Add global settings chapter (open + appearance pages)
- Add AutoScript manual (syntax, functions, variables, editor, orchestrator, integration)
- Remove changelog (zh/changelog) as per v1.4.0 scope
- Update docs.json navigation for v1.4.0 version and AutoScript tab

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
KenanZhuandClaude committed 2026-06-14 21:22:58 +08:00
1 parent c13da9f2f5
commit 552f21ef8f
23 files changed
+2158 -38

No files matched your search

+38
View File
@@ -0,0 +1,38 @@
---
title: "核心功能"
description: "AutoLibrary 核心功能 - 自动预约、签到、续约、AutoScript 脚本与模式组合"
---
## 运行模式
<CardGroup cols={3}>
<Card
title="自动预约"
icon="calendar-check"
href="#"
>
如果用户当前没有有效预约,工具会自动为您预约指定座位。适用于提前预约第二天的座位。
</Card>
<Card
title="自动签到"
icon="clipboard-check"
href="#"
>
在可签到时间范围(开始时间的前后30分钟)内,自动完成签到,避免因忘记签到导致失约。
</Card>
<Card
title="自动续约"
icon="rotate-right"
href="#"
>
到达可续约时间(结束时间前的120分钟),自动延长座位使用时间。
</Card>
</CardGroup>
## 模式组合
运行模式可以组合使用,只需在配置窗口中勾选对应模式即可。同时启用三种模式后,工具会自动判断当前状态并执行相应操作。
<Tip>
推荐同时启用三种模式,让工具自动处理预约、签到、续约的完整流程。
</Tip>
+136
View File
@@ -0,0 +1,136 @@
---
title: "定时任务"
description: "AutoLibrary 定时任务管理 - 添加、编辑、删除定时任务与 AutoScript 集成"
---
使用内置定时任务管理,添加定时任务后在指定时间按当前预约信息自动运行。
支持设置重复周期,如每周一、周三、周五自动执行。
在定时任务中集成 AutoScript 脚本,在任务执行前自动调整预约参数。
## 打开定时任务管理
点击主界面窗口底部左侧的 [<Icon icon="clock" />] 按钮,打开定时任务管理窗口。
![定时任务管理窗口](/images/v1.3.0/timer-management-window.png)
![功能介绍-定时任务](/images/v1.2.1/feature-timer.png)
## 添加定时任务
点击 [**添加任务**] 按钮,在弹出的对话框中配置任务参数:
![添加定时任务对话框](/images/v1.3.0/add-timer-dialog.png)
<Info>
添加后任务将显示在列表中,状态为"等待中"。到达指定时间后自动执行。
</Info>
### 定时类型
| 选项 | 说明 | 示例 |
| --- | --- | --- |
| [**特定时间**] | 指定任务开始的绝对时间 | `2025-10-30 08:00:00` |
| [**相对时间**] | 相对当前时间的偏移量 | 提前 1 天、提前 2 小时、提前 30 分钟 |
### 运行模式
| 选项 | 行为 | 适用场景 |
| --- | --- | --- |
| [**静默运行**] | 任务执行时不会弹出窗口,完成后右下角通知 | 完全自动化,无需人工干预 |
| [**运行前提示**] | 任务执行前显示提示信息 | 需要在运行前确认或查看进度 |
<Tip>
如需完全静默运行:在配置界面的系统设置中勾选 [**无头模式**],并在程序托盘中右键选择 [**最小化到托盘**]。这样定时任务运行时不会显示主界面和浏览器窗口,仅在完成时弹出系统通知。
</Tip>
### 重复执行
勾选 [**启用重复执行**] 后,可以按周循环执行任务:
- 选择需要运行的天(如:每周一、周三、周五)
- 需要每天运行则勾选全部(周一至周日)
- 全选和全不选均视为每日执行
## AutoScript 自动化脚本
AutoScript 是基于 Lua 语言的自动化脚本引擎,支持条件判断和算术表达式,
可在定时任务运行前对预约参数进行动态调整,比如能够实现以下场景:
<Note>
AutoScript 自动化脚本仅支持在**重复性**定时任务中配置,请务必
勾选 [**启用重复执行**] 以使用 AutoScript 脚本。
</Note>
- 根据当前日期动态调整预约时间
- 根据用户状态自动切换预约参数
- 多个用户配置的批量自动化处理
<Card
title="AutoScript 手册"
icon="code"
href="/zh/autoscript/index"
>
查看完整的 AutoScript 语法指引、工具使用说明和集成方法。
</Card>
<Steps>
<Step title="编写 AutoScript 脚本">
在添加或编辑定时任务对话框中,点击 [**AutoScript 指令**] 区域
的 [**编辑**] 按钮,打开代码编辑器编写脚本。
例如,以下脚本将预约日期设为明天,开始时间设为上午 9:00:
```lua
RESERVE_DATE = dateadd(datenow(), 1)
RESERVE_BEGIN_TIME = time(9, 0)
```
</Step>
<Step title="保存脚本">
在编辑器中点击 [**确认**],脚本将直接保存到当前定时任务的配置中。无需手动管理外部脚本文件。
</Step>
<Step title="验证脚本效果">
建议结合使用 AutoScript 编辑器的 [**调试运行**] 功能,在模拟数据上验证脚本逻辑,确保参数调整符合预期。
</Step>
</Steps>
<Info>
AutoScript 脚本在定时任务每次执行前独立运行,针对每个启用的用户组和用户依次应用。脚本修改的参数仅影响当次执行,
不会回写到用户配置文件。详见 [AutoScript 集成](/zh/autoscript/integration)。
</Info>
## 编辑定时任务
支持对已创建的定时任务进行编辑修改,无需删除重建。
<Steps>
<Step title="打开编辑菜单">
在定时任务管理窗口中,在任务列表中的任意任务项上单击**鼠标右键**,在弹出的菜单中选择 [**编辑**]。
![定时任务右键编辑菜单](/images/v1.3.0/timer-context-menu-edit.png)
</Step>
<Step title="修改配置">
编辑对话框将显示任务的当前配置。您可以修改:
- 任务名称
- 定时时间
- 运行模式
- AutoScript 脚本(通过内置编辑器管理)
- 将普通任务转换为可重复性任务(反之亦然)
</Step>
</Steps>
<Info>
编辑任务时,任务的 UUID 和执行历史(可重复性任务)将被保留。修改执行时间后,状态将重置为"等待中"。
</Info>
## 删除定时任务
可通过以下两种方式移除定时任务:
- 右键菜单选择 [**删除**]
- 点击任务项右侧的 [**删除**] 按钮
<Warning>
删除可重复性任务将同时清除该任务的所有执行历史记录。
</Warning>