diff --git a/docs/important-notice.md b/docs/important-notice.md index 9b102db..d39bc4a 100644 --- a/docs/important-notice.md +++ b/docs/important-notice.md @@ -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` 时，客户端会提示一次并执行重做。 + ## 相关链接 @@ -46,7 +47,8 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z" **标题**：留空用动作名；填 `-` 不显示标题；其他文字原样显示。 -**显示位置**：底部居中、四角、顶/底居中。仅成功 / 信息 / 告警 / 错误。 +**显示位置**：底部居中、四角、顶/底居中。仅成功 / 信息 / 告警 / 错误。2.2.22 起，步骤还可选择跟随设置中的全局默认位置；未单独指定时使用该默认。 + 底部居中： @@ -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-列表项自定义子程序与提示消息默认设置)。 + ### 点击操作 这个参数有三种填写方式： diff --git a/docs/v2/xaction/modules/compute/managelist.md b/docs/v2/xaction/modules/compute/managelist.md index eb2c2e6..27ccd61 100644 --- a/docs/v2/xaction/modules/compute/managelist.md +++ b/docs/v2/xaction/modules/compute/managelist.md @@ -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-列表项自定义子程序与提示消息默认设置)。 + ## 输出 - **是否确认**：用户是否点了「完成」。 @@ -120,5 +141,6 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z" ## 更新内容 +- 2.2.22 增加「添加项子程序」「编辑项子程序」，可用子程序（如多字段表单）自定义添加与编辑。 - 20240504 (1.42.34) 增加「显示内容提取表达式」和「取消后停止动作」。 - 20241023 修复错别字。 diff --git a/docs/v2/xaction/modules/ui/form.md b/docs/v2/xaction/modules/ui/form.md index 07cd6aa..228b489 100644 --- a/docs/v2/xaction/modules/ui/form.md +++ b/docs/v2/xaction/modules/ui/form.md @@ -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) @@ -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 起，多选下拉（多选列表）里已经选中的标签会与下拉项一样显示选项图标，而不只显示文字名称。选项本身未配置图标时，标签仍只显示名称。 + **最大长度**：最多允许的字符数。 **数值范围**：可选的最小 / 最大值。