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: 3 additions & 1 deletion docs/release-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,10 @@ comments: true

**[https://getquicker.net/v2/versions](https://getquicker.net/v2/versions)**

请以官网记录为准(至少已更新到 2.1.22)。安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载,不要使用仍提供 1.x 的 `/Download` 页。
请以官网记录为准(至少已更新到 2.1.23)。安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载,不要使用仍提供 1.x 的 `/Download` 页。

本站补充的是安装、迁移、功能说明和相对 1.x 的结构变化,例如 [V2 重要变化](/v2/what's-new/)。文档会随版本抽查修订,但不会在每次发版时完整复述官网 changelog。

2.1.23 的用户可见补充已同步到相关功能页。需要特别检查的是:**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响;其它旧动作升级后请打开动作确认录制范围,避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。

体验、降级和回退风险见 [体验前必读](/important-notice)。
7 changes: 5 additions & 2 deletions docs/v2/features/screenshot/capture-pro.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,7 @@ comments: true
| 箭头 | 指向说明 |
| 序列号 | 步骤编号 |
| 文本 | 添加文字说明 |
| 文字水印 | 输入要显示的文字,设定颜色后斜向平铺到当前截图 |
| 马赛克 / 智能马赛克 | 手动打码,或识别文字区域后自动打码(见下文) |
| 聚光灯 | 压暗周围,突出关注区域 |
| 橡皮擦 | 擦除标注 |
Expand Down Expand Up @@ -130,6 +131,8 @@ comments: true
| 贴图工具栏 / 右键「识别文字」 | 打开同一结果窗;成功后还会把文字写入贴图的不可见文本选择层 |
| 新建贴图后(自动) | 后台静默识别,不弹结果窗、默认不显示区域边框 |

使用截图 Pro 的斜铺文字水印时,水印会作为标注效果叠加到最终图片中;之后把它贴成贴图再做 OCR,不会把水印文字当成原图内容写入贴图文本层。

### 识别引擎

- **优先本地 OCR**:首次使用需登录 Quicker,并按需下载依赖包(默认快速模型约 7MB,标准模型约 31MB)。
Expand Down Expand Up @@ -180,7 +183,7 @@ comments: true

重启 Quicker 后恢复贴图时,如果原显示器仍存在,会尽量保留上次所在屏幕和位置;原显示器已移除时,才会移回主屏可见区域。

通过贴图步骤生成的 HTML 或公式贴图会在隔离环境中渲染。未信任内容不会执行页面脚本或加载嵌入页面;如果内容边缘被裁切,可先升级到当前版本再重新生成贴图
通过贴图步骤生成的 HTML 或公式贴图会先在隔离环境中渲染,再以普通图片窗口显示;未信任内容不会执行页面脚本或加载嵌入页面。作为普通图片窗口后,可以正常拖移、显示阴影,并可在自动 OCR 完成后直接选中文字复制。剪贴板图片携带的位置也会随复制保留,便于后续贴回原处

### 移动模式

Expand Down Expand Up @@ -210,7 +213,7 @@ comments: true

锁定窗口后,不能移动、缩放、改透明度或继续标注,但仍可复制、保存、OCR,以及开关置顶 / 阴影等。

右键菜单中的 **历史记录…** 可打开采集历史中心,查看当前贴图、已关闭贴图、截图历史与录屏历史,并做筛选、多选与批量操作。
右键菜单中的 **历史记录…** 可打开采集历史中心,查看当前贴图、已关闭贴图、截图历史与录屏历史,并做筛选、多选与批量操作。2.1.23 起,采集历史中心还可以管理进行中的录屏,并在页内预览录屏成品、复制、另存或切换播放速度。

## 动作步骤参数

Expand Down
4 changes: 2 additions & 2 deletions docs/v2/features/screenshot/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,6 @@ Quicker 提供一套完整的屏幕截取与后续处理能力,可在动作中
]}
/>

[官网 2.1.21 记录](https://getquicker.net/V2/Versions)中新增了独立的 **贴图** 组合动作步骤,可从图片变量、剪贴板、文本、HTML、公式或 OCR 原始结果创建贴图;内容参数会跟随内容来源显示。当前仓库的 `data/xaction` 还没有该步骤的独立模块定义,因此参数页待后续结构化数据同步后补齐。已有 **显示图片** 步骤仍可用于显示图片文件、图片变量或剪贴板图片。
[官网 2.1.21 记录](https://getquicker.net/V2/Versions)中新增了独立的 **贴图** 组合动作步骤,可从图片变量、剪贴板、文本、HTML、公式或 OCR 原始结果创建贴图;内容参数会跟随内容来源显示。[官网 2.1.23 记录](https://getquicker.net/V2/Versions)进一步增加了「自动」和「截图原位置」贴图位置,Quicker 或 PixPin 复制的图片可贴回原处,旧动作仍保持原有自定义坐标。当前仓库的 `data/xaction` 还没有该步骤的独立模块定义,因此参数页待后续结构化数据同步后补齐。已有 **显示图片** 步骤仍可用于显示图片文件、图片变量或剪贴板图片。

截图界面内已集成 OCR、图片翻译、智能马赛克等常用后处理。更复杂的自动化仍可在动作链中用独立步骤完成。截图历史、已关闭贴图与录屏成品可在采集历史中心统一查看与管理。
截图界面内已集成 OCR、图片翻译、智能马赛克、斜铺文字水印等常用后处理。更复杂的自动化仍可在动作链中用独立步骤完成。截图历史、已关闭贴图与录屏成品可在采集历史中心统一查看与管理;2.1.23 起,进行中的录屏也可以在这里管理,并可在页内预览、复制、另存和切换播放速度
2 changes: 1 addition & 1 deletion docs/v2/features/triggers/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ flowchart LR

1. 打开新版主窗口工具菜单中的 **场景与动作管理**(或设置里对应入口)。
2. 左侧选场景,右侧按 **键盘触发** / **鼠标触发** 等标签编辑规则。
3. 误触发或场景不对时:看 **最近触发历史**(本次运行约 30 分钟内的记录),并可配合 **当前场景诊断**。
3. 误触发或场景不对时:看 **最近触发历史**(本次运行约 30 分钟内的记录),并可配合 **当前场景诊断**;2.1.23 起,切换窗口后高级鼠标、手势、轮盘等会更稳定地使用触发当时的程序和场景,历史记录中的规则、场景和操作摘要也更便于归因
4. 快捷键冲突:用 **设置 → 快捷键查询 → 快捷键占用查询** 定位 Quicker 内已注册的键。

场景继承与禁用语义见 [场景与触发方式(V2 变化)](/v2/what's-new/scenes-and-triggers)。
Expand Down
2 changes: 2 additions & 0 deletions docs/v2/what's-new/new-main-win/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -182,4 +182,6 @@ comments: true

如果还不知道动作位于哪些旧动作页或场景,可使用标题栏“更多菜单 → 动作管理”,按程序、动作页等条件筛选后再批量处理。详细操作和剪切安全边界见[常见问题](./faq.md)。

2.1.23 起,动作管理页增加 **动作回收站** 和 **批量更新动作** 快捷入口,并提示可以把动作直接拖到面板。从动作管理列表拖到新面板目标场景或分组时,会建立该动作的面板入口;这和“移动到…”一样处理的是动作位置,不会复制动作内容本体。

排查最近运行失败的动作时,可从面板工具菜单打开 **最近动作错误**,查看最近 10 条失败记录和错误详情。
4 changes: 3 additions & 1 deletion docs/v2/what's-new/scenes-and-triggers.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,11 +68,13 @@ V2 把以下功能逐步集中到“场景与动作管理”:

如果面板标签或触发规则匹配错误,可以从新版主窗口的工具菜单打开“当前场景诊断”,查看 Quicker 识别到的程序、网址和继承链。

2.1.23 起,切换窗口或刷新设置时,高级鼠标、手势、轮盘菜单等触发规则会更稳定地按触发当时的程序和场景执行。遇到“刚切窗口就触发到上一个程序”的情况,先确认已升级到当前版本,再结合下面的最近触发历史排查具体规则。

## 诊断触发记录和快捷键占用

新版主窗口的工具菜单提供“最近触发历史”。它记录本次 Quicker 运行中最近 30 分钟、最多 200 条自动触发记录,不写入磁盘。

记录包括触发时间、前台程序、场景、触发规则和执行内容,覆盖动作快捷键、扩展热键、文本指令、轮盘、手势、按键双击、左键辅助和高级鼠标触发等入口。
记录包括触发时间、前台程序、场景、触发规则和执行内容,覆盖动作快捷键、扩展热键、文本指令、轮盘、手势、按键双击、左键辅助和高级鼠标触发等入口。2.1.23 起,规则、场景和操作摘要的归因更清楚,也减少了默认记录对鼠标、键盘触发本身的影响。

遇到误触发、重复触发或场景不符合预期时,可以复制全部记录后再清空,以便和“当前场景诊断”结果一起排查。

Expand Down
6 changes: 4 additions & 2 deletions docs/v2/what's-new/tools-and-experience.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,15 @@ comments: true

V2 将截图、贴图、长截图和录屏整理为更完整的工作流。

截图 Pro 支持窗口与 UI 元素选区、手动框选、标注、OCR、智能马赛克、贴图、长截图和录屏入口。动作步骤也能返回图片、截图区域和保存路径。
截图 Pro 支持窗口与 UI 元素选区、手动框选、标注、OCR、智能马赛克、斜铺文字水印、贴图、长截图和录屏入口。动作步骤也能返回图片、截图区域和保存路径。

选区阶段可用 `Ctrl+A` 在鼠标所在显示器与全部屏幕之间切换。截图 Pro、长截图和录屏的工具栏可以拖动并吸附到选区附近,双击手柄可恢复自动定位;吸附窗口时也会尽量排除窗口阴影。

步骤工具栏既可用可视化方式拖放内置工具、分组和自定义命令,也可配置 **自定义工具栏脚本**(JavaScript):用压缩写法 `sp` / `act` 给默认工具栏加「调子程序 / 开动作」按钮,需要分支时再写完整 `run`。说明见 [JS 自定义工具栏](../features/screenshot/toolbar-script.md)。

贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。重启后恢复贴图时,原显示器仍在则尽量保留上次屏幕位置;HTML 和公式贴图使用隔离渲染,避免未信任内容执行脚本。截图及录屏历史使用统一的本机目录和历史管理入口。
贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。重启后恢复贴图时,原显示器仍在则尽量保留上次屏幕位置;HTML 和公式贴图使用隔离渲染后以普通图片窗口显示,可继续拖移、显示阴影并选字复制。Quicker 或 PixPin 复制的图片位置可随剪贴板保留,配合贴图步骤的「截图原位置」把图片贴回原处。

截图、贴图与录屏历史使用统一的采集历史中心。录屏成品可页内预览、复制、另存和切换播放速度;进行中的录屏也可以在这里管理。交互式和后台录屏步骤支持选择保存文件夹,写到自定义目录的成品只建立历史索引,不再为了入库额外复制一份。

详情见[截图与贴图概览](../features/screenshot/index.md)和[截图 Pro](../features/screenshot/capture-pro.md)。

Expand Down
3 changes: 2 additions & 1 deletion docs/v2/what's-new/xaction-steps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,12 +23,13 @@ Quicker 2.x 在保持已有组合动作兼容的基础上,增加了一批面
- [新增:运行C#文件应用模块](./new-csharp-file-app.md):使用 .NET SDK 编译运行支持现代 SDK 功能的单文件应用。
- [新增:自动化脚本模块](/v2/xaction/modules/automationscript):使用受限 JavaScript 编排鼠标、键盘、窗口、剪贴板、选择、截图识别等桌面自动化操作;首次使用相关能力时会请求本机授权。

[官网 2.1.21 记录](https://getquicker.net/V2/Versions)中还新增了 **贴图** 步骤,可从图片变量、剪贴板、文本、HTML、公式和 OCR 原始结果创建贴图。当前 `data/xaction` 暂无该步骤的独立模块定义,因此本站先在[截图与贴图概览](/v2/features/screenshot)中说明能力,参数页待结构化数据同步后再补。
[官网 2.1.21 记录](https://getquicker.net/V2/Versions)中还新增了 **贴图** 步骤,可从图片变量、剪贴板、文本、HTML、公式和 OCR 原始结果创建贴图。[官网 2.1.23 记录](https://getquicker.net/V2/Versions)补充了「自动」和「截图原位置」贴图位置,Quicker 或 PixPin 复制的图片可贴回原处,旧动作仍保持原有自定义坐标。当前 `data/xaction` 暂无该步骤的独立模块定义,因此本站先在[截图与贴图概览](/v2/features/screenshot)中说明能力,参数页待结构化数据同步后再补。

## 改进模块

- [提示消息模块](./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):找图新增相似度匹配模式,适合界面轻微缩放、抗锯齿或颜色变化时提高容错。
- [基础OCR模块](./basic-ocr.md):增加独立本地引擎、模型档位和本地表格识别。
- [图片处理模块](./image-process.md):为缩放和图标生成增加多种采样算法。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,14 @@ comments: true

模块支持常用视频格式、帧率、画质和音频选项。开始步骤可以立即返回,让动作继续执行;停止后可以取得文件路径、时长和实际录制区域。

2.1.23 起,后台录屏步骤可以选择保存文件夹。录制到自定义目录时,采集历史中心只建立历史索引,不会为了加入历史再复制一份成品文件。

后台录制适合定时、批量或由外部条件控制的流程。动作应妥善保存会话 ID,并为异常退出或取消路径安排停止步骤,避免遗留未结束的录制会话。

:::caution[升级后检查录制范围]

2.1.23 起,后台屏幕录制步骤的默认录制范围改为 **主屏幕**。已明确保存录制范围的动作不受影响;其它旧动作升级后请打开步骤确认范围,避免原本依赖旧默认值的动作录到不符合预期的屏幕。

:::

参数说明见[后台屏幕录制](/v2/xaction/modules/screen-recording)。
2 changes: 2 additions & 0 deletions docs/v2/what's-new/xaction-steps/new-screen-recording-ui.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ comments: true

录制结束后,模块会等待用户完成预览或导出,并返回视频文件路径、录制时长和实际区域。它适合需要在动作运行时由用户临时决定范围的流程。

2.1.23 起,交互式录屏步骤可以选择保存文件夹。录制到自定义目录时,采集历史中心只建立历史索引,不会为了加入历史再复制一份成品文件。

如果动作需要无人值守地启动和停止录制,或由多个步骤共同控制同一次录制,请改用“后台屏幕录制”模块。

参数说明见[屏幕录制](/v2/xaction/modules/screen-recording-ui)。
4 changes: 3 additions & 1 deletion docs/v2/xaction/modules/image/screen-recording-ui.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@ metadataGeneratedAt: "2026-08-03 20:08:03"

选区操作与「屏幕截图」相近。完整界面说明见下面的入口;本页只写本模块自己的参数。

2.1.23 起,录制时可以选择保存文件夹。成品放在自定义目录时,采集历史中心只建立索引,不会为了加入历史再额外复制一份文件。

<RelatedDocs
layout="cards"
items={[
Expand All @@ -48,7 +50,7 @@ metadataGeneratedAt: "2026-08-03 20:08:03"

**手动调整选区**:默认关闭:框选完就确认并开录。打开后可以先改选区,再确认开录。

**加入录屏历史**:打开后把成品复制到本机录屏历史。默认关闭,以免旧动作的文件生命周期被改掉。
**加入录屏历史**:打开后把成品纳入本机录屏历史。默认关闭,以免旧动作的文件生命周期被改掉;2.1.23 起,若成品保存到自定义目录,历史里只建立索引

**失败后停止**:失败或取消是否中止动作。默认开启。

Expand Down
10 changes: 9 additions & 1 deletion docs/v2/xaction/modules/image/screen-recording.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,14 @@ metadataGeneratedAt: "2026-08-03 20:08:03"

本模块没有选区 UI。开始录制时指定范围;之后用同一个会话 ID 暂停、继续或结束。需要框选界面时请用下面的 **屏幕录制**。

2.1.23 起,录制时可以选择保存文件夹。成品放在自定义目录时,采集历史中心只建立索引,不会为了加入历史再额外复制一份文件。

:::caution[升级后检查默认范围]

2.1.23 起,后台屏幕录制步骤的默认录制范围改为 **主屏幕**。已明确保存录制范围的动作不受影响;其它旧动作升级后请打开步骤确认范围,避免原本依赖旧默认值的动作录到不符合预期的屏幕。

:::

<RelatedDocs
layout="cards"
items={[
Expand Down Expand Up @@ -80,7 +88,7 @@ metadataGeneratedAt: "2026-08-03 20:08:03"

**结束后删除会话**:成功结束后从会话表里删掉。默认开启。

**加入录屏历史**:是否把成品复制到本机录屏历史。后台录屏默认不加入。
**加入录屏历史**:是否把成品纳入本机录屏历史。后台录屏默认不加入;2.1.23 起,若成品保存到自定义目录,历史里只建立索引

## 输出

Expand Down
2 changes: 2 additions & 0 deletions docs/v2/xaction/modules/image/showimage.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,8 @@ legacyContentUpdatedAt: "2025-05-11T08:37:04.000Z"

## 图片窗口的使用

2.1.23 起,由新版贴图步骤生成的 HTML 或公式贴图也会以普通图片窗口显示,因此可继续拖移、显示阴影,并可在 OCR 完成后选中文字复制。如果剪贴板图片携带 Quicker 或 PixPin 的位置数据,独立贴图步骤可贴回原处;本 **显示图片** 模块仍按下方 **显示位置** 和 **位置坐标** 参数决定窗口位置。

![](./img/showimage-005-04f2c536e2.png)

### 右键菜单
Expand Down
Loading