Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/important-notice.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,14 @@ AI 助手正式版支持选择本地工作区。选择本地文件夹后,AI

使用在线补全时,Quicker 会向服务器发送正在编辑的代码、变量类型和默认 using。本地模式下,组件不可用时不会自动改用在线服务。操作入口见 [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)。

## 2.2.22 列表项自定义子程序与提示消息默认设置

2.2.22 起,「管理和排序列表」可通过高级参数指定 **添加项子程序**、**编辑项子程序**,用多字段表单等方式处理复杂列表项。依赖这些子程序的动作需要 **2.2.22 或更高版本**客户端;分享给他人时请注明最低版本要求。旧版没有对应回调,不能当作退回内置编辑器的等价行为。操作说明见 [管理和排序列表](/v2/xaction/modules/managelist#用子程序自定义添加和编辑)。

同版起,可在 **设置 → 模块功能选项** 配置提示消息的默认显示位置和停留时间,并随账号同步。旧客户端不认识这两项设置;若在旧版保存设置并同步,可能把它们重置。建议先记下所选值,把所有会改设置的设备升级后再修改;若已被重置,可在新版重新设置。步骤或脚本里单独指定的位置、时长仍优先于全局默认。详见 [提示消息](/v2/xaction/modules/notify#默认位置与停留时间)。

同版起,截图、贴图和录屏标注中 `Ctrl+Shift+Z` 改为 **重做**(不再清空全部标注);清空全部标注请用 `Shift+Delete`。首次按旧习惯的 `Ctrl+Shift+Z` 时,客户端会提示一次并执行重做。

## 相关链接

<RelatedDocs
Expand Down
8 changes: 8 additions & 0 deletions docs/release-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,14 @@ comments: true

## 近期文档补充

### 2.2.22 · 列表编辑、提示消息与长截图

- [管理和排序列表](/v2/xaction/modules/managelist#用子程序自定义添加和编辑)支持通过子程序自定义添加、编辑列表项,可用多字段表单处理复杂内容。使用该能力的动作需要 **2.2.22 或更高版本**,详见[升级注意](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。
- [提示消息](/v2/xaction/modules/notify#默认位置与停留时间)可在「设置 → 模块功能选项」配置默认显示位置和停留时间,并随账号同步;步骤里单独指定的位置或时长仍优先。
- [表单多选列表](/v2/xaction/modules/form#多选列表已选标签图标)的已选标签会显示选项图标。
- [长截图](/v2/features/screenshot/capture-pro#长截图编辑)支持「重来」;截图、贴图和录屏标注中 `Ctrl+Shift+Z` 改为重做,「清空全部标注」改用 `Shift+Delete`,详见[快捷键说明](/v2/features/screenshot/capture-pro#快捷键一览)。
- 主面板「最新动作」会包含在编辑器中打开查看过的动作;更多对话框可用 `Esc` 取消。完整改动见[官网版本记录](https://getquicker.net/V2/Versions)。

### 2.2.21 · 代码补全与动作面板

- [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)默认在线提供,也可在「设置 → 动作设计」安装本地组件。在线补全会向服务器发送编辑中的代码等信息,详见[升级注意](/important-notice#2221-代码补全服务)。
Expand Down
2 changes: 1 addition & 1 deletion docs/v2/features/action-panel/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ comments: true
- 筛选时用 `↑`、`↓` 选择结果,按 `Enter` 运行,按 `Esc` 清除筛选。
- 点击标题栏的搜索入口,会打开全局搜索窗口;它适合跨场景和其它搜索来源查找。
- 鼠标位于全局区或上下文区时,按住 `Ctrl` 滚动滚轮,可以切换该区域的场景标签;横向滚轮也可以切换标签。
- 底部「最新动作」条可快速再次运行近期用过的动作;这一行只有图标,没有标题。
- 底部「最新动作」条可快速再次运行近期用过的动作;这一行只有图标,没有标题。2.2.22 起,在编辑器中打开查看过的动作也会进入该列表。


## 双击导航栏
Expand Down
13 changes: 11 additions & 2 deletions docs/v2/features/screenshot/capture-pro.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,8 @@ comments: true
| 马赛克 / 智能马赛克 | 手动打码,或识别文字区域后自动打码(见下文) |
| 聚光灯 | 压暗周围,突出关注区域 |
| 橡皮擦 | 擦除标注 |
| 撤销 / 重做 | `Ctrl+Z` / `Ctrl+Y` |
| 撤销 / 重做 | `Ctrl+Z` / `Ctrl+Y`(2.2.22 起 `Ctrl+Shift+Z` 也是重做) |
| 清空全部标注 | `Shift+Delete`(2.2.22 起;此前曾用 `Ctrl+Shift+Z`) |

工具栏上还可直接进行 OCR、**图片翻译**、保存、复制、贴图,以及进入长截图或录屏。

Expand Down Expand Up @@ -147,6 +148,8 @@ comments: true

2.2.13 起,长截图完成后会先打开编辑窗口,可裁剪四周,也可选中中间一段直接删除,再保存、复制或贴图。编辑只作用于当前结果;取消不会覆盖原始拼接图。

2.2.22 起,长截图工具栏提供与录屏类似的 **重来**:丢弃当前已采集内容,保留选区和滚动方向,从当前位置重新开始采集;暂停时点击也会恢复采集。快速滚动时的采集与拼接稳定性也有改善。

超长图贴图时会先适合当前屏幕并居中,必要时首次缩放可低于 10%,避免窗口超出工作区。

### 马赛克与智能马赛克
Expand Down Expand Up @@ -338,6 +341,11 @@ HTML、公式贴图缩放时先显示预览,停稳后按倍率重绘;复制

## 快捷键一览

:::caution[2.2.22 标注快捷键变化]
截图、贴图和录屏标注中,`Ctrl+Shift+Z` 改为 **重做**,不再清空全部标注;清空请用 `Shift+Delete`。首次仍按旧习惯按下时,客户端会提示一次并执行重做。详见[体验前必读](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。
:::


### 选区阶段(截图界面)

| 操作 | 快捷键 |
Expand Down Expand Up @@ -394,7 +402,8 @@ HTML、公式贴图缩放时先显示预览,停稳后按倍率重绘;复制

| 操作 | 快捷键 |
| --- | --- |
| 撤销 / 重做 | `Ctrl+Z` / `Ctrl+Y` |
| 撤销 / 重做 | `Ctrl+Z` / `Ctrl+Y`(2.2.22 起 `Ctrl+Shift+Z` 也是重做) |
| 清空全部标注 | `Shift+Delete`(2.2.22 起;此前曾用 `Ctrl+Shift+Z`) |
| 保存 | `Ctrl+S` |
| 贴图透明度 | `Ctrl + 滚轮` |
| 拖出图片 | `Ctrl + 左键拖动` |
Expand Down
17 changes: 14 additions & 3 deletions docs/v2/xaction/modules/basic/notify.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z"

## 概述

默认出现在屏幕底部居中。
默认出现在屏幕底部居中。2.2.22 起,可在设置里改全局默认位置和停留时间,见下方[默认位置与停留时间](#默认位置与停留时间)。


<NotifyToastPreview message="你好,感谢你使用Quicker!" />

Expand All @@ -46,7 +47,8 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z"

**标题**:留空用动作名;填 `-` 不显示标题;其他文字原样显示。

**显示位置**:底部居中、四角、顶/底居中。仅成功 / 信息 / 告警 / 错误。
**显示位置**:底部居中、四角、顶/底居中。仅成功 / 信息 / 告警 / 错误。2.2.22 起,步骤还可选择跟随设置中的全局默认位置;未单独指定时使用该默认。


底部居中:

Expand All @@ -65,12 +67,21 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z"

**最大行数**:按换行计。`0` 不限制。

**保持秒数**:`0` 用默认时长,`-1` 一直显示,或填秒数。2.2.17 起按设置可保持 **1 秒**;更早版本界面与元数据常见范围为 2~30 秒。
**保持秒数**:`0` 用默认时长,`-1` 一直显示,或填秒数。2.2.17 起按设置可保持 **1 秒**;更早版本界面与元数据常见范围为 2~30 秒。2.2.22 起,「默认时长」可在设置中配置;步骤填 `0` 时跟随该全局默认(带按钮的提示仍至少保留约 10 秒互动时间)。


**显示时间**:有标题时在右上角显示发出时间;无标题的紧凑条不显示。

**重复控制**:留空则每次都出一条新的。填标识可复用同一条:`replace:标识` 换内容,`count:标识` 累计次数,`ignore:标识` 忽略后续重复。只写标识时按 `replace` 处理。

### 默认位置与停留时间

2.2.22 起,在 **设置 → 模块功能选项** 可单独配置提示消息的 **默认显示位置** 和 **默认停留时间**,并随账号同步。默认停留时间为 `0` 时,仍按消息长度自动估算显示时长。

单条提示若在步骤或自动化脚本里单独指定了位置或时长,仍使用该条自身设置,不改全局默认。脚本未指定 placement 时跟随全局默认;显式指定底部居中等位置时仍固定在该位置。

旧客户端不认识这两项设置。回退或混用旧版时,若在旧版保存设置并同步,可能把默认位置和停留时间重置;建议先记录当前值,把相关设备升级后再改。详见[体验前必读](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。

### 点击操作

这个参数有三种填写方式:
Expand Down
22 changes: 22 additions & 0 deletions docs/v2/xaction/modules/compute/managelist.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,27 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z"

**帮助按钮内容**:Markdown。填写后窗口上出现「帮助」按钮。

**添加项子程序** / **编辑项子程序**(高级,2.2.22+):可选。留空时仍用内置文本框或「编辑菜单项」窗口。填写子程序标识后,添加或编辑会调用对应子程序,便于用[多字段表单](/v2/xaction/modules/form)处理 JSON 等复杂项。当前 `data/xaction` 尚未同步这两项的元数据预览;步骤编辑器里可在高级参数中看到完整说明,也以客户端为准。

## 用子程序自定义添加和编辑

2.2.22 起,可在高级参数中指定 **添加项子程序**、**编辑项子程序**(也可填同一个子程序)。不配置时行为与旧版相同。

子程序与列表窗口约定下列变量(区分大小写):

| 变量 | 方向 | 含义 |
| --- | --- | --- |
| `_item` | 输入 / 输出 | 编辑时传入原始字符串;添加时为空。确认后返回要写入列表的完整字符串(不是仅显示标题)。 |
| `_index` | 输入 | 从 0 开始:编辑为当前项索引,添加为预定插入位置。 |
| `_isNew` | 输入 | 添加为 `true`,编辑为 `false`,便于共用一个子程序。 |
| `_confirmed` | 输出 | 为 `true` 时才应用 `_item`;`false` 表示取消本次单项编辑。 |

只有 `_confirmed` 为 `true` 时才会改列表工作副本。单项取消、子程序异常或关闭列表窗口,都不会提交那一次修改。编辑进行中会暂时禁用添加、编辑、删除、排序、重置和「完成」,「取消」仍可用。列表仍须点窗口上的「完成」才写回动作变量;点「取消」会丢弃本次窗口内的全部改动。

子程序里若打开多字段表单,会以列表窗口为 Owner。不要在子程序里直接把整份列表持久化到动作状态或文件;等主动作根据「是否确认」再保存,避免用户取消列表窗口后仍留下副作用。

使用自定义子程序的动作需要 **2.2.22 或更高版本**;分享时请注明最低版本。回退与兼容见[体验前必读](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。

## 输出

- **是否确认**:用户是否点了「完成」。
Expand Down Expand Up @@ -120,5 +141,6 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z"

## 更新内容

- 2.2.22 增加「添加项子程序」「编辑项子程序」,可用子程序(如多字段表单)自定义添加与编辑。
- 20240504 (1.42.34) 增加「显示内容提取表达式」和「取消后停止动作」。
- 20241023 修复错别字。
6 changes: 5 additions & 1 deletion docs/v2/xaction/modules/ui/form.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ legacyContentUpdatedAt: "2025-04-26T13:46:14.000Z"

每一行是一个**字段**,对应一个动作变量,或词典里的一个键。打开时加载当前值,保存后写回。常和「作为状态使用」的变量一起做 [设置界面](/v2/xaction/concepts/store-settings)。

2.2.7 起,若某个字段绑定了不存在的变量,Quicker 会在打开表单前明确提示缺失变量,而不是进入表单后再异常中断。2.2.8 起,多字段表单中对小数连续加减时,不再出现多余尾数。2.2.13 起,可使用单选按钮列表,并为文本字段启用表达式校验。2.2.14 起,常用扩展选项可直接在结构化界面编辑,仍保留高级原始扩展设置入口;校验规则统一在同一输入框中设置。2.2.15 起,单选列表与字段标题的对齐已修复。
2.2.7 起,若某个字段绑定了不存在的变量,Quicker 会在打开表单前明确提示缺失变量,而不是进入表单后再异常中断。2.2.8 起,多字段表单中对小数连续加减时,不再出现多余尾数。2.2.13 起,可使用单选按钮列表,并为文本字段启用表达式校验。2.2.14 起,常用扩展选项可直接在结构化界面编辑,仍保留高级原始扩展设置入口;校验规则统一在同一输入框中设置。2.2.15 起,单选列表与字段标题的对齐已修复。2.2.22 起,多选列表的已选标签也会显示选项图标,见[多选列表已选标签图标](#多选列表已选标签图标)。

![](./img/form-001-1b317aa5a9.png)

Expand Down Expand Up @@ -139,6 +139,10 @@ legacyContentUpdatedAt: "2025-04-26T13:46:14.000Z"

**单选按钮列表**:2.2.13 起可把候选项直接显示为单选按钮。扩展设置可用 `radio_direction:horizontal` 改为横向排列,或用 `radio_columns:3` 指定每行列数(1–12);不设置时自动换行。2.2.15 起,单选列表与字段标题的对齐已修复。

### 多选列表已选标签图标

2.2.22 起,多选下拉(多选列表)里已经选中的标签会与下拉项一样显示选项图标,而不只显示文字名称。选项本身未配置图标时,标签仍只显示名称。

**最大长度**:最多允许的字符数。

**数值范围**:可选的最小 / 最大值。
Expand Down
Loading