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

+105
View File
@@ -0,0 +1,105 @@
---
title: "可视化编排器"
description: "AutoScript 可视化编排器 - 通过图形界面构建条件判断与变量操作,无需手写代码"
---
可视化编排器让你通过图形界面构建 AutoScript 脚本,无需了解 Lua 语法。编排器会根据你的配置自动生成代码。
{/* TODO: 添加可视化编排器界面截图 */}
![AutoScript 可视化编排器](/images/v1.4.0/autoscript-orchestrator.png)
## 编排器结构
编排器由多个判断块(Conditional Block)堆叠组成,从上到下依次执行。每个判断块包含条件判断和操作步骤两部分。
### 判断块类型
每个判断块可以设置为以下三种类型之一:
| 类型 | 触发条件 | 说明 |
| --- | --- | --- |
| **IF** | 第一个判断块 | 始终为 IF,不可更改 |
| **ELSE IF** | 上方条件均不满足 | 添加额外的条件分支 |
| **ELSE** | 上方所有条件均不满足 | 默认分支,不需要设置条件 |
<Info>
在一个 IF 后可以添加多个 ELSE IF,但只能有一个 ELSE 块。
添加 ELSE 块后,不能再添加 ELSE IF 或 ELSE 块。
</Info>
## 添加判断块
点击 [**+ 添加判断块**] 按钮添加新的判断块。新块的类型默认为 ELSE IF。
## 配置条件
每个判断块可包含一个或多个条件行,多个条件之间用 `and` 或 `or` 连接。
### 条件行配置项
| 配置项 | 说明 |
| --- | --- |
| 逻辑运算符 | 与上一条件行的关系:`and`(且)或 `or`(或)。第一行不显示此选项 |
| 左变量 | 选择要比较的目标变量,或直接使用 `true`/`false` 布尔值 |
| 比较运算符 | `==` `~=` `>` `<` `>=` `<=` |
| 比较方式 | 与固定值比较 / 与另一个变量比较 |
| 右值 | 根据变量类型提供对应的输入控件 |
### 特殊规则
- **布尔变量**:当左侧选择布尔类型变量(如 `USER_ENABLE`)时,比较运算符和右值自动隐藏,
条件直接判断该布尔值是否为真
- 可以点击 [**+**] 按钮添加更多条件行,或点击 [**x**] 按钮删除某个条件行
## 配置操作步骤
每个判断块内可包含一个或多个操作步骤(Action Step),当该块的条件满足时,所有操作步骤按顺序执行。
### 操作类型
| 操作 | 说明 | 示例 |
| --- | --- | --- |
| **set** | 将变量设置为指定值 | `RESERVE_DATE = dateadd(datenow(), 1)` |
| **add** | 在变量当前值上增加 | `RESERVE_BEGIN_TIME = RESERVE_BEGIN_TIME + 30` |
| **sub** | 在变量当前值上减去 | `RESERVE_END_TIME = RESERVE_END_TIME - 60` |
### 值来源
| 来源 | 说明 |
| --- | --- |
| 固定值 | 手动输入或选择具体值 |
| 变量 | 从其他目标变量读取值 |
### 日期和时间特殊处理
对于日期和时间类型变量,输入控件提供以下便捷选项:
| 变量类型 | 便捷选项 |
| --- | --- |
| Date | 今天、明天、后天、指定日期(日历选择器) |
| Time | 当前时间、指定时间(时间选择器) |
<Note>
当选择相对日期选项(如"明天")时,编排器会生成相应的工具函数调用(如 `dateadd(datenow(), 1)`),
确保脚本在运行时动态计算正确的日期。
</Note>
## 生成代码
配置完成后,点击 [**确认**] 按钮,编排器将把所有判断块转换为 Lua 代码并插入到代码编辑器中。
例如,以下编排配置:
- IF `USER_ENABLE` → set `RESERVE_DATE` 为明天,set `RESERVE_BEGIN_TIME` 为 09:00
- ELSE → set `USER_ENABLE` 为 false
将生成:
```lua
if USER_ENABLE then
RESERVE_DATE = dateadd(datenow(), 1)
RESERVE_BEGIN_TIME = time(9, 0)
else
USER_ENABLE = false
end
```