From 55c39f42b49cd2e696b8d262782ac66af5146007 Mon Sep 17 00:00:00 2001 From: Cea <61349137+ceastld@users.noreply.github.com> Date: Thu, 1 Oct 2026 06:26:16 -0700 Subject: [PATCH] =?UTF-8?q?docs(v2):=20=E5=90=8C=E6=AD=A5=E6=96=B0?= =?UTF-8?q?=E7=89=88=E4=BD=BF=E7=94=A8=E8=AF=B4=E6=98=8E=E4=B8=8E=E6=A8=A1?= =?UTF-8?q?=E5=9D=97=E5=8F=82=E6=95=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- data/xaction/catalog.json | 77 ++- data/xaction/changes.json | 466 +++++++++++++++++- data/xaction/modules/sys_WriteTextFile.json | 2 +- .../xaction/modules/sys_getClipboardText.json | 2 +- data/xaction/modules/sys_imgProcess.json | 9 +- data/xaction/modules/sys_listOperations.json | 3 +- .../modules/sys_quickeroperations.json | 20 +- data/xaction/modules/sys_readFile.json | 2 +- data/xaction/modules/sys_runScript.json | 2 +- .../xaction/modules/sys_screenCapturePro.json | 35 +- .../v2/features/action-panel/action-drafts.md | 18 +- docs/v2/features/action-panel/usage.md | 10 + docs/v2/features/action-sharing.md | 16 + docs/v2/features/ai-and-agent.md | 102 +++- docs/v2/features/screenshot/capture-pro.md | 34 +- docs/v2/features/tools.md | 19 +- docs/v2/features/triggers/action-hotkeys.md | 6 +- docs/v2/features/triggers/circle-menu.md | 20 +- docs/v2/features/triggers/index.md | 18 +- docs/v2/what's-new/tools-and-experience.md | 24 + docs/v2/xaction/concepts/subprogram.md | 12 + docs/v2/xaction/concepts/xaction-editor.md | 43 +- docs/v2/xaction/index.md | 2 +- docs/v2/xaction/modules/basic/runscript.md | 2 +- .../modules/clipboard/getclipboardtext.md | 2 +- docs/v2/xaction/modules/files/readfile.md | 2 +- .../v2/xaction/modules/files/writetextfile.md | 2 +- docs/v2/xaction/modules/flow/csscript.md | 8 + .../xaction/modules/image/long-screenshot.md | 4 + docs/v2/xaction/modules/image/pinimage.md | 2 + .../modules/image/screen-capture-pro.md | 14 +- .../modules/system/quickeroperations.md | 37 +- docs/v2/xaction/modules/ui/custompanel.md | 16 +- docs/v2/xaction/modules/ui/reactui.md | 27 + docs/v2/xaction/modules/ui/webview2.md | 8 +- 35 files changed, 953 insertions(+), 113 deletions(-) diff --git a/data/xaction/catalog.json b/data/xaction/catalog.json index a5551ca..45511a7 100644 --- a/data/xaction/catalog.json +++ b/data/xaction/catalog.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "generatedAt": "2026-09-27 14:50:01", + "generatedAt": "2026-09-30 06:04:10", "moduleCount": 175, "legacyMappedModuleCount": 0, "migratedLegacyModuleCount": 0, @@ -4351,7 +4351,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" } ] }, @@ -4606,7 +4606,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" } ] } @@ -6506,7 +6506,8 @@ }, { "value": "reverse", - "name": "倒置" + "name": "倒置", + "description": "原地倒置输入列表，不输出到“结果”" }, { "value": "sub", @@ -7420,7 +7421,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" }, { "value": "auto", @@ -8499,7 +8500,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" } ] }, @@ -12050,13 +12051,22 @@ "key": "preSelectArea", "name": "预选截图区域", "type": "Text", - "description": "留空时手动选择；指定物理屏幕坐标 left,top,right,bottom（右、下边界不包含）时，从该区域进入可调整、可标注状态。", + "description": "留空时手动选择；指定物理屏幕坐标 left,top,right,bottom（右、下边界不包含）时，截图/快速保存从该区域进入可调整状态，其他操作直接对该区域执行。", "isAdvanced": true, "validForList": [ "capture", + "capture_now", + "copy", + "pin", + "ocr_copy", + "ocr", + "table", + "formula", + "translate", + "image_translate", "quick_save" ], - "condition": "仅：capture, quick_save", + "condition": "仅：capture, capture_now, copy, pin, ocr_copy, ocr, table, formula, translate, image_translate, quick_save", "defaultValue": "", "variableMode": "UseVarOrInput" }, @@ -12084,11 +12094,13 @@ "key": "toClip", "name": "写入剪贴板", "type": "Boolean", - "description": "打勾或双击后写入剪贴板。", + "description": "确认截图后写入剪贴板；“框选即出图”在框选完成后写入。其他工具栏出口不触发。", "validForList": [ - "capture" + "capture", + "capture_now", + "quick_save" ], - "condition": "仅：capture", + "condition": "仅：capture, capture_now, quick_save", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "Input" @@ -12097,11 +12109,13 @@ "key": "pinImage", "name": "截图后贴图", "type": "Boolean", - "description": "打勾或双击后贴到原位置。", + "description": "确认截图后贴到原位置；“框选即出图”在框选完成后贴图。其他工具栏出口不触发。", "validForList": [ - "capture" + "capture", + "capture_now", + "quick_save" ], - "condition": "仅：capture", + "condition": "仅：capture, capture_now, quick_save", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "Input" @@ -12113,9 +12127,11 @@ "isAdvanced": true, "validForList": [ "capture", - "pin" + "capture_now", + "pin", + "quick_save" ], - "condition": "仅：capture, pin", + "condition": "仅：capture, capture_now, pin, quick_save", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "Input" @@ -14195,15 +14211,18 @@ }, { "value": "Invert", - "name": "反色" + "name": "反色", + "description": "原地修改输入图片 img，不输出结果图片；需保留原图请先用“复制图片”" }, { "value": "GrayScale", - "name": "灰度" + "name": "灰度", + "description": "原地修改输入图片 img，不输出结果图片；需保留原图请先用“复制图片”" }, { "value": "Rotate", - "name": "旋转" + "name": "旋转", + "description": "原地修改输入图片 img，不输出结果图片；需保留原图请先用“复制图片”" }, { "value": "Filters", @@ -40033,7 +40052,7 @@ "key": "profileId", "name": "动作页ID", "type": "Text", - "description": "请在场景与动作管理中，查看动作页信息获取ID。", + "description": "请在场景、动作与触发管理中，查看动作页信息获取ID。", "validForList": [ "loadProfile" ], @@ -40075,7 +40094,7 @@ "key": "exe", "name": "场景标识", "type": "Text", - "description": "场景关联的exe文件名。请参考场景与动作管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", + "description": "场景关联的exe文件名。请参考场景、动作与触发管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", "validForList": [ "showCircleMenu", "showDashboardWindow", @@ -40247,6 +40266,16 @@ "GetActionInfo" ], "condition": "仅：GetActionInfo" + }, + { + "key": "lastEditedActionId", + "name": "动作ID", + "type": "Text", + "description": "本次启动Quicker期间，最后打开或重新激活编辑器的已安装动作ID，不包含预览、草稿和公共子程序。关闭或取消编辑后仍保留记录；已删除或不属于当前账号的动作会跳过。没有记录时输出空文本并返回步骤失败。", + "validForList": [ + "GetLastEditedAction" + ], + "condition": "仅：GetLastEditedAction" } ], "selections": { @@ -40307,7 +40336,7 @@ }, { "value": "showExeSettingWindow", - "name": "显示场景与动作管理窗口" + "name": "显示场景、动作与触发管理窗口" }, { "value": "closeAllFloatWindow", @@ -40380,6 +40409,10 @@ { "value": "GetActionInfo", "name": "根据ID获取动作信息" + }, + { + "value": "GetLastEditedAction", + "name": "获取最后打开编辑器的动作" } ] }, diff --git a/data/xaction/changes.json b/data/xaction/changes.json index a0cf684..b44e6a6 100644 --- a/data/xaction/changes.json +++ b/data/xaction/changes.json @@ -1,14 +1,472 @@ { "schemaVersion": 1, "baselineCreated": false, - "fromGeneratedAt": "2026-09-27 14:50:01", - "toGeneratedAt": "2026-09-27 14:50:01", + "fromGeneratedAt": "2026-09-29 15:21:29", + "toGeneratedAt": "2026-09-30 06:04:10", "summary": { "addedModules": 0, "removedModules": 0, - "changedModules": 0 + "changedModules": 1 }, "addedModules": [], "removedModules": [], - "changedModules": [] + "changedModules": [ + { + "key": "sys:quickeroperations", + "name": "Quicker操作", + "changedFields": [], + "inputs": { + "added": [], + "removed": [], + "changed": [ + { + "key": "profileId", + "before": { + "key": "profileId", + "name": "动作页ID", + "type": "Text", + "description": "请在场景与动作管理中，查看动作页信息获取ID。", + "validForList": [ + "loadProfile" + ], + "condition": "仅：loadProfile", + "defaultValue": "", + "required": true, + "variableMode": "UseVarOrInput" + }, + "after": { + "key": "profileId", + "name": "动作页ID", + "type": "Text", + "description": "请在场景、动作与触发管理中，查看动作页信息获取ID。", + "validForList": [ + "loadProfile" + ], + "condition": "仅：loadProfile", + "defaultValue": "", + "required": true, + "variableMode": "UseVarOrInput" + } + }, + { + "key": "exe", + "before": { + "key": "exe", + "name": "场景标识", + "type": "Text", + "description": "场景关联的exe文件名。请参考场景与动作管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", + "validForList": [ + "showCircleMenu", + "showDashboardWindow", + "showExeSettingWindow", + "loadExeProfiles", + "loadExeProfilesNoLock", + "GetActionList" + ], + "condition": "仅：showCircleMenu, showDashboardWindow, showExeSettingWindow, loadExeProfiles, loadExeProfilesNoLock, GetActionList", + "defaultValue": "", + "required": true, + "variableMode": "UseVarOrInput" + }, + "after": { + "key": "exe", + "name": "场景标识", + "type": "Text", + "description": "场景关联的exe文件名。请参考场景、动作与触发管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", + "validForList": [ + "showCircleMenu", + "showDashboardWindow", + "showExeSettingWindow", + "loadExeProfiles", + "loadExeProfilesNoLock", + "GetActionList" + ], + "condition": "仅：showCircleMenu, showDashboardWindow, showExeSettingWindow, loadExeProfiles, loadExeProfilesNoLock, GetActionList", + "defaultValue": "", + "required": true, + "variableMode": "UseVarOrInput" + } + } + ] + }, + "outputs": { + "added": [], + "removed": [], + "changed": [] + }, + "selectionsChanged": true, + "selections": { + "before": { + "type": { + "name": "类型", + "items": [ + { + "value": "showPanel", + "name": "显示面板" + }, + { + "value": "showSearch", + "name": "显示搜索框" + }, + { + "value": "closeSearch", + "name": "关闭搜索框" + }, + { + "value": "showCircleMenu", + "name": "显示轮盘菜单 (点击)" + }, + { + "value": "showTextSelectionToolbar", + "name": "显示选中文本工具条" + }, + { + "value": "togglePause", + "name": "禁用/启用" + }, + { + "value": "runLastAction", + "name": "运行最后使用的动作" + }, + { + "value": "startAppVoiceInput", + "name": "启动App语音输入" + }, + { + "value": "stopAllActions", + "name": "停止运行中的动作" + }, + { + "value": "reinstallMouseHook", + "name": "重新加载键鼠挂钩" + }, + { + "value": "ResetKeyboard", + "name": "重置键盘状态" + }, + { + "value": "showDashboardWindow", + "name": "显示仪表盘窗口" + }, + { + "value": "showConfigWindow", + "name": "显示设置窗口" + }, + { + "value": "showExeSettingWindow", + "name": "显示场景与动作管理窗口" + }, + { + "value": "closeAllFloatWindow", + "name": "关闭所有悬浮按钮" + }, + { + "value": "loadProfile", + "name": "加载动作页" + }, + { + "value": "loadExeProfiles", + "name": "加载场景动作（锁定切换）" + }, + { + "value": "loadExeProfilesNoLock", + "name": "加载场景动作（不锁定切换）" + }, + { + "value": "ToggleLockPanel", + "name": "锁定/解锁 动作页自动切换" + }, + { + "value": "editAction", + "name": "编辑动作" + }, + { + "value": "RestartQuicker", + "name": "重启Quicker" + }, + { + "value": "SetPushActiveClient", + "name": "推送服务：设置为活动客户端" + }, + { + "value": "StartSearchWithAction", + "name": "使用当前动作进行实时搜索" + }, + { + "value": "SearchWithCertainAction", + "name": "使用指定动作进行实时搜索" + }, + { + "value": "operation_show_context_menu", + "name": "显示剪贴板上下文菜单" + }, + { + "value": "LoadSkin", + "name": "加载外观/切换主题(专业版功能)" + }, + { + "value": "ExitQuicker", + "name": "退出Quicker" + }, + { + "value": "FloatAction", + "name": "悬浮动作(专业版功能)" + }, + { + "value": "ToggleFloatButtons", + "name": "切换所有悬浮按钮显示" + }, + { + "value": "ShowHideImageWindows", + "name": "显示或隐藏所有图片窗口" + }, + { + "value": "RemoveAction", + "name": "删除当前动作" + }, + { + "value": "GetActionInfo", + "name": "根据ID获取动作信息" + }, + { + "value": "GetLastEditedAction", + "name": "获取最后打开编辑器的动作" + } + ] + }, + "theme": { + "name": "主题模式", + "items": [ + { + "value": "", + "name": "不改变" + }, + { + "value": "auto", + "name": "跟随Windows" + }, + { + "value": "light", + "name": "浅色" + }, + { + "value": "dark", + "name": "暗色" + }, + { + "value": "toggle", + "name": "切换浅色和暗色" + } + ] + }, + "viewMode": { + "name": "显示状态", + "items": [ + { + "value": "HideAll", + "name": "隐藏全部" + }, + { + "value": "ByProcess", + "name": "自动(按关联进程切换)" + }, + { + "value": "ShowAll", + "name": "显示全部" + }, + { + "value": "ToggleHideAndAuto", + "name": "切换隐藏和自动" + } + ] + } + }, + "after": { + "type": { + "name": "类型", + "items": [ + { + "value": "showPanel", + "name": "显示面板" + }, + { + "value": "showSearch", + "name": "显示搜索框" + }, + { + "value": "closeSearch", + "name": "关闭搜索框" + }, + { + "value": "showCircleMenu", + "name": "显示轮盘菜单 (点击)" + }, + { + "value": "showTextSelectionToolbar", + "name": "显示选中文本工具条" + }, + { + "value": "togglePause", + "name": "禁用/启用" + }, + { + "value": "runLastAction", + "name": "运行最后使用的动作" + }, + { + "value": "startAppVoiceInput", + "name": "启动App语音输入" + }, + { + "value": "stopAllActions", + "name": "停止运行中的动作" + }, + { + "value": "reinstallMouseHook", + "name": "重新加载键鼠挂钩" + }, + { + "value": "ResetKeyboard", + "name": "重置键盘状态" + }, + { + "value": "showDashboardWindow", + "name": "显示仪表盘窗口" + }, + { + "value": "showConfigWindow", + "name": "显示设置窗口" + }, + { + "value": "showExeSettingWindow", + "name": "显示场景、动作与触发管理窗口" + }, + { + "value": "closeAllFloatWindow", + "name": "关闭所有悬浮按钮" + }, + { + "value": "loadProfile", + "name": "加载动作页" + }, + { + "value": "loadExeProfiles", + "name": "加载场景动作（锁定切换）" + }, + { + "value": "loadExeProfilesNoLock", + "name": "加载场景动作（不锁定切换）" + }, + { + "value": "ToggleLockPanel", + "name": "锁定/解锁 动作页自动切换" + }, + { + "value": "editAction", + "name": "编辑动作" + }, + { + "value": "RestartQuicker", + "name": "重启Quicker" + }, + { + "value": "SetPushActiveClient", + "name": "推送服务：设置为活动客户端" + }, + { + "value": "StartSearchWithAction", + "name": "使用当前动作进行实时搜索" + }, + { + "value": "SearchWithCertainAction", + "name": "使用指定动作进行实时搜索" + }, + { + "value": "operation_show_context_menu", + "name": "显示剪贴板上下文菜单" + }, + { + "value": "LoadSkin", + "name": "加载外观/切换主题(专业版功能)" + }, + { + "value": "ExitQuicker", + "name": "退出Quicker" + }, + { + "value": "FloatAction", + "name": "悬浮动作(专业版功能)" + }, + { + "value": "ToggleFloatButtons", + "name": "切换所有悬浮按钮显示" + }, + { + "value": "ShowHideImageWindows", + "name": "显示或隐藏所有图片窗口" + }, + { + "value": "RemoveAction", + "name": "删除当前动作" + }, + { + "value": "GetActionInfo", + "name": "根据ID获取动作信息" + }, + { + "value": "GetLastEditedAction", + "name": "获取最后打开编辑器的动作" + } + ] + }, + "theme": { + "name": "主题模式", + "items": [ + { + "value": "", + "name": "不改变" + }, + { + "value": "auto", + "name": "跟随Windows" + }, + { + "value": "light", + "name": "浅色" + }, + { + "value": "dark", + "name": "暗色" + }, + { + "value": "toggle", + "name": "切换浅色和暗色" + } + ] + }, + "viewMode": { + "name": "显示状态", + "items": [ + { + "value": "HideAll", + "name": "隐藏全部" + }, + { + "value": "ByProcess", + "name": "自动(按关联进程切换)" + }, + { + "value": "ShowAll", + "name": "显示全部" + }, + { + "value": "ToggleHideAndAuto", + "name": "切换隐藏和自动" + } + ] + } + } + } + } + ] } diff --git a/data/xaction/modules/sys_WriteTextFile.json b/data/xaction/modules/sys_WriteTextFile.json index 929eb9b..bd1ffcf 100644 --- a/data/xaction/modules/sys_WriteTextFile.json +++ b/data/xaction/modules/sys_WriteTextFile.json @@ -120,7 +120,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" } ] }, diff --git a/data/xaction/modules/sys_getClipboardText.json b/data/xaction/modules/sys_getClipboardText.json index eaf16e0..863e32f 100644 --- a/data/xaction/modules/sys_getClipboardText.json +++ b/data/xaction/modules/sys_getClipboardText.json @@ -165,7 +165,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" } ] } diff --git a/data/xaction/modules/sys_imgProcess.json b/data/xaction/modules/sys_imgProcess.json index a172b59..d239626 100644 --- a/data/xaction/modules/sys_imgProcess.json +++ b/data/xaction/modules/sys_imgProcess.json @@ -186,15 +186,18 @@ }, { "value": "Invert", - "name": "反色" + "name": "反色", + "description": "原地修改输入图片 img，不输出结果图片；需保留原图请先用“复制图片”" }, { "value": "GrayScale", - "name": "灰度" + "name": "灰度", + "description": "原地修改输入图片 img，不输出结果图片；需保留原图请先用“复制图片”" }, { "value": "Rotate", - "name": "旋转" + "name": "旋转", + "description": "原地修改输入图片 img，不输出结果图片；需保留原图请先用“复制图片”" }, { "value": "Filters", diff --git a/data/xaction/modules/sys_listOperations.json b/data/xaction/modules/sys_listOperations.json index c8cec4d..dc3dd13 100644 --- a/data/xaction/modules/sys_listOperations.json +++ b/data/xaction/modules/sys_listOperations.json @@ -288,7 +288,8 @@ }, { "value": "reverse", - "name": "倒置" + "name": "倒置", + "description": "原地倒置输入列表，不输出到“结果”" }, { "value": "sub", diff --git a/data/xaction/modules/sys_quickeroperations.json b/data/xaction/modules/sys_quickeroperations.json index cb02bea..4d8df86 100644 --- a/data/xaction/modules/sys_quickeroperations.json +++ b/data/xaction/modules/sys_quickeroperations.json @@ -24,7 +24,7 @@ "key": "profileId", "name": "动作页ID", "type": "Text", - "description": "请在场景与动作管理中，查看动作页信息获取ID。", + "description": "请在场景、动作与触发管理中，查看动作页信息获取ID。", "validForList": [ "loadProfile" ], @@ -66,7 +66,7 @@ "key": "exe", "name": "场景标识", "type": "Text", - "description": "场景关联的exe文件名。请参考场景与动作管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", + "description": "场景关联的exe文件名。请参考场景、动作与触发管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", "validForList": [ "showCircleMenu", "showDashboardWindow", @@ -238,6 +238,16 @@ "GetActionInfo" ], "condition": "仅：GetActionInfo" + }, + { + "key": "lastEditedActionId", + "name": "动作ID", + "type": "Text", + "description": "本次启动Quicker期间，最后打开或重新激活编辑器的已安装动作ID，不包含预览、草稿和公共子程序。关闭或取消编辑后仍保留记录；已删除或不属于当前账号的动作会跳过。没有记录时输出空文本并返回步骤失败。", + "validForList": [ + "GetLastEditedAction" + ], + "condition": "仅：GetLastEditedAction" } ], "selections": { @@ -298,7 +308,7 @@ }, { "value": "showExeSettingWindow", - "name": "显示场景与动作管理窗口" + "name": "显示场景、动作与触发管理窗口" }, { "value": "closeAllFloatWindow", @@ -371,6 +381,10 @@ { "value": "GetActionInfo", "name": "根据ID获取动作信息" + }, + { + "value": "GetLastEditedAction", + "name": "获取最后打开编辑器的动作" } ] }, diff --git a/data/xaction/modules/sys_readFile.json b/data/xaction/modules/sys_readFile.json index 0352b3c..d5e9528 100644 --- a/data/xaction/modules/sys_readFile.json +++ b/data/xaction/modules/sys_readFile.json @@ -123,7 +123,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" }, { "value": "auto", diff --git a/data/xaction/modules/sys_runScript.json b/data/xaction/modules/sys_runScript.json index f7ea182..642d11e 100644 --- a/data/xaction/modules/sys_runScript.json +++ b/data/xaction/modules/sys_runScript.json @@ -229,7 +229,7 @@ }, { "value": "default", - "name": "系统默认(gb2312)" + "name": "系统默认(windows-1252)" } ] }, diff --git a/data/xaction/modules/sys_screenCapturePro.json b/data/xaction/modules/sys_screenCapturePro.json index 0298886..a491bd4 100644 --- a/data/xaction/modules/sys_screenCapturePro.json +++ b/data/xaction/modules/sys_screenCapturePro.json @@ -24,13 +24,22 @@ "key": "preSelectArea", "name": "预选截图区域", "type": "Text", - "description": "留空时手动选择；指定物理屏幕坐标 left,top,right,bottom（右、下边界不包含）时，从该区域进入可调整、可标注状态。", + "description": "留空时手动选择；指定物理屏幕坐标 left,top,right,bottom（右、下边界不包含）时，截图/快速保存从该区域进入可调整状态，其他操作直接对该区域执行。", "isAdvanced": true, "validForList": [ "capture", + "capture_now", + "copy", + "pin", + "ocr_copy", + "ocr", + "table", + "formula", + "translate", + "image_translate", "quick_save" ], - "condition": "仅：capture, quick_save", + "condition": "仅：capture, capture_now, copy, pin, ocr_copy, ocr, table, formula, translate, image_translate, quick_save", "defaultValue": "", "variableMode": "UseVarOrInput" }, @@ -58,11 +67,13 @@ "key": "toClip", "name": "写入剪贴板", "type": "Boolean", - "description": "打勾或双击后写入剪贴板。", + "description": "确认截图后写入剪贴板；“框选即出图”在框选完成后写入。其他工具栏出口不触发。", "validForList": [ - "capture" + "capture", + "capture_now", + "quick_save" ], - "condition": "仅：capture", + "condition": "仅：capture, capture_now, quick_save", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "Input" @@ -71,11 +82,13 @@ "key": "pinImage", "name": "截图后贴图", "type": "Boolean", - "description": "打勾或双击后贴到原位置。", + "description": "确认截图后贴到原位置；“框选即出图”在框选完成后贴图。其他工具栏出口不触发。", "validForList": [ - "capture" + "capture", + "capture_now", + "quick_save" ], - "condition": "仅：capture", + "condition": "仅：capture, capture_now, quick_save", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "Input" @@ -87,9 +100,11 @@ "isAdvanced": true, "validForList": [ "capture", - "pin" + "capture_now", + "pin", + "quick_save" ], - "condition": "仅：capture, pin", + "condition": "仅：capture, capture_now, pin, quick_save", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "Input" diff --git a/docs/v2/features/action-panel/action-drafts.md b/docs/v2/features/action-panel/action-drafts.md index 362c1b3..1318dda 100644 --- a/docs/v2/features/action-panel/action-drafts.md +++ b/docs/v2/features/action-panel/action-drafts.md @@ -52,7 +52,7 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位 编辑副本也可以保存本机版本、试运行和调试。选择 **写回原动作** 并确认后，Quicker 用副本内容覆盖原动作；通常会在写回成功后移除该暂存项。 -如果原动作在建立副本后又被修改，写回会被拒绝，避免覆盖较新的内容。当前不会自动合并：先保留需要的修改，再丢弃旧副本、重新打开最新原动作继续处理。如果确认写回期间暂存副本又发生变化，也需要检查最新内容并重新确认。 +在 2.2.24 中，如果原动作在建立副本后又被修改，写回会被拒绝，避免覆盖较新的内容。该版本不会自动合并：先保留需要的修改，再丢弃旧副本、重新打开最新原动作继续处理。如果确认写回期间暂存副本又发生变化，也需要检查最新内容并重新确认。2.2.25 起新增的合并与冲突处理见[下文](#原动作已变化时处理冲突)。 丢弃编辑副本不会删除它对应的正式动作，但会删除副本及其本机版本历史。 @@ -64,6 +64,22 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位 正式化会继续使用暂存动作的标识。动作进入正式动作库后，才能被普通快捷键、轮盘、手势等规则稳定引用，并按正式动作规则参与同步。 + + +## 原动作已变化时处理冲突 + +:::note[适用范围] +以下合并与冲突处理从 2.2.25 起可用。2.2.24 不会自动合并两边的修改。 +::: + +独立 AI 对话修改已安装的正式动作时，会使用它的暂存编辑副本。若正式动作随后也被修改，在「写回原动作」时会比较原始内容、当前正式动作和暂存副本，尝试保留双方不冲突的修改。 + +程序中的步骤、变量、子程序和表达式可能互相依赖；双方都修改了程序内容时，不能仅因改了不同步骤就当作可以自动拼接。缺少可靠原始内容的旧草稿，也不会猜测哪一边才应保留。有冲突时，写回会停止，两份修改都保留。 + +出现「让 AI 协助合并」时，可以主动点击并说明希望保留的行为。助手会读取差异、整理候选内容；不明确的取舍仍需本人决定。**合并结果先保存到暂存副本**，重新检查并试运行后，再确认写回原动作。仅写回失败不会自动发送合并请求。 + +如果合并期间原动作或草稿又变了，需要重新读取差异，不能沿用过期的选择。不要为了消除提示而直接丢弃仍需要的草稿。 + ## 与正式动作和同步的区别 暂存内容不会作为独立的正式动作出现在普通动作选择器和触发规则选择器中。已有动作的编辑副本不会替换选择器中的原动作；只有完成写回，原动作才使用修改后的内容。暂存区的试运行只执行该暂存项最近保存的内容，不会临时建立正式动作引用。 diff --git a/docs/v2/features/action-panel/usage.md b/docs/v2/features/action-panel/usage.md index fd03df2..c2019e3 100644 --- a/docs/v2/features/action-panel/usage.md +++ b/docs/v2/features/action-panel/usage.md @@ -86,6 +86,8 @@ comments: true 2.2.23 起，侧边栏会根据可用高度尽量显示更多快捷按钮；放不下的按钮收进「更多」。 +缩小窗口后按钮看似少了，可以先打开「…」菜单，无需重新添加；原有配置和顺序不会因此删除。拉高窗口后会显示更多按钮，并为场景列表保留浏览空间。 + 2.2.26 起，原独立的「动作管理」「公共子程序管理」入口整合到设置：**设置 → 动作 → 全部动作**、**设置 → 动作 → 公共子程序**。面板与托盘中的重复入口已移除；需要浏览全部动作或公共子程序时，请从设置进入。 ::::caution[侧边栏快捷按钮的回退风险] @@ -251,6 +253,14 @@ comments: true 背景可以选择普通透明、毛玻璃或亚克力，并调整背景色叠加浓度。亚克力需要 Windows 11 且开启系统“透明效果”；条件不满足时，Quicker 会按毛玻璃效果显示。背景色叠加浓度是 2.1.22 新增设置，回退到 2.1.21 或在未升级设备上保存设置时可能被清为 0，需要回到新版本重新设置。 + + +## 拖动动作时切换场景 + +2.2.25 起，可以在拖动动作过程中，把鼠标停在主面板的另一个场景标签上约半秒，自动切换到该场景。保持拖动，再移入目标动作区域或分组后松开，才会按现有拖放规则完成移动或添加。 + +场景标签只用于切换，不能直接作为动作的放置位置；在标签上松开不会把动作放入该场景。离开标签或取消拖动会取消待执行的切换。此入口针对动作拖放，不用于把文件、普通文字或分组直接放到场景标签上。 + ## 管理多个场景和大量动作 需要跨场景整理时，使用标题栏「更多菜单 → 场景、动作与触发」。在「场景、动作与触发」管理窗口中，可以： diff --git a/docs/v2/features/action-sharing.md b/docs/v2/features/action-sharing.md index 861c014..d9d2934 100644 --- a/docs/v2/features/action-sharing.md +++ b/docs/v2/features/action-sharing.md @@ -52,6 +52,8 @@ V1 和 V2 只是同一修订中的两种可安装内容，不是两条独立分 更新已有分享时，若原「适用软件」保存的是非法值，需要重新选择有效分类，客户端不再自动改为「通用」。已有 Chrome 等具体程序分类**不会**自动改成「浏览器通用」；需要跨浏览器展示时请手动改选。 ::: +该选项不会修改本地场景归属，也不会自动使动作兼容所有浏览器。只适用于具体程序、网站或依赖某个扩展的动作，应保留相应分类，并在说明中写清限制。 + ### 如何选择发布格式 | 本次选择 | Quicker 1.x | Quicker 2.0 | 适用情况 | @@ -81,6 +83,20 @@ V1 和 V2 只是同一修订中的两种可安装内容，不是两条独立分 2.2.11 的“指定类型”变量属于明确不支持 V1 的能力，包括主程序和嵌入子程序中的声明。应仅发布 V2；动态对象的可选补全类型提示不属于此限制。 +## 让 AI 协助分享动作 + +2.2.23 起，可以在 Agent 对话中说明要分享哪个正式动作，或请助手为已分享的动作准备新版本。操作顺序为： + +1. 先检查并试运行正式动作。如果修改还在暂存区，先把新动作保留到场景，或把修改写回原动作；只保存暂存草稿并不会更新准备分享的正式内容。 +2. 告诉助手分享或更新的目标。助手会读取正式动作；更新已有分享时，会根据能够核实的差异建议更新说明。公开分享缺少说明或合适图标时，也可以先由助手补充建议。 +3. 在打开的分享页面核对名称、说明、图标、适用软件、许可、发布格式和公开范围，然后由本人提交。 + +打开确认窗口不等于发布成功。关闭或取消后不会提交；若动作或线上修订已发生变化，需要重新准备并核对，不能直接沿用旧建议。AI 无法确定修改内容时，更新说明应由作者补充，不要把猜测当作已实现的功能。 + +:::note[对话内确认] +2.2.24 起，可在对话内打开分享确认；2.2.23 使用独立分享页面。确认位置以本机界面为准，仍需本人核对并提交。 +::: + ## 公开、审核和不公开分享 - **公开分享**会提交到动作库或子程序库。普通动作通常需要审核；部分账号或资源可能按当前规则直接通过。 diff --git a/docs/v2/features/ai-and-agent.md b/docs/v2/features/ai-and-agent.md index 6c132af..de6241b 100644 --- a/docs/v2/features/ai-and-agent.md +++ b/docs/v2/features/ai-and-agent.md @@ -38,12 +38,14 @@ comments: true 检查并试运行暂存副本后，选择 **写回原动作**，或让助手发起写回并按提示确认。写回会用暂存内容覆盖原动作；它与新动作的“保留到场景”是两种不同操作。 -如果提示原动作已变化，不要反复要求强制覆盖。先保留仍需要的修改内容，再丢弃旧编辑副本、重新打开最新原动作，将需要的改动重新应用。当前不会自动合并两边的修改。暂存版本和删除限制见 [本机动作暂存区](./action-panel/action-drafts.md)。 +在 2.2.24 中，如果提示原动作已变化，不要反复要求强制覆盖。先保留仍需要的修改内容，再丢弃旧编辑副本、重新打开最新原动作，将需要的改动重新应用。该版本不会自动合并两边的修改；2.2.25 起的合并能力见[暂存副本冲突处理](/v2/features/action-panel/action-drafts#原动作已变化时处理冲突)。暂存版本和删除限制见 [本机动作暂存区](./action-panel/action-drafts.md)。 ### 在设计器内修改 2.2.25 起，在动作编辑窗口配置好 AI 参数后，可点击右上角 **AI** 按钮，或按 `Ctrl+J`，打开设计器内的 AI 面板，用 AI 编写和修改当前动作。 +详细操作见[在动作设计器内检查 AI 修改](#在动作设计器内检查-ai-修改)。 + 使用设计器内的程序助手时，助手修改的是当前编辑内容，成功的修改会显示在设计器中。检查结果后，仍需通过设计器的保存操作保存动作；保存到正式动作还是暂存区，取决于当前正在编辑的动作身份。 这与独立 AI 对话中“保存暂存副本，再写回原动作”的流程不同。判断修改是否完成，应看当前设计器和暂存区的实际状态，而不只看助手回复。 @@ -70,7 +72,7 @@ comments: true - **导入对话文件…**：选择收到的对话文件，导入后会以带「[导入]」前缀的标题保存在本机对话列表中，可再次打开查看。也兼容 2.2.20 版本导出的完整会话 JSON。 - **复制为 Markdown**：复制便于阅读的文本内容，不作为可重新导入的对话文件。 -导入的对话仅供查看，不能继续发送消息。对话文件不打包附件文件、工作区文件或模型上下文，也不会重放工具操作。发送前请检查是否含私人内容、路径或工具返回的数据。 +在 2.2.22 中，导入的对话仅供查看，不能继续发送消息；该版本的对话文件不打包附件文件、工作区文件或模型上下文，也不会重放工具操作。2.2.23 起的续聊条件见[导入后继续对话](#导入后继续对话)。发送前请检查是否含私人内容、路径或工具返回的数据。 新版对话文件请用 **2.2.22 或更高版本**导入，旧版离线查看流程不保证兼容；已有普通对话无需迁移。工作区回退限制见 [体验前必读](/important-notice#2218-远程文件账号与-ai-助手工作区)。 @@ -93,16 +95,6 @@ comments: true 通过 MCP 编写动作也使用暂存流程：新动作确认后保留到场景，已有正式动作的编辑副本确认后写回原动作。允许 MCP 写入不等于每次修改都会自动成为正式动作；完成后请在 Quicker 中检查实际保存位置和动作内容。 -## 对话界面 - -2.2.24 起，AI 对话界面补充： - -- 选中对话中的文字后，可点击 **添加到对话**，把内容作为引用加入输入草稿（引用可删除）。 -- 模型选择菜单支持切换上下文窗口大小，适用于提供多个可选档位的模型。 -- 对话侧栏支持收起、展开，并记住展开状态；折叠分组时不再跳动滚动位置。 - -2.2.26 起，同轮程序变更会合并展示；当本轮已记录完整快照时，可撤销整轮修改。新建对话与输入草稿会保留。粘贴附件的导入问题已修复；图片文字识别改为按需读取，减少不必要的识别开销。 - ## 对话与图片输入 2.2.18 起，新建对话可选择工作区，重新打开历史对话时会恢复对应目录；导出对话后会显示保存位置，并可直接打开文件夹。工作区设置会随对话保留，回退到不支持自选工作区的旧版后，不要继续编辑对应项目对话。 @@ -115,6 +107,70 @@ comments: true 2.2.11 改进“用 AI 写”对当前空对话的复用；有草稿的空对话经确认关闭后保留归档。图片缺少本地文字识别组件时，可按提示安装再识别；需要直接理解图像内容时，还应选择支持图片输入的模型。 +## 导入后继续对话 + +2.2.23 起，导出的对话文件可携带已经保存的模型会话。使用**同一种 Agent 入口**导入，并且文件中有可恢复的模型会话时，可以继续发送消息；缺少模型会话、来源入口不匹配或恢复失败时，仍按只读对话导入。较早版本导出的只读文件不会因为升级而自动获得续聊能力。 + +导入会新建一条带「[导入]」前缀的对话，不覆盖原对话。可续聊对话使用**导入时当前选择的工作区**，不会自动复制发送方的工作区文件或附件；继续让助手处理文件前，请先核对本机目录和所需文件。导入本身不会重放历史工具操作。 + +## 让 AI 协助分享动作 + +2.2.23 起，可以让助手为正式动作准备分享说明、图标和更新摘要，再打开分享页面供本人核对并提交。具体步骤和暂存草稿的处理见[分享动作与公共子程序](/v2/features/action-sharing#让-ai-协助分享动作)。 + +## 对话界面 + +以下界面功能从 2.2.24 起可用。 + +### 在对话中选择上下文窗口 + +在输入区域打开模型选择菜单，进入所选模型的「上下文」子菜单，选择界面提供的档位。只有存在至少两个可选窗口大小时才会出现此入口；看不到该项不一定是配置错误。 + +「默认」使用模型配置的工作窗口；其它档位以界面显示的模型容量为界。选择按模型记在本机，切换回该模型时会沿用；重新选择「默认」可恢复默认预算。如果保存的档位已不再提供，会退回当前默认值。上下文用量显示随选择更新，后续请求使用相应预算；这不会改变服务商实际允许的容量，也不会还原已经压缩掉的原始历史。 + +### 引用文字和收起侧栏 + +选中对话记录中的文字，点击浮出的「添加到对话」，可把内容作为普通引用文本加入输入草稿，再补充问题并发送。2.2.24 中可以直接编辑或删除这些引用文本；添加引用本身不会发送消息。 + +点击左侧会话栏顶部的「收起侧栏」可给对话留出更多空间，再点「展开侧栏」恢复。展开或收起状态保存在本机，重新打开时会沿用。收起侧栏不会归档或删除对话，也不会停止后台任务；折叠会话分组时保留滚动位置。 + + + +## 2.2.25 新增与改进 + +:::note[适用范围] +本节能力已包含在 2.2.25 中。2.2.24 的引用仍是可直接编辑的普通文本；升级后可使用下面的独立引用块和其它改进。 +::: + +### 引用对话中的一段内容 + +在对话记录中选中需要追问的文字，点击浮出的「添加到对话」。选中文字会作为「所选文本」引用块加入输入区，原有草稿保留；点击引用块可展开检查，用旁边的移除按钮可删除单个引用。 + +可以连续加入多段引用，再输入问题并发送。添加引用不会立即发送消息或执行其中的操作；移除引用也不会删除原聊天记录。 + +### 手动压缩上下文 + +长对话中可单独发送 `/summarize`，把较旧的模型上下文整理成摘要后继续交谈。在空输入框键入 `/` 可打开命令补全，点击候选项或按 `Tab` / `Enter` 只补全命令，随后仍需发送。 + +发送时只保留该命令，不要附加问题、图片或引用块，否则会作为普通消息处理。压缩会保留界面中的聊天记录，并尽量保护最近消息和关键要求；它改变的是后续请求携带的上下文，不能保证每次都能进一步缩小。没有可安全压缩的旧消息时会给出提示；压缩失败或取消时保留原上下文，可按状态提示继续或重试。生成摘要会调用所选模型，可能产生相应的用量。 + +### 调整会话侧栏 + +侧栏展开时，拖动它与对话区之间的分隔线可调整宽度，双击分隔线恢复默认宽度；宽度也会记在本机。窗口变窄时会限制侧栏宽度，为对话保留空间。标题较长时，将鼠标停在对话标题上可滚动查看完整标题。 + +### 在动作设计器内检查 AI 修改 + +桌面动作设计器可从标题栏「AI」按钮或 `Ctrl+J` 打开助手面板。助手修改当前正在编辑的程序，完成后可通过改动标记和完成卡片定位修改，再决定是否保存或撤销。它与独立 AI 对话中的暂存副本写回流程不同，详见[动作编辑器中的 AI 助手](/v2/xaction/concepts/xaction-editor#设计器内的-ai-助手)。 + +### 命令批准和外部助手授权 + +命令确认卡片只有在本次命令支持记住同类批准时，才显示「批准同类」，并说明适用范围。多行脚本或不能归为可记住命令的内容仍需逐次确认；没有该按钮不表示命令执行失败。多行脚本的摘要会注明行数，确认前应查看实际内容。 + +外部助手的「已同意的 MCP 客户端」列表会显示程序路径，便于辨认和撤销授权。同一安装位置下，仅版本号目录变化的客户端升级可沿用已有同意；更换其它目录或程序文件名不能据此视为同一个客户端。客户端同意与「允许 MCP 写入」仍是分别控制的权限。 + +### 正式动作与暂存副本同时被修改 + +2.2.25 起，写回暂存编辑副本时会尝试保留原动作中不冲突的最新修改；有冲突时保留两份内容，并提供「让 AI 协助合并」。合并结果先存回草稿，检查和试运行后仍需本人确认写回。具体边界见[暂存副本冲突处理](/v2/features/action-panel/action-drafts#原动作已变化时处理冲突)。 + ## 当前功能边界 Agent 对话与外部助手设置已有用户入口，但不代表所有开发中的浏览器、桌面操控能力都已开放。“选网页元素”等仍受发布限制的入口，以当前软件界面为准。 @@ -122,3 +178,25 @@ Agent 对话与外部助手设置已有用户入口，但不代表所有开发 不要把 1.x 的手机遥控或 Android 局域网遥控当成 V2 已有能力。V2 已移除手机 App 遥控器，目前也没有承诺替代方案。见 [不再支持的功能](/v2/what's-new/not-supported.md)。 具体功能是否已经改用统一候选模型，以该功能自己的页面和软件界面为准。 + + + +## 对话中的保存撤销与输入草稿 + +以下功能从 2.2.26 起可用。同版修复了粘贴附件的导入问题，图片文字识别内容改为按需读取。 + +独立 AI 对话的聚合变更卡片新增「撤销」。一轮中多次保存同一动作时，可恢复到该轮第一次保存之前的内容；只有记录了完整快照、回合已结束且没有后续修改冲突时才能恢复。它与桌面设计器的「撤销本轮」是两个入口。 + +这里撤销的是卡片记录的程序内容保存，不会删除新建动作、改变场景位置，或撤回动作运行产生的文件、网络等结果。写回原动作后的撤销会恢复正式动作，但不会重建已被写回移除的暂存副本。涉及多个程序时可能只有部分恢复成功，应按卡片逐项结果处理，不能只凭点击过「撤销」就认为全部恢复。 + +新对话中尚未发送的文本和引用可在本机保留；同一工作区保留一个新对话草稿入口。重新打开后可继续编辑，发送前仍需检查引用和附件。输入草稿尚不是已发送的历史消息，也不会因为恢复输入框而自动发送。 + +## 开发版：设置与场景窗口中的 AI 助手 + +以下依据 2026-10-01 核对的开发代码，尚未包含在 2.2.26 中。 + +在「设置」或「场景、动作与触发管理」窗口中，点击标题栏的 AI 按钮，或按 `Ctrl+J`，可打开右侧助手。先配置 AI 服务与模型，再说明要查找的设置、目标场景和已有动作，例如「把主题改成深色」或「在 Chrome 场景为翻译动作设置快捷键」。场景窗口会提供当前场景、页签和部分选中项作为上下文；涉及继承规则时，仍要明确希望修改哪个场景。 + +助手可查找设置、修改已支持的设置项，并为已有动作配置支持的触发规则。回复中的设置或触发链接可打开相应页面，便于核对实际结果。部分列表或尚未支持直接修改的设置只提供页面入口，需要本人继续操作；手势绘制、轮盘布局以及动作程序编写也应到对应编辑器完成。 + +写入仍受当前审批方式、设置校验和账号权益限制。若当前页面有无效或无法提交的输入，请先修正，再发送请求。回合结束后检查变更记录与页面结果，并实际试用触发规则；这里尚不支持设计器那样的「撤销本轮」。如果手动编辑与助手修改发生冲突，请按提示重新读取和核对，不能仅凭助手回复认定全部保存成功。 diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md index 348885c..07a4a8e 100644 --- a/docs/v2/features/screenshot/capture-pro.md +++ b/docs/v2/features/screenshot/capture-pro.md @@ -95,6 +95,12 @@ comments: true 选区内没有可识别的码、或码被遮挡、模糊时，不会出现悬停提示；仍可确认截图后，在 [结果窗](#结果窗) 中查看二维码结果。 +#### 开发版：识别更多条码 + +2026-10-01 核对的开发版扩展了截图 Pro 与贴图的本地条码识别，尚未包含在 2.2.26 中。除二维码外，还支持 Code 128、EAN / UPC、Data Matrix、Aztec、PDF417 等常见格式，并改进竖向、反色和同图多个码的识别。悬停结果可查看或复制内容；只有有效的 HTTP / HTTPS 地址才提供打开链接。 + +选区内先显示快速预览；未出现提示并不一定代表图片中没有码。可缩小选区、提高图片清晰度，或先贴图，再从右键菜单执行「识别二维码 / 条形码」进行完整识别。完整扫描与快速预览的识别范围和耗时不同，结果仍需核对。本项说明针对截图与贴图界面，不改变「识别二维码」组合动作模块的参数定义。 + ### 自动吸附 步骤参数 **自动吸附**（默认关闭）决定悬停时是否主动下钻到更细的控件： @@ -158,6 +164,22 @@ comments: true 超长图贴图时会先适合当前屏幕并居中，必要时首次缩放可低于 10%，避免窗口超出工作区。 +#### 开发版：长截图自动滚动 + +以下依据 2026-10-01 核对的开发代码，尚未包含在 2.2.26 中。 + +选好范围并进入长截图后，点击工具栏的 **自动滚动**。纵向模式向下滚动，横向模式向右滚动；每次匹配完成后再继续下一次滚动。点击速度按钮可在 **0.5×～2×** 间调整，速度面板打开时暂停采集，关闭后继续。 + +点击 **停止自动滚动** 可切回手动滚动；需要暂停采集或移动选区时，使用 **暂停采集**。暂停、移动选区或进入编辑、导出会停止自动滚动。它不会替你自动滚回页面起点。 + +选区外的状态提示用于判断中断原因： + +- **页面没有继续移动**：可能已到末尾，也可能窗口不支持自动滚动。可手动滚动后继续，或检查结果后完成截图。 +- **找不到滚动窗口、窗口不可用或被遮挡**：先把鼠标放在目标内容上，并恢复页面，再开启自动滚动。 +- **拼接中断**：已拼接内容会保留。回滚到上一段后缓慢滚动，匹配恢复后可继续手动采集或重新开启自动滚动；需要丢弃本轮结果时再用「重来」。 + +自动滚动仍依赖页面能够滚动和相邻画面能够匹配。遇到动画、固定遮挡或异步加载内容，应放慢速度并检查拼接结果。 + ### 马赛克与智能马赛克 马赛克工具是一个**分裂按钮**：左侧主键执行当前模式，右侧箭头在「手动马赛克 / 智能马赛克」之间切换，并记住上次选择。 @@ -249,7 +271,7 @@ comments: true 说明： -- 步骤的 **写入剪贴板** 和 **截图后贴图** 只叠加到默认确认出口（双击、`Enter` 或工具栏确认）。 +- 步骤的 **写入剪贴板** 和 **截图后贴图** 可用于默认确认出口（双击、`Enter` 或工具栏确认）；2.2.25 起也支持「框选即出图」和快速保存。 - 界面内复制、保存、工具栏直接贴图，以及自定义工具栏的 `post.confirm` / `post.pin` 都按各自出口处理，不再额外触发上述两个步骤参数。因此勾选「写入剪贴板」后用保存结束，并不会顺带写入剪贴板；勾选「截图后贴图」后用复制或保存结束，也不会再弹贴图。 - 长截图、录屏、OCR、界面内复制 / 贴图等「另类出口」会在截图界面内完成对应操作；步骤仍可能带上可用的图片、区域或路径输出。 - 成功确认、复制、保存、OCR、直接贴图等操作默认会写入本机**截图历史**（可在采集历史中心查看）；取消、仅选录屏范围、长截图过程中的中间帧不会收录。 @@ -319,8 +341,8 @@ comments: true | --- | --- | --- | | 截图前延迟时间 | `0` | 开始截图前等待的毫秒数，便于先打开菜单或隐藏 Quicker 面板 | | 预选截图区域 | 空 | 2.2.19 起可填 `left,top,right,bottom` 物理像素坐标，右、下边界不包含；留空时手动选区。2.2.25 起手动截图与「框选即出图」等出口也可使用预选区域 | -| 写入剪贴板 | 关 | 仅默认确认出口结束时把图片写入剪贴板；复制、保存、直接贴图和自定义出口不叠加 | -| 截图后贴图 | 关 | 仅默认确认出口结束时自动贴图；复制、保存、直接贴图和自定义出口不叠加 | +| 写入剪贴板 | 关 | 默认确认出口结束时写入剪贴板；2.2.25 起也支持「框选即出图」和快速保存，其他出口见[模块说明](/v2/xaction/modules/screen-capture-pro#各操作的预选区域与完成后操作) | +| 截图后贴图 | 关 | 默认确认出口结束时贴图；2.2.25 起也支持「框选即出图」和快速保存，其他出口见[模块说明](/v2/xaction/modules/screen-capture-pro#各操作的预选区域与完成后操作) | | 贴图后显示工具栏 | 关（高级） | 贴图窗口打开后是否自动显示标注工具栏；关闭时仍可按空格显示 | | 自动吸附 | 关 | 是否在悬停时持续吸附到细控件；关闭时滚轮再触发精细选区 | | 自定义工具栏脚本 | 空 | 可选的 JS 脚本，默认只加自定义按钮（原工具栏保留）；写法见 [JS 自定义工具栏](./toolbar-script.md)。留空则使用默认工具栏；推荐外置为动作包内文件 | @@ -333,7 +355,7 @@ comments: true | 是否成功 | 步骤是否成功 | | 图片 | 截取图像 | | 截图区域 | `left,top,right,bottom` | -| 保存路径 | 用户保存到磁盘时的路径，否则为空 | +| 保存路径 | 用户保存到磁盘或快速保存成功后的路径，否则为空 | 同一时间只能进行一次截图 Pro；若已在截图中再次触发，会提示等待当前截图完成。 @@ -438,11 +460,11 @@ HTML、公式贴图缩放时先显示预览，停稳后按倍率重绘；复制 ### 截图后剪贴板没有图片 -检查是否在截图界面内使用了 `Ctrl+C` / 工具栏复制，或是否通过默认确认出口结束且步骤勾选了 **写入剪贴板**。保存、直接贴图和自定义出口不会叠加该参数；仅默认确认且未勾选时，图片只进入动作变量。 +检查是否使用了 `Ctrl+C` / 工具栏复制，或在当前操作支持时勾选了 **写入剪贴板**。2.2.25 起，「框选即出图」和快速保存也支持此选项；从工具栏保存、直接贴图或自定义出口结束时不再叠加。默认确认且未勾选时，图片只进入动作变量。 ### 保存后没有自动贴图 -这是预期行为：只有默认确认出口会叠加步骤侧的 **截图后贴图**。通过复制、保存、直接贴图或自定义出口结束时不会再打开第二个贴图窗口。需要同时保存和贴图时，可先用界面工具完成其中一项，或在后续步骤中处理输出图片。 +通过工具栏复制、保存、直接贴图或自定义出口结束时，不再额外叠加 **截图后贴图**。需要同时保存和贴图时，2.2.25 起可选择「快速保存」操作并勾选「截图后贴图」，再通过确认出口完成；也可在后续步骤中处理输出图片。 ### OCR 提示需要登录或下载 diff --git a/docs/v2/features/tools.md b/docs/v2/features/tools.md index 9858901..fe9723c 100644 --- a/docs/v2/features/tools.md +++ b/docs/v2/features/tools.md @@ -45,6 +45,23 @@ comments: true - [统一 AI 服务与模型设置](/v2/what's-new/ai-services-and-models.md)：服务连接、模型能力和用途优选 - [AI 与 Agent 现状](./ai-and-agent.md)：AI 写动作、外部助手连接及当前功能边界 + + +## 挑选上下文菜单的内容 + +以下功能从 2.2.26 起可用，用于处理文本、图片或文件内容的上下文菜单。 + +在设置中搜索「上下文菜单」，选择「菜单内容」下的文本、图片或文件页签。每类可分别控制内置功能组，并从「管理关联动作…」调整该类菜单的动作： + +| 模式 | 显示方式 | +| --- | --- | +| 自动显示 | 显示符合关联条件的动作，可隐藏个别动作并调整顺序；未排序的动作按标题排列，新安装且符合条件的动作可自动加入 | +| 手动挑选 | 只显示已挑选且符合本次内容条件的动作，按挑选顺序排列；新安装的动作不会自动出现 | + +列表支持拖动或用上下按钮排序，修改即时保存。隐藏或从挑选列表移除，只影响该类菜单中的显示，不会删除动作，也不会取消动作本身的关联。管理页列出的是候选动作，实际弹出时仍检查内容匹配条件；挑选了一个动作不代表它会对任意文字、图片或文件显示。 + +菜单底部的「设置…」入口由三类菜单共用开关控制；即使隐藏该入口，仍可从 Quicker 主设置页进入。若页面显示保存失败或只读原因，应先处理提示，不能把列表上的临时显示当成保存成功。 + ## 远程文件 - [远程文件](./remote-files.md)：配置 WebDAV 或 S3 账号，在动作中上传、下载、查询和批量传输文件 @@ -57,7 +74,7 @@ comments: true ### 上下文菜单 -2.2.26 起，可按 **文本**、**图片**、**文件** 分别调整系统上下文菜单中内置功能的显示与隐藏。通过 **管理关联动作**，可选择自动显示关联动作，或手动挑选并调整顺序。设置入口请在设置窗口用搜索查找「上下文菜单」或「关联动作」（分类位置随设置改版可能调整）。 +2.2.26 起，可分别管理文本、图片、文件菜单中的内置功能与关联动作，详见[挑选上下文菜单的内容](#挑选上下文菜单的内容)。 ### 自定义搜索引擎的导入导出 diff --git a/docs/v2/features/triggers/action-hotkeys.md b/docs/v2/features/triggers/action-hotkeys.md index bdcaaf3..d843eef 100644 --- a/docs/v2/features/triggers/action-hotkeys.md +++ b/docs/v2/features/triggers/action-hotkeys.md @@ -14,11 +14,11 @@ comments: true ## 快速开始 -1. 打开 **场景与动作管理 → 键盘触发 → 动作快捷键**。 +1. 打开 **场景、动作与触发管理 → 键盘触发 → 动作快捷键**（2.2.25 及更早版本名为「场景与动作管理」）。 2. 左侧选择要设置的场景：全局、普通程序、路径 / 标题 / 窗口类子场景、浏览器或网址。 3. 新增一条规则，录下组合键，并选择要执行的动作或操作。 4. 保存后，切到目标程序按下该组合键。 -5. 没有响应时，先在管理页点击 **刷新状态**，再检查是否与其它程序或 Quicker 功能快捷键冲突（**设置 → 快捷键查询 → 快捷键占用查询**）。 +5. 没有响应时，先在管理页点击 **刷新状态**，再检查是否与其它程序或 Quicker 功能快捷键冲突。2.2.25 起，在 **设置 → 功能快捷键** 页的相关功能中打开 **快捷键占用查询**，或直接搜索此名称；较早版本的入口在「设置 → 快捷键查询」。 规则归属于场景本身，不需要为每条普通场景规则重复填写进程名。原有全局规则仍保留进程白名单和黑名单，方便兼容旧配置；普通场景的编辑器会隐藏这些字段，以免与场景作用域重复。 @@ -69,7 +69,7 @@ Quicker 只为当前前台场景维护需要的系统快捷键，并按差异增 ## 限制与排障 -- **快捷键没有响应**：先在管理页查看状态和注册失败信息，再使用 **设置 → 快捷键查询 → 快捷键占用查询** 定位 Quicker 内已注册的键。 +- **快捷键没有响应**：先在管理页查看状态和注册失败信息，再使用设置中的 **快捷键占用查询** 定位 Quicker 内已注册的键，入口见上面的快速开始。 - **停用后全局同键仍不触发**：这是预期行为。本地同键规则全部停用不会回退上级；删除本地同键规则才会恢复继承。 - **切窗口后执行了上一个程序的动作**：确认已升级到会在触发时重新核对窗口和规则的版本，并检查桌面 / 任务栏 / 资源管理器是否被当成同一场景。 - **与功能快捷键或其它入口冲突**：动作快捷键、扩展热键、热键联动和系统快捷键不要占用同一组合。 diff --git a/docs/v2/features/triggers/circle-menu.md b/docs/v2/features/triggers/circle-menu.md index d7633f9..a93cdd8 100644 --- a/docs/v2/features/triggers/circle-menu.md +++ b/docs/v2/features/triggers/circle-menu.md @@ -10,13 +10,13 @@ comments: true 轮盘菜单把一组常用操作放在指针周围，通过方向和距离选择。适合鼠标不离开当前窗口、又希望「往某个方向一滑就执行」的场景。 -通常先通过 [高级鼠标触发](/v2/features/triggers/advanced-mouse-triggers) 进入轮盘会话（例如按住右键并移动，操作选 **显示轮盘菜单**）。圈层容量、可视子动作和场景来源在 **场景、动作与触发** 管理窗口里配置（2.2.26 起由原「场景与动作管理」更名）。 +通常先通过 [高级鼠标触发](/v2/features/triggers/advanced-mouse-triggers) 进入轮盘会话（例如按住右键并移动，操作选 **显示轮盘菜单**）。圈层容量、可视子动作和场景来源在 **场景、动作与触发管理** 里配置；此窗口从 2.2.26 起由「场景与动作管理」更名。 ## 快速开始 1. 确认 Quicker 在后台运行，并能弹出动作面板或其它触发入口。 -2. 打开 **场景、动作与触发**，在当前场景中编辑轮盘槽位：可把动作面板中的动作拖入空槽，或在轮盘打开时按下面的 `Ctrl+Shift` 快速添加。 -3. 如需从鼠标进入轮盘：打开 **场景、动作与触发 → 鼠标触发 → 高级鼠标触发**，新增一条划动或长按规则，操作选 **显示轮盘菜单**（按键以你本机设置为准，常见是右键）。 +2. 打开 **场景、动作与触发管理**，在当前场景中编辑轮盘槽位：可把动作面板中的动作拖入空槽，或在轮盘打开时按下面的 `Ctrl+Shift` 快速添加。 +3. 如需从鼠标进入轮盘：打开 **场景、动作与触发管理 → 鼠标触发 → 高级鼠标触发**，新增一条划动或长按规则，操作选 **显示轮盘菜单**（按键以你本机设置为准，常见是右键）。 4. 保存后，在目标程序中按配置的方式打开轮盘，把指针移向目标槽位并提交（滑动模式松开鼠标键，点击模式再点一次）。 5. 需要改圈层容量、指针放大或外观时，打开轮盘功能设置。 @@ -95,15 +95,19 @@ comments: true ::: -快速编辑适用于当前可见的常驻圈槽位。轮盘中心、圈间空白、传统扩展圈的空位置和可视子动作区域不会通过此方式创建动作。 +2.2.25 中，快速编辑适用于当前可见的常驻圈槽位。轮盘中心、圈间空白、传统扩展圈的空位置和可视子动作区域不会通过此方式创建动作。 在轮盘设置界面中，也可以通过右键菜单直接进入引用动作的编辑。 -## 按 F2 编辑指向的动作 + -2.2.26 起，轮盘显示时按 `F2`，可编辑鼠标当前指向的动作。该选项**默认开启**，可在轮盘设置中关闭。 +### 按 F2 编辑指向的动作 -已有 F2 子动作，以及 F2 重复触发相关设置优先于本开关：若指向项已绑定 F2 子动作或你配置了 F2 重复触发，会先按那些设置处理。 +2.2.26 起，轮盘设置新增「按 F2 编辑指向的动作」，默认开启，可按需要关闭。开启后，在轮盘显示期间指向目标位置，单独按一次 `F2` 即可收起轮盘并打开槽位编辑；不需要再按住 `Ctrl+Shift` 提交。常驻圈空槽可创建动作，已有动作按其实际所属场景编辑。 + +这一版也扩展了快速编辑的目标：传统扩展圈中已有的动作可以编辑；指向可视子动作时，打开父槽位编辑窗口并定位到相应子项。中心、圈间空白和扩展圈空位置不会因此创建动作。 + +如果当前动作已经给 `F2` 或任意键绑定了子动作，或将重复触发按键设为 `F2`，原有绑定优先。带 `Ctrl`、`Shift` 等修饰键的 `F2` 不作为这里的编辑快捷键；刚切换轮盘来源后，请先重新移动指针指向目标。 :::caution[回退旧版可能丢弃此开关] 回退到旧版后保存或同步轮盘设置，可能丢弃「按 F2 编辑指向的动作」开关；再次升级会恢复为默认开启。建议各设备升级后再调整，必要时重新关闭。详见[体验前必读](/important-notice#2226-轮盘-f2-编辑指向的动作)。 @@ -191,4 +195,4 @@ comments: true description: '用划动或长按启动轮盘会话', }, ]} -/> \ No newline at end of file +/> diff --git a/docs/v2/features/triggers/index.md b/docs/v2/features/triggers/index.md index fa5dd5b..4322bc0 100644 --- a/docs/v2/features/triggers/index.md +++ b/docs/v2/features/triggers/index.md @@ -10,7 +10,7 @@ comments: true 动作是「做什么」，触发是「什么时候、用什么输入把它跑起来」。同一个动作可以挂在面板、快捷键、手势、轮盘等多种入口上；从某个入口移除规则，不会删除动作本身。 -规则按**场景**生效：全局、当前程序、网址或子场景。更具体的场景可以覆盖或禁用上级规则。统一编辑入口在 **场景、动作与触发** 管理窗口（2.2.26 起更名）。 +规则按**场景**生效：全局、当前程序、网址或子场景。更具体的场景可以覆盖或禁用上级规则。统一编辑入口在 **场景、动作与触发管理**。 ```mermaid flowchart LR @@ -53,17 +53,27 @@ flowchart LR | 动作面板 | 弹出面板再点动作 | [开始使用](/v2/getting-started)、[新面板](/v2/features/action-panel/usage) | | 滚轮触发动作 | 在悬浮按钮等位置用滚轮连续调用 | [教程](/v2/xaction/guides/scroll-trigger) | -上表「使用说明」均指向本目录下的功能页。相对 1.x 的改进清单见各功能页中的「2.x 变化」链接。配置入口以软件里 **场景、动作与触发** 管理窗口为准（按键双击等少数项见各功能页，可能已迁入设置）。 +上表「使用说明」均指向本目录下的功能页。相对 1.x 的改进清单见各功能页中的「2.x 变化」链接。配置入口以软件里 **场景、动作与触发管理** 为准。 部分规则还可从设置中的「功能快捷键」入口进入，参见各功能页。 ## 统一管理与排障 -1. 打开标题栏「更多」→「场景与动作」（或设置里对应入口）。 +1. 打开标题栏「更多」→「场景、动作与触发」（或设置里对应入口）。 2. 左侧选场景，右侧按 **键盘触发** / **鼠标触发** 等标签编辑规则。 3. 误触发或场景不对时：看 **「更多」→「工具」→「动作运行与触发记录」→「触发记录」**（本次运行约 30 分钟内的记录），并可配合 **当前场景诊断**；2.1.23 起，切换窗口后高级鼠标、手势、轮盘等会更稳定地使用触发当时的程序和场景，历史记录中的规则、场景和操作摘要也更便于归因。 -4. 快捷键冲突：用 **设置 → 快捷键查询 → 快捷键占用查询** 定位 Quicker 内已注册的键。 +4. 快捷键冲突：2.2.25 起，在 **设置 → 功能快捷键** 页的相关功能中打开 **快捷键占用查询**，也可直接搜索此名称；较早版本的入口在「设置 → 快捷键查询」。 + +:::note[2.2.26 起的入口名称] +2.2.26 起，管理窗口更名为「场景、动作与触发管理」。设置中的规则管理入口会先打开全局场景；要修改特定程序或网址的规则，进入后再切换场景。此窗口与管理动作本体的「设置 → 动作 → 全部动作」是不同入口，名称变化不改变规则的继承和触发范围。 +::: 场景继承与禁用语义见 [场景与触发方式（V2 变化）](/v2/what's-new/scenes-and-triggers)。 +## 开发版：搜索操作类型 + +2026-10-01 核对的开发版在操作编辑器中增加了搜索和分类筛选，尚未包含在 2.2.26 中。点击操作类型按钮后，输入名称或拼音缩小候选范围，也可选择分类；用上下方向键选择，`Enter` 确认，`Esc` 取消。候选仍受当前编辑场景限制，搜索不会增加原本不可用的操作类型。 + +开发版还可在管理窗口内使用 [AI 助手配置设置和触发规则](/v2/features/ai-and-agent#开发版设置与场景窗口中的-ai-助手)。 + ## 相关链接 + +## 查找和修改设置 + +:::note[适用范围] +以下设置界面从 2.2.25 起可用；较早版本使用原有布局。 +::: + +设置窗口左侧改为树形导航，页面顶部显示所在路径。找不到原来的分类时，可在左上角搜索设置名称、关键词或拼音首字母，再从结果定位到相应设置项。部分原本只负责打开管理窗口的入口移到了相关页面的「相关功能」或「相关操作」区域；例如「动作快捷键管理」「热键联动管理」在「功能快捷键」页，也可以直接搜索这些名称。窗口较窄时，相关操作会移到页面顶部。 + +标有「修改后自动保存」的页面不需要再点整页保存。开关、下拉项确认后即保存；单行文本和数字可按 `Enter` 或移开输入焦点提交。还在编辑的单行输入可按 `Esc` 放弃本次草稿，但关闭窗口不会撤销已经保存的修改。保留独立保存按钮的页面仍按该页提示操作。 + +输入无效或保存失败时，先看该项下方的原因并修正；切页或关窗会尝试提交剩余输入，越界数字可能被调整到允许范围，仍无法保存的内容会提示「以下设置未保存」。能关闭窗口不代表所有输入都已保存，遇到该提示应回到对应项目检查。需要重启才能生效的选项会另有标记，自动保存不等于立即生效。 + +从 2.2.25 回退到 2.2.24 后，旧版保存本机状态可能清除 AI 侧栏宽度、开关和设置导航展开记录。这些界面偏好可重新设置，不影响动作内容；需要保留时，可先备份本机数据目录中的 `data/app-state.json`。 + + + +### 管理入口调整（2.2.26 起） + +2.2.26 起，「动作管理」与「公共子程序管理」并入设置中的「动作 → 全部动作」「动作 → 公共子程序」。它们管理动作本体或公共子程序；面板布局和按场景生效的触发规则仍在独立的「场景、动作与触发管理」窗口中。 + +该窗口由原「场景与动作管理」更名而来。「功能快捷键」页还提供动作快捷键、热键联动和按键双击的管理入口，打开时先定位全局场景；要设置特定程序或网址，进入后再选择对应场景。名称和入口变化不要求重新创建原有规则。 diff --git a/docs/v2/xaction/concepts/subprogram.md b/docs/v2/xaction/concepts/subprogram.md index 5185fde..45777a7 100644 --- a/docs/v2/xaction/concepts/subprogram.md +++ b/docs/v2/xaction/concepts/subprogram.md @@ -89,6 +89,18 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z" 公共或网络子程序也可从步骤右键转成动作内，以便改内部定义。列表上还能重命名、复制、建副本；复制后可到别的动作的子程序列表空白处粘贴。 +### 开发版：检查内嵌子程序的来源更新 + +以下依据 2026-10-01 核对的开发代码，尚未包含在 2.2.26 中。对于保留有效分享来源的动作内子程序，可在子程序列表中右键选择 **检查来源更新**。 + +1. 先保存正在编辑的子程序并返回主程序，结束调试或 AI 回合。 +2. 检查来源更新。发现新版后，核对确认框中的来源、版本、更新说明、步骤和变量数量，以及输入输出参数变化摘要。 +3. 确认后替换该子程序的正文，保留本地名称和身份。随后检查调用它的步骤，按需重新绑定参数，再试运行并保存动作。 + +更新会覆盖本地对正文的修改，不会自动合并；需要保留修改时，请取消并先创建副本。确认框只是变化摘要，不是完整逐步差异。应用后可在主程序中撤销或重做本次更新，调用步骤的参数不会自动改写。 + +没有有效来源、只读、受保护或使用服务器正文的子程序不能通过此入口覆盖更新；来源存在使用限制或缺少许可信息时也会拒绝。按提示登录、升级客户端或从子程序库重新导入。检查、下载失败或取消时不应用更新；等待期间如果目标内容或编辑状态已变化，需要重新检查。 + ## 公共子程序 本地所有动作都能用。标签页里可筛选、新建、编辑、分享到库、查找哪些动作在用、复制为动作内、高亮、删除。 diff --git a/docs/v2/xaction/concepts/xaction-editor.md b/docs/v2/xaction/concepts/xaction-editor.md index 420a5e3..7ccaeb1 100644 --- a/docs/v2/xaction/concepts/xaction-editor.md +++ b/docs/v2/xaction/concepts/xaction-editor.md @@ -34,11 +34,48 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z" ## 使用 AI 修改 -设计器内的程序助手可以根据要求修改当前程序。说明目标步骤、输入输出和需要保留的行为；如果涉及变量或子程序接口，也应说明相关调用如何调整。 +说明目标步骤、输入输出和需要保留的行为；如果涉及变量或子程序接口，也应说明相关调用如何调整。独立 AI 对话修改正式动作时使用暂存编辑副本，检查后需要 **写回原动作**，见[用 AI 编写和修改动作](/v2/features/ai-and-agent#用-ai-编写和修改动作)。 -助手成功修改后，结果会显示在设计器中。检查步骤和变量后，通过设计器的保存操作保存；显示了修改不代表已经保存，也不代表运行结果已经验证。按需要使用测试数据试运行或调试。 + -独立 AI 对话修改正式动作时，使用的是暂存编辑副本，需要检查后再 **写回原动作**。两种入口的区别和操作流程见 [用 AI 编写和修改动作](/v2/features/ai-and-agent#用-ai-编写和修改动作)。 +### 设计器内的 AI 助手 + +:::note[适用范围] +以下桌面动作设计器助手从 2.2.25 起可用；首次使用前，请先配置 AI 服务与模型。 +::: + +点击设计器标题栏的「AI」按钮，或按 `Ctrl+J`，打开右侧助手面板。说明要修改的行为和需要保留的部分；助手成功修改后，结果直接显示在当前编辑的步骤、变量和子程序中。检查后仍需保存动作，显示了修改或完成卡片不等于已经保存，也不代表已经运行验证。 + +本轮有程序改动时，对话末尾会显示改动数量。步骤列表用标记提示新增、修改或移动；折叠容器也会提示内部有改动。点击最新完成卡片的「在列表中查看」可定位修改，再次点击可查看下一处。标记是本窗口内的检查提示，关闭窗口后不会作为动作内容保存。 + +需要放弃最新一轮修改时，可使用「撤销本轮」。只有没有任务运行、设计器可编辑，且本轮结束后程序未再被修改时才能执行；如果之后又做过手动修改，卡片会说明原因，可用设计器的撤销功能逐步回退，避免一起覆盖后续修改。多次工具写入会归入本轮的一个撤销点。 + +收起助手面板不等于停止任务，需要中断时使用「停止」。保存后再用合适的测试数据试运行或调试。独立 AI 对话修改正式动作时使用暂存副本，与这里直接修改当前编辑内容的流程不同，见[AI 与 Agent](/v2/features/ai-and-agent)。 + + + +### 运行并分析 + +以下功能从 2.2.26 起可用。 + +在助手输入框写明预期结果和实际问题，点击旁边的「运行并分析」图标。也可从下拉菜单选择指定参数或最小化运行。它会**真实执行当前动作**并记录过程，结束后自动把运行记录和说明交给 AI 分析；准备测试数据时应考虑动作本身的文件修改、网络请求等操作。 + +「最近运行」卡片可查看结果、定位失败步骤、打开报告，或用「分析这次运行」重新分析已有记录；重新分析不会再次运行动作。运行后又改过程序时，旧记录会标为过期，失败步骤的位置也可能变化，应重新运行后再定位。AI 正在回答时不能同时发起这里的运行；「停止运行」和停止 AI 回答是两个独立操作。 + +输入区的上下文圆环用于查看当前对话的上下文占用，悬停可看用量。AI 的分析仍需结合预期结果判断；图片、窗口等视觉效果需要本人检查，修复后再次运行由本人发起。 + +### 开发版：助手斜杠命令 + +2026-10-01 核对的开发版为桌面助手增加输入框命令列表，尚未包含在 2.2.26 中。输入 `/` 后，可用方向键选择，按 `Enter` 或 `Tab` 执行；`Esc` 关闭列表。 + +| 命令 | 用途 | +| --- | --- | +| `/new` | 开始新对话；正在处理回合时不可用 | +| `/summarize` 或 `/compact` | 压缩较旧上下文，保留聊天记录；请等当前回合结束 | +| `/export` | 导出对话 | +| `/help` | 查看可用命令 | + +这组命令也用于开发版的设置与场景窗口助手。输入不认识的命令时，界面会提示；再次按 `Enter` 会把它作为普通消息发送。 ## 工具箱 diff --git a/docs/v2/xaction/index.md b/docs/v2/xaction/index.md index c50988b..424a438 100644 --- a/docs/v2/xaction/index.md +++ b/docs/v2/xaction/index.md @@ -18,7 +18,7 @@ hide_table_of_contents: true -**文件编码**：仅 **文本**。UTF8、UTF-16 LE / BE、ASCII、UTF7、UTF32、系统默认(gb2312)，或自动（BOM/UTF/ANSI）。默认 UTF8。 +**文件编码**：仅 **文本**。UTF8、UTF-16 LE / BE、ASCII、UTF7、UTF32、系统默认，或自动（BOM/UTF/ANSI）。默认 UTF8。“系统默认”取运行电脑的 Windows 默认代码页，不一定是 gb2312；读取来自其他电脑的文件时，应选择与文件实际编码一致的选项，或使用自动检测后检查结果。 **失败后停止**：读取失败是否中止动作。默认开启。 diff --git a/docs/v2/xaction/modules/files/writetextfile.md b/docs/v2/xaction/modules/files/writetextfile.md index 629cd6d..ad6b26c 100644 --- a/docs/v2/xaction/modules/files/writetextfile.md +++ b/docs/v2/xaction/modules/files/writetextfile.md @@ -31,7 +31,7 @@ legacyContentUpdatedAt: "2019-12-20T02:52:44.000Z" **文件路径**：目标文件的完整路径，必须包含文件名。 -**文件编码**：UTF8、UTF-16 LE / BE、ASCII、UTF7、UTF32，或系统默认(gb2312)。默认 UTF8。 +**文件编码**：UTF8、UTF-16 LE / BE、ASCII、UTF7、UTF32，或系统默认。默认 UTF8。“系统默认”取运行电脑的 Windows 默认代码页，不一定是 gb2312；需要在多台电脑间交换文件时，建议明确选择接收方支持的编码。 **添加UTF-BOM**：UTF-8 文件是否写入 BOM。默认关闭。 diff --git a/docs/v2/xaction/modules/flow/csscript.md b/docs/v2/xaction/modules/flow/csscript.md index b6821c7..a8f2409 100644 --- a/docs/v2/xaction/modules/flow/csscript.md +++ b/docs/v2/xaction/modules/flow/csscript.md @@ -126,6 +126,14 @@ context.SetVarValue("ready", true); "ok" ``` + + +### 获取已运行的 COM 对象 + +2.2.26 恢复了旧脚本中 `System.Runtime.InteropServices.Marshal.GetActiveObject("Excel.Application")` 这类调用的兼容支持。它获取已运行且已注册的 COM 对象，不会启动目标程序；找不到对象仍会报错，程序是否注册该对象以及双方权限是否一致仍会影响结果。 + +这项兼容针对 Quicker 的 C# 脚本宿主，不适用于「运行 C# 文件应用」或任意外部 .NET 程序。`using static Marshal` 后不带类型名的裸调用、通过反射查找该方法也不在兼容范围内。 + ### 何时仍应写完整 Exec 以下情况不会按「纯脚本」包装： diff --git a/docs/v2/xaction/modules/image/long-screenshot.md b/docs/v2/xaction/modules/image/long-screenshot.md index fce028c..19d99f0 100644 --- a/docs/v2/xaction/modules/image/long-screenshot.md +++ b/docs/v2/xaction/modules/image/long-screenshot.md @@ -42,6 +42,10 @@ metadataGeneratedAt: "2026-08-24 20:01:39" +## 开发版：自动滚动采集 + +2026-10-01 核对的开发版可在进入长截图后，从工具栏开启自动滚动、调节速度，并查看选区外的状态提示；尚未包含在 2.2.26 中。这些是采集界面操作，不是新增步骤参数。用法和中断处理见 [长截图自动滚动](/v2/features/screenshot/capture-pro#开发版长截图自动滚动)。 + ## 参数说明 **写入剪贴板**：结果是否同时写入剪贴板。默认开启。 diff --git a/docs/v2/xaction/modules/image/pinimage.md b/docs/v2/xaction/modules/image/pinimage.md index eb6ade1..a4b9cc3 100644 --- a/docs/v2/xaction/modules/image/pinimage.md +++ b/docs/v2/xaction/modules/image/pinimage.md @@ -31,4 +31,6 @@ metadataGeneratedAt: "2026-08-24 20:01:39" 2.2.19 起，步骤成功创建贴图后会输出 **窗口句柄**。可将它传给[窗口操作](/v2/xaction/modules/windowoperations)等后续步骤，精确操作本次新建的贴图，不必依赖窗口标题。贴图关闭后句柄失效，不要持久化后在下次运行中复用。 +2.2.23 起，贴图的系统窗口标题固定为 `QuickerPin`。按 `F2` 或右键选择「设置标题…」编辑的是**图片下方的显示标题**：`Enter` 保存，`Esc` 取消，清空后保存可移除显示标题。设置显示标题不会改变系统窗口标题；已有按图片标题查找窗口的动作，应改用本步骤输出的窗口句柄。 + 2.2.20 起，贴图窗口可按 `Y` 切换窗口阴影，右键菜单也把常用窗口状态操作提升到一级菜单；文字编辑时不会拦截 `Y`，`Ctrl+Y` 仍用于重做。详情见 [截图 Pro · 贴图窗口](/v2/features/screenshot/capture-pro#贴图窗口截图后)。 diff --git a/docs/v2/xaction/modules/image/screen-capture-pro.md b/docs/v2/xaction/modules/image/screen-capture-pro.md index 22c6736..dc708a6 100644 --- a/docs/v2/xaction/modules/image/screen-capture-pro.md +++ b/docs/v2/xaction/modules/image/screen-capture-pro.md @@ -60,7 +60,7 @@ metadataGeneratedAt: "2026-09-20 15:25:17" **截图前延迟时间**：等多少毫秒再进入截图。从面板或轮盘触发时，可垫一点延时，避免截到 Quicker 自己。 -**预选截图区域**（2.2.19 起）：填写物理屏幕坐标 `left,top,right,bottom`，右、下边界不包含在区域内。指定后跳过第一次手动框选，直接进入可调整和标注的截图状态；留空时仍正常手动选择。 +**预选截图区域**（2.2.19 起）：填写物理屏幕坐标 `left,top,right,bottom`，右、下边界不包含在区域内。在 2.2.19–2.2.24 中，仅“截图”和“快速保存”支持此参数；指定后跳过第一次手动框选，进入可调整和标注的截图状态。留空时仍正常手动选择。2.2.25 起对其他操作的支持见下文。 **写入剪贴板**：仅在默认确认出口（打勾、双击或 `Enter`）结束后，把结果写入剪贴板。复制出口本身会写剪贴板；保存、工具栏直接贴图以及自定义工具栏的 `post.confirm` / `post.pin` 不会再叠加此参数。默认关闭。 @@ -74,6 +74,16 @@ metadataGeneratedAt: "2026-09-20 15:25:17" **失败后停止**：失败或取消是否中止动作。默认开启。 + + +## 各操作的预选区域与完成后操作 + +以下行为需要 2.2.25 或更新版本；在 2.2.24 中，预选区域仍只适用于“截图”和“快速保存”。 + +“预选截图区域”扩展到所有操作。“截图”和“快速保存”仍先进入可调整、标注的状态；其他操作会直接在指定区域执行，不再等待手动框选。例如，选择“识别并复制”并填写 `100,100,500,300`，会识别该 400 × 200 物理像素区域，并在识别成功后复制文本。坐标格式无效会报错；留空仍走手动选区流程。 + +“写入剪贴板”和“截图后贴图”除普通“截图”外，也适用于“框选即出图”和“快速保存”。“框选即出图”在选区完成后应用这两个选项，“快速保存”在确认截图后应用；若改从工具栏的复制、保存、直接贴图或自定义出口结束，不会额外叠加这两个选项。具体可见参数以所选操作的模块定义为准。 + ## 输出 输出以所选“操作”的参数界面为准，下面列出常见截图输出。识别类操作按用途打开结果窗或复制文本；“识别并复制”在识别完成前取消时，不再写入剪贴板。 @@ -81,7 +91,7 @@ metadataGeneratedAt: "2026-09-20 15:25:17" - **是否成功**：是否完成截图。 - **图片**：截到的图。 - **截图区域**：格式 `left,top,right,bottom`。 -- **保存路径**：用户点保存并写入磁盘后的路径；用确认按钮结束时为空。 +- **保存路径**：用户点保存并写入磁盘后的路径，或“快速保存”成功后的自动保存路径；普通截图只用确认按钮结束时为空。 ## 相关步骤 diff --git a/docs/v2/xaction/modules/system/quickeroperations.md b/docs/v2/xaction/modules/system/quickeroperations.md index 0edc2db..1a662c9 100644 --- a/docs/v2/xaction/modules/system/quickeroperations.md +++ b/docs/v2/xaction/modules/system/quickeroperations.md @@ -152,9 +152,13 @@ legacyContentUpdatedAt: "2024-08-20T01:16:01.000Z" ![](./img/quickeroperations-010-79b445d8dc.png) -### 显示场景与动作管理窗口 + -打开场景与动作管理。需要时可填 **场景标识**，自动切到该场景。 +### 显示场景、动作与触发管理窗口 + +打开场景、动作与触发管理。需要时可填 **场景标识**，自动切到该场景。 + +2.2.26 起，此选项和窗口名称改为「显示场景、动作与触发管理窗口」，以说明这里也管理触发规则。操作标识和场景参数保持兼容，已有动作不需要重建；这与设置中的「全部动作」管理页不同。 + +记录按**打开或重新激活编辑器**的顺序计算，不按保存时间或运行动作的时间计算。普通动作编辑器与「外观与关联」编辑器均计入；关闭编辑器或取消编辑仍保留记录；预览、只读编辑、暂存草稿、未安装动作和公共子程序不计入。查询会跳过已删除或不属于当前账号的动作，也不会改变编辑记录、运行历史或动作保存时间。 + +记录只保留本次启动 Quicker 期间最近打开的最多 30 个不同动作，重启后清空；如果最后编辑的是查询工具自身，也会返回它自身的 ID。没有可用记录时，动作 ID 为空且步骤失败。需要自行提示时，可关闭本步骤的「失败后停止」，检查「步骤是否成功」后再决定是否打开编辑器。 + ### 重启Quicker / 退出Quicker **重启Quicker**：重启软件。 @@ -324,19 +344,6 @@ legacyContentUpdatedAt: "2024-08-20T01:16:01.000Z" 按动作 ID 读取动作信息。此时 **动作ID或名称** 只能填动作 ID，不能填名称。 -### 获取最后打开编辑器的动作 - -2.2.24 起可用。读取**本次启动 Quicker 期间**最后打开或重新激活编辑器的已安装动作 ID，方便从别处（例如 AI 回答）复制代码或表达式后，回到刚才编辑的动作继续改。 - -- 只看本进程内的编辑访问记录，不按动作保存时间排序；执行本操作不会改动记录、运行历史或动作保存时间。 -- 包含普通动作编辑器与「外观与关联」编辑器；排除预览、只读编辑、独立草稿、尚未安装的动作和公共子程序。 -- 最近编辑的是本查询所在动作时，仍返回该动作 ID（没有「排除当前动作」开关）。 -- 重启 Quicker 后记录为空。没有可用记录时，步骤按现有失败机制处理，并清空动作 ID 输出。 - -常见用法：先执行本操作把动作 ID 存入文本变量，步骤成功后再用 **编辑动作**，把该变量填进「动作ID或名称」。 - -含此操作类型的动作需要 **2.2.24 或更高版本**客户端；旧版无法识别。参数页会在 `data/xaction` 同步后再更新；完整条目见[官网版本记录](https://getquicker.net/V2/Versions)。 - ## 输出 - **步骤是否成功**：本步是否完成。 diff --git a/docs/v2/xaction/modules/ui/custompanel.md b/docs/v2/xaction/modules/ui/custompanel.md index ff48b57..5bcedba 100644 --- a/docs/v2/xaction/modules/ui/custompanel.md +++ b/docs/v2/xaction/modules/ui/custompanel.md @@ -37,6 +37,16 @@ legacyContentUpdatedAt: "2025-12-23T08:07:51.000Z" 显示后立刻继续后面的步骤。下面参数仅「显示操作窗」「显示操作窗并等待关闭」时出现（**窗口标识**、**失败后停止** 例外）。 +### 可视化设计布局 + +Quicker 2.2.24 起可用。 + +在步骤编辑器中选择「显示操作窗」或「显示操作窗并等待关闭」，填写固定的操作项定义后，点击顶部「设计」。左侧可编辑操作项和分组，右侧预览按钮布局；预览中的按钮不会执行实际操作。可在设计窗中调整列数、分组方式等布局设置。 + +设计窗确认后，仅本次改动且非动态的参数会回填到步骤编辑器，还需保存步骤并保存动作；步骤保存后可通过设计器撤销。取消设计窗不会回填；回填后若取消步骤编辑，也会丢弃这次修改。运行中的操作窗没有布局编辑或保存入口。 + +如果「操作项定义」由变量或表达式生成，「设计」会禁用并说明原因，应继续编辑产生该数据的步骤。其它由变量或表达式控制的布局项不能在设计窗中改成固定值；只读动作可以查看预览，不能保存修改。 + ### 操作项定义 **操作项定义**：窗上按钮及其行为。格式大体与 [显示菜单](/v2/xaction/modules/showmenu) 的菜单数据相同，差别： @@ -189,11 +199,7 @@ $=new CommonOperationItem(){ #### 可视化设计窗 -2.2.24 起，步骤编辑窗口顶部的 **设计** 按钮可打开可视化设计窗：左侧编辑操作项树（按钮、分组、下拉项），右侧用与运行时相同的渲染器实时预览，顶部可调布局相关参数。确认后只回填本次改动且非动态的参数，由步骤编辑器保存并进入撤销栈。 - -:::warning[动态定义时不可用] -当「操作项定义」等使用变量或表达式时，不能使用可视化设计窗（入口会禁用）。请先改为静态缩进文本或 JSON，再用设计窗。 -::: +使用步骤编辑窗口顶部的「设计」按钮调整操作项树和布局，操作流程与动态定义限制见[可视化设计布局](#可视化设计布局)。 ### 默认Operation diff --git a/docs/v2/xaction/modules/ui/reactui.md b/docs/v2/xaction/modules/ui/reactui.md index 02a7d7b..4223d34 100644 --- a/docs/v2/xaction/modules/ui/reactui.md +++ b/docs/v2/xaction/modules/ui/reactui.md @@ -163,6 +163,33 @@ import { Button, Panel } from "QuickerUi"; 外层建议使用 `
`，以便与窗口边距、主题一致。 +### 代码与文本对比 + +:::note[适用范围] +`CodeDiff` 需要 Quicker 2.2.23 或更新版本。旧版缺少该导出时，请先升级再运行使用它的动作。 +::: + +从 `QuickerUi` 导入 `CodeDiff`，用 `before` 和 `after` 传入修改前后的文本。默认并排显示，也可在界面切换为合并视图；对象和数组会以 JSON 文本展示。适合让用户检查 AI 改写结果、配置差异或代码修改。 + +例如，让上游步骤把两份文本放在 **输入数据** 的 `before`、`after` 字段中： + +```tsx +import Quicker from "Quicker"; +import { Button, CodeDiff, Panel } from "QuickerUi"; + +export default function App() { + const input = Quicker.getInput<{ before?: string; after?: string }>() ?? {}; + return ( + + + + + ); +} +``` + +这个界面只展示差异，并在点击按钮后返回 `accepted: true`；是否保存文本或修改文件，由后续步骤处理。未变化的长段落会折叠，可展开查看；超长文本只对比前 4000 行，差异过大时部分区段会按整段增删展示，因此不要把截断后的展示当作完整文件检查。 + ### 草稿 storage 示例 若希望用户上次填写的名称在**同一动作**下次运行时仍保留，可用 `useQuickerStorage`： diff --git a/docs/v2/xaction/modules/ui/webview2.md b/docs/v2/xaction/modules/ui/webview2.md index 0259a6b..938ca74 100644 --- a/docs/v2/xaction/modules/ui/webview2.md +++ b/docs/v2/xaction/modules/ui/webview2.md @@ -125,7 +125,13 @@ window.chrome.webview.addEventListener('message', event => ### 多标签 / 多列 -这两种布局方便同时打开一组相关网页，没有和动作其它部分交互的能力，参数也相同。 +这两种布局方便同时打开一组相关网页，参数相同，不提供普通单页窗口的消息和脚本交互能力。 + +:::note[开发版的关闭与等待修复] +2026-10-01 核对的开发版支持用「关闭窗口(如果尚未关闭)」关闭相同窗口标识的多标签、多列窗口；尚未包含在 2.2.26 中。打开与关闭步骤应填写相同标识；如果有多个同标识的此类窗口，会一并关闭。此改进不增加向多标签、多列窗口发送消息或执行脚本的能力。 + +同一开发版中，普通网页使用「打开网页并等待加载完成」时，如果加载结束前关窗，步骤会报告「网页窗口已关闭，无法等待加载完成」，避免一直等待。请按「失败后停止」和动作的错误处理方式处理，不能把提前关闭当作加载成功。 +::: **多标签**：适合用多个搜索引擎搜同一个词。