ceastld · Sep 23, 2026 · Sep 23, 2026
diff --git a/docs/important-notice.md b/docs/important-notice.md
@@ -95,6 +95,10 @@ AI 助手正式版支持选择本地工作区。选择本地文件夹后，AI
 
 远程文件账号的导出 JSON 包含明文密码或密钥。不要上传到公开网盘、聊天群、动作分享或源码仓库；传输完成后及时删除，外泄后立即在服务端轮换凭据。
 
+## 2.2.20 显示器与虚拟桌面步骤
+
+2.2.20 起新增的显示器、虚拟桌面步骤需要新版客户端。含这些步骤的动作在旧版客户端中可能无法识别或运行；多设备同步或分享给他人前，请确认目标设备已升级到 2.2.20 或更高版本。
+
 ## 相关链接
 
 <RelatedDocs

diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md
@@ -12,7 +12,7 @@ comments: true
 
 **[https://getquicker.net/v2/versions](https://getquicker.net/v2/versions)**
 
-本站功能说明已按 2.2.19 补充，新增了[远程文件](/v2/features/remote-files)、[自动化脚本调用截图 Pro](/v2/xaction/modules/automationscript#打开截图-pro)、[贴图窗口句柄](/v2/xaction/modules/pinimage)和[匹配子窗口详情](/v2/xaction/modules/getwindowtitle#输出)等说明。版本是否已开放下载、完整条目及安装包校验值，以官网为准。
+本站功能说明已按 2.2.20 补充，新增了[显示器与虚拟桌面步骤能力](/v2/xaction)、[子程序输入参数设置](/v2/xaction/modules/subprogram#输入参数)、[录屏 FFmpeg 参数](/v2/xaction/modules/screen-recording-ui#参数说明)和[贴图窗口阴影快捷键](/v2/features/screenshot/capture-pro#移动模式)等说明。版本是否已开放下载、完整条目及安装包校验值，以官网为准。
 
 安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。
 
@@ -36,6 +36,8 @@ comments: true
 
 2.2.18 补充了 [远程文件（WebDAV）步骤能力与本机账号限制](/v2/xaction)、[远程文件账号入口和 HTTP / WebSocket 设置迁移](/v2/features/software-connections)、[主面板自由格子边缘插队、工具菜单和未配置程序提示](/v2/features/action-panel/usage)、[软件桥接命令工具生成动作拖放与 Photoshop 分类筛选](/v2/features/software-connections/command-tool)、[触发规则粘贴到选中项之后及批量删除](/v2/features/triggers/advanced-mouse-triggers#规则列表筛选)、[AI 助手正式版工作区选择、历史对话目录恢复和导出后打开文件夹](/v2/features/ai-and-agent)，以及 [贴图穿透模式下通过工具栏拖动和定位修正](/v2/features/screenshot/capture-pro#贴图窗口截图后)。回退和跨设备注意见 [2.2.18 远程文件账号与 AI 助手工作区](/important-notice#2218-远程文件账号与-ai-助手工作区)；新版网络子程序搜索 / 更新检查、焦点切换瞬间窗口信息获取、贴图工具栏空格和右键遮挡等修复以官网完整记录为准。
 
+2.2.20 补充了 [显示器与虚拟桌面步骤能力](/v2/xaction)（参数页待 `data/xaction` 同步后再补）、[子程序输入参数的代码语言和高级分组](/v2/xaction/modules/subprogram#输入参数)、[屏幕录制](/v2/xaction/modules/screen-recording-ui#参数说明)与[后台屏幕录制](/v2/xaction/modules/screen-recording#参数说明)可填写 FFmpeg 编码参数，以及[贴图窗口按 `Y` 切换阴影、右键菜单常用窗口操作上移](/v2/features/screenshot/capture-pro#移动模式)。含显示器或虚拟桌面步骤的动作需要 2.2.20 或更高版本客户端，见 [体验前必读](/important-notice#2220-显示器与虚拟桌面步骤)；完整条目仍以[官网版本记录](https://getquicker.net/V2/Versions)为准。
+
 升级到 2.1.23 或更高版本时仍需特别检查：**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其它旧动作升级后请打开动作确认录制范围，避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。
 
 体验、降级和回退风险见 [体验前必读](/important-notice)。
diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md
@@ -46,7 +46,7 @@ comments: true
 
 这些设置影响手动截图和未显式指定行为的场景。通过组合动作步骤调用截图 Pro 时，**步骤参数优先**；例如动作里已经指定了写入剪贴板、截图后贴图或工具栏配置，就按动作步骤当前参数执行。
 
-2.2.17 起，截图设置可指定**本机 ffmpeg** 用于 MP4 实时录屏：默认关闭；需自行准备 `ffmpeg.exe`，在设置中检测通过后再启用。未启用时仍使用原有录制路径。
+2.2.17 起，截图设置可指定**本机 ffmpeg** 用于 MP4 实时录屏：默认关闭；需自行准备 `ffmpeg.exe`，在设置中检测通过后再启用。未启用时仍使用原有录制路径。2.2.20 起，录屏步骤还可直接填写编码方案和多行 FFmpeg 参数（支持变量），用于自定义编码器、码率或滤镜；使用自定义编码时仍以设置页检测通过的本机 ffmpeg 路径为前提。
 
 完整发版注意见[官网版本记录](https://getquicker.net/V2/Versions)。
 
@@ -234,6 +234,8 @@ comments: true
 
 2.2.17 起，录屏结束后预览会自动获得焦点，可用空格暂停或继续；预览工具条支持调整播放速度。需要边录边生成 MP4 时，可在截图设置中启用本机 ffmpeg（见上文[截图 Pro 设置页](#截图-pro-设置页)）。
 
+2.2.20 起，[屏幕录制](/v2/xaction/modules/screen-recording-ui)和[后台屏幕录制](/v2/xaction/modules/screen-recording)步骤可直接填写 FFmpeg 编码参数。参数会随同一次录制会话固定下来，并用于实时编码、延后转码、预览保存和音频合成；不要在自定义参数里再添加额外输出文件。
+
 说明：
 
 - 步骤的 **写入剪贴板** 和 **截图后贴图** 只叠加到默认确认出口（双击、`Enter` 或工具栏确认）。
@@ -260,10 +262,13 @@ comments: true
 - **空格**：显示 / 隐藏标注工具栏
 - **`L`**：锁定 / 解锁窗口
 - **`T`**：切换置顶
+- **`Y`**：切换窗口阴影
 - **`Ctrl+W` / `Esc`**：关闭贴图
 
 2.2.17 起，贴图支持**鼠标穿透**：开启后鼠标可点到贴图后方的窗口；可用独立工具条调节不透明度、恢复操作，或关闭贴图。需要临时对照文档又不想挡住点击时，打开穿透即可。2.2.18 起，穿透模式下也可通过这条工具栏拖动贴图，工具栏定位更准确；同时修复了空格显示工具栏和右键菜单遮挡相关问题。
 
+2.2.20 起，贴图窗口按 `Y` 可直接切换窗口阴影；正在编辑文字时不会抢走输入，`Ctrl+Y` 仍按重做处理。同版起，右键菜单中的常用窗口状态操作提升到一级菜单，二维码相关操作移到识别子菜单中。
+
 ### 图像处理与工具栏
 
 - 右键菜单「图像处理」中可用 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。
@@ -275,7 +280,7 @@ comments: true
 
 ### 显示与缩略图
 
-- 右键菜单「显示」可调缩放（25%–200%）、不透明度预设、窗口阴影、置顶等。
+- 右键菜单可直接处理常用窗口状态；「显示」中仍可调缩放（25%–200%）、不透明度预设、窗口阴影、置顶等。
 - 缩略图模式下，复制和另存为只输出当前可见部分；完整内容在退出缩略图后仍保留。
 - 缩略图视口内可平移、拖拽边缘调整窗口大小；菜单中可用「重置缩略图范围」恢复，或用 **裁剪** 永久裁成当前视口。
 
@@ -396,6 +401,7 @@ HTML、公式贴图缩放时先显示预览，停稳后按倍率重绘；复制
 | 缩略图 | `R` 或右键拖框 |
 | 贴图锁定 | `L`（贴图窗口；截图阶段 `L` 为长截图） |
 | 贴图置顶 | `T` |
+| 贴图阴影 | `Y`（文字编辑时不拦截；`Ctrl+Y` 仍为重做） |
 | 关闭贴图 | `Ctrl+W` / `Esc` |
 | 图像处理（工具栏隐藏） | `1`–`8`；`0` 重置 |
 

diff --git a/docs/v2/what's-new/xaction-steps/subprogram.md b/docs/v2/what's-new/xaction-steps/subprogram.md
@@ -18,6 +18,8 @@ comments: true
 
 2.2.8 起，子程序中的软件连接（Bridge）步骤会沿用调用动作的目标窗口，不再在进入子程序后丢失。
 
+2.2.20 起，定义或编辑子程序输入参数时，代码样式输入可选择代码语言；参数较多的子程序也可用高级分组整理调用界面。
+
 这些变化不会修改子程序的输入输出定义，但复杂动作升级后仍建议重点检查依赖并行、窗口回调或主动中止的调用链。
 
 参数说明见[运行子程序](/v2/xaction/modules/subprogram)。
diff --git a/docs/v2/xaction/concepts/subprogram.md b/docs/v2/xaction/concepts/subprogram.md
@@ -75,6 +75,8 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"
   remark="子程序输入"
 />
 
+2.2.20 起，定义输入参数时，代码样式的输入可选择代码语言；参数较多时，也可使用高级分组整理调用界面。它们只影响调用者看到和编辑参数的方式，不改变变量名、输入 / 输出标记或传值规则。
+
 ## 动作内子程序
 
 只存在当前动作里。编辑器有单独标签：列表、新建、从网址/文件导入、清理未使用。

diff --git a/docs/v2/xaction/index.md b/docs/v2/xaction/index.md
@@ -14,6 +14,8 @@ hide_table_of_contents: true
 
 2.2.18 起，客户端新增[远程文件](/v2/xaction/modules/remotefile)步骤，可通过 WebDAV 上传、下载、列出、查询、删除或移动网盘及 NAS 文件，并创建目录；2.2.19 起进一步支持 S3、文本与图片内容、复制文件和批量传输。账号在 **设置 → 软件连接 → 远程文件账号** 中配置，只保存在本机；换电脑或分享动作时，需要在目标电脑配置相同的账号引用名。
 
+2.2.20 起，客户端新增 **显示器** 与 **虚拟桌面** 步骤。显示器步骤可获取屏幕列表、坐标和工作区，并对鼠标所在屏、主屏、指定屏或全部屏读取、设置或增减亮度，也可显示可交互亮度 OSD；复制显示导致无法唯一对应物理显示器时，请明确指定目标。虚拟桌面步骤可查询、切换、创建、删除、重命名、排序桌面，查询窗口所在桌面并移动窗口，也可读取或设置窗口是否固定到所有桌面；能力取决于 Windows 完整版本，删除桌面时需要指定窗口迁移目标，且不能删除最后一个桌面。当前 `data/xaction` 尚未同步这两个模块的参数定义，本站先说明能力；具体参数请以客户端步骤编辑器和[官网版本记录](https://getquicker.net/V2/Versions)为准。
+
 <XActionLanding
   moduleCount={173}
   generatedAt="2026-09-22 21:47:06"

diff --git a/docs/v2/xaction/modules/flow/subprogram.md b/docs/v2/xaction/modules/flow/subprogram.md
@@ -107,6 +107,8 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"
 
 ![](./img/subprogram-006-91ac05bd3e.png)
 
+2.2.20 起，编辑子程序输入参数时，代码样式的输入可选择代码语言，参数界面也支持高级分组，便于把复杂子程序的选项按用途收纳。这里是界面配置能力，不改变输入变量的名称或传值方式；具体字段请以客户端变量属性窗口为准。
+
 变量一旦作为子程序的输入或输出，尽量不要改名。改了之后，请编辑调用它的「运行子程序」步骤，重新设置参数。
 
 ### 输出参数
@@ -295,6 +297,7 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"
 
 ## 更新历史
 
+- 2.2.20：子程序输入参数支持代码语言选择和高级分组。
 - 2.1.28：调试结果支持定位共享子程序步骤。
 - 2.1.26：网络共享子程序步骤右键菜单新增「查看定义」，可预览当前引用版本。
 - 20250606 修改描述错误。
diff --git a/docs/v2/xaction/modules/image/pinimage.md b/docs/v2/xaction/modules/image/pinimage.md
@@ -30,3 +30,5 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 2.2.17 起，贴图支持**鼠标穿透**，并可通过独立工具条调节不透明度、恢复操作或关闭贴图。交互细节见 [截图 Pro · 贴图窗口](/v2/features/screenshot/capture-pro#贴图窗口截图后)。
 
 2.2.19 起，步骤成功创建贴图后会输出 **窗口句柄**。可将它传给[窗口操作](/v2/xaction/modules/windowoperations)等后续步骤，精确操作本次新建的贴图，不必依赖窗口标题。贴图关闭后句柄失效，不要持久化后在下次运行中复用。
+
+2.2.20 起，贴图窗口可按 `Y` 切换窗口阴影，右键菜单也把常用窗口状态操作提升到一级菜单；文字编辑时不会拦截 `Y`，`Ctrl+Y` 仍用于重做。详情见 [截图 Pro · 贴图窗口](/v2/features/screenshot/capture-pro#贴图窗口截图后)。
diff --git a/docs/v2/xaction/modules/image/screen-recording-ui.md b/docs/v2/xaction/modules/image/screen-recording-ui.md
@@ -50,6 +50,8 @@ metadataGeneratedAt: "2026-09-20 15:25:17"
 
 2.2.17 起，录屏结束预览自动获得焦点，可按空格暂停或继续，并在预览工具条调整播放速度。需要以本机 ffmpeg 编码 MP4 时，在截图设置中启用并检测路径；配置方法见[截图 Pro 设置页](/v2/features/screenshot/capture-pro#截图-pro-设置页)。
 
+2.2.20 起，本步骤可在客户端编辑器中选择编码方案，并填写多行 **FFmpeg 参数**（支持变量），用于自定义编码器、码率或滤镜。使用自定义编码时仍需本机 ffmpeg 路径检测通过；同一次录制会话会固定使用开始时的 ffmpeg 路径和参数，并贯穿实时编码、延后转码、预览保存和音频合成。自定义参数只应描述编码和过滤选项，不要再添加额外输出文件。若下方参数预览暂未显示这些字段，请以客户端步骤编辑器和[官网版本记录](https://getquicker.net/V2/Versions)为准。
+
 **开始前延迟**：等多少毫秒再弹出选区。
 
 **手动调整选区**：默认关闭：框选完就确认并开录。打开后可以先改选区，再确认开录。

diff --git a/docs/v2/xaction/modules/image/screen-recording.md b/docs/v2/xaction/modules/image/screen-recording.md
@@ -78,6 +78,8 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 
 **编码策略**：实时编码（停录后立即可用，需要 QuickerAvCodec）；或录制结束后再转码（停录后要等 ffmpeg）。
 
+2.2.20 起，开始录屏时可在客户端编辑器中选择编码方案，并填写多行 **FFmpeg 参数**（支持变量），用于自定义编码器、码率或滤镜。使用自定义编码时仍需本机 ffmpeg 路径检测通过；同一次录制会话会固定使用开始时的 ffmpeg 路径和参数，并贯穿实时编码、延后转码、预览保存和音频合成。自定义参数只应描述编码和过滤选项，不要再添加额外输出文件。若当前参数预览暂未显示这些字段，请以客户端步骤编辑器和[官网版本记录](https://getquicker.net/V2/Versions)为准。
+
 **开始后立即返回**：打开后本步骤启动录制就成功返回；结束请另写一步。默认开启。
 
 **开始前延迟**：等多少毫秒再开录。
Original file line number	Diff line number	Diff line change
Expand Up		@@ -30,3 +30,5 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
		2.2.17 起，贴图支持鼠标穿透，并可通过独立工具条调节不透明度、恢复操作或关闭贴图。交互细节见 [截图 Pro · 贴图窗口](/v2/features/screenshot/capture-pro#贴图窗口截图后)。

		2.2.19 起，步骤成功创建贴图后会输出窗口句柄。可将它传给[窗口操作](/v2/xaction/modules/windowoperations)等后续步骤，精确操作本次新建的贴图，不必依赖窗口标题。贴图关闭后句柄失效，不要持久化后在下次运行中复用。

		2.2.20 起，贴图窗口可按 `Y` 切换窗口阴影，右键菜单也把常用窗口状态操作提升到一级菜单；文字编辑时不会拦截 `Y`，`Ctrl+Y` 仍用于重做。详情见 [截图 Pro · 贴图窗口](/v2/features/screenshot/capture-pro#贴图窗口截图后)。