From 7834607124f2e1b5798e42e044d7db8d7b7d4e9e Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 23 Aug 2026 22:09:07 +0000 Subject: [PATCH] =?UTF-8?q?docs(release):=20=E8=A1=A5=E5=85=85=20Quicker?= =?UTF-8?q?=202.1.26=20=E7=94=A8=E6=88=B7=E5=8F=AF=E8=A7=81=E8=83=BD?= =?UTF-8?q?=E5=8A=9B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cea --- docs/release-notes/index.md | 4 ++-- docs/v2/features/screenshot/capture-pro.md | 7 +++++++ docs/v2/what's-new/actions.md | 2 ++ docs/v2/what's-new/tools-and-experience.md | 4 ++++ docs/v2/what's-new/xaction-steps/csharp-script.md | 2 ++ docs/v2/what's-new/xaction-steps/index.md | 2 +- docs/v2/what's-new/xaction-steps/subprogram.md | 2 ++ docs/v2/xaction/concepts/subprogram.md | 2 +- docs/v2/xaction/concepts/xaction-editor.md | 4 ++++ docs/v2/xaction/modules/flow/csscript.md | 5 +++++ docs/v2/xaction/modules/flow/subprogram.md | 3 +++ docs/v2/xaction/modules/image/searchbmp.md | 9 +++++++-- 12 files changed, 40 insertions(+), 6 deletions(-) diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md index 66ee8d7..ddfa812 100644 --- a/docs/release-notes/index.md +++ b/docs/release-notes/index.md @@ -12,11 +12,11 @@ comments: true **[https://getquicker.net/v2/versions](https://getquicker.net/v2/versions)** -请以官网记录为准（至少已更新到 2.1.25）。安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。 +请以官网记录为准（至少已更新到 2.1.26）。安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。 本站补充的是安装、迁移、功能说明和相对 1.x 的结构变化，例如 [V2 重要变化](/v2/what's-new/)。文档会随版本抽查修订，但不会在每次发版时完整复述官网 changelog。 -2.1.25 的用户可见补充集中在 **屏幕找图/找色/找字** 的新查找范围，以及截图快捷键提示在多屏环境下的显示位置。本站只补操作上会遇到的差异，完整版本记录仍见官网。 +2.1.26 的用户可见补充集中在 OCR 结果窗的翻译页签、代码编辑器的区域折叠、**屏幕找图/找色/找字** 的指定图片 / 指定窗口细节、网络子程序定义预览，以及动作选择器入口恢复。本站只补操作上会遇到的差异，完整版本记录仍见官网。 升级到 2.1.23 或更高版本时仍需特别检查：**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其它旧动作升级后请打开动作确认录制范围，避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。 diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md index bdb9e20..f767359 100644 --- a/docs/v2/features/screenshot/capture-pro.md +++ b/docs/v2/features/screenshot/capture-pro.md @@ -145,10 +145,13 @@ comments: true - 在左侧缩放查看原图（可隐藏预览区）。 - 在右侧编辑、复制识别文本。 +- 切换到 **翻译** 页签，选择源语言、目标语言和服务商；可自动翻译，也可手动重新翻译并复制译文。 - 切换 **快速 / 标准** 模型后重新识别（若该档模型尚未安装，会提示下载）。 - 使用「自动排版 / 恢复原始排版」整理段落。 - 点「复制并关闭」一次性复制并关闭窗口。 +2.1.26 起，OCR 结果窗会减少初始占用并加快首屏显示。切到需要付费识别的公式页签前，Quicker 会先确认，避免误点后直接发起付费识别。 + ### 贴图上的选字复制 贴图在移动模式下，可直接在图片上拖选或双击选字，用 `Ctrl+C` 复制。文字层默认不可见；若需要对照识别区域，可在移动模式右键菜单中打开「显示文本区域边框」。 @@ -310,6 +313,10 @@ comments: true 本地 OCR 依赖按需下载的识别组件，需先登录 Quicker 账号。首次识别或切换更大模型时可能短暂下载；下载完成后同一模型不会重复下载。 +### 翻译页签没有译文或想换服务 + +在 OCR 结果窗切到 **翻译** 页签，先确认源语言、目标语言和服务商，再重新翻译。识别文本变化后可重新翻译；只需要译文时，用页签里的复制按钮复制翻译结果。 + ### 贴图上看不到文字框，但似乎能选中 这是预期行为：自动 OCR 默认只填充不可见的文本选择层，不显示边框。需要对照区域时，在移动模式右键菜单打开「显示文本区域边框」；也可点 OCR 按钮打开结果窗查看全文。 diff --git a/docs/v2/what's-new/actions.md b/docs/v2/what's-new/actions.md index dbc0472..430f46d 100644 --- a/docs/v2/what's-new/actions.md +++ b/docs/v2/what's-new/actions.md @@ -34,6 +34,8 @@ V2 使用统一操作描述执行内容。发送按键、输入文本、打开 统一并不表示所有操作都能放到所有位置。每个宿主仍会限制可创建的操作，例如高级鼠标专用操作不会出现在普通动作选择器中。 +2.1.26 起，动作选择器中缺失的 **编辑** 和 **悬浮快捷入口** 已恢复。选择动作时需要顺手调整动作内容，或把动作建立为悬浮入口，可在选择器里直接进入对应操作。 + ## 动作本体与使用位置分开 动作本体保存名称、图标、说明、运行选项和操作内容。动作页、新面板场景、快捷键和触发规则只负责说明动作在哪里出现或何时运行。 diff --git a/docs/v2/what's-new/tools-and-experience.md b/docs/v2/what's-new/tools-and-experience.md index e313af8..c49a0e0 100644 --- a/docs/v2/what's-new/tools-and-experience.md +++ b/docs/v2/what's-new/tools-and-experience.md @@ -16,6 +16,8 @@ V2 将截图、贴图、长截图和录屏整理为更完整的工作流。 截图 Pro 支持窗口与 UI 元素选区、手动框选、标注、OCR、智能马赛克、斜铺文字水印、贴图、长截图和录屏入口。动作步骤也能返回图片、截图区域和保存路径。 +2.1.26 起，OCR 结果窗新增 **翻译** 页签，可选择源语言、目标语言和服务商，支持自动翻译、重新翻译和复制译文。结果窗初始占用降低，首屏显示更快；切到需要付费识别的公式页签前会先确认。 + 选区阶段可用 `Ctrl+A` 在鼠标所在显示器与全部屏幕之间切换。2.1.25 起，截图 Pro 和屏幕截图的快捷键提示在多显示器环境下会跟随光标所在显示器，并尽量避让当前选区。截图 Pro、长截图和录屏的工具栏可以拖动并吸附到选区附近，双击手柄可恢复自动定位；吸附窗口时也会尽量排除窗口阴影。 步骤工具栏既可用可视化方式拖放内置工具、分组和自定义命令，也可配置 **自定义工具栏脚本**（JavaScript）：用压缩写法 `sp` / `act` 给默认工具栏加「调子程序 / 开动作」按钮，需要分支时再写完整 `run`。说明见 [JS 自定义工具栏](../features/screenshot/toolbar-script.md)。 @@ -46,6 +48,8 @@ V2 改为轻量的“选中文本工具条”。它可以在选中文字后显 “打开所在位置”会尽量复用已有资源管理器窗口。对部分支持的第三方文件管理器，也可以复用已有标签页，而不是重复打开窗口。 +2.1.26 起，动作选择器中缺失的 **编辑** 和 **悬浮快捷入口** 已恢复。需要在选择动作时顺手编辑动作，或把动作设为悬浮入口时，可先升级到该版本再操作。 + 这些改进不会改变已有动作数据，但能减少在大量动作和文件之间查找、定位和重复开窗的成本。 ## 应用更新 diff --git a/docs/v2/what's-new/xaction-steps/csharp-script.md b/docs/v2/what's-new/xaction-steps/csharp-script.md index 5301291..d0ad7f3 100644 --- a/docs/v2/what's-new/xaction-steps/csharp-script.md +++ b/docs/v2/what's-new/xaction-steps/csharp-script.md @@ -12,6 +12,8 @@ comments: true 除了继续支持完整的 `Exec(context)` 方法，现在也可以直接编写顶层脚本，通过 `context` 读写动作变量，并把末行表达式作为返回值。脚本返回 `Task` 或 `ValueTask` 时，Quicker 会等待完成并输出解包后的结果。 +2.1.26 起，代码编辑器支持 `#region` 和 `//#region` 区域折叠，便于把较长脚本分段；普通模式也继续兼容旧式末行表达式，旧脚本通常不需要为返回值单独改写。 + 编译结果支持磁盘缓存；关闭磁盘缓存后，相同代码在当前进程内仍可复用。迁移旧脚本时仍应检查 .NET 10、x64、程序集引用和已移除 API 的兼容性。 参数说明见[运行C#代码](/v2/xaction/modules/csscript)。 diff --git a/docs/v2/what's-new/xaction-steps/index.md b/docs/v2/what's-new/xaction-steps/index.md index d69ac10..f8bbf1f 100644 --- a/docs/v2/what's-new/xaction-steps/index.md +++ b/docs/v2/what's-new/xaction-steps/index.md @@ -30,7 +30,7 @@ Quicker 2.x 在保持已有组合动作兼容的基础上，增加了一批面 - [提示消息模块](./notify.md)：增加显示位置、持续时间、重复消息处理和交互按钮。 - [屏幕截图模块](./screen-capture.md)：增加 UI 元素检测、截图历史，并接入新版截图后工具。 - [屏幕录制模块](./new-screen-recording-ui.md) / [后台屏幕录制模块](./new-background-screen-recording.md)：2.1.23 起可选择保存文件夹；自定义目录中的成品只建立历史索引，不再额外复制一份。当前 `data/xaction` 尚未同步对应参数 Key，因此模块页只写能力说明。 -- [屏幕找图/找色/找字模块](/v2/xaction/modules/searchbmp)：找图新增相似度匹配模式；2.1.25 起查找范围还支持指定窗口和指定图片，适合在被遮挡窗口或本地图片中定位目标。当前 `data/xaction` 尚未同步新增选项的参数 Key，因此模块页只写能力说明。 +- [屏幕找图/找色/找字模块](/v2/xaction/modules/searchbmp)：找图新增相似度匹配模式；2.1.25 起查找范围还支持指定窗口和指定图片，适合在被遮挡窗口或本地图片中定位目标。2.1.26 起，指定图片可使用图片路径或图片变量；指定窗口可选择返回窗口相对坐标。2.1.25 里已经配过指定图片的动作，升级后需要重新打开步骤编辑一次。当前 `data/xaction` 尚未同步新增选项的参数 Key，因此模块页只写能力说明。 - [基础OCR模块](./basic-ocr.md)：增加独立本地引擎、模型档位和本地表格识别。 - [图片处理模块](./image-process.md)：为缩放和图标生成增加多种采样算法。 - [读取文件模块](./read-file.md)：改进 BOM、UTF-8 和 Windows ANSI 自动编码识别。 diff --git a/docs/v2/what's-new/xaction-steps/subprogram.md b/docs/v2/what's-new/xaction-steps/subprogram.md index 7cfb4f2..09f9463 100644 --- a/docs/v2/what's-new/xaction-steps/subprogram.md +++ b/docs/v2/what's-new/xaction-steps/subprogram.md @@ -12,6 +12,8 @@ comments: true 结构化调试会保留主动作与子程序的父子关系。调试器还可以强制记录下级子程序，方便进入子程序断点和查看内部步骤；原有“跳过调试输出”参数仍可用于减少普通调试日志。 +2.1.26 起，网络共享子程序步骤右键菜单新增 **查看定义**，可预览当前引用版本的子程序。需要修改时，仍应先导入或转换为动作内子程序。 + 这些变化不会修改子程序的输入输出定义，但复杂动作升级后仍建议重点检查依赖并行、窗口回调或主动中止的调用链。 参数说明见[运行子程序](/v2/xaction/modules/subprogram)。 diff --git a/docs/v2/xaction/concepts/subprogram.md b/docs/v2/xaction/concepts/subprogram.md index a184a90..cf95525 100644 --- a/docs/v2/xaction/concepts/subprogram.md +++ b/docs/v2/xaction/concepts/subprogram.md @@ -99,7 +99,7 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z" 不会经管理员审核，用前请自己看内容。发现恶意子程序可发 197906@qq.com，奖励 1 年专业版兑换码。 -可导入为动作内再改，或在「共享」标签搜索后直接拖进步骤。右键可查看定义或导入。 +可导入为动作内再改，或在「共享」标签搜索后直接拖进步骤。右键可查看定义或导入。2.1.26 起，拖进步骤列表后的网络共享子程序步骤也能右键 **查看定义**，预览的是当前步骤引用的版本；要修改时仍需导入或转成动作内子程序。 ![](./img/subprogram-018-895314019a.png) diff --git a/docs/v2/xaction/concepts/xaction-editor.md b/docs/v2/xaction/concepts/xaction-editor.md index 7670529..ae9a28d 100644 --- a/docs/v2/xaction/concepts/xaction-editor.md +++ b/docs/v2/xaction/concepts/xaction-editor.md @@ -201,6 +201,10 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z" ## 高级技巧 +### 代码编辑器折叠 + +2.1.26 起，动作编辑器里的代码输入框支持 `#region` / `#endregion` 和 `//#region` / `//#endregion` 区域折叠。区域可以嵌套；除作为独立区域标记的 `//#region` 行外，写在字符串或普通注释里的同名文本不会被当成折叠标记。 + ### 给步骤加后续延迟 鼠标停在步骤上，`Ctrl+滚轮` 给「本步完成后、下一步开始前」加等待，行右侧出现毫秒数；`Ctrl+Shift+滚轮` 加大步进。 diff --git a/docs/v2/xaction/modules/flow/csscript.md b/docs/v2/xaction/modules/flow/csscript.md index c3c38af..74d90b2 100644 --- a/docs/v2/xaction/modules/flow/csscript.md +++ b/docs/v2/xaction/modules/flow/csscript.md @@ -41,6 +41,8 @@ legacyContentUpdatedAt: "2025-01-20T01:01:01.000Z" **脚本内容**：要运行的 C#。三种模式各有一份输入（界面上仍叫「脚本内容」）。普通模式可写纯脚本或完整 `Exec`；低权限必须声明 `Exec(string paramValue)`；生成程序集按模板写命名空间和类。 +2.1.26 起，代码编辑器支持 `#region` / `#endregion` 和 `//#region` / `//#endregion` 区域折叠，可嵌套；除作为独立区域标记的 `//#region` 行外，字符串和普通注释中的同名文本不会误触发折叠。编辑器也会补全 region 标记，错误提示的位置会尽量对应到你实际编辑的代码行。 + **参数值**：仅低权限。传给 `Exec(string paramValue)` 的参数。 **引用DLL库**：要引用的 DLL，每行一个。也可在代码里用 `#r`。 @@ -112,6 +114,8 @@ return DateTime.Now.ToString("O"); 若末行是 `MessageBox.Show(...)` 这类本身没有可用返回值的调用，编译器会按「无返回值」处理；需要同时弹窗并返回文本时，把返回值单独放在最后一行。 +2.1.26 继续兼容早期普通模式里的旧式末行表达式。如果旧脚本升级后只是依赖最后一行返回结果，通常不需要改成完整 `return`。 + ### 使用 await 脚本中出现 `await` 时，宿主会按异步方式编译并**等待完成**后再继续后续步骤。返回 `Task` / `ValueTask`（以及带结果的泛型形式）时，**返回内容** 取等待完成后的解包结果。 @@ -270,3 +274,4 @@ public static string Exec(string paramValue) - 20231130 执行线程增加 STA 选项；普通模式支持返回值。 - 20250120 更新文档标题，以匹配实际功能。 - 20260811 普通模式支持直接编写纯脚本：末行表达式作返回值、可用 `context`、支持 `await` / Task；完整 `Exec` 仍兼容。 +- 20260823 代码编辑器支持 region 折叠；普通模式继续兼容旧式末行表达式。 diff --git a/docs/v2/xaction/modules/flow/subprogram.md b/docs/v2/xaction/modules/flow/subprogram.md index 2b5f5f8..d14db0c 100644 --- a/docs/v2/xaction/modules/flow/subprogram.md +++ b/docs/v2/xaction/modules/flow/subprogram.md @@ -261,6 +261,8 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z" 1. 查看子程序定义：在编辑窗口里查看内部定义。 2. 导入为动作内子程序：需要对定义做修改时，先导入再用。 +2.1.26 起，已经拖进步骤列表的网络共享子程序步骤，也可以从右键菜单点 **查看定义**。这会预览当前步骤引用的子程序版本，方便确认内部步骤和变量；如果要改定义，仍需先导入或转换为动作内子程序。 + ## 限制与排障 - 改了子程序的输入 / 输出变量名后，已有的「运行子程序」步骤不会自动改映射，需要重新打开步骤设置。 @@ -291,4 +293,5 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z" ## 更新历史 +- 2.1.26：网络共享子程序步骤右键菜单新增「查看定义」，可预览当前引用版本。 - 20250606 修改描述错误。 diff --git a/docs/v2/xaction/modules/image/searchbmp.md b/docs/v2/xaction/modules/image/searchbmp.md index 37834d1..469ae47 100644 --- a/docs/v2/xaction/modules/image/searchbmp.md +++ b/docs/v2/xaction/modules/image/searchbmp.md @@ -25,7 +25,9 @@ legacyContentUpdatedAt: "2024-05-18T08:56:35.000Z" 例如要点一个按钮：先把按钮截成 png，再用本模块在屏幕上搜，得到坐标。[鼠标输入](/v2/xaction/modules/mouse) 里也有「移动到位图位置」，找到后会直接点，但不返回坐标。本模块只回报位置，不点击。 -[官网 2.1.25 记录](https://getquicker.net/V2/Versions)中，本模块的查找范围新增了 **指定窗口** 和 **指定图片**：前者适合在被遮挡的目标窗口中查找，后者适合在本地图片里查找，不必先把内容显示到屏幕上。当前仓库的 `data/xaction` 还没有同步这两个选项的枚举值和后续参数 Key，因此本页只说明能力，不写参数 Key、示例值或可导入的配置片段。 +[官网 2.1.25 与 2.1.26 记录](https://getquicker.net/V2/Versions)中，本模块的查找范围新增并继续完善了 **指定窗口** 和 **指定图片**：前者适合在被遮挡的目标窗口中查找，后者适合在本地图片里查找，不必先把内容显示到屏幕上。当前仓库的 `data/xaction` 还没有同步这两个选项的枚举值和后续参数 Key，因此本页只说明能力，不写参数 Key、示例值或可导入的配置片段。 + +升级注意：如果你在 2.1.25 里已经把查找范围设为 **指定图片**，升级到 2.1.26 后请重新打开该步骤编辑并保存一次，让目标图片设置按新版格式更新。 @@ -46,7 +48,7 @@ legacyContentUpdatedAt: "2024-05-18T08:56:35.000Z" **文字**：仅查找文字。可多行写多组，命中任意一组即可。 -**查找范围**：主屏幕、当前窗口、坐标范围、所有屏幕。2.1.25 起还可选择 **指定窗口** 或 **指定图片**；这两个选项的具体参数以当前 Quicker 编辑器和官网版本记录为准。注意 **当前窗口** 是动作运行时的当前前台窗口，不等同于新增的 **指定窗口**。 +**查找范围**：主屏幕、当前窗口、坐标范围、所有屏幕。2.1.25 起还可选择 **指定窗口** 或 **指定图片**；2.1.26 起，指定图片的目标可来自图片路径或图片变量，指定窗口可选择返回窗口相对坐标。这两个选项的具体参数以当前 Quicker 编辑器和官网版本记录为准。注意 **当前窗口** 是动作运行时的当前前台窗口，不等同于新增的 **指定窗口**。 **查找坐标范围**：查找范围为「坐标范围」时填写，格式 `left,top,right,bottom`，例如 `0,0,800,600`。 @@ -86,6 +88,8 @@ legacyContentUpdatedAt: "2024-05-18T08:56:35.000Z" - **所有匹配点**：全部匹配点列表。找色没有这项。 - **最佳相似度**：最佳成功匹配的评分，范围 `0`–`100`；颜色容差模式成功时为 `100`，未找到时为 `0`。仅找图。 +查找范围为 **指定窗口** 时，2.1.26 起可在步骤设置中选择是否返回窗口相对坐标。需要把结果交给窗口内部处理、或窗口可能移动时，优先考虑窗口相对坐标；需要直接移动系统鼠标时，仍要确认后续步骤期望的是屏幕坐标还是窗口坐标。 + ## 找图失败时 截图和屏幕不一致： @@ -237,6 +241,7 @@ legacyContentUpdatedAt: "2024-05-18T08:56:35.000Z" ## 更新历史 +- 2.1.26：指定图片目标支持图片路径或图片变量；指定窗口可选择返回窗口相对坐标。2.1.25 中已使用指定图片的动作升级后需要重新打开步骤编辑一次。 - 2.1.25：查找范围新增指定窗口、指定图片。当前结构化模块数据尚未同步对应参数。 - 2.1.19：找图新增相似度匹配、最低相似度和最佳相似度输出。 - 1.1.4：增加此模块。