diff --git a/data/xaction/catalog.json b/data/xaction/catalog.json index 92b1fd5..bf98dae 100644 --- a/data/xaction/catalog.json +++ b/data/xaction/catalog.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "generatedAt": "2026-09-24 08:30:46", + "generatedAt": "2026-09-25 22:26:23", "moduleCount": 175, "legacyMappedModuleCount": 0, "migratedLegacyModuleCount": 0, @@ -3054,7 +3054,7 @@ "items": [ { "value": "BottomCenter", - "name": "默认位置（底部居中）", + "name": "默认位置（使用全局设置）", "description": "" }, { @@ -3081,6 +3081,11 @@ "value": "BottomRight", "name": "右下角", "description": "" + }, + { + "value": "FixedBottomCenter", + "name": "底部居中", + "description": "" } ] } @@ -5979,6 +5984,26 @@ "variableMode": "Input", "condition": "", "description": "点击弹出显示帮助内容，MarkDown格式" + }, + { + "key": "addSubprogram", + "name": "添加项子程序", + "type": "Text", + "defaultValue": "", + "required": false, + "variableMode": "Input", + "condition": "", + "description": "可选，留空使用内置编辑器。输入：_item（文本，空串）、_index（数字，0起始插入位置）、_isNew（布尔，true）。输出：_confirmed（布尔）为true时，使用_item（文本）添加一项。" + }, + { + "key": "editSubprogram", + "name": "编辑项子程序", + "type": "Text", + "defaultValue": "", + "required": false, + "variableMode": "Input", + "condition": "", + "description": "可选，留空使用内置编辑器。输入：_item（原始文本）、_index（数字，0起始索引）、_isNew（布尔，false）。输出：_confirmed（布尔）为true时，使用_item（文本）替换当前项；取消不修改列表。" } ], "outputs": [ @@ -34961,9 +34986,9 @@ "sourceFileName": "sys_fileSystemWatch_文件系统监控.md" }, { - "key": "sys:monitorBrightness", - "slug": "monitorbrightness", - "legacySlug": "monitorbrightness", + "key": "sys:monitor", + "slug": "monitor", + "legacySlug": "monitor", "ownsLegacyContent": true, "name": "显示器", "description": "获取显示器列表、读取显示器坐标与工作区，获取或调整指定显示器的硬件亮度。", @@ -35149,7 +35174,7 @@ ] } }, - "sourceFileName": "sys_monitorBrightness_显示器.md" + "sourceFileName": "sys_monitor_显示器.md" }, { "key": "sys:sendMessage", @@ -38024,6 +38049,16 @@ "condition": "仅：WAIT, NO_WAIT", "description": "宽度,高度：逻辑像素或屏幕工作区百分比；自定义位置填坐标。" }, + { + "key": "rememberWindowPlacement", + "name": "记住上次位置和大小", + "type": "Boolean", + "defaultValue": "false", + "required": false, + "variableMode": "Input", + "condition": "仅：WAIT, NO_WAIT", + "description": "关闭窗口后保存位置和大小，下次运行此动作时恢复。按文本窗口标识分别记忆；全屏或最大化的位置类型不使用记忆位置。" + }, { "key": "topMost", "name": "置顶显示", diff --git a/data/xaction/changes.json b/data/xaction/changes.json index 1b0d490..55927bb 100644 --- a/data/xaction/changes.json +++ b/data/xaction/changes.json @@ -1,56 +1,36 @@ { "schemaVersion": 1, "baselineCreated": false, - "fromGeneratedAt": "2026-09-22 21:47:06", - "toGeneratedAt": "2026-09-24 08:30:46", + "fromGeneratedAt": "2026-09-24 08:30:46", + "toGeneratedAt": "2026-09-25 22:26:23", "summary": { - "addedModules": 2, - "removedModules": 0, - "changedModules": 4 + "addedModules": 1, + "removedModules": 1, + "changedModules": 3 }, "addedModules": [ { - "key": "sys:monitorBrightness", + "key": "sys:monitor", "name": "显示器", - "slug": "monitorbrightness", + "slug": "monitor", "category": "System" - }, + } + ], + "removedModules": [ { - "key": "sys:virtualDesktop", - "name": "虚拟桌面", - "slug": "virtualdesktop", + "key": "sys:monitorBrightness", + "name": "显示器", + "slug": "monitorbrightness", "category": "System" } ], - "removedModules": [], "changedModules": [ { - "key": "sys:screenRecording", - "name": "后台屏幕录制", + "key": "sys:notify", + "name": "提示消息", "changedFields": [], "inputs": { - "added": [ - { - "key": "encodingPreset", - "name": "编码方案", - "type": "Enum", - "defaultValue": "default", - "required": false, - "variableMode": "UseVarOrInput", - "condition": "", - "description": "可选快捷配置，默认沿用原有画质；FFmpeg 参数可覆盖方案。" - }, - { - "key": "encodingParameters", - "name": "FFmpeg 参数", - "type": "Text", - "defaultValue": "", - "required": false, - "variableMode": "UseVarOrInput", - "condition": "", - "description": "直接传给本机 FFmpeg，覆盖预设；留空沿用默认。例：-crf 20 -preset veryfast。" - } - ], + "added": [], "removed": [], "changed": [] }, @@ -62,234 +42,139 @@ "selectionsChanged": true, "selections": { "before": { - "operation": { - "name": "操作", + "type": { + "name": "类型", "items": [ { - "value": "start", - "name": "开始录屏", - "description": "" - }, - { - "value": "pause", - "name": "暂停录屏", + "value": "Success", + "name": "成功", "description": "" }, { - "value": "resume", - "name": "继续录屏", + "value": "Info", + "name": "信息", "description": "" }, { - "value": "stop", - "name": "结束录屏", - "description": "" - } - ] - }, - "regionType": { - "name": "录制范围", - "items": [ - { - "value": "fixed_area", - "name": "固定区域", + "value": "Warning", + "name": "告警", "description": "" }, { - "value": "primary_screen", - "name": "主屏幕", + "value": "Error", + "name": "错误", "description": "" }, { - "value": "full_screen", - "name": "所有屏幕", + "value": "WindowsToast", + "name": "Windows 通知 (win10+)", "description": "" } ] }, - "outputFormat": { - "name": "输出格式", + "placement": { + "name": "显示位置", "items": [ { - "value": "mp4", - "name": "MP4", + "value": "BottomCenter", + "name": "默认位置（底部居中）", "description": "" }, { - "value": "gif", - "name": "GIF", + "value": "TopLeft", + "name": "左上角", "description": "" }, { - "value": "avi", - "name": "AVI", - "description": "" - } - ] - }, - "exportQuality": { - "name": "导出画质", - "items": [ - { - "value": "standard", - "name": "标准", + "value": "TopCenter", + "name": "顶部居中", "description": "" }, { - "value": "high", - "name": "高清", + "value": "TopRight", + "name": "右上角", "description": "" }, { - "value": "original", - "name": "原始", - "description": "" - } - ] - }, - "encodingStrategy": { - "name": "编码策略", - "items": [ - { - "value": "encodeWhileRecording", - "name": "实时编码", + "value": "BottomLeft", + "name": "左下角", "description": "" }, { - "value": "recordThenEncode", - "name": "录制结束后转码", + "value": "BottomRight", + "name": "右下角", "description": "" } ] } }, "after": { - "operation": { - "name": "操作", - "items": [ - { - "value": "start", - "name": "开始录屏", - "description": "" - }, - { - "value": "pause", - "name": "暂停录屏", - "description": "" - }, - { - "value": "resume", - "name": "继续录屏", - "description": "" - }, - { - "value": "stop", - "name": "结束录屏", - "description": "" - } - ] - }, - "regionType": { - "name": "录制范围", + "type": { + "name": "类型", "items": [ { - "value": "fixed_area", - "name": "固定区域", + "value": "Success", + "name": "成功", "description": "" }, { - "value": "primary_screen", - "name": "主屏幕", + "value": "Info", + "name": "信息", "description": "" }, { - "value": "full_screen", - "name": "所有屏幕", - "description": "" - } - ] - }, - "outputFormat": { - "name": "输出格式", - "items": [ - { - "value": "mp4", - "name": "MP4", + "value": "Warning", + "name": "告警", "description": "" }, { - "value": "gif", - "name": "GIF", + "value": "Error", + "name": "错误", "description": "" }, { - "value": "avi", - "name": "AVI", + "value": "WindowsToast", + "name": "Windows 通知 (win10+)", "description": "" } ] }, - "exportQuality": { - "name": "导出画质", + "placement": { + "name": "显示位置", "items": [ { - "value": "standard", - "name": "标准", - "description": "" - }, - { - "value": "high", - "name": "高清", + "value": "BottomCenter", + "name": "默认位置（使用全局设置）", "description": "" }, { - "value": "original", - "name": "原始", - "description": "" - } - ] - }, - "encodingPreset": { - "name": "编码方案", - "items": [ - { - "value": "default", - "name": "沿用原有画质", + "value": "TopLeft", + "name": "左上角", "description": "" }, { - "value": "balanced", - "name": "均衡", + "value": "TopCenter", + "name": "顶部居中", "description": "" }, { - "value": "text", - "name": "文字清晰", + "value": "TopRight", + "name": "右上角", "description": "" }, { - "value": "compact", - "name": "小体积", + "value": "BottomLeft", + "name": "左下角", "description": "" }, { - "value": "lowCpu", - "name": "低 CPU 占用", - "description": "" - } - ] - }, - "encodingStrategy": { - "name": "编码策略", - "items": [ - { - "value": "encodeWhileRecording", - "name": "实时编码", + "value": "BottomRight", + "name": "右下角", "description": "" }, { - "value": "recordThenEncode", - "name": "录制结束后转码", + "value": "FixedBottomCenter", + "name": "底部居中", "description": "" } ] @@ -298,30 +183,30 @@ } }, { - "key": "sys:screenRecordingUI", - "name": "屏幕录制", + "key": "sys:manageList", + "name": "管理和排序列表", "changedFields": [], "inputs": { "added": [ { - "key": "encodingPreset", - "name": "编码方案", - "type": "Enum", - "defaultValue": "default", + "key": "addSubprogram", + "name": "添加项子程序", + "type": "Text", + "defaultValue": "", "required": false, - "variableMode": "UseVarOrInput", + "variableMode": "Input", "condition": "", - "description": "可选快捷配置，默认沿用原有画质；FFmpeg 参数可覆盖方案。" + "description": "可选，留空使用内置编辑器。输入：_item（文本，空串）、_index（数字，0起始插入位置）、_isNew（布尔，true）。输出：_confirmed（布尔）为true时，使用_item（文本）添加一项。" }, { - "key": "encodingParameters", - "name": "FFmpeg 参数", + "key": "editSubprogram", + "name": "编辑项子程序", "type": "Text", "defaultValue": "", "required": false, - "variableMode": "UseVarOrInput", + "variableMode": "Input", "condition": "", - "description": "直接传给本机 FFmpeg，覆盖预设；留空沿用默认。例：-crf 20 -preset veryfast。" + "description": "可选，留空使用内置编辑器。输入：_item（原始文本）、_index（数字，0起始索引）、_isNew（布尔，false）。输出：_confirmed（布尔）为true时，使用_item（文本）替换当前项；取消不修改列表。" } ], "removed": [], @@ -332,822 +217,34 @@ "removed": [], "changed": [] }, - "selectionsChanged": true, - "selections": { - "before": { - "regionType": { - "name": "录制范围", - "items": [ - { - "value": "none", - "name": "手动框选", - "description": "" - }, - { - "value": "primary_screen", - "name": "主屏幕", - "description": "" - }, - { - "value": "full_screen", - "name": "所有屏幕", - "description": "" - }, - { - "value": "fixed_area", - "name": "固定区域", - "description": "" - } - ] - } - }, - "after": { - "regionType": { - "name": "录制范围", - "items": [ - { - "value": "none", - "name": "手动框选", - "description": "" - }, - { - "value": "primary_screen", - "name": "主屏幕", - "description": "" - }, - { - "value": "full_screen", - "name": "所有屏幕", - "description": "" - }, - { - "value": "fixed_area", - "name": "固定区域", - "description": "" - } - ] - }, - "encodingPreset": { - "name": "编码方案", - "items": [ - { - "value": "default", - "name": "沿用原有画质", - "description": "" - }, - { - "value": "balanced", - "name": "均衡", - "description": "" - }, - { - "value": "text", - "name": "文字清晰", - "description": "" - }, - { - "value": "compact", - "name": "小体积", - "description": "" - }, - { - "value": "lowCpu", - "name": "低 CPU 占用", - "description": "" - } - ] - } - } - } + "selectionsChanged": false }, { - "key": "sys:remoteFile", - "name": "远程文件", - "changedFields": [ - "description" - ], + "key": "sys:showText", + "name": "文本窗口", + "changedFields": [], "inputs": { - "added": [], - "removed": [], - "changed": [] - }, - "outputs": { "added": [ { - "key": "accountList", - "name": "账号列表", - "type": "List", - "condition": "仅：listAccounts", - "description": "本机远程文件账号，每项为“显示名（引用名）|引用名”；可直接作为“选择窗口”的选项。" + "key": "rememberWindowPlacement", + "name": "记住上次位置和大小", + "type": "Boolean", + "defaultValue": "false", + "required": false, + "variableMode": "Input", + "condition": "仅：WAIT, NO_WAIT", + "description": "关闭窗口后保存位置和大小，下次运行此动作时恢复。按文本窗口标识分别记忆；全屏或最大化的位置类型不使用记忆位置。" } ], "removed": [], "changed": [] }, - "selectionsChanged": true, - "selections": { - "before": { - "operation": { - "name": "操作", - "items": [ - { - "value": "upload", - "name": "上传", - "description": "" - }, - { - "value": "download", - "name": "下载/读取内容", - "description": "" - }, - { - "value": "list", - "name": "列目录", - "description": "" - }, - { - "value": "query", - "name": "查询", - "description": "" - }, - { - "value": "createDirectory", - "name": "新建目录", - "description": "" - }, - { - "value": "deleteFile", - "name": "删除文件", - "description": "" - }, - { - "value": "moveFile", - "name": "移动/重命名文件", - "description": "" - }, - { - "value": "copyFile", - "name": "复制文件", - "description": "" - }, - { - "value": "batchRead", - "name": "批量读取内容", - "description": "" - }, - { - "value": "batchDownload", - "name": "批量下载文件", - "description": "" - }, - { - "value": "uploadFolder", - "name": "上传文件夹", - "description": "" - }, - { - "value": "downloadFolder", - "name": "下载文件夹", - "description": "" - } - ] - }, - "uploadSource": { - "name": "上传内容", - "items": [ - { - "value": "file", - "name": "本地文件", - "description": "" - }, - { - "value": "text", - "name": "文本", - "description": "" - }, - { - "value": "bytes", - "name": "字节数组", - "description": "" - }, - { - "value": "image", - "name": "图片", - "description": "" - } - ] - }, - "batchContent": { - "name": "读取内容", - "items": [ - { - "value": "text", - "name": "文本", - "description": "" - }, - { - "value": "bytes", - "name": "字节数组", - "description": "" - } - ] - }, - "downloadMode": { - "name": "下载方式", - "items": [ - { - "value": "file", - "name": "保存为本地文件", - "description": "" - }, - { - "value": "text", - "name": "读取为文本", - "description": "" - }, - { - "value": "bytes", - "name": "读取为字节数组", - "description": "" - }, - { - "value": "image", - "name": "图片", - "description": "" - } - ] - }, - "imageFormat": { - "name": "图片格式", - "items": [ - { - "value": "png", - "name": "PNG", - "description": "" - }, - { - "value": "jpeg", - "name": "JPEG", - "description": "" - } - ] - }, - "existsPolicy": { - "name": "已存在时", - "items": [ - { - "value": "fail", - "name": "失败", - "description": "" - }, - { - "value": "skip", - "name": "跳过", - "description": "" - }, - { - "value": "overwrite", - "name": "覆盖", - "description": "" - } - ] - }, - "moveExistsPolicy": { - "name": "目标已存在时", - "items": [ - { - "value": "fail", - "name": "失败", - "description": "" - }, - { - "value": "overwrite", - "name": "覆盖", - "description": "" - } - ] - }, - "listFilter": { - "name": "列出", - "items": [ - { - "value": "all", - "name": "全部", - "description": "" - }, - { - "value": "files", - "name": "只列文件", - "description": "" - }, - { - "value": "directories", - "name": "只列目录", - "description": "" - } - ] - } - }, - "after": { - "operation": { - "name": "操作", - "items": [ - { - "value": "listAccounts", - "name": "获取账号列表", - "description": "" - }, - { - "value": "upload", - "name": "上传", - "description": "" - }, - { - "value": "download", - "name": "下载/读取内容", - "description": "" - }, - { - "value": "list", - "name": "列目录", - "description": "" - }, - { - "value": "query", - "name": "查询", - "description": "" - }, - { - "value": "createDirectory", - "name": "新建目录", - "description": "" - }, - { - "value": "deleteFile", - "name": "删除文件", - "description": "" - }, - { - "value": "moveFile", - "name": "移动/重命名文件", - "description": "" - }, - { - "value": "copyFile", - "name": "复制文件", - "description": "" - }, - { - "value": "batchRead", - "name": "批量读取内容", - "description": "" - }, - { - "value": "batchDownload", - "name": "批量下载文件", - "description": "" - }, - { - "value": "uploadFolder", - "name": "上传文件夹", - "description": "" - }, - { - "value": "downloadFolder", - "name": "下载文件夹", - "description": "" - } - ] - }, - "uploadSource": { - "name": "上传内容", - "items": [ - { - "value": "file", - "name": "本地文件", - "description": "" - }, - { - "value": "text", - "name": "文本", - "description": "" - }, - { - "value": "bytes", - "name": "字节数组", - "description": "" - }, - { - "value": "image", - "name": "图片", - "description": "" - } - ] - }, - "batchContent": { - "name": "读取内容", - "items": [ - { - "value": "text", - "name": "文本", - "description": "" - }, - { - "value": "bytes", - "name": "字节数组", - "description": "" - } - ] - }, - "downloadMode": { - "name": "下载方式", - "items": [ - { - "value": "file", - "name": "保存为本地文件", - "description": "" - }, - { - "value": "text", - "name": "读取为文本", - "description": "" - }, - { - "value": "bytes", - "name": "读取为字节数组", - "description": "" - }, - { - "value": "image", - "name": "图片", - "description": "" - } - ] - }, - "imageFormat": { - "name": "图片格式", - "items": [ - { - "value": "png", - "name": "PNG", - "description": "" - }, - { - "value": "jpeg", - "name": "JPEG", - "description": "" - } - ] - }, - "existsPolicy": { - "name": "已存在时", - "items": [ - { - "value": "fail", - "name": "失败", - "description": "" - }, - { - "value": "skip", - "name": "跳过", - "description": "" - }, - { - "value": "overwrite", - "name": "覆盖", - "description": "" - } - ] - }, - "moveExistsPolicy": { - "name": "目标已存在时", - "items": [ - { - "value": "fail", - "name": "失败", - "description": "" - }, - { - "value": "overwrite", - "name": "覆盖", - "description": "" - } - ] - }, - "listFilter": { - "name": "列出", - "items": [ - { - "value": "all", - "name": "全部", - "description": "" - }, - { - "value": "files", - "name": "只列文件", - "description": "" - }, - { - "value": "directories", - "name": "只列目录", - "description": "" - } - ] - } - } - } - }, - { - "key": "sys:textSelectTools", - "name": "辅助选择工具", - "changedFields": [], - "inputs": { - "added": [], - "removed": [], - "changed": [] - }, "outputs": { "added": [], "removed": [], "changed": [] }, - "selectionsChanged": true, - "selections": { - "before": { - "operation": { - "name": "选择器", - "items": [ - { - "value": "SelectSingleFile", - "name": "选取文件", - "description": "" - }, - { - "value": "SelectMultiFile", - "name": "选取(多个)文件", - "description": "" - }, - { - "value": "SelectSingleFolder", - "name": "选取文件夹", - "description": "" - }, - { - "value": "SelectSavePath", - "name": "选择保存路径", - "description": "" - }, - { - "value": "SelectProcessPath", - "name": "选择窗口的进程路径", - "description": "" - }, - { - "value": "SelectProcessName", - "name": "选择进程名", - "description": "" - }, - { - "value": "SelectProfileExe", - "name": "选择场景标识", - "description": "" - }, - { - "value": "SelectWindowHandle", - "name": "选择窗口句柄", - "description": "" - }, - { - "value": "SelectKeyName", - "name": "从键盘输入键名", - "description": "" - }, - { - "value": "SelectSendKeysData", - "name": "从键盘输入模拟按键B的内容", - "description": "" - }, - { - "value": "SelectKeyCode", - "name": "从键盘输入键码数字", - "description": "" - }, - { - "value": "SelectLocationArea", - "name": "选取区域", - "description": "" - }, - { - "value": "SelectLocationPoint", - "name": "选取坐标位置", - "description": "" - }, - { - "value": "SelectRelativePoint", - "name": "选取窗口坐标位置", - "description": "" - }, - { - "value": "CaptureToFile", - "name": "截图并获取路径", - "description": "" - }, - { - "value": "SelectIcon", - "name": "选取矢量图标", - "description": "" - }, - { - "value": "SelectActionId", - "name": "选取动作ID", - "description": "" - }, - { - "value": "SelectActionName", - "name": "选取动作名称", - "description": "" - }, - { - "value": "SelectControlXPath", - "name": "选择窗口控件，获取其XPath", - "description": "" - }, - { - "value": "OperationItemEditor", - "name": "操作项编辑器", - "description": "" - }, - { - "value": "SelectBluetoothDevice", - "name": "已配对的蓝牙设备", - "description": "" - }, - { - "value": "SelectBluetoothLEDevice", - "name": "低功耗蓝牙设备", - "description": "" - }, - { - "value": "SelectNetworkProfile", - "name": "网络连接", - "description": "" - }, - { - "value": "SelectWebElementSelector", - "name": "网页元素的CSS选择器", - "description": "" - }, - { - "value": "SelectFontFamily", - "name": "选择字体名称", - "description": "" - } - ] - } - }, - "after": { - "operation": { - "name": "选择器", - "items": [ - { - "value": "SelectSingleFile", - "name": "选取文件", - "description": "" - }, - { - "value": "SelectMultiFile", - "name": "选取(多个)文件", - "description": "" - }, - { - "value": "SelectSingleFolder", - "name": "选取文件夹", - "description": "" - }, - { - "value": "SelectSavePath", - "name": "选择保存路径", - "description": "" - }, - { - "value": "SelectProcessPath", - "name": "选择窗口的进程路径", - "description": "" - }, - { - "value": "SelectProcessName", - "name": "选择进程名", - "description": "" - }, - { - "value": "SelectProfileExe", - "name": "选择场景标识", - "description": "" - }, - { - "value": "SelectWindowHandle", - "name": "选择窗口句柄", - "description": "" - }, - { - "value": "SelectKeyName", - "name": "从键盘输入键名", - "description": "" - }, - { - "value": "SelectSendKeysData", - "name": "从键盘输入模拟按键B的内容", - "description": "" - }, - { - "value": "SelectKeyCode", - "name": "从键盘输入键码数字", - "description": "" - }, - { - "value": "SelectLocationArea", - "name": "选取区域", - "description": "" - }, - { - "value": "SelectLocationPoint", - "name": "选取坐标位置", - "description": "" - }, - { - "value": "SelectRelativePoint", - "name": "选取窗口坐标位置", - "description": "" - }, - { - "value": "CaptureToFile", - "name": "截图并获取路径", - "description": "" - }, - { - "value": "SelectIcon", - "name": "选取矢量图标", - "description": "" - }, - { - "value": "SelectActionId", - "name": "选取动作ID", - "description": "" - }, - { - "value": "SelectActionName", - "name": "选取动作名称", - "description": "" - }, - { - "value": "SelectControlXPath", - "name": "选择窗口控件，获取其XPath", - "description": "" - }, - { - "value": "OperationItemEditor", - "name": "操作项编辑器", - "description": "" - }, - { - "value": "SelectBluetoothDevice", - "name": "已配对的蓝牙设备", - "description": "" - }, - { - "value": "SelectBluetoothLEDevice", - "name": "低功耗蓝牙设备", - "description": "" - }, - { - "value": "SelectNetworkProfile", - "name": "网络连接", - "description": "" - }, - { - "value": "SelectWebElementSelector", - "name": "网页元素的CSS选择器", - "description": "" - }, - { - "value": "SelectFontFamily", - "name": "选择字体名称", - "description": "" - }, - { - "value": "SelectMonitor", - "name": "选择显示器设备标识", - "description": "" - }, - { - "value": "SelectVirtualDesktop", - "name": "选择虚拟桌面标识", - "description": "" - } - ] - } - } - } + "selectionsChanged": false } ] } diff --git a/data/xaction/modules/sys_manageList.json b/data/xaction/modules/sys_manageList.json index d4c0ebc..7ab7d25 100644 --- a/data/xaction/modules/sys_manageList.json +++ b/data/xaction/modules/sys_manageList.json @@ -131,6 +131,26 @@ "variableMode": "Input", "condition": "", "description": "点击弹出显示帮助内容，MarkDown格式" + }, + { + "key": "addSubprogram", + "name": "添加项子程序", + "type": "Text", + "defaultValue": "", + "required": false, + "variableMode": "Input", + "condition": "", + "description": "可选，留空使用内置编辑器。输入：_item（文本，空串）、_index（数字，0起始插入位置）、_isNew（布尔，true）。输出：_confirmed（布尔）为true时，使用_item（文本）添加一项。" + }, + { + "key": "editSubprogram", + "name": "编辑项子程序", + "type": "Text", + "defaultValue": "", + "required": false, + "variableMode": "Input", + "condition": "", + "description": "可选，留空使用内置编辑器。输入：_item（原始文本）、_index（数字，0起始索引）、_isNew（布尔，false）。输出：_confirmed（布尔）为true时，使用_item（文本）替换当前项；取消不修改列表。" } ], "outputs": [ diff --git a/data/xaction/modules/sys_monitorBrightness.json b/data/xaction/modules/sys_monitor.json similarity index 97% rename from data/xaction/modules/sys_monitorBrightness.json rename to data/xaction/modules/sys_monitor.json index 8cd7d2b..111278a 100644 --- a/data/xaction/modules/sys_monitorBrightness.json +++ b/data/xaction/modules/sys_monitor.json @@ -1,7 +1,7 @@ { - "key": "sys:monitorBrightness", - "slug": "monitorbrightness", - "legacySlug": "monitorbrightness", + "key": "sys:monitor", + "slug": "monitor", + "legacySlug": "monitor", "ownsLegacyContent": true, "name": "显示器", "description": "获取显示器列表、读取显示器坐标与工作区，获取或调整指定显示器的硬件亮度。", @@ -187,5 +187,5 @@ ] } }, - "sourceFileName": "sys_monitorBrightness_显示器.md" + "sourceFileName": "sys_monitor_显示器.md" } diff --git a/data/xaction/modules/sys_notify.json b/data/xaction/modules/sys_notify.json index 072e698..81ec711 100644 --- a/data/xaction/modules/sys_notify.json +++ b/data/xaction/modules/sys_notify.json @@ -140,7 +140,7 @@ "items": [ { "value": "BottomCenter", - "name": "默认位置（底部居中）", + "name": "默认位置（使用全局设置）", "description": "" }, { @@ -167,6 +167,11 @@ "value": "BottomRight", "name": "右下角", "description": "" + }, + { + "value": "FixedBottomCenter", + "name": "底部居中", + "description": "" } ] } diff --git a/data/xaction/modules/sys_showText.json b/data/xaction/modules/sys_showText.json index 7b6bc4a..83254e7 100644 --- a/data/xaction/modules/sys_showText.json +++ b/data/xaction/modules/sys_showText.json @@ -82,6 +82,16 @@ "condition": "仅：WAIT, NO_WAIT", "description": "宽度,高度：逻辑像素或屏幕工作区百分比；自定义位置填坐标。" }, + { + "key": "rememberWindowPlacement", + "name": "记住上次位置和大小", + "type": "Boolean", + "defaultValue": "false", + "required": false, + "variableMode": "Input", + "condition": "仅：WAIT, NO_WAIT", + "description": "关闭窗口后保存位置和大小，下次运行此动作时恢复。按文本窗口标识分别记忆；全屏或最大化的位置类型不使用记忆位置。" + }, { "key": "topMost", "name": "置顶显示", diff --git a/docs/important-notice.md b/docs/important-notice.md index d39bc4a..a4f9fe3 100644 --- a/docs/important-notice.md +++ b/docs/important-notice.md @@ -113,6 +113,10 @@ AI 助手正式版支持选择本地工作区。选择本地文件夹后，AI 同版起，截图、贴图和录屏标注中 `Ctrl+Shift+Z` 改为 **重做**（不再清空全部标注）；清空全部标注请用 `Shift+Delete`。首次按旧习惯的 `Ctrl+Shift+Z` 时，客户端会提示一次并执行重做。 +旧「底部居中」步骤选项现在跟随全局默认位置；需要固定时，请重新选择本版的「底部居中」。 + +新导出的 Agent `.jsonl` 对话文件请用本版或更新版本导入；仍兼容旧版完整会话 JSON，已有对话无需迁移。导入的对话仅供查看，不能继续发送消息。见[AI 与 Agent](/v2/features/ai-and-agent)。 + ## 相关链接 \ No newline at end of file +/> diff --git a/docs/v2/features/ai-and-agent.md b/docs/v2/features/ai-and-agent.md index 909f30c..00aa5c3 100644 --- a/docs/v2/features/ai-and-agent.md +++ b/docs/v2/features/ai-and-agent.md @@ -30,7 +30,21 @@ comments: true 切换工作区会开启新的对话，不会把原对话、未提交草稿或上下文迁移过去。重新打开历史对话时，Quicker 会恢复该对话对应的目录，便于继续处理同一项目。 -导出对话后，界面会显示保存位置，并提供直接打开文件夹的入口。2.2.20 起，标题栏的「导入导出」菜单还可导出完整会话 JSON，保留原始消息、工具输入输出和事件记录；也可复制完整 JSON，再用「导入对话」离线查看。导入的内容是只读记录，不会恢复为可继续执行的对话；附件文件不会打包进 JSON。回退旧正式版的限制见 [体验前必读](/important-notice#2218-远程文件账号与-ai-助手工作区)。 +2.2.22 起，标题栏的「导入导出」菜单统一提供以下操作： + +- **导出对话文件**：保存为 `.jsonl` 文件，包含消息、工具输入输出和事件记录。正式版会把文件复制到剪贴板，可直接粘贴发送；导出后也可打开所在文件夹。 +- **导入对话文件…**：选择收到的对话文件，导入后会以带「[导入]」前缀的标题保存在本机对话列表中，可再次打开查看。也兼容 2.2.20 版本导出的完整会话 JSON。 +- **复制为 Markdown**：复制便于阅读的文本内容，不作为可重新导入的对话文件。 + +导入的对话仅供查看，不能继续发送消息。对话文件不打包附件文件、工作区文件或模型上下文，也不会重放工具操作。发送前请检查是否含私人内容、路径或工具返回的数据。 + +新版对话文件请用 **2.2.22 或更高版本**导入，旧版离线查看流程不保证兼容；已有普通对话无需迁移。工作区回退限制见 [体验前必读](/important-notice#2218-远程文件账号与-ai-助手工作区)。 + +### 针对步骤提问 + +2.2.22 起，右侧设计器中的步骤可拖到对话输入框，或通过「加入对话」加入步骤引用。输入修改要求后再发送，便于助手定位要处理的步骤；加入引用本身不会运行步骤。 + +右上角的同一图标可显示或隐藏右侧栏；右侧标签栏的「+」可打开动作选择页。关闭 Agent 窗口后，正在进行的任务会继续在 Quicker 后台执行；需要停止时请使用任务的停止操作，退出 Quicker 则会停止后台任务。 ## 连接外部助手 diff --git a/docs/v2/features/displays-and-desktops.md b/docs/v2/features/displays-and-desktops.md index c0435bd..cf985ff 100644 --- a/docs/v2/features/displays-and-desktops.md +++ b/docs/v2/features/displays-and-desktops.md @@ -14,7 +14,7 @@ comments: true 「显示器」可获取显示器列表与坐标、工作区、DPI，也可读取、设置、增加或降低硬件亮度。目标可选鼠标所在显示器、主显示器、指定显示器或所有显示器；指定显示器时，可从选择器选设备，或使用上一步输出的显示器标识。 -完整参数见[显示器步骤](/v2/xaction/modules/monitorbrightness)。 +完整参数见[显示器步骤](/v2/xaction/modules/monitor)。 调整亮度时可显示可拖动的亮度浮层。目标亮度按 0–100% 输入；0% 不等于关闭显示器。实际支持的亮度档位取决于设备；部分外接显示器可能不支持硬件亮度读写。对所有显示器执行时，各设备逐一处理；若其中一块失败，已经完成的调整不会回滚。 diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md index 4fb0e6a..9514e1f 100644 --- a/docs/v2/features/screenshot/capture-pro.md +++ b/docs/v2/features/screenshot/capture-pro.md @@ -148,7 +148,9 @@ comments: true 2.2.13 起，长截图完成后会先打开编辑窗口，可裁剪四周，也可选中中间一段直接删除，再保存、复制或贴图。编辑只作用于当前结果；取消不会覆盖原始拼接图。 -2.2.22 起，长截图工具栏提供与录屏类似的 **重来**：丢弃当前已采集内容，保留选区和滚动方向，从当前位置重新开始采集；暂停时点击也会恢复采集。快速滚动时的采集与拼接稳定性也有改善。 +2.2.22 起，采集工具栏提供 **重来**：丢弃本轮已拼接的内容，保留选区和滚动方向，从页面当前位置重新采集；暂停时点击也会恢复采集。它不会自动把页面滚回起点，需要从头截取时，请先把页面滚到所需位置。 + +同版改进了快速滚动时的采集稳定性和预览绿框显示，进入编辑或确认导出前会处理尚未拼接完的画面。遇到动画、固定悬浮层或异步加载内容时，仍建议放慢滚动并检查拼接结果。 超长图贴图时会先适合当前屏幕并居中，必要时首次缩放可低于 10%，避免窗口超出工作区。 @@ -400,6 +402,8 @@ HTML、公式贴图缩放时先显示预览，停稳后按倍率重绘；复制 ### 标注与贴图常用 +2.2.22 起，截图、贴图和录屏标注统一用 `Ctrl+Shift+Z` 重做，不再清空全部标注；清空改用 `Shift+Delete`。首次使用旧快捷键时会显示一次变更提示。 + | 操作 | 快捷键 | | --- | --- | | 撤销 / 重做 | `Ctrl+Z` / `Ctrl+Y`（2.2.22 起 `Ctrl+Shift+Z` 也是重做） | diff --git a/docs/v2/what's-new/xaction-steps/notify.md b/docs/v2/what's-new/xaction-steps/notify.md index 0554e57..5d9b1e9 100644 --- a/docs/v2/what's-new/xaction-steps/notify.md +++ b/docs/v2/what's-new/xaction-steps/notify.md @@ -15,3 +15,5 @@ comments: true 这些改进适用于应用内的成功、信息、警告和错误提示；“Windows 通知”仍由系统通知中心处理。 参数说明见[提示消息](/v2/xaction/modules/notify)。 + +2.2.22 起，可在「设置 → 模块功能选项 → 提示消息」设置并同步默认位置和停留时间。步骤选择「默认位置（使用全局设置）」或保持秒数为 `0` 时采用对应默认值；也可为单个步骤固定位置和时长。旧版兼容限制见[全局默认位置和时长](/v2/xaction/modules/notify#默认位置与停留时间)。 diff --git a/docs/v2/xaction/index.md b/docs/v2/xaction/index.md index 0ae2986..b1fedcb 100644 --- a/docs/v2/xaction/index.md +++ b/docs/v2/xaction/index.md @@ -14,11 +14,11 @@ hide_table_of_contents: true 2.2.18 起，客户端新增[远程文件](/v2/xaction/modules/remotefile)步骤，可通过 WebDAV 上传、下载、列出、查询、删除或移动网盘及 NAS 文件，并创建目录；2.2.19 起进一步支持 S3、文本与图片内容、复制文件和批量传输。账号在 **设置 → 软件连接 → 远程文件账号** 中配置，只保存在本机；换电脑或分享动作时，需要在目标电脑配置相同的账号引用名。 -2.2.20 起，客户端新增 [显示器](/v2/xaction/modules/monitorbrightness) 与 [虚拟桌面](/v2/xaction/modules/virtualdesktop) 步骤。显示器步骤可获取屏幕列表、坐标和工作区，并对鼠标所在屏、主屏、指定屏或全部屏读取、设置或增减亮度，也可显示可交互亮度 OSD；复制显示导致无法唯一对应物理显示器时，请明确指定目标。虚拟桌面步骤可查询、切换、创建、删除、重命名、排序桌面，查询窗口所在桌面并移动窗口，也可读取或设置窗口是否固定到所有桌面；能力取决于 Windows 完整版本，删除桌面时需要指定窗口迁移目标，且不能删除最后一个桌面。更多操作说明见[显示器与虚拟桌面](/v2/features/displays-and-desktops)。 +2.2.20 起，客户端新增 [显示器](/v2/xaction/modules/monitor) 与 [虚拟桌面](/v2/xaction/modules/virtualdesktop) 步骤。显示器步骤可获取屏幕列表、坐标和工作区，并对鼠标所在屏、主屏、指定屏或全部屏读取、设置或增减亮度，也可显示可交互亮度 OSD；复制显示导致无法唯一对应物理显示器时，请明确指定目标。虚拟桌面步骤可查询、切换、创建、删除、重命名、排序桌面，查询窗口所在桌面并移动窗口，也可读取或设置窗口是否固定到所有桌面；能力取决于 Windows 完整版本，删除桌面时需要指定窗口迁移目标，且不能删除最后一个桌面。更多操作说明见[显示器与虚拟桌面](/v2/features/displays-and-desktops)。 @@ -47,8 +46,7 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z" **标题**：留空用动作名；填 `-` 不显示标题；其他文字原样显示。 -**显示位置**：底部居中、四角、顶/底居中。仅成功 / 信息 / 告警 / 错误。2.2.22 起，步骤还可选择跟随设置中的全局默认位置；未单独指定时使用该默认。 - +**显示位置**：选择「默认位置（使用全局设置）」，或固定在屏幕六个位置之一。仅影响成功 / 信息 / 告警 / 错误提示，不控制 Windows 通知。 底部居中： @@ -76,11 +74,16 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z" ### 默认位置与停留时间 -2.2.22 起，在 **设置 → 模块功能选项** 可单独配置提示消息的 **默认显示位置** 和 **默认停留时间**，并随账号同步。默认停留时间为 `0` 时，仍按消息长度自动估算显示时长。 +2.2.22 起，在 **设置 → 模块功能选项 → 提示消息** 中，可设置默认显示位置和默认停留时间，保存后随账号同步到其他设备。 + +- 默认位置可选底部居中、左下角、右下角、顶部居中、左上角和右上角。 +- 默认停留时间为 `0` 时，根据文本长度自动计算；也可设为 1～30 秒。采用默认时长且带操作按钮的提示至少显示 10 秒。 +- 步骤的「显示位置」选择「默认位置（使用全局设置）」时跟随全局设置；选择具体位置时使用该位置。 +- 步骤的「保持秒数」为 `0` 时采用默认时长；明确填写秒数或 `-1` 时使用该步骤的设置。 -单条提示若在步骤或自动化脚本里单独指定了位置或时长，仍使用该条自身设置，不改全局默认。脚本未指定 placement 时跟随全局默认；显式指定底部居中等位置时仍固定在该位置。 +升级前保存的旧「底部居中」选项在本版对应「默认位置（使用全局设置）」。没有改动全局位置时，外观仍为底部居中；需要始终固定在底部时，请重新选择本版的「底部居中」。 -旧客户端不认识这两项设置。回退或混用旧版时，若在旧版保存设置并同步，可能把默认位置和停留时间重置；建议先记录当前值，把相关设备升级后再改。详见[体验前必读](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。 +回退旧客户端后，保存设置并同步可能重置新增的默认位置和时长；建议先记录所选值，并在所有设备升级后再修改。详见[升级注意](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。 ### 点击操作 diff --git a/docs/v2/xaction/modules/compute/managelist.md b/docs/v2/xaction/modules/compute/managelist.md index 27ccd61..d202267 100644 --- a/docs/v2/xaction/modules/compute/managelist.md +++ b/docs/v2/xaction/modules/compute/managelist.md @@ -8,7 +8,7 @@ quickerDocKey: "xaction/module/sys:manageList" comments: true moduleKey: "sys:manageList" docStatus: "reviewed" -metadataGeneratedAt: "2026-08-24 20:01:39" +metadataGeneratedAt: "2026-09-25 22:26:23" legacyDocId: 5350953 legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z" --- @@ -23,7 +23,7 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z" ## 概述 -运行时打开列表管理窗口。改动直接写回 **列表** 变量，点「完成」后继续。 +运行时打开列表管理窗口，先在窗口中修改列表副本。点「完成」后才写回 **列表** 变量；取消或关闭窗口不写回。 ![](./img/managelist-001-040cc435a4.png) @@ -45,7 +45,7 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z" - 选中了某一项：新项加在它后面。 - 没有选中：加到末尾。 -- 开启 **解析菜单数据** 时，添加会打开「编辑菜单项」窗口，可生成带图标的 [菜单数据项](/v2/xaction/concepts/action-custom-context-menu)。窗口里可以勾选「连续添加」。 +- 未指定自定义添加子程序且开启 **解析菜单数据** 时，添加会打开「编辑菜单项」窗口，可生成带图标的 [菜单数据项](/v2/xaction/concepts/action-custom-context-menu)。窗口里可以勾选「连续添加」。 **编辑**：选中后点「编辑」，或双击该项。 @@ -67,11 +67,11 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z" **取消后停止动作**：点「取消」后是否中止后续步骤。默认关闭。 -**解析菜单数据**：是否把 `[fa:Solid_Pen:#FF0000]文字标题(提示文字内容)|值` 当成菜单项。开启后列表显示图标和标题，编辑用「编辑菜单项」窗口。 +**解析菜单数据**：是否把 `[fa:Solid_Pen:#FF0000]文字标题(提示文字内容)|值` 当成菜单项。开启后列表显示图标和标题，未指定自定义子程序时使用「编辑菜单项」窗口。 ![](./img/managelist-003-1875478276.png) -关闭时按普通文本管理，编辑用文本框。 +关闭时按普通文本管理，未指定自定义子程序时使用文本框编辑。 ![](./img/managelist-004-c987d208d3.png) @@ -86,32 +86,48 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z" **帮助按钮内容**：Markdown。填写后窗口上出现「帮助」按钮。 -**添加项子程序** / **编辑项子程序**（高级，2.2.22+）：可选。留空时仍用内置文本框或「编辑菜单项」窗口。填写子程序标识后，添加或编辑会调用对应子程序，便于用[多字段表单](/v2/xaction/modules/form)处理 JSON 等复杂项。当前 `data/xaction` 尚未同步这两项的元数据预览；步骤编辑器里可在高级参数中看到完整说明，也以客户端为准。 - ## 用子程序自定义添加和编辑 -2.2.22 起，可在高级参数中指定 **添加项子程序**、**编辑项子程序**（也可填同一个子程序）。不配置时行为与旧版相同。 +2.2.22 起，可在高级参数中填写 **添加项子程序**、**编辑项子程序**，用自己的子程序处理单项内容，例如打开多字段表单。两个参数可填写同一个子程序，也可分别设置；留空仍使用内置编辑器。对应的「允许添加项」或「允许编辑项」关闭时，不会调用子程序。 + +列表仍是文本列表。需要保存多个字段时，可将每项存为 JSON 文本，再用 **显示内容提取表达式** 生成便于阅读的标题。编辑子程序收到的是原始文本，不是显示标题。 + +### 子程序变量 + +在子程序中声明以下变量，名称区分大小写，并勾选对应的输入、输出选项： + +| 变量 | 类型 | 方向 | 用途 | +| --- | --- | --- | --- | +| `_item` | 文本 | 输入、输出 | 添加时为空串，编辑时为原始内容；确认后返回完整新内容 | +| `_index` | 数字 | 输入 | 从 0 开始的插入位置或当前项索引 | +| `_isNew` | 布尔 | 输入 | 添加为 `true`，编辑为 `false` | +| `_confirmed` | 布尔 | 输出 | `true` 才采用 `_item`；`false` 取消这一次添加或编辑 | + +每次调用最多添加或替换一项。确认时允许返回空字符串；缺少必要输出、输出类型不正确或子程序运行失败时，窗口显示错误并保留原项。 + +### 示例：用表单编辑一项 + +1. 创建「编辑配置」子程序，按上表声明变量。 +2. 先把 `_confirmed` 设为 `false`；添加时准备空字段，编辑时解析 `_item` 中保存的 JSON。 +3. 用 [多字段表单](/v2/xaction/modules/form)编辑这些字段。取消表单则结束子程序；确认后把结果转换为 JSON 文本，写入 `_item`，最后把 `_confirmed` 设为 `true`。 +4. 在本模块的「添加项子程序」「编辑项子程序」中填入「编辑配置」，关闭「解析菜单数据」。 +5. 在列表窗口中添加、编辑和排序，点「完成」后再根据本模块的「是否确认」保存整份列表。 -子程序与列表窗口约定下列变量（区分大小写）： +子程序打开多字段表单时，表单会关联到列表窗口。 -| 变量 | 方向 | 含义 | -| --- | --- | --- | -| `_item` | 输入 / 输出 | 编辑时传入原始字符串；添加时为空。确认后返回要写入列表的完整字符串（不是仅显示标题）。 | -| `_index` | 输入 | 从 0 开始：编辑为当前项索引，添加为预定插入位置。 | -| `_isNew` | 输入 | 添加为 `true`，编辑为 `false`，便于共用一个子程序。 | -| `_confirmed` | 输出 | 为 `true` 时才应用 `_item`；`false` 表示取消本次单项编辑。 | +子程序运行期间，列表的添加、编辑、删除、排序、重置和完成暂时不可用；仍可取消或关闭窗口。取消单项编辑会保留列表窗口；取消整个列表窗口会丢弃本轮列表修改。 -只有 `_confirmed` 为 `true` 时才会改列表工作副本。单项取消、子程序异常或关闭列表窗口，都不会提交那一次修改。编辑进行中会暂时禁用添加、编辑、删除、排序、重置和「完成」，「取消」仍可用。列表仍须点窗口上的「完成」才写回动作变量；点「取消」会丢弃本次窗口内的全部改动。 +:::caution[版本与保存时机] -子程序里若打开多字段表单，会以列表窗口为 Owner。不要在子程序里直接把整份列表持久化到动作状态或文件；等主动作根据「是否确认」再保存，避免用户取消列表窗口后仍留下副作用。 +使用这两个参数的动作需要 **2.2.22 或更高版本**，分享和多设备使用前请确认客户端版本。子程序自行写文件、保存动作状态等操作不能被列表窗口的「取消」撤销；请尽量在列表整体确认后再保存。 -使用自定义子程序的动作需要 **2.2.22 或更高版本**；分享时请注明最低版本。回退与兼容见[体验前必读](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。 +::: ## 输出 - **是否确认**：用户是否点了「完成」。 -对列表的修改直接写回原变量，没有单独的列表输出。 +点「完成」后，列表修改写回原变量，没有单独的列表输出；取消不写回。 ## 限制与排障 @@ -141,6 +157,6 @@ legacyContentUpdatedAt: "2024-10-23T06:02:52.000Z" ## 更新内容 -- 2.2.22 增加「添加项子程序」「编辑项子程序」，可用子程序（如多字段表单）自定义添加与编辑。 +- 2026-09-25（2.2.22）支持用子程序自定义添加和编辑列表项。 - 20240504 (1.42.34) 增加「显示内容提取表达式」和「取消后停止动作」。 - 20241023 修复错别字。 diff --git a/docs/v2/xaction/modules/input/automationscript.md b/docs/v2/xaction/modules/input/automationscript.md index 86b6164..390f4f7 100644 --- a/docs/v2/xaction/modules/input/automationscript.md +++ b/docs/v2/xaction/modules/input/automationscript.md @@ -8,7 +8,7 @@ quickerDocKey: "xaction/module/sys:automationScript" comments: true moduleKey: "sys:automationScript" docStatus: "reviewed" -metadataGeneratedAt: "2026-08-24 20:01:39" +metadataGeneratedAt: "2026-09-25 22:26:23" --- # 自动化脚本 @@ -473,7 +473,7 @@ notify.show("正在同步", { }); ``` -`placement` 支持 `bottomCenter`、`bottomLeft`、`bottomRight`、`topCenter`、`topLeft`、`topRight`，默认 `bottomCenter`。`title` 最长 128 个字符，`key` 最长 64 个字符且不能全是空白。 +`placement` 支持 `bottomCenter`、`bottomLeft`、`bottomRight`、`topCenter`、`topLeft`、`topRight`。2.2.22 起，省略 `placement` 时跟随[提示消息的全局默认位置](/v2/xaction/modules/notify#默认位置与停留时间)；明确传入 `bottomCenter` 则固定在底部居中。省略 `durationMs` 或设为 `0` 时使用全局默认时长。`title` 最长 128 个字符，`key` 最长 64 个字符且不能全是空白。 相同 `key` 只在当前动作范围内参与去重：`replace` 替换已有消息，`count` 合并并累计次数，`ignore` 忽略新的重复消息。每次脚本最多显示 20 条提示，每秒最多 5 条；超过限制返回 `NOTIFY_LIMIT_EXCEEDED`。 diff --git a/docs/v2/xaction/modules/system/monitor.md b/docs/v2/xaction/modules/system/monitor.md new file mode 100644 index 0000000..5417f79 --- /dev/null +++ b/docs/v2/xaction/modules/system/monitor.md @@ -0,0 +1,26 @@ +--- +title: "显示器" +description: "获取显示器列表、坐标与工作区，读取和调整硬件亮度。" +slug: "/v2/xaction/modules/monitor" +sidebar_label: "显示器" +sidebar_position: 170 +quickerDocKey: "xaction/module/sys:monitor" +comments: true +moduleKey: "sys:monitor" +docStatus: "reviewed" +metadataGeneratedAt: "2026-09-25 22:26:23" +--- + +# 显示器 + +获取显示器列表、读取显示器坐标与工作区，获取或调整指定显示器的硬件亮度。 + +## 当前模块定义 + + + +## 使用说明 + +2.2.20 起可获取显示器列表、坐标与工作区，或读取、设置硬件亮度。先用「获取显示器列表」确认设备，再选择鼠标所在、主显示器、指定显示器或所有显示器。设备标识可供后续步骤引用；显示器断开或更换后，应重新选择。 + +设置亮度时可打开可交互的亮度浮层。并非所有外接显示器都支持硬件亮度控制；选择所有显示器时，已完成的调整不会因另一块失败而回滚。更多说明见[显示器与虚拟桌面](/v2/features/displays-and-desktops)。 diff --git a/docs/v2/xaction/modules/system/monitorbrightness.md b/docs/v2/xaction/modules/system/monitorbrightness.md index 7c56311..42ec5cc 100644 --- a/docs/v2/xaction/modules/system/monitorbrightness.md +++ b/docs/v2/xaction/modules/system/monitorbrightness.md @@ -6,21 +6,9 @@ sidebar_label: "显示器" sidebar_position: 170 quickerDocKey: "xaction/module/sys:monitorBrightness" comments: true -moduleKey: "sys:monitorBrightness" -docStatus: "generated" -metadataGeneratedAt: "2026-09-24 08:30:46" +unlisted: true --- # 显示器 -获取显示器列表、读取显示器坐标与工作区，获取或调整指定显示器的硬件亮度。 - -## 当前模块定义 - - - -## 使用说明 - -2.2.20 起可获取显示器列表、坐标与工作区，或读取、设置硬件亮度。先用「获取显示器列表」确认设备，再选择鼠标所在、主显示器、指定显示器或所有显示器。设备标识可供后续步骤引用；显示器断开或更换后，应重新选择。 - -设置亮度时可打开可交互的亮度浮层。并非所有外接显示器都支持硬件亮度控制；选择所有显示器时，已完成的调整不会因另一块失败而回滚。更多说明见[显示器与虚拟桌面](/v2/features/displays-and-desktops)。 +显示器模块的使用说明已移至[显示器](/v2/xaction/modules/monitor)。原链接继续保留，收藏此页的用户可从这里进入新版说明。 diff --git a/docs/v2/xaction/modules/ui/form.md b/docs/v2/xaction/modules/ui/form.md index 228b489..689b2cb 100644 --- a/docs/v2/xaction/modules/ui/form.md +++ b/docs/v2/xaction/modules/ui/form.md @@ -517,4 +517,4 @@ $= _context.GetRootContext().GetVarValue("变量名") - 20240223 增加动态更新选项、计算字段值的说明。 - 20240504 1.42.34 自动计算时，通过 depd 限制依赖的字段。 - 20240526 增加字段标题中使用快捷定位按键的说明。 -- 20240618 完善对扩展设置参数的说明。 \ No newline at end of file +- 20240618 完善对扩展设置参数的说明。