From ad47e19d78671eb7ff6baf7d129ad81305b1160a Mon Sep 17 00:00:00 2001 From: Cea <61349137+ceastld@users.noreply.github.com> Date: Sat, 3 Oct 2026 06:45:30 -0700 Subject: [PATCH] =?UTF-8?q?docs(docs):=20=E5=8F=91=E5=B8=83=E5=A2=9E?= =?UTF-8?q?=E9=87=8F=E8=AF=B4=E6=98=8E=E4=B8=8E=E6=A8=A1=E5=9D=97=E5=8F=82?= =?UTF-8?q?=E6=95=B0=E6=A0=A1=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- data/xaction/catalog.json | 17 +- data/xaction/changes.json | 628 ++++++------------ data/xaction/modules/sys_audioControl.json | 4 +- data/xaction/modules/sys_pdf.json | 1 + data/xaction/modules/sys_smtp.json | 10 +- docs/release-notes/index.md | 2 +- .../v2/features/action-panel/action-drafts.md | 34 +- docs/v2/features/action-sharing.md | 6 + docs/v2/features/ai-and-agent.md | 30 + docs/v2/features/screenshot/capture-pro.md | 24 +- docs/v2/features/tools.md | 10 + docs/v2/features/triggers/index.md | 12 +- docs/v2/features/triggers/powerkeys.md | 1 + docs/v2/xaction/index.md | 2 +- docs/v2/xaction/modules/files/pdf.md | 8 + .../xaction/modules/image/long-screenshot.md | 6 +- docs/v2/xaction/modules/network/smtp.md | 10 +- .../v2/xaction/modules/system/audiocontrol.md | 6 +- 18 files changed, 368 insertions(+), 443 deletions(-) diff --git a/data/xaction/catalog.json b/data/xaction/catalog.json index 45511a7..5582e16 100644 --- a/data/xaction/catalog.json +++ b/data/xaction/catalog.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "generatedAt": "2026-09-30 06:04:10", + "generatedAt": "2026-10-02 06:19:26", "moduleCount": 175, "legacyMappedModuleCount": 0, "migratedLegacyModuleCount": 0, @@ -9245,6 +9245,7 @@ "key": "text", "name": "文字", "type": "Text", + "description": "要绘制的文字。支持占位符 {page}（该页在整个文档中的页码，从 1 开始）和 {pages}（整个文档的总页数，不受 pages 页码范围影响），不区分大小写，如“第{page}页/共{pages}页”。页码操作留空时为 {page}；叠加文字与水印不能为空。", "validForList": [ "overlayText", "watermark", @@ -18150,7 +18151,7 @@ "key": "useSsl", "name": "使用加密连接", "type": "Boolean", - "description": "是否使用TLS连接（通常为587端口）。", + "description": "是否使用TLS加密连接。采用 STARTTLS（先明文连接再升级加密，通常为587端口，部分服务器为25端口）；不支持465端口的隐式SSL连接。", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "UseVarOrInput" @@ -18195,7 +18196,7 @@ "key": "to", "name": "收件人", "type": "Text", - "description": "收件人Email地址，多个的话使用小写逗号分隔。", + "description": "收件人Email地址，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" @@ -18204,7 +18205,7 @@ "key": "cc", "name": "抄送", "type": "Text", - "description": "抄送给的Email地址列表，多个的话使用小写逗号分隔。", + "description": "抄送给的Email地址列表，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" @@ -18213,7 +18214,7 @@ "key": "bcc", "name": "密送", "type": "Text", - "description": "密送给的Email地址列表，多个的话使用小写逗号分隔。", + "description": "密送给的Email地址列表，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" @@ -18239,7 +18240,7 @@ "key": "attachList", "name": "附件", "type": "Text", - "description": "附件文件列表。多个时每行一个。", + "description": "附件文件路径列表。多个时每行一个（按换行拆分），文件不存在时步骤失败。", "defaultValue": "", "variableMode": "UseVarOrInput" }, @@ -39818,7 +39819,7 @@ "key": "deviceList", "name": "设备信息列表", "type": "List", - "description": "每项的格式为:[图标]名称(注释)|设备ID", + "description": "每项的格式为:[icon:图标路径]设备名称(状态: …, ID: …)|设备ID。取设备ID时按最后一个“|”拆分，取其后的部分。", "validForList": [ "GetOutputDeviceList", "GetInputDeviceList" @@ -39883,6 +39884,7 @@ "key": "volume", "name": "设置音量", "type": "Number", + "description": "设备当前主音量，0–1 之间的小数（0.5 表示 50%），不是 0–100。", "validForList": [ "GetOutputDefaultDevice", "GetInputDefaultDevice", @@ -39894,6 +39896,7 @@ "key": "masterPeakValue", "name": "实时音量", "type": "Number", + "description": "设备当前的峰值电平，0–1 之间的小数。", "validForList": [ "GetOutputDefaultDevice", "GetInputDefaultDevice", diff --git a/data/xaction/changes.json b/data/xaction/changes.json index b44e6a6..e98741d 100644 --- a/data/xaction/changes.json +++ b/data/xaction/changes.json @@ -1,91 +1,173 @@ { "schemaVersion": 1, "baselineCreated": false, - "fromGeneratedAt": "2026-09-29 15:21:29", - "toGeneratedAt": "2026-09-30 06:04:10", + "fromGeneratedAt": "2026-09-30 06:04:10", + "toGeneratedAt": "2026-10-02 06:19:26", "summary": { "addedModules": 0, "removedModules": 0, - "changedModules": 1 + "changedModules": 3 }, "addedModules": [], "removedModules": [], "changedModules": [ { - "key": "sys:quickeroperations", - "name": "Quicker操作", + "key": "sys:pdf", + "name": "PDF 文件处理", "changedFields": [], "inputs": { "added": [], "removed": [], "changed": [ { - "key": "profileId", + "key": "text", "before": { - "key": "profileId", - "name": "动作页ID", + "key": "text", + "name": "文字", "type": "Text", - "description": "请在场景与动作管理中，查看动作页信息获取ID。", "validForList": [ - "loadProfile" + "overlayText", + "watermark", + "pageNumber" ], - "condition": "仅：loadProfile", + "condition": "仅：overlayText, watermark, pageNumber", "defaultValue": "", - "required": true, "variableMode": "UseVarOrInput" }, "after": { - "key": "profileId", - "name": "动作页ID", + "key": "text", + "name": "文字", "type": "Text", - "description": "请在场景、动作与触发管理中，查看动作页信息获取ID。", + "description": "要绘制的文字。支持占位符 {page}（该页在整个文档中的页码，从 1 开始）和 {pages}（整个文档的总页数，不受 pages 页码范围影响），不区分大小写，如“第{page}页/共{pages}页”。页码操作留空时为 {page}；叠加文字与水印不能为空。", "validForList": [ - "loadProfile" + "overlayText", + "watermark", + "pageNumber" ], - "condition": "仅：loadProfile", + "condition": "仅：overlayText, watermark, pageNumber", + "defaultValue": "", + "variableMode": "UseVarOrInput" + } + } + ] + }, + "outputs": { + "added": [], + "removed": [], + "changed": [] + }, + "selectionsChanged": false + }, + { + "key": "sys:smtp", + "name": "SMTP发送邮件", + "changedFields": [], + "inputs": { + "added": [], + "removed": [], + "changed": [ + { + "key": "useSsl", + "before": { + "key": "useSsl", + "name": "使用加密连接", + "type": "Boolean", + "description": "是否使用TLS连接（通常为587端口）。", + "defaultValue": "false", + "defaultValueRaw": false, + "variableMode": "UseVarOrInput" + }, + "after": { + "key": "useSsl", + "name": "使用加密连接", + "type": "Boolean", + "description": "是否使用TLS加密连接。采用 STARTTLS（先明文连接再升级加密，通常为587端口，部分服务器为25端口）；不支持465端口的隐式SSL连接。", + "defaultValue": "false", + "defaultValueRaw": false, + "variableMode": "UseVarOrInput" + } + }, + { + "key": "to", + "before": { + "key": "to", + "name": "收件人", + "type": "Text", + "description": "收件人Email地址，多个的话使用小写逗号分隔。", + "defaultValue": "", + "required": true, + "variableMode": "UseVarOrInput" + }, + "after": { + "key": "to", + "name": "收件人", + "type": "Text", + "description": "收件人Email地址，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" } }, { - "key": "exe", + "key": "cc", "before": { - "key": "exe", - "name": "场景标识", + "key": "cc", + "name": "抄送", "type": "Text", - "description": "场景关联的exe文件名。请参考场景与动作管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", - "validForList": [ - "showCircleMenu", - "showDashboardWindow", - "showExeSettingWindow", - "loadExeProfiles", - "loadExeProfilesNoLock", - "GetActionList" - ], - "condition": "仅：showCircleMenu, showDashboardWindow, showExeSettingWindow, loadExeProfiles, loadExeProfilesNoLock, GetActionList", + "description": "抄送给的Email地址列表，多个的话使用小写逗号分隔。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" }, "after": { - "key": "exe", - "name": "场景标识", + "key": "cc", + "name": "抄送", "type": "Text", - "description": "场景关联的exe文件名。请参考场景、动作与触发管理窗口左侧应用列表；打开轮盘或场景管理时可填写 _curr 表示当前程序场景。", - "validForList": [ - "showCircleMenu", - "showDashboardWindow", - "showExeSettingWindow", - "loadExeProfiles", - "loadExeProfilesNoLock", - "GetActionList" - ], - "condition": "仅：showCircleMenu, showDashboardWindow, showExeSettingWindow, loadExeProfiles, loadExeProfilesNoLock, GetActionList", + "description": "抄送给的Email地址列表，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" } + }, + { + "key": "bcc", + "before": { + "key": "bcc", + "name": "密送", + "type": "Text", + "description": "密送给的Email地址列表，多个的话使用小写逗号分隔。", + "defaultValue": "", + "required": true, + "variableMode": "UseVarOrInput" + }, + "after": { + "key": "bcc", + "name": "密送", + "type": "Text", + "description": "密送给的Email地址列表，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", + "defaultValue": "", + "required": true, + "variableMode": "UseVarOrInput" + } + }, + { + "key": "attachList", + "before": { + "key": "attachList", + "name": "附件", + "type": "Text", + "description": "附件文件列表。多个时每行一个。", + "defaultValue": "", + "variableMode": "UseVarOrInput" + }, + "after": { + "key": "attachList", + "name": "附件", + "type": "Text", + "description": "附件文件路径列表。多个时每行一个（按换行拆分），文件不存在时步骤失败。", + "defaultValue": "", + "variableMode": "UseVarOrInput" + } } ] }, @@ -94,379 +176,101 @@ "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": "获取最后打开编辑器的动作" - } - ] + "selectionsChanged": false + }, + { + "key": "sys:audioControl", + "name": "音频设备", + "changedFields": [], + "inputs": { + "added": [], + "removed": [], + "changed": [] + }, + "outputs": { + "added": [], + "removed": [], + "changed": [ + { + "key": "deviceList", + "before": { + "key": "deviceList", + "name": "设备信息列表", + "type": "List", + "description": "每项的格式为:[图标]名称(注释)|设备ID", + "validForList": [ + "GetOutputDeviceList", + "GetInputDeviceList" + ], + "condition": "仅：GetOutputDeviceList, GetInputDeviceList" + }, + "after": { + "key": "deviceList", + "name": "设备信息列表", + "type": "List", + "description": "每项的格式为:[icon:图标路径]设备名称(状态: …, ID: …)|设备ID。取设备ID时按最后一个“|”拆分，取其后的部分。", + "validForList": [ + "GetOutputDeviceList", + "GetInputDeviceList" + ], + "condition": "仅：GetOutputDeviceList, GetInputDeviceList" + } }, - "theme": { - "name": "主题模式", - "items": [ - { - "value": "", - "name": "不改变" - }, - { - "value": "auto", - "name": "跟随Windows" - }, - { - "value": "light", - "name": "浅色" - }, - { - "value": "dark", - "name": "暗色" - }, - { - "value": "toggle", - "name": "切换浅色和暗色" - } - ] + { + "key": "volume", + "before": { + "key": "volume", + "name": "设置音量", + "type": "Number", + "validForList": [ + "GetOutputDefaultDevice", + "GetInputDefaultDevice", + "GetDeviceById" + ], + "condition": "仅：GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById" + }, + "after": { + "key": "volume", + "name": "设置音量", + "type": "Number", + "description": "设备当前主音量，0–1 之间的小数（0.5 表示 50%），不是 0–100。", + "validForList": [ + "GetOutputDefaultDevice", + "GetInputDefaultDevice", + "GetDeviceById" + ], + "condition": "仅：GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById" + } }, - "viewMode": { - "name": "显示状态", - "items": [ - { - "value": "HideAll", - "name": "隐藏全部" - }, - { - "value": "ByProcess", - "name": "自动(按关联进程切换)" - }, - { - "value": "ShowAll", - "name": "显示全部" - }, - { - "value": "ToggleHideAndAuto", - "name": "切换隐藏和自动" - } - ] + { + "key": "masterPeakValue", + "before": { + "key": "masterPeakValue", + "name": "实时音量", + "type": "Number", + "validForList": [ + "GetOutputDefaultDevice", + "GetInputDefaultDevice", + "GetDeviceById" + ], + "condition": "仅：GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById" + }, + "after": { + "key": "masterPeakValue", + "name": "实时音量", + "type": "Number", + "description": "设备当前的峰值电平，0–1 之间的小数。", + "validForList": [ + "GetOutputDefaultDevice", + "GetInputDefaultDevice", + "GetDeviceById" + ], + "condition": "仅：GetOutputDefaultDevice, GetInputDefaultDevice, GetDeviceById" + } } - } - } + ] + }, + "selectionsChanged": false } ] } diff --git a/data/xaction/modules/sys_audioControl.json b/data/xaction/modules/sys_audioControl.json index c47738c..83e1795 100644 --- a/data/xaction/modules/sys_audioControl.json +++ b/data/xaction/modules/sys_audioControl.json @@ -108,7 +108,7 @@ "key": "deviceList", "name": "设备信息列表", "type": "List", - "description": "每项的格式为:[图标]名称(注释)|设备ID", + "description": "每项的格式为:[icon:图标路径]设备名称(状态: …, ID: …)|设备ID。取设备ID时按最后一个“|”拆分，取其后的部分。", "validForList": [ "GetOutputDeviceList", "GetInputDeviceList" @@ -173,6 +173,7 @@ "key": "volume", "name": "设置音量", "type": "Number", + "description": "设备当前主音量，0–1 之间的小数（0.5 表示 50%），不是 0–100。", "validForList": [ "GetOutputDefaultDevice", "GetInputDefaultDevice", @@ -184,6 +185,7 @@ "key": "masterPeakValue", "name": "实时音量", "type": "Number", + "description": "设备当前的峰值电平，0–1 之间的小数。", "validForList": [ "GetOutputDefaultDevice", "GetInputDefaultDevice", diff --git a/data/xaction/modules/sys_pdf.json b/data/xaction/modules/sys_pdf.json index c1b2452..5073f18 100644 --- a/data/xaction/modules/sys_pdf.json +++ b/data/xaction/modules/sys_pdf.json @@ -482,6 +482,7 @@ "key": "text", "name": "文字", "type": "Text", + "description": "要绘制的文字。支持占位符 {page}（该页在整个文档中的页码，从 1 开始）和 {pages}（整个文档的总页数，不受 pages 页码范围影响），不区分大小写，如“第{page}页/共{pages}页”。页码操作留空时为 {page}；叠加文字与水印不能为空。", "validForList": [ "overlayText", "watermark", diff --git a/data/xaction/modules/sys_smtp.json b/data/xaction/modules/sys_smtp.json index 4337f7e..90d68ab 100644 --- a/data/xaction/modules/sys_smtp.json +++ b/data/xaction/modules/sys_smtp.json @@ -33,7 +33,7 @@ "key": "useSsl", "name": "使用加密连接", "type": "Boolean", - "description": "是否使用TLS连接（通常为587端口）。", + "description": "是否使用TLS加密连接。采用 STARTTLS（先明文连接再升级加密，通常为587端口，部分服务器为25端口）；不支持465端口的隐式SSL连接。", "defaultValue": "false", "defaultValueRaw": false, "variableMode": "UseVarOrInput" @@ -78,7 +78,7 @@ "key": "to", "name": "收件人", "type": "Text", - "description": "收件人Email地址，多个的话使用小写逗号分隔。", + "description": "收件人Email地址，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" @@ -87,7 +87,7 @@ "key": "cc", "name": "抄送", "type": "Text", - "description": "抄送给的Email地址列表，多个的话使用小写逗号分隔。", + "description": "抄送给的Email地址列表，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" @@ -96,7 +96,7 @@ "key": "bcc", "name": "密送", "type": "Text", - "description": "密送给的Email地址列表，多个的话使用小写逗号分隔。", + "description": "密送给的Email地址列表，多个的话使用英文逗号（,）分隔，不支持分号或中文逗号。", "defaultValue": "", "required": true, "variableMode": "UseVarOrInput" @@ -122,7 +122,7 @@ "key": "attachList", "name": "附件", "type": "Text", - "description": "附件文件列表。多个时每行一个。", + "description": "附件文件路径列表。多个时每行一个（按换行拆分），文件不存在时步骤失败。", "defaultValue": "", "variableMode": "UseVarOrInput" }, diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md index 659950e..2397709 100644 --- a/docs/release-notes/index.md +++ b/docs/release-notes/index.md @@ -167,7 +167,7 @@ comments: true ### 2.2.6 · 悬浮动作与分组 - 补充[悬浮动作与分组](/v2/features/floating-actions)：整组缩放、窗口跟随、自动折叠和布局备份。功能默认关闭，启用后需要重启。 -- 补充[截图选区悬停识别二维码](/v2/features/screenshot/capture-pro#选区二维码)、[Mastercam 软件连接](/v2/features/software-connections/software/mastercam)、动作编辑器优先显示收藏夹，以及[作者重装恢复原标识、复制切断分享关系](/v2/features/action-sharing#安装标识与副本)。 +- 补充[截图选区悬停识别二维码](/v2/features/screenshot/capture-pro#二维码与条形码)、[Mastercam 软件连接](/v2/features/software-connections/software/mastercam)、动作编辑器优先显示收藏夹，以及[作者重装恢复原标识、复制切断分享关系](/v2/features/action-sharing#安装标识与副本)。 ### 2.2.5 · 连接管理与贴图 diff --git a/docs/v2/features/action-panel/action-drafts.md b/docs/v2/features/action-panel/action-drafts.md index 1318dda..45d9c5f 100644 --- a/docs/v2/features/action-panel/action-drafts.md +++ b/docs/v2/features/action-panel/action-drafts.md @@ -20,9 +20,18 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位 2.2.0 起，暂存区顶部提供 **新建动作** 和 **用 AI 写**。用 AI 写出的动作会先进入暂存区预览；AI 创建或修改暂存动作后，暂存区会自动刷新。该功能仍在改进中，生成内容需要人工检查、试运行和调试。 -如果剪贴板中是 Quicker 分享动作链接，点击暂存区右上角的 **＋**，菜单会同时显示「创建动作」和「安装动作（动作名）」。选择安装后仍会显示正常的动作确认信息，确认完成后动作直接进入暂存区，不会先注册为正式动作。 +在 2.3.0 中，如果剪贴板中是 Quicker 分享动作链接，点击暂存区右上角的 **＋**，菜单会同时显示「创建动作」和「安装剪贴板中的分享动作」。选择安装后仍会显示正常的动作确认信息，确认完成后动作直接进入暂存区，不会先注册为正式动作。 -剪贴板不是有效分享链接、链接读取失败或动作要求更高版本时，不会提供可安装项；可以继续选择「创建动作」。 +剪贴板不是有效分享链接时，不会提供安装项。链接无法读取或动作要求更高版本时，安装不能继续；可以改为创建本机动作。 + +:::note[开发版变化] +以下行为已在开发版实现，尚未包含在官网当前提供的 **2.3.0** 中： + +- 点击 **＋** 后，先选择「创建组合动作」或「创建脚本动作」，再进入对应编辑器；没有分享链接时也会显示这两个选项。剪贴板有有效分享链接时，菜单还会提供「安装剪贴板中的分享动作」。 +- 从暂存区启动运行或调试时，会先收起主面板，再运行最近保存的内容，便于操作目标软件。 + +创建与试运行仍只使用本机暂存项，不会因此加入正式动作库或开启云同步。 +::: ## 可以对暂存动作做什么 @@ -39,6 +48,25 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位 暂存动作保存时会建立本机版本记录。需要撤销较大的修改时，可以打开“版本历史”，选择以前的版本恢复。 +### 开发版：手动备份和版本说明 + +:::note[适用范围] +以下功能依据 2026-10-03 核对的开发版，尚未包含在官网当前的 **2.3.0** 中。 +::: + +准备进行较大修改前，可以保留一个有说明的版本： + +1. 先在编辑器保存需要备份的内容。备份取的是已保存版本，不包含尚未保存的编辑。 +2. 右键暂存动作，选择 **创建备份…**，打开版本历史。 +3. 选中需要保留的版本，填写说明，并勾选 **保留为手动备份（不自动裁剪）**。 +4. 点击 **保存说明 / 备份**。只填写说明、勾选后关闭窗口不会保存这些设置。 + +也可直接从 **版本历史** 修改某个已有版本的说明，或筛选查看手动备份。标记备份不会修改动作内容，也不会增加一个新的内容版本；普通历史保留最近 30 个版本，手动备份不参与这项自动裁剪。取消备份保护后，较旧版本可能立即被裁剪。 + +选择旧版本并点击 **恢复选中** 后，会以旧内容生成一个新版本，恢复前的已保存内容仍保留在历史中。如果当前动作或版本说明已被其它窗口修改，请刷新后重新核对。 + +手动备份仍只属于本机暂存项，不是云端副本。丢弃、全部删除，或写回成功后移除暂存项时，其历史和手动备份也会一起删除。 + 超过 30 天没有活动的暂存动作会显示清理提示，但 Quicker 不会据此自动删除。确认不再需要后，应由用户手工丢弃。 ## 新动作与已有动作的编辑副本 @@ -78,6 +106,8 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位 出现「让 AI 协助合并」时，可以主动点击并说明希望保留的行为。助手会读取差异、整理候选内容；不明确的取舍仍需本人决定。**合并结果先保存到暂存副本**，重新检查并试运行后，再确认写回原动作。仅写回失败不会自动发送合并请求。 +开发版开启 **完全控制** 时，助手可按当前请求直接应用合并后的修改，不再逐次等待写回确认；版本校验和冲突保护仍保留。当前发布版的确认流程与开发版的区别见 [AI 写回与历史说明](/v2/features/ai-and-agent#开发版动作保存与对话入口)。 + 如果合并期间原动作或草稿又变了，需要重新读取差异，不能沿用过期的选择。不要为了消除提示而直接丢弃仍需要的草稿。 ## 与正式动作和同步的区别 diff --git a/docs/v2/features/action-sharing.md b/docs/v2/features/action-sharing.md index 22e0aa7..2c1a1e6 100644 --- a/docs/v2/features/action-sharing.md +++ b/docs/v2/features/action-sharing.md @@ -64,6 +64,12 @@ V1 和 V2 只是同一修订中的两种可安装内容，不是两条独立分 如果计划支持两代客户端，并已在目标版本验证，可以同时选择 V1 和 V2。Quicker 2.0 会优先使用同一修订中的原生 V2 内容；该修订没有 V2 时，仍可安装 V1 兼容内容。作者也可以保留最后一个可用的 V1 修订，后续仅更新 V2，不必长期保持两版功能一致。 +:::note[开发版：完整分享窗口的默认格式] +2026-10-03 核对的开发版在新分享和更新已有分享时，默认勾选 **Quicker 2.0（原生制品）**；能够生成 V1 时，也同时勾选 **Quicker 1.x（兼容制品）**。此变化尚未包含在官网当前的 **2.3.0** 中。 + +作者仍可手动取消某一格式；无法生成 V1 时，该选项仍不可选。更新原来只有 V1 的分享时，也应重新核对本次发布格式。默认勾选不代表已验证两代客户端，提交前仍需检查；快速更新的规则见下文。 +::: + 从兼容两版转向仅维护 V2 的操作建议见[动作作者：迁移到 V2 与维护 V1 兼容版本](/v2/migration/action-authors)。 某些 Quicker 2.0 动作使用了 1.x 不支持的模块或结构，客户端会说明为什么无法生成 V1。此时可以取消 V1，只发布 V2，不要为了兼容而删除动作必需的步骤。 diff --git a/docs/v2/features/ai-and-agent.md b/docs/v2/features/ai-and-agent.md index 3b512c3..bb5d431 100644 --- a/docs/v2/features/ai-and-agent.md +++ b/docs/v2/features/ai-and-agent.md @@ -40,6 +40,10 @@ comments: true 在 2.2.24 中，如果提示原动作已变化，不要反复要求强制覆盖。先保留仍需要的修改内容，再丢弃旧编辑副本、重新打开最新原动作，将需要的改动重新应用。该版本不会自动合并两边的修改；2.2.25 起的合并能力见[暂存副本冲突处理](/v2/features/action-panel/action-drafts#原动作已变化时处理冲突)。暂存版本和删除限制见 [本机动作暂存区](./action-panel/action-drafts.md)。 +:::note[开发版的写回方式] +官网当前 **2.3.0** 仍使用上面的确认流程。开发版开启 **完全控制** 后，助手可以按修改请求直接写回原动作，详情见 [动作保存与对话入口](#开发版动作保存与对话入口)。仅要求保存草稿时，仍先留在暂存区。 +::: + ### 在设计器内修改 2.2.25 起，在动作编辑窗口配置好 AI 参数后，可点击右上角 **AI** 按钮，或按 `Ctrl+J`，打开设计器内的 AI 面板，用 AI 编写和修改当前动作。 @@ -191,6 +195,8 @@ Agent 对话与外部助手设置已有用户入口，但不代表所有开发 新对话中尚未发送的文本和引用可在本机保留；同一工作区保留一个新对话草稿入口。重新打开后可继续编辑，发送前仍需检查引用和附件。输入草稿尚不是已发送的历史消息，也不会因为恢复输入框而自动发送。 + + ## 设置与场景窗口中的 AI 助手 2.3.0 起，在「设置」或「场景、动作与触发管理」窗口中，点击标题栏的 AI 按钮，或按 `Ctrl+J`，可打开右侧助手。先配置 AI 服务与模型，再说明要查找的设置、目标场景和已有动作，例如「把主题改成深色」或「在 Chrome 场景为翻译动作设置快捷键」。场景窗口会提供当前场景、页签和部分选中项作为上下文；涉及继承规则时，仍要明确希望修改哪个场景。 @@ -198,3 +204,27 @@ Agent 对话与外部助手设置已有用户入口，但不代表所有开发 助手可查找设置、修改已支持的设置项，并为已有动作配置支持的触发规则。回复中的设置或触发链接可打开相应页面，便于核对实际结果。部分列表或尚未支持直接修改的设置只提供页面入口，需要本人继续操作；手势绘制、轮盘布局以及动作程序编写也应到对应编辑器完成。 写入仍受当前审批方式、设置校验和账号权益限制。若当前页面有无效或无法提交的输入，请先修正，再发送请求。回合结束后检查变更记录与页面结果，并实际试用触发规则；这里尚不支持设计器那样的「撤销本轮」。如果手动编辑与助手修改发生冲突，请按提示重新读取和核对，不能仅凭助手回复认定全部保存成功。 + +## 开发版：动作保存与对话入口 + +:::note[适用范围] +以下变化依据 2026-10-03 核对的开发版，尚未包含在官网当前的 **2.3.0** 中。 +::: + +### 完全控制下写回原动作 + +助手修改已有正式动作时仍先保存暂存副本；开启 **完全控制** 后，若请求要求应用修改，助手可以直接写回原动作，不再逐次弹出写回确认。其它审批方式仍需确认。**仅保存到暂存区** 不代表已应用，回复中应区分「已保存到暂存区」和「已应用到原动作」；新动作仍使用 **保留到场景**。 + +直接写回仍检查当前草稿版本、原动作是否变化及是否只读，并尝试合并不冲突的修改。存在冲突时保留两边内容；完全控制不会跳过这些检查。写回前会保存原动作的完整版本，备份失败则停止写回。若提示新版本历史未完整记录，应核对正式动作与本地历史，避免把提示当作没有写回。 + +助手保存时可附带简短的版本说明，供暂存历史和写回后的动作历史查看。它描述这一版的变化，不会代替动作标题或说明。暂存手动备份的保留范围见 [本机动作暂存区](./action-panel/action-drafts.md#开发版手动备份和版本说明)。 + +### 新对话引用最近修改的动作 + +尚未发送消息的新对话中，输入区附近可显示 **最近修改**，按实际修改时间列出至多六个动作，也可能包含标有「暂存」的动作。点击候选只把动作引用加入输入框，会保留已有文字和引用；继续填写要求并发送后，助手才开始处理。这里不是最近打开的动作列表，没有可用候选时不会显示。 + +### 设计器与对话中的检查入口 + +设计器内的组合动作助手也可修改动作标题和说明。这些改动会纳入本轮变更检查及「撤销本轮」；回合结束后，除了步骤，还应检查标题、说明是否准确。若期间又有手工修改，请按冲突提示处理。 + +独立对话中的思考和连续工具调用可以收起后再展开查看；回复正文和向用户提出的问题仍直接可见。折叠只改变显示，不会停止正在运行的任务。 diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md index afef8d5..87d2dc5 100644 --- a/docs/v2/features/screenshot/capture-pro.md +++ b/docs/v2/features/screenshot/capture-pro.md @@ -89,12 +89,16 @@ comments: true 2.2.8 起，选区侧栏支持**按住刷新**查看实时桌面，松开后重新捕获当前画面；也可按 `F5` 刷新截图，并保留当前选区、样式和标注。刷新后再用马赛克、模糊、填充、橡皮擦或撤销 / 重做时，不会带回旧画面；旧画面上的智能马赛克识别结果也会清除。 + + ### 二维码与条形码 2.2.5 起，OCR 结果窗可以查看并复制识别到的二维码内容。2.2.6 起，截图选区阶段也会自动识别选区内的二维码：把光标悬停到码上即可看到内容，并可直接复制或打开链接，不必先打开结果窗。 选区内没有可识别的码、或码被遮挡、模糊时，不会出现悬停提示；仍可确认截图后，在 [结果窗](#结果窗) 中查看二维码结果。 + + #### 识别更多条码 2.3.0 起，截图 Pro 与贴图的本地识别扩展为**二维码 / 条形码**：除二维码外，还支持 Code 128、EAN / UPC、Data Matrix、Aztec、PDF417 等常见格式，并改进竖向、反色和同图多个码的识别。悬停结果可查看或复制内容；只有有效的 HTTP / HTTPS 地址才提供打开链接。 @@ -164,6 +168,8 @@ comments: true 超长图贴图时会先适合当前屏幕并居中，必要时首次缩放可低于 10%，避免窗口超出工作区。 + + #### 长截图自动滚动 2.3.0 起，选好范围并进入长截图后，点击工具栏的 **自动滚动**。纵向模式向下滚动，横向模式向右滚动；每次匹配完成后再继续下一次滚动。点击速度按钮可在 **0.5×～2×** 间调整，速度面板打开时暂停采集，关闭后继续。 @@ -201,7 +207,7 @@ comments: true ## 文字识别（OCR） -截图 Pro 与贴图共用一套本地 OCR 能力，但使用场景不同： +截图 Pro 与贴图共用一套本地 OCR 能力，但使用场景不同。下面是官网当前 **2.3.0** 的流程；开发版在截图内选字的变化见 [下文](#开发版截图内选字与全文编辑)。 | 场景 | 行为 | | --- | --- | @@ -242,6 +248,22 @@ comments: true 自动 OCR 在后台运行时，若你正在使用铅笔等标注工具，**不会**强制切回移动工具或抢占键盘焦点。关闭贴图会取消尚未完成的识别；从上次会话恢复的旧贴图不会批量重跑 OCR。 +### 开发版：截图内选字与全文编辑 + +:::note[适用范围] +以下变化依据 2026-10-03 核对的开发版，尚未包含在官网当前的 **2.3.0** 中。 +::: + +普通文字识别可以直接留在截图界面完成： + +1. 框选范围后，点击工具栏的 **文字识别**，或按 `R`。识别状态与结果显示在当前截图上，保留原图供对照。 +2. 识别完成后，在原图文字上拖选或双击选字，用 `Ctrl+C` 或 **复制选中** 复制。 +3. 需要校正识别结果时，点击 **编辑全文**，修改文字后使用 **复制全文**。原图上的选字仍取原识别文字，全文编辑不会改写原图的文字选择层。 +4. 默认 **复制后关闭** 开启；复制成功才结束截图。需要连续复制多段文字时，先关闭此选项。复制失败会留在当前界面，可以重试。 +5. 需要重新框选时，点击 **返回截图** 或按 `Esc`；需要保留结果结束截图时，点击 **完成**。 + +内嵌工具栏可切换 **标准 / 快速** 和 **方向检测**；更改识别参数会重新识别当前选区。这些选项与 **复制后关闭** 会记住。识别失败可用 **重新识别** 重试，或返回截图调整范围。 + ## 结束方式 确认选区（并可标注）后，常见结束方式： diff --git a/docs/v2/features/tools.md b/docs/v2/features/tools.md index fe9723c..dd14b40 100644 --- a/docs/v2/features/tools.md +++ b/docs/v2/features/tools.md @@ -33,6 +33,16 @@ comments: true 排查“主动作调用子程序后失败”时，先选择主动作，再选择对应调用链，查看其中子动作输出的日志。这里查询的是动作输出的日志，不会因为打开页签而自动采集完整变量或步骤输入输出；需要这些信息时请使用调试运行。导出前检查日志中是否含本机路径、网址或其它私密内容。 +## 开发版：查看控件树与取消选择 + +以下改进已在开发版实现，尚未包含在官网当前提供的 **2.3.0** 中。 + +在窗口检查器或界面检查器中查看控件树时，可以使用「展开全部」，也可以右键节点选择「展开此分支」。展开按批次进行；达到深度或节点数量上限时会显示提示，可从需要的子分支继续展开。 + +目标软件的界面已经变化，或节点读取失败时，右键选择「刷新此节点」重新获取。刷新会中止当前展开过程，避免继续查看已过时的分支。 + +使用「控件选择器」点选目标控件时，尚未点击确认前可按 `Esc` 取消。已经点击、正在确认中的选择不会被该取消打断。 + ## 常用功能搜索 2.2.17 起，配置操作时的“常用功能”选择框支持输入名称或拼音筛选；输入法组字期间不会提前改变筛选结果。 diff --git a/docs/v2/features/triggers/index.md b/docs/v2/features/triggers/index.md index 4322bc0..18471ce 100644 --- a/docs/v2/features/triggers/index.md +++ b/docs/v2/features/triggers/index.md @@ -68,11 +68,17 @@ flowchart LR 场景继承与禁用语义见 [场景与触发方式（V2 变化）](/v2/what's-new/scenes-and-triggers)。 -## 开发版：搜索操作类型 + -2026-10-01 核对的开发版在操作编辑器中增加了搜索和分类筛选，尚未包含在 2.2.26 中。点击操作类型按钮后，输入名称或拼音缩小候选范围，也可选择分类；用上下方向键选择，`Enter` 确认，`Esc` 取消。候选仍受当前编辑场景限制，搜索不会增加原本不可用的操作类型。 +## 选择操作类型 -开发版还可在管理窗口内使用 [AI 助手配置设置和触发规则](/v2/features/ai-and-agent#开发版设置与场景窗口中的-ai-助手)。 +在官网当前 **2.3.0** 中，点击操作类型按钮后，可以输入名称或拼音搜索，也可选择分类；用上下方向键选择，`Enter` 确认，`Esc` 取消。候选仍受当前编辑场景限制，搜索不会增加原本不可用的操作类型。 + +:::note[开发版变化] +2026-10-03 核对的最新开发版已恢复为 **多级菜单**：点击操作类型按钮，按分类展开后选择目标操作。这项恢复尚未包含在 2.3.0 中；开发版不再使用上面的搜索弹层，菜单仍按当前编辑场景提供可用操作。 +::: + +2.3.0 起，还可在管理窗口内使用 [AI 助手配置设置和触发规则](/v2/features/ai-and-agent#设置与场景窗口中的-ai-助手)。 ## 相关链接 diff --git a/docs/v2/features/triggers/powerkeys.md b/docs/v2/features/triggers/powerkeys.md index 8575c66..63f6d4c 100644 --- a/docs/v2/features/triggers/powerkeys.md +++ b/docs/v2/features/triggers/powerkeys.md @@ -130,6 +130,7 @@ comments: true ## 限制与排障 +- **使用某些软件后扩展热键失效**：在设置中搜索「自动重置键盘状态」并尝试启用。按下引导键时，如果此前已经超过 2 秒没有按键输入，Quicker 会尝试清理异常的按键按下状态，恢复扩展热键。它不是每隔 2 秒自动重置，也不要求把引导键按住 2 秒。 - **输入优先仍是试验策略**：建议先为少量引导键启用并观察实际手感。 - **校准不能代替试用**：不同输入法、键盘布局和打字习惯差异较大。Quicker 目前不会把输入法已经开启等同于「正在组字」。 - **快速滚键、长按自动重复或按错第三个键**：会尽量恢复完整的普通输入，避免丢字或重复执行动作。 diff --git a/docs/v2/xaction/index.md b/docs/v2/xaction/index.md index 399db2e..0cdd947 100644 --- a/docs/v2/xaction/index.md +++ b/docs/v2/xaction/index.md @@ -14,7 +14,7 @@ hide_table_of_contents: true -## 开发版：自动滚动采集 + -2026-10-01 核对的开发版可在进入长截图后，从工具栏开启自动滚动、调节速度，并查看选区外的状态提示；尚未包含在 2.2.26 中。这些是采集界面操作，不是新增步骤参数。用法和中断处理见 [长截图自动滚动](/v2/features/screenshot/capture-pro#开发版长截图自动滚动)。 +## 自动滚动采集 + +2.3.0 起，进入长截图后，可从工具栏开启自动滚动、调节速度，并查看选区外的状态提示。这些是采集界面操作，不是新增步骤参数。用法和中断处理见 [长截图自动滚动](/v2/features/screenshot/capture-pro#长截图自动滚动)。 ## 参数说明 diff --git a/docs/v2/xaction/modules/network/smtp.md b/docs/v2/xaction/modules/network/smtp.md index 08ba90b..22a58cf 100644 --- a/docs/v2/xaction/modules/network/smtp.md +++ b/docs/v2/xaction/modules/network/smtp.md @@ -31,9 +31,7 @@ legacyContentUpdatedAt: "2021-11-29T13:33:22.000Z" **邮件服务器**：SMTP 域名或 IP。本机要能访问到。 -**端口**：通常不加密用 `25`；Gmail 等用 `587` 并打开加密连接。 - -**使用加密连接**：是否用 TLS（常见于 587 端口）。默认关闭。 +**端口与加密**：以邮件服务商提供的 SMTP 配置为准。开启「使用加密连接」时采用 **STARTTLS**：先建立连接，再升级为 TLS，通常使用 `587`，部分服务器使用 `25`。本模块不支持 `465` 端口的隐式 SSL/TLS 连接；不要只把端口改成 `465`。该选项默认关闭。 **帐号** / **密码**：发信账号。 @@ -41,13 +39,13 @@ legacyContentUpdatedAt: "2021-11-29T13:33:22.000Z" **发件人名称**：收件人看到的显示名。可选。 -**收件人**：不能为空。多个地址用半角逗号分隔。 +**收件人**：不能为空。多个地址用英文逗号 `,` 分隔，不支持分号或中文逗号。 -**抄送** / **密送**：多个地址同样用半角逗号分隔。 +**抄送** / **密送**：多个地址同样用英文逗号 `,` 分隔。 **邮件主题** / **邮件正文** -**附件**：文件完整路径，多个时每行一个。文件太大可能失败。 +**附件**：文件完整路径，多个时每行一个，按换行拆分。任一文件不存在时步骤失败；文件太大也可能被邮件服务商拒绝。 **内容为html**：正文是否按 HTML 发送。默认关闭。 diff --git a/docs/v2/xaction/modules/system/audiocontrol.md b/docs/v2/xaction/modules/system/audiocontrol.md index 2978f83..1948f3c 100644 --- a/docs/v2/xaction/modules/system/audiocontrol.md +++ b/docs/v2/xaction/modules/system/audiocontrol.md @@ -45,7 +45,7 @@ legacyContentUpdatedAt: "2025-01-20T01:00:00.000Z" 输出： -- **设备信息列表**：每项 `[图标]名称(注释)|设备ID`，可直接当作 [用户选择](/v2/xaction/modules/userselect) 的选项。 +- **设备信息列表**：每项格式为 `[icon:图标路径]设备名称(状态: …, ID: …)|设备ID`，可直接当作 [用户选择](/v2/xaction/modules/userselect) 的选项。需要提取设备 ID 时，按最后一个 `|` 拆分，取其后的部分。 - **原始对象列表**：内部 `MMDevice` 对象列表。 ### 获取默认设备 / 指定设备 @@ -88,7 +88,9 @@ legacyContentUpdatedAt: "2025-01-20T01:00:00.000Z" values={{operation: 'SetDeviceVolume', id: 'deviceId', volume: '0.1'}} /> -**音量**：`0`–`1.0` 的小数。**设备ID** 为空时操作当前默认输出设备。 +**音量**：`0`–`1.0` 的小数，例如 `0.5` 表示 50%，不要填写 `50`；超出范围时步骤失败。**设备ID** 为空时操作当前默认输出设备。 + +「设置音量」输出表示设备当前主音量，「实时音量」输出表示当前峰值电平；两者也都是 `0`–`1` 的小数。 ## 输出