ceastld · Sep 8, 2026 · Sep 8, 2026
diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md
@@ -12,13 +12,13 @@ comments: true
 
 **[https://getquicker.net/v2/versions](https://getquicker.net/v2/versions)**
 
-官网版本记录目前写到 2.2.7，完整条目以那里为准。
+官网版本记录目前写到 2.2.8，完整条目以那里为准。
 
 安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。
 
 本站补充的是安装、迁移、功能说明和相对 1.x 的结构变化，例如 [V2 重要变化](/v2/what's-new/)。文档会随版本抽查修订，但不会在每次发版时完整复述官网 changelog。
 
-2.1.29–2.2.0 的用户可见补充集中在新版主窗口侧边栏快捷按钮、暂存区「新建动作 / 用 AI 写」和「保留到场景」、贴图通用 / 人像抠图、自动化脚本面向窗口与区域的 OCR / 找图 / 找色和相对点击、窗口操作的贴边自动隐藏 / 类似窗口关闭与切换，以及步骤编辑器可拉伸或贴靠到完整屏幕高度。2.2.1 继续补充了 [动作分享的 V1 / V2 制品兼容说明](/v2/what's-new/actions#动作与公共子程序分享)、[可视化录屏预选范围](/v2/xaction/modules/screen-recording-ui)、[选中文本工具条悬浮圆点与选区定位](/v2/features/triggers/text-selection-toolbar)、[截图 Pro 设置页](/v2/features/screenshot/capture-pro#截图-pro-设置页)、[图片翻译 V2.0 单独凭证](/v2/features/screenshot/image-translate)，并新增 [等待窗口](/v2/xaction/modules/waitwindow) 步骤、把等待类步骤集中到等待分组。2.2.2–2.2.3 补充了 [动作分享安装、公共子程序嵌入和预览版本号](/v2/features/action-sharing)、[百度图片翻译 V2.0 单独凭证 / API Key](/v2/features/screenshot/image-translate)、[本地表格 OCR 固定使用 small 模型](/v2/what's-new/xaction-steps/basic-ocr)，以及 [截图快捷键提示布局和遮挡处理](/v2/features/screenshot/capture-pro#快捷键一览)。2.2.4 补充了 [软件连接与 Bridge](/v2/features/software-connections) 入口、[OCR 结果窗的表格识别、Excel 打开和原图复制](/v2/features/screenshot/capture-pro#结果窗)、[用 AI 写的重复点击与未配置模型处理](/v2/features/ai-and-agent)，以及百度图片翻译 V2.0 短暂简化为只需 API Key。2.2.5 补充了 [软件连接与 Bridge](/v2/features/software-connections) 在设置页内安装与管理、[模兔云软件连接](/v2/features/software-connections/software/motuyun)、[截图 Pro 二维码识别、贴图分组与保存模板](/v2/features/screenshot/capture-pro)、[AI 助手本机用量与工作区](/v2/features/ai-and-agent)，以及文件列表获取超时、[百度图片翻译 V2.0 APP ID 与 API Key 双凭证](/v2/features/screenshot/image-translate) 和 [2.2.4 回退风险](/important-notice)。2.2.6 补充了 [悬浮动作与分组](/v2/features/floating-actions)（整组缩放、窗口跟随、自动折叠、布局备份；默认关闭，启用后需重启）、[截图选区悬停识别二维码](/v2/features/screenshot/capture-pro#选区二维码)、[Mastercam 软件连接](/v2/features/software-connections/software/mastercam)、动作编辑器进入时优先显示收藏夹，以及 [作者重装恢复原标识、复制切断分享关系](/v2/features/action-sharing#安装标识与副本)。2.2.7 补充了 [截图 Pro 选区阴影与边框及记忆规则](/v2/features/screenshot/capture-pro#选区阴影与边框)、[OCR 结果窗文本工具](/v2/features/screenshot/capture-pro#结果窗)、[截图侧栏恢复已关闭贴图](/v2/features/screenshot/capture-pro#贴图窗口截图后)、[Photoshop 手动路径与 Adobe 安装依赖检测](/v2/features/software-connections/software/photoshop)、设置窗滚轮切换分组、[表达式显式 dynamic](/v2/xaction/concepts/expression#表达式的运算结果)、[表单打开前提示缺失变量](/v2/xaction/modules/form)，以及 [回退 2.2.6 丢阴影边框配置](/important-notice)（可备份 `image-drawing-tool-state.json`）。本站只补操作上会遇到的差异，完整版本记录仍见官网。
+2.1.29–2.2.0 的用户可见补充集中在新版主窗口侧边栏快捷按钮、暂存区「新建动作 / 用 AI 写」和「保留到场景」、贴图通用 / 人像抠图、自动化脚本面向窗口与区域的 OCR / 找图 / 找色和相对点击、窗口操作的贴边自动隐藏 / 类似窗口关闭与切换，以及步骤编辑器可拉伸或贴靠到完整屏幕高度。2.2.1 继续补充了 [动作分享的 V1 / V2 制品兼容说明](/v2/what's-new/actions#动作与公共子程序分享)、[可视化录屏预选范围](/v2/xaction/modules/screen-recording-ui)、[选中文本工具条悬浮圆点与选区定位](/v2/features/triggers/text-selection-toolbar)、[截图 Pro 设置页](/v2/features/screenshot/capture-pro#截图-pro-设置页)、[图片翻译 V2.0 单独凭证](/v2/features/screenshot/image-translate)，并新增 [等待窗口](/v2/xaction/modules/waitwindow) 步骤、把等待类步骤集中到等待分组。2.2.2–2.2.3 补充了 [动作分享安装、公共子程序嵌入和预览版本号](/v2/features/action-sharing)、[百度图片翻译 V2.0 单独凭证 / API Key](/v2/features/screenshot/image-translate)、[本地表格 OCR 固定使用 small 模型](/v2/what's-new/xaction-steps/basic-ocr)，以及 [截图快捷键提示布局和遮挡处理](/v2/features/screenshot/capture-pro#快捷键一览)。2.2.4 补充了 [软件连接与 Bridge](/v2/features/software-connections) 入口、[OCR 结果窗的表格识别、Excel 打开和原图复制](/v2/features/screenshot/capture-pro#结果窗)、[用 AI 写的重复点击与未配置模型处理](/v2/features/ai-and-agent)，以及百度图片翻译 V2.0 短暂简化为只需 API Key。2.2.5 补充了 [软件连接与 Bridge](/v2/features/software-connections) 在设置页内安装与管理、[模兔云软件连接](/v2/features/software-connections/software/motuyun)、[截图 Pro 二维码识别、贴图分组与保存模板](/v2/features/screenshot/capture-pro)、[AI 助手本机用量与工作区](/v2/features/ai-and-agent)，以及文件列表获取超时、[百度图片翻译 V2.0 APP ID 与 API Key 双凭证](/v2/features/screenshot/image-translate) 和 [2.2.4 回退风险](/important-notice)。2.2.6 补充了 [悬浮动作与分组](/v2/features/floating-actions)（整组缩放、窗口跟随、自动折叠、布局备份；默认关闭，启用后需重启）、[截图选区悬停识别二维码](/v2/features/screenshot/capture-pro#选区二维码)、[Mastercam 软件连接](/v2/features/software-connections/software/mastercam)、动作编辑器进入时优先显示收藏夹，以及 [作者重装恢复原标识、复制切断分享关系](/v2/features/action-sharing#安装标识与副本)。2.2.7 补充了 [截图 Pro 选区阴影与边框及记忆规则](/v2/features/screenshot/capture-pro#选区阴影与边框)、[OCR 结果窗文本工具](/v2/features/screenshot/capture-pro#结果窗)、[截图侧栏恢复已关闭贴图](/v2/features/screenshot/capture-pro#贴图窗口截图后)、[Photoshop 手动路径与 Adobe 安装依赖检测](/v2/features/software-connections/software/photoshop)、设置窗滚轮切换分组、[表达式显式 dynamic](/v2/xaction/concepts/expression#表达式的运算结果)、[表单打开前提示缺失变量](/v2/xaction/modules/form)，以及 [回退 2.2.6 丢阴影边框配置](/important-notice)（可备份 `image-drawing-tool-state.json`）。2.2.8 补充了 [截图 Pro 混合文本捕获](/v2/features/screenshot/capture-pro#混合文本捕获)、[选区侧栏按住刷新与 F5](/v2/features/screenshot/capture-pro#选区刷新)、[剪贴板贴图支持富文本 / 公式 / 纯文本 / 图片文件](/v2/features/screenshot/capture-pro#贴图窗口截图后)、[「恢复贴图」更名与连续恢复](/v2/features/screenshot/capture-pro#贴图窗口截图后)，以及跨屏工具栏定位、刷新后马赛克与旧智能马赛克结果清理、[选中文本工具条从圆点展开不再误隐藏](/v2/features/triggers/text-selection-toolbar#悬浮圆点与选区定位)、[表达式数组 / 可空值 / 枚举匹配](/v2/xaction/concepts/expression#表达式的运算结果)、[多字段表单小数加减尾数](/v2/xaction/modules/form)、[子程序内软件连接目标窗口](/v2/what's-new/xaction-steps/subprogram) 等修复。本站只补操作上会遇到的差异，完整版本记录仍见官网。
 
 升级到 2.1.23 或更高版本时仍需特别检查：**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其它旧动作升级后请打开动作确认录制范围，避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。
 

diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md
@@ -67,6 +67,14 @@ comments: true
 - **确认**：双击或 `Enter`
 - **重选 / 取消**：右键或 `Esc`
 
+### 混合文本捕获
+
+2.2.8 起，在**自动选区**阶段可混合捕获界面文字与图片文字：按 `R` 或 `Shift+C`，会读取当前 UI 文本，并用 OCR 补充图片中的文字；按 `Ctrl+Shift+C` 可直接把结果复制到剪贴板。这些快捷键用于自动选区阶段；手动框选后请用工具栏 OCR。贴图窗口里的 `R` 仍是缩略图切换，二者场景不同。
+
+### 选区刷新
+
+2.2.8 起，选区侧栏支持**按住刷新**查看实时桌面，松开后重新捕获当前画面；也可按 `F5` 刷新截图，并保留当前选区、样式和标注。刷新后再用马赛克、模糊、填充、橡皮擦或撤销 / 重做时，不会带回旧画面；旧画面上的智能马赛克识别结果也会清除。
+
 ### 选区二维码
 
 2.2.5 起，OCR 结果窗可以查看并复制识别到的二维码内容。2.2.6 起，截图选区阶段也会自动识别选区内的二维码：把光标悬停到码上即可看到内容，并可直接复制或打开链接，不必先打开结果窗。
@@ -117,7 +125,7 @@ comments: true
 
 ### 工具栏位置
 
-截图 Pro 工具栏可以拖动并吸附到选区附近；双击拖动手柄可恢复自动定位。进入长截图或录屏后，对应工具栏也提供六点拖动手柄，可停靠在选区四边或自由摆放，双击手柄同样恢复自动定位。
+截图 Pro 工具栏可以拖动并吸附到选区附近；双击拖动手柄可恢复自动定位。进入长截图或录屏后，对应工具栏也提供六点拖动手柄，可停靠在选区四边或自由摆放，双击手柄同样恢复自动定位。2.2.8 起，跨多显示器时工具栏和选区样式栏会跟到正确屏幕，避免贴错屏或被裁切。
 
 ### 马赛克与智能马赛克
 
@@ -251,7 +259,9 @@ comments: true
 
 2.2.5 起，贴图支持分组。可在贴图菜单中切换桌面贴图组；采集历史中心可把多张历史图片批量贴图到指定组、在组之间移动贴图，并管理分组。
 
-2.2.7 起，截图侧栏可连续贴出之前关闭的贴图（恢复贴图），不必先打开采集历史中心。
+2.2.7 起，截图侧栏可连续贴出之前关闭的贴图。2.2.8 起，「贴出上一个关闭的贴图」更名为「恢复贴图」，可连续恢复最近关闭的贴图，不必先打开采集历史中心。
+
+常用功能和侧栏中的「剪贴板贴图」在 2.2.8 起支持富文本 HTML、公式、纯文本和图片文件，不再仅限于位图。
 
 ## 动作步骤参数
 
@@ -293,6 +303,9 @@ comments: true
 | 显示工具栏 | `Space` |
 | 贴图 | `Ctrl+T` |
 | 复制 | `Ctrl+C` |
+| 混合文本捕获（读 UI + OCR） | `R` / `Shift+C`（自动选区） |
+| 复制混合文本结果 | `Ctrl+Shift+C`（自动选区） |
+| 刷新截图（保留选区与标注） | `F5` |
 | 长截图 / 录屏 | `L` / `G` |
 | 重选 / 取消 | 右键 / `Esc` |
 

diff --git a/docs/v2/features/triggers/text-selection-toolbar.md b/docs/v2/features/triggers/text-selection-toolbar.md
@@ -50,7 +50,7 @@ comments: true
 
 2.2.1 起，选中文本工具条可以先显示一个悬浮圆点，也可以尝试按文本选区位置定位工具条。这两个选项默认关闭，需要在 **设置 → 功能 → 选中文本工具条** 手动开启。
 
-按选区定位依赖目标程序能提供可靠的选区位置。自绘编辑器、远程桌面、浏览器内复杂页面等场景可能定位不准；遇到偏移或遮挡时，可关闭该选项，改回鼠标附近显示或主动快捷键呼出。完整发版说明见[官网版本记录](https://getquicker.net/V2/Versions)。
+按选区定位依赖目标程序能提供可靠的选区位置。自绘编辑器、远程桌面、浏览器内复杂页面等场景可能定位不准；遇到偏移或遮挡时，可关闭该选项，改回鼠标附近显示或主动快捷键呼出。2.2.8 起，从悬浮圆点展开工具条后，工具条不会再被误判为需要自动隐藏。完整发版说明见[官网版本记录](https://getquicker.net/V2/Versions)。
 
 ## 配置候选操作
 

diff --git a/docs/v2/what's-new/tools-and-experience.md b/docs/v2/what's-new/tools-and-experience.md
@@ -18,11 +18,11 @@ V2 将截图、贴图、长截图和录屏整理为更完整的工作流。
 
 2.1.26 起，OCR 结果窗新增 **翻译** 页签，可选择源语言、目标语言和服务商，支持自动翻译、重新翻译和复制译文。结果窗初始占用降低，首屏显示更快；切到需要付费识别的公式页签前会先确认。2.1.27 起，结果窗显示识别耗时，翻译原文 / 译文可同步滚动，冷启动会先显示预览。2.2.4 起，规范表格识别继续优化；表格结果可用 Excel 打开，左侧原图大图可右键复制。详情见 [截图 Pro 的 OCR 结果窗](../features/screenshot/capture-pro.md#结果窗)。
 
-选区阶段可用 `Ctrl+A` 在鼠标所在显示器与全部屏幕之间切换。2.1.25 起，截图 Pro 和屏幕截图的快捷键提示在多显示器环境下会跟随光标所在显示器，并尽量避让当前选区。2.2.2–2.2.3 继续调整提示布局与键位显示，长按键不再把卡片撑得过宽；提示被鼠标或选区遮挡时会自动隐藏。截图 Pro、长截图和录屏的工具栏可以拖动并吸附到选区附近，双击手柄可恢复自动定位；吸附窗口时也会尽量排除窗口阴影。2.1.27 起，快速截图和获取窗口信息可正确选中部分透明顶层弹窗。2.1.29 起，截图窗口选择高亮更醒目，套索和贴图阴影等标注细节也继续改进。
+选区阶段可用 `Ctrl+A` 在鼠标所在显示器与全部屏幕之间切换。2.1.25 起，截图 Pro 和屏幕截图的快捷键提示在多显示器环境下会跟随光标所在显示器，并尽量避让当前选区。2.2.2–2.2.3 继续调整提示布局与键位显示，长按键不再把卡片撑得过宽；提示被鼠标或选区遮挡时会自动隐藏。截图 Pro、长截图和录屏的工具栏可以拖动并吸附到选区附近，双击手柄可恢复自动定位；吸附窗口时也会尽量排除窗口阴影。2.1.27 起，快速截图和获取窗口信息可正确选中部分透明顶层弹窗。2.1.29 起，截图窗口选择高亮更醒目，套索和贴图阴影等标注细节也继续改进。2.2.8 起，自动选区可用 `R` / `Shift+C` 混合捕获界面文字与图片文字（`Ctrl+Shift+C` 直接复制）；选区侧栏可按住刷新查看实时桌面，或按 `F5` 刷新并保留选区、样式与标注；跨屏时工具栏与选区样式栏定位更稳。
 
 步骤工具栏既可用可视化方式拖放内置工具、分组和自定义命令，也可配置 **自定义工具栏脚本**（JavaScript）：用压缩写法 `sp` / `act` 给默认工具栏加「调子程序 / 开动作」按钮，需要分支时再写完整 `run`。说明见 [JS 自定义工具栏](../features/screenshot/toolbar-script.md)。
 
-贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。2.1.28 起，右键菜单「图像处理」可 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。重启后恢复贴图时，原显示器仍在则尽量保留上次屏幕位置；HTML 和公式贴图使用隔离渲染后以普通图片窗口显示，可继续拖移、显示阴影并选字复制。Quicker 或 PixPin 复制的图片位置可随剪贴板保留，配合贴图步骤的「截图原位置」把图片贴回原处。
+贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。2.1.28 起，右键菜单「图像处理」可 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。重启后恢复贴图时，原显示器仍在则尽量保留上次屏幕位置；HTML 和公式贴图使用隔离渲染后以普通图片窗口显示，可继续拖移、显示阴影并选字复制。Quicker 或 PixPin 复制的图片位置可随剪贴板保留，配合贴图步骤的「截图原位置」把图片贴回原处。2.2.8 起，「恢复贴图」可连续恢复最近关闭的贴图；常用功能 / 侧栏的「剪贴板贴图」支持富文本 HTML、公式、纯文本和图片文件。
 
 截图、贴图与录屏历史使用统一的采集历史中心。录屏成品可页内预览、复制、另存和切换播放速度；进行中的录屏也可以在这里管理。交互式和后台录屏步骤支持选择保存文件夹，写到自定义目录的成品只建立历史索引，不再为了入库额外复制一份。2.2.1 起，可视化录屏可预选主屏幕、所有屏幕或固定区域，跳过手动框选并直接打开录屏工具栏。
 
@@ -44,7 +44,7 @@ V2 将截图、贴图、长截图和录屏整理为更完整的工作流。
 
 V2 改为轻量的“选中文本工具条”。它可以在选中文字后显示少量常用操作，并把更多操作收纳到展开菜单中。
 
-工具条支持全局默认清单和按场景追加、替换或禁用。也可以关闭自动显示，仅通过快捷键主动呼出。2.2.1 起，可在 **设置 → 功能 → 选中文本工具条** 手动开启「先显示悬浮圆点」和「按选区位置定位」；这两个选项默认关闭，定位效果取决于目标程序是否能提供可靠的选区位置。
+工具条支持全局默认清单和按场景追加、替换或禁用。也可以关闭自动显示，仅通过快捷键主动呼出。2.2.1 起，可在 **设置 → 功能 → 选中文本工具条** 手动开启「先显示悬浮圆点」和「按选区位置定位」；这两个选项默认关闭，定位效果取决于目标程序是否能提供可靠的选区位置。2.2.8 起，从悬浮圆点展开工具条后，工具条不会再被误判为需要自动隐藏。
 
 详情见[选中文本工具条](../features/triggers/text-selection-toolbar.md)。
 

diff --git a/docs/v2/what's-new/xaction-steps/subprogram.md b/docs/v2/what's-new/xaction-steps/subprogram.md
@@ -16,6 +16,8 @@ comments: true
 
 2.1.28 起，调试结果支持定位共享子程序步骤，排查调用链时更容易回到对应步骤。
 
+2.2.8 起，子程序中的软件连接（Bridge）步骤会沿用调用动作的目标窗口，不再在进入子程序后丢失。
+
 这些变化不会修改子程序的输入输出定义，但复杂动作升级后仍建议重点检查依赖并行、窗口回调或主动中止的调用链。
 
 参数说明见[运行子程序](/v2/xaction/modules/subprogram)。
diff --git a/docs/v2/xaction/concepts/expression.md b/docs/v2/xaction/concepts/expression.md
@@ -96,7 +96,7 @@ legacyContentUpdatedAt: "2023-10-08T07:46:06.000Z"
 
 如果参数的类型与表达式结果的不同，Quicker将尝试自动转换（如将文本转换为数字等）。
 
-2.2.7 起，表达式可显式声明 `dynamic` 类型；按 `object` 使用时的行为与以前一致，只是需要动态类型时不必再绕弯声明。
+2.2.7 起，表达式可显式声明 `dynamic` 类型；按 `object` 使用时的行为与以前一致，只是需要动态类型时不必再绕弯声明。2.2.8 起，数组初始化、空可空值转文本，以及枚举参数匹配的边界情况已修复，相关写法不再因此导致动作运行失败。
 
 ### 表达式支持的数据类型(C#)