Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/release-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 或更高版本时仍需特别检查:**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响;其它旧动作升级后请打开动作确认录制范围,避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。

Expand Down
7 changes: 7 additions & 0 deletions docs/v2/features/screenshot/capture-pro.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,10 +145,13 @@ comments: true

- 在左侧缩放查看原图(可隐藏预览区)。
- 在右侧编辑、复制识别文本。
- 切换到 **翻译** 页签,选择源语言、目标语言和服务商;可自动翻译,也可手动重新翻译并复制译文。
- 切换 **快速 / 标准** 模型后重新识别(若该档模型尚未安装,会提示下载)。
- 使用「自动排版 / 恢复原始排版」整理段落。
- 点「复制并关闭」一次性复制并关闭窗口。

2.1.26 起,OCR 结果窗会减少初始占用并加快首屏显示。切到需要付费识别的公式页签前,Quicker 会先确认,避免误点后直接发起付费识别。

### 贴图上的选字复制

贴图在移动模式下,可直接在图片上拖选或双击选字,用 `Ctrl+C` 复制。文字层默认不可见;若需要对照识别区域,可在移动模式右键菜单中打开「显示文本区域边框」。
Expand Down Expand Up @@ -310,6 +313,10 @@ comments: true

本地 OCR 依赖按需下载的识别组件,需先登录 Quicker 账号。首次识别或切换更大模型时可能短暂下载;下载完成后同一模型不会重复下载。

### 翻译页签没有译文或想换服务

在 OCR 结果窗切到 **翻译** 页签,先确认源语言、目标语言和服务商,再重新翻译。识别文本变化后可重新翻译;只需要译文时,用页签里的复制按钮复制翻译结果。

### 贴图上看不到文字框,但似乎能选中

这是预期行为:自动 OCR 默认只填充不可见的文本选择层,不显示边框。需要对照区域时,在移动模式右键菜单打开「显示文本区域边框」;也可点 OCR 按钮打开结果窗查看全文。
Expand Down
2 changes: 2 additions & 0 deletions docs/v2/what's-new/actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@ V2 使用统一操作描述执行内容。发送按键、输入文本、打开

统一并不表示所有操作都能放到所有位置。每个宿主仍会限制可创建的操作,例如高级鼠标专用操作不会出现在普通动作选择器中。

2.1.26 起,动作选择器中缺失的 **编辑** 和 **悬浮快捷入口** 已恢复。选择动作时需要顺手调整动作内容,或把动作建立为悬浮入口,可在选择器里直接进入对应操作。

## 动作本体与使用位置分开

动作本体保存名称、图标、说明、运行选项和操作内容。动作页、新面板场景、快捷键和触发规则只负责说明动作在哪里出现或何时运行。
Expand Down
4 changes: 4 additions & 0 deletions docs/v2/what's-new/tools-and-experience.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)。
Expand Down Expand Up @@ -46,6 +48,8 @@ V2 改为轻量的“选中文本工具条”。它可以在选中文字后显

“打开所在位置”会尽量复用已有资源管理器窗口。对部分支持的第三方文件管理器,也可以复用已有标签页,而不是重复打开窗口。

2.1.26 起,动作选择器中缺失的 **编辑** 和 **悬浮快捷入口** 已恢复。需要在选择动作时顺手编辑动作,或把动作设为悬浮入口时,可先升级到该版本再操作。

这些改进不会改变已有动作数据,但能减少在大量动作和文件之间查找、定位和重复开窗的成本。

## 应用更新
Expand Down
2 changes: 2 additions & 0 deletions docs/v2/what's-new/xaction-steps/csharp-script.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)。
2 changes: 1 addition & 1 deletion docs/v2/what's-new/xaction-steps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 自动编码识别。
Expand Down
2 changes: 2 additions & 0 deletions docs/v2/what's-new/xaction-steps/subprogram.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ comments: true

结构化调试会保留主动作与子程序的父子关系。调试器还可以强制记录下级子程序,方便进入子程序断点和查看内部步骤;原有“跳过调试输出”参数仍可用于减少普通调试日志。

2.1.26 起,网络共享子程序步骤右键菜单新增 **查看定义**,可预览当前引用版本的子程序。需要修改时,仍应先导入或转换为动作内子程序。

这些变化不会修改子程序的输入输出定义,但复杂动作升级后仍建议重点检查依赖并行、窗口回调或主动中止的调用链。

参数说明见[运行子程序](/v2/xaction/modules/subprogram)。
2 changes: 1 addition & 1 deletion docs/v2/xaction/concepts/subprogram.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"

不会经管理员审核,用前请自己看内容。发现恶意子程序可发 197906@qq.com,奖励 1 年专业版兑换码。

可导入为动作内再改,或在「共享」标签搜索后直接拖进步骤。右键可查看定义或导入。
可导入为动作内再改,或在「共享」标签搜索后直接拖进步骤。右键可查看定义或导入。2.1.26 起,拖进步骤列表后的网络共享子程序步骤也能右键 **查看定义**,预览的是当前步骤引用的版本;要修改时仍需导入或转成动作内子程序。

![](./img/subprogram-018-895314019a.png)

Expand Down
4 changes: 4 additions & 0 deletions docs/v2/xaction/concepts/xaction-editor.md
Original file line number Diff line number Diff line change
Expand Up @@ -201,6 +201,10 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"

## 高级技巧

### 代码编辑器折叠

2.1.26 起,动作编辑器里的代码输入框支持 `#region` / `#endregion` 和 `//#region` / `//#endregion` 区域折叠。区域可以嵌套;除作为独立区域标记的 `//#region` 行外,写在字符串或普通注释里的同名文本不会被当成折叠标记。

### 给步骤加后续延迟

鼠标停在步骤上,`Ctrl+滚轮` 给「本步完成后、下一步开始前」加等待,行右侧出现毫秒数;`Ctrl+Shift+滚轮` 加大步进。
Expand Down
5 changes: 5 additions & 0 deletions docs/v2/xaction/modules/flow/csscript.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`。
Expand Down Expand Up @@ -112,6 +114,8 @@ return DateTime.Now.ToString("O");

若末行是 `MessageBox.Show(...)` 这类本身没有可用返回值的调用,编译器会按「无返回值」处理;需要同时弹窗并返回文本时,把返回值单独放在最后一行。

2.1.26 继续兼容早期普通模式里的旧式末行表达式。如果旧脚本升级后只是依赖最后一行返回结果,通常不需要改成完整 `return`。

### 使用 await

脚本中出现 `await` 时,宿主会按异步方式编译并**等待完成**后再继续后续步骤。返回 `Task` / `ValueTask`(以及带结果的泛型形式)时,**返回内容** 取等待完成后的解包结果。
Expand Down Expand Up @@ -270,3 +274,4 @@ public static string Exec(string paramValue)
- 20231130 执行线程增加 STA 选项;普通模式支持返回值。
- 20250120 更新文档标题,以匹配实际功能。
- 20260811 普通模式支持直接编写纯脚本:末行表达式作返回值、可用 `context`、支持 `await` / Task;完整 `Exec` 仍兼容。
- 20260823 代码编辑器支持 region 折叠;普通模式继续兼容旧式末行表达式。
3 changes: 3 additions & 0 deletions docs/v2/xaction/modules/flow/subprogram.md
Original file line number Diff line number Diff line change
Expand Up @@ -261,6 +261,8 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"
1. 查看子程序定义:在编辑窗口里查看内部定义。
2. 导入为动作内子程序:需要对定义做修改时,先导入再用。

2.1.26 起,已经拖进步骤列表的网络共享子程序步骤,也可以从右键菜单点 **查看定义**。这会预览当前步骤引用的子程序版本,方便确认内部步骤和变量;如果要改定义,仍需先导入或转换为动作内子程序。

## 限制与排障

- 改了子程序的输入 / 输出变量名后,已有的「运行子程序」步骤不会自动改映射,需要重新打开步骤设置。
Expand Down Expand Up @@ -291,4 +293,5 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"

## 更新历史

- 2.1.26:网络共享子程序步骤右键菜单新增「查看定义」,可预览当前引用版本。
- 20250606 修改描述错误。
9 changes: 7 additions & 2 deletions docs/v2/xaction/modules/image/searchbmp.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 后请重新打开该步骤编辑并保存一次,让目标图片设置按新版格式更新。

<ModuleParamPreview moduleKey="sys:searchBmp" />

Expand All @@ -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`。

Expand Down Expand Up @@ -86,6 +88,8 @@ legacyContentUpdatedAt: "2024-05-18T08:56:35.000Z"
- **所有匹配点**:全部匹配点列表。找色没有这项。
- **最佳相似度**:最佳成功匹配的评分,范围 `0`–`100`;颜色容差模式成功时为 `100`,未找到时为 `0`。仅找图。

查找范围为 **指定窗口** 时,2.1.26 起可在步骤设置中选择是否返回窗口相对坐标。需要把结果交给窗口内部处理、或窗口可能移动时,优先考虑窗口相对坐标;需要直接移动系统鼠标时,仍要确认后续步骤期望的是屏幕坐标还是窗口坐标。

## 找图失败时

截图和屏幕不一致:
Expand Down Expand Up @@ -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:增加此模块。
Expand Down
Loading