From 3181b90738f798d007bf9acfa8d25cacf2434f3c Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Thu, 27 Aug 2026 22:08:54 +0000
Subject: [PATCH] =?UTF-8?q?docs(release-notes):=20=E5=90=8C=E6=AD=A5=202.1?=
 =?UTF-8?q?.29=20=E5=92=8C=202.2.0=20=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Cea <ceastld@users.noreply.github.com>
---
 docs/important-notice.md                         |  4 ++++
 docs/release-notes/index.md                      |  4 ++--
 docs/v2/features/ai-and-agent.md                 |  3 ++-
 docs/v2/features/screenshot/capture-pro.md       |  2 +-
 docs/v2/features/screenshot/index.md             |  2 +-
 docs/v2/what's-new/new-main-win/action-drafts.md |  6 ++++--
 docs/v2/what's-new/new-main-win/usage.md         | 10 +++++++++-
 docs/v2/what's-new/tools-and-experience.md       |  4 ++--
 docs/v2/what's-new/xaction-steps/index.md        |  3 ++-
 docs/v2/xaction/concepts/subprogram.md           |  2 ++
 docs/v2/xaction/concepts/xaction-editor.md       |  2 ++
 docs/v2/xaction/modules/image/pinimage.md        |  2 +-
 .../v2/xaction/modules/input/automationscript.md | 16 +++++++++-------
 .../xaction/modules/system/windowoperations.md   |  2 ++
 14 files changed, 43 insertions(+), 19 deletions(-)

diff --git a/docs/important-notice.md b/docs/important-notice.md
index 4e4cf20..9ddb3e0 100644
--- a/docs/important-notice.md
+++ b/docs/important-notice.md
@@ -38,6 +38,10 @@ V2 仍在快速迭代，部分功能未完成，已有动作也可能需要调
 
 更早的回退也有类似情况，例如回退到 2.1.12 可能清除图片翻译凭证。逐版本注意以 [官网版本记录](https://getquicker.net/v2/versions) 为准。
 
+## 2.1.29 侧边栏快捷按钮的回退注意
+
+2.1.29 起可配置新版主窗口侧边栏快捷按钮。配置后若再用 2.1.28 或更早版本修改并同步动作面板偏好，旧客户端可能清除快捷按钮配置，恢复为仅默认「截图 Pro」。多设备使用同一账号时，建议先升级所有设备；回退旧版后也避免修改该项。
+
 ## 相关链接
 
 <RelatedDocs
diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md
index 4972832..164791a 100644
--- 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.1.28，完整条目以那里为准。
+官网版本记录目前写到 2.2.0，完整条目以那里为准。
 
 安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。
 
 本站补充的是安装、迁移、功能说明和相对 1.x 的结构变化，例如 [V2 重要变化](/v2/what's-new/)。文档会随版本抽查修订，但不会在每次发版时完整复述官网 changelog。
 
-2.1.28 的用户可见补充集中在截图 Pro 套索裁切、贴图抠出主体、FlaUI 提取窗口界面信息 / 观察可交互元素、OCR 结果窗方向检测开关、场景可把程序归类为浏览器，以及主面板动作名称按按钮空间自动缩小。本站只补操作上会遇到的差异，完整版本记录仍见官网。
+2.1.29–2.2.0 的用户可见补充集中在新版主窗口侧边栏快捷按钮、暂存区「新建动作 / 用 AI 写」和「保留到场景」、贴图通用 / 人像抠图、自动化脚本面向窗口与区域的 OCR / 找图 / 找色和相对点击、窗口操作的贴边自动隐藏 / 类似窗口关闭与切换，以及步骤编辑器可拉伸或贴靠到完整屏幕高度。本站只补操作上会遇到的差异，完整版本记录仍见官网。
 
 升级到 2.1.23 或更高版本时仍需特别检查：**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其它旧动作升级后请打开动作确认录制范围，避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。
 
diff --git a/docs/v2/features/ai-and-agent.md b/docs/v2/features/ai-and-agent.md
index 67245f3..422dd87 100644
--- a/docs/v2/features/ai-and-agent.md
+++ b/docs/v2/features/ai-and-agent.md
@@ -13,6 +13,7 @@ comments: true
 ## 现在可以用
 
 - **统一 AI 设置**：设置里的「AI 服务」和「用途与模型」，用来管理连接、模型和用途优选。说明见 [统一 AI 服务与模型设置](/v2/what's-new/ai-services-and-models.md)。
+- **Quicker AI 写动作预览**：2.2.0 起，可在新版主窗口暂存区点击 **用 AI 写**，让 AI 生成或修改暂存动作；完成后暂存区会自动刷新。生成结果先留在本机暂存区，确认可用后再执行「保留到场景」转为正式动作。功能仍在改进中，AI 可能写错步骤或逻辑，保存前请自行检查、试运行和调试。
 - **五个组合动作模块**，共用上面的全局设置，不必在每个步骤里重填地址和 Key：
   - [AI 文本处理](/v2/xaction/modules/ai-text)
   - [AI 图片理解](/v2/xaction/modules/ai-vision)
@@ -20,7 +21,7 @@ comments: true
   - [AI 结构化提取](/v2/xaction/modules/ai-extract)
   - [AI 交互对话](/v2/xaction/modules/ai-chat)
 
-API Key 只在本机加密保存，不随动作分享，也不随普通设置文件拷到另一台电脑。
+首次使用 AI 能力前，需要在「配置 API」中添加服务商、模型和 API Key。多数服务需要自备账号和额度；API Key 只在本机加密保存，不随动作分享，也不随普通设置文件拷到另一台电脑。
 
 ## 还没有对普通用户普遍开放
 
diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md
index 573dd53..206cef7 100644
--- a/docs/v2/features/screenshot/capture-pro.md
+++ b/docs/v2/features/screenshot/capture-pro.md
@@ -205,7 +205,7 @@ comments: true
 
 ### 图像处理与工具栏
 
-- 右键菜单「图像处理」中可用 **抠出主体（透明背景）**，在本机完成主体抠图后继续保存或贴图。
+- 右键菜单「图像处理」中可用 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。
 - **工具栏隐藏时**：数字键 `1`–`8` 可快速旋转、翻转、灰度、反色、亮度等；`0` 重置滤镜、方向与不透明度。
 - **工具栏显示时**：数字键优先选择标注工具（见「快捷键一览」），不再触发图像处理。
 
diff --git a/docs/v2/features/screenshot/index.md b/docs/v2/features/screenshot/index.md
index 61cfb45..cf54afe 100644
--- a/docs/v2/features/screenshot/index.md
+++ b/docs/v2/features/screenshot/index.md
@@ -59,4 +59,4 @@ Quicker 提供一套完整的屏幕截取与后续处理能力，可在动作中
 
 [官网 2.1.21 记录](https://getquicker.net/V2/Versions)中新增了独立的 **贴图** 组合动作步骤，可从图片变量、剪贴板、文本、HTML、公式或 OCR 原始结果创建贴图；内容参数会跟随内容来源显示。[官网 2.1.23 记录](https://getquicker.net/V2/Versions)进一步增加了「自动」和「截图原位置」贴图位置，Quicker 或 PixPin 复制的图片可贴回原处，旧动作仍保持原有自定义坐标。当前仓库的 `data/xaction` 还没有该步骤的独立模块定义，因此参数页待后续结构化数据同步后补齐。已有 **显示图片** 步骤仍可用于显示图片文件、图片变量或剪贴板图片。
 
-截图界面内已集成 OCR、图片翻译、智能马赛克、斜铺文字水印等常用后处理。2.1.27 起，快速截图选区可正确命中部分透明顶层弹窗，贴图窗口已显示后也不再误弹“未产生位图”。2.1.28 起，截图 Pro 可用 **套索裁切** 自由圈选保留区域；贴图右键菜单的「图像处理」可用 **抠出主体（透明背景）**，在本机抠图后继续保存或贴图。更复杂的自动化仍可在动作链中用独立步骤完成。截图历史、已关闭贴图与录屏成品可在采集历史中心统一查看与管理；2.1.23 起，进行中的录屏也可以在这里管理，并可在页内预览、复制、另存和切换播放速度。
+截图界面内已集成 OCR、图片翻译、智能马赛克、斜铺文字水印等常用后处理。2.1.27 起，快速截图选区可正确命中部分透明顶层弹窗，贴图窗口已显示后也不再误弹“未产生位图”。2.1.28 起，截图 Pro 可用 **套索裁切** 自由圈选保留区域；贴图右键菜单的「图像处理」可用 **抠出主体（透明背景）**，2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机抠图后继续保存或贴图。更复杂的自动化仍可在动作链中用独立步骤完成。截图历史、已关闭贴图与录屏成品可在采集历史中心统一查看与管理；2.1.23 起，进行中的录屏也可以在这里管理，并可在页内预览、复制、另存和切换播放速度。
diff --git a/docs/v2/what's-new/new-main-win/action-drafts.md b/docs/v2/what's-new/new-main-win/action-drafts.md
index 0eae55f..c87a4fb 100644
--- a/docs/v2/what's-new/new-main-win/action-drafts.md
+++ b/docs/v2/what's-new/new-main-win/action-drafts.md
@@ -18,6 +18,8 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位
 
 暂存区共用新版主窗口的搜索入口。输入动作名称后，可以用方向键选择结果，按 `Enter` 试运行。
 
+2.2.0 起，暂存区顶部提供 **新建动作** 和 **用 AI 写**。用 AI 写出的动作会先进入暂存区预览；AI 创建或修改暂存动作后，暂存区会自动刷新。该功能仍在改进中，生成内容需要人工检查、试运行和调试。
+
 如果剪贴板中是 Quicker 分享动作链接，点击暂存区右上角的 **＋**，菜单会同时显示「创建动作」和「安装动作（动作名）」。选择安装后仍会显示正常的动作确认信息，确认完成后动作直接进入暂存区，不会先注册为正式动作。
 
 剪贴板不是有效分享链接、链接读取失败或动作要求更高版本时，不会提供可安装项；可以继续选择「创建动作」。
@@ -41,7 +43,7 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位
 
 ## 保留为正式动作
 
-选择“保留到场景”，再指定目标场景和分组，即可把暂存动作写入正式动作库，并在目标位置增加入口。
+选择“保留到场景”，再指定目标场景和分组，即可把暂存动作写入正式动作库，并在目标位置增加入口。手动新建、导入安装和 AI 创建的暂存动作都使用这条路径正式化。
 
 也可以把暂存动作直接拖到新面板或“场景与动作管理”中的目标位置。写入成功后，原暂存项会被移除。
 
@@ -51,7 +53,7 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位
 
 暂存动作不会注册到正式动作库，也不会出现在普通动作选择器和触发规则选择器中。试运行只执行暂存区最近保存的内容，不会临时建立正式动作引用。
 
-暂存内容保存在当前账号的本机数据中，不参与云同步。切换账号后会看到该账号自己的暂存区；换一台电脑也不会自动出现这里的动作。
+暂存动作、暂存分组和本机版本历史保存在当前账号的本机数据中，不参与云同步。切换账号后会看到该账号自己的暂存区；换一台电脑也不会自动出现这里的动作。
 
 如果希望跨设备使用，请先把动作保留到正式场景，并等待正式动作同步完成。
 
diff --git a/docs/v2/what's-new/new-main-win/usage.md b/docs/v2/what's-new/new-main-win/usage.md
index efa3416..bc1e6a2 100644
--- a/docs/v2/what's-new/new-main-win/usage.md
+++ b/docs/v2/what's-new/new-main-win/usage.md
@@ -61,7 +61,15 @@ comments: true
 
 上下文区的标签由当前程序、网址和场景规则动态生成，不支持拖动排序。
 
-新版主窗口左侧还提供“暂存区”。暂存动作可以先在本机编辑、试运行和调试，确认后再放入正式场景。详细说明见[本机动作暂存区](./action-drafts.md)。
+新版主窗口左侧还提供“暂存区”。暂存区顶部可直接 **新建动作** 或 **用 AI 写**；暂存动作可以先在本机编辑、试运行和调试，确认后再放入正式场景。详细说明见[本机动作暂存区](./action-drafts.md)。
+
+2.1.29 起，侧边栏快捷按钮可以自定义。除默认的 **截图 Pro** 外，还可放入 **设置**、**场景与动作管理**、**公共子程序管理**，也可以添加常用动作并调整顺序；常用动作本身的整理方式见[动作与入口](/v2/features/actions)。
+
+::::caution[侧边栏快捷按钮的回退风险]
+
+侧边栏快捷按钮会和动作面板偏好一起同步。若配置后仍在 2.1.28 或更早版本修改并同步动作面板偏好，旧客户端可能清除快捷按钮配置，恢复为仅默认「截图 Pro」。多设备使用同一账号时，建议先升级所有设备；回退旧版后也避免修改该项。配置丢失后，可在「快捷按钮设置」中重新配置。
+
+::::
 
 ## 查找和运行动作
 
diff --git a/docs/v2/what's-new/tools-and-experience.md b/docs/v2/what's-new/tools-and-experience.md
index 6d64880..5c483d7 100644
--- 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 起，结果窗显示识别耗时，翻译原文 / 译文可同步滚动，冷启动会先显示预览。
 
-选区阶段可用 `Ctrl+A` 在鼠标所在显示器与全部屏幕之间切换。2.1.25 起，截图 Pro 和屏幕截图的快捷键提示在多显示器环境下会跟随光标所在显示器，并尽量避让当前选区。截图 Pro、长截图和录屏的工具栏可以拖动并吸附到选区附近，双击手柄可恢复自动定位；吸附窗口时也会尽量排除窗口阴影。2.1.27 起，快速截图和获取窗口信息可正确选中部分透明顶层弹窗。
+选区阶段可用 `Ctrl+A` 在鼠标所在显示器与全部屏幕之间切换。2.1.25 起，截图 Pro 和屏幕截图的快捷键提示在多显示器环境下会跟随光标所在显示器，并尽量避让当前选区。截图 Pro、长截图和录屏的工具栏可以拖动并吸附到选区附近，双击手柄可恢复自动定位；吸附窗口时也会尽量排除窗口阴影。2.1.27 起，快速截图和获取窗口信息可正确选中部分透明顶层弹窗。2.1.29 起，截图窗口选择高亮更醒目，套索和贴图阴影等标注细节也继续改进。
 
 步骤工具栏既可用可视化方式拖放内置工具、分组和自定义命令，也可配置 **自定义工具栏脚本**（JavaScript）：用压缩写法 `sp` / `act` 给默认工具栏加「调子程序 / 开动作」按钮，需要分支时再写完整 `run`。说明见 [JS 自定义工具栏](../features/screenshot/toolbar-script.md)。
 
-贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。2.1.28 起，右键菜单「图像处理」可 **抠出主体（透明背景）**，在本机完成主体抠图后继续保存或贴图。重启后恢复贴图时，原显示器仍在则尽量保留上次屏幕位置；HTML 和公式贴图使用隔离渲染后以普通图片窗口显示，可继续拖移、显示阴影并选字复制。Quicker 或 PixPin 复制的图片位置可随剪贴板保留，配合贴图步骤的「截图原位置」把图片贴回原处。
+贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。2.1.28 起，右键菜单「图像处理」可 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。重启后恢复贴图时，原显示器仍在则尽量保留上次屏幕位置；HTML 和公式贴图使用隔离渲染后以普通图片窗口显示，可继续拖移、显示阴影并选字复制。Quicker 或 PixPin 复制的图片位置可随剪贴板保留，配合贴图步骤的「截图原位置」把图片贴回原处。
 
 截图、贴图与录屏历史使用统一的采集历史中心。录屏成品可页内预览、复制、另存和切换播放速度；进行中的录屏也可以在这里管理。交互式和后台录屏步骤支持选择保存文件夹，写到自定义目录的成品只建立历史索引，不再为了入库额外复制一份。
 
diff --git a/docs/v2/what's-new/xaction-steps/index.md b/docs/v2/what's-new/xaction-steps/index.md
index 42b91f5..fb84748 100644
--- a/docs/v2/what's-new/xaction-steps/index.md
+++ b/docs/v2/what's-new/xaction-steps/index.md
@@ -21,7 +21,7 @@ Quicker 2.x 在保持已有组合动作兼容的基础上，增加了一批面
 - [新增：屏幕录制模块](./new-screen-recording-ui.md)：框选区域，通过录屏工具栏交互式完成录制。
 - [新增：后台屏幕录制模块](./new-background-screen-recording.md)：通过会话 ID 自动开始、查询和停止录制。
 - [新增：运行C#文件应用模块](./new-csharp-file-app.md)：使用 .NET SDK 编译运行支持现代 SDK 功能的单文件应用。
-- [新增：自动化脚本模块](/v2/xaction/modules/automationscript)：使用受限 JavaScript 编排鼠标、键盘、窗口、剪贴板、选择、截图识别等桌面自动化操作；首次使用相关能力时会请求本机授权。
+- [新增：自动化脚本模块](/v2/xaction/modules/automationscript)：使用受限 JavaScript 编排鼠标、键盘、剪贴板和识别定位等桌面自动化操作；2.1.29 起可面向窗口和区域执行 OCR、找图、找色与目标相对点击，窗口移动后仍按最新位置执行。完整 API 以软件界面与后续结构化同步为准。
 
 [官网 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)中说明能力，参数页待结构化数据同步后再补。
 
@@ -31,6 +31,7 @@ Quicker 2.x 在保持已有组合动作兼容的基础上，增加了一批面
 - [浏览器控制模块](/v2/xaction/modules/chromecontrol)：2.1.27 配合 Quicker Connector 1.2.0，可通过侧边栏生成列表提取、连续翻页和表单填写模板；文件上传 / 拖放使用专用文件操作，参数以当前编辑器为准。
 - [屏幕截图模块](./screen-capture.md)：增加 UI 元素检测、截图历史，并接入新版截图后工具。
 - [获取窗口信息/查找窗口模块](/v2/xaction/modules/getwindowtitle)：2.1.27 起，“选择一个窗口”可正确命中部分透明顶层弹窗。
+- [窗口操作模块](/v2/xaction/modules/windowoperations)：2.2.0 起新增任意窗口贴边自动隐藏、关闭类似窗口、在类似窗口中切换。当前 `data/xaction` 尚未同步新增类型 Key，因此模块页只写能力说明，参数以当前编辑器选项为准。
 - [窗口界面控制(FlaUI)](/v2/xaction/modules/flauiautomation)：2.1.28 起可提取窗口界面信息、观察可交互元素，并批量返回控件树、定位信息和坐标范围。当前 `data/xaction` 尚未同步新版操作 Key，因此模块页只写能力说明。
 - [屏幕录制模块](./new-screen-recording-ui.md) / [后台屏幕录制模块](./new-background-screen-recording.md)：2.1.23 起可选择保存文件夹；自定义目录中的成品只建立历史索引，不再额外复制一份。当前 `data/xaction` 尚未同步对应参数 Key，因此模块页只写能力说明。
 - [屏幕找图/找色/找字模块](/v2/xaction/modules/searchbmp)：找图新增相似度匹配模式；2.1.25 起查找范围还支持指定窗口和指定图片，适合在被遮挡窗口或本地图片中定位目标。2.1.26 起，指定图片可使用图片路径或图片变量；指定窗口可选择返回窗口相对坐标。2.1.25 里已经配过指定图片的动作，升级后需要重新打开步骤编辑一次。当前 `data/xaction` 尚未同步新增选项的参数 Key，因此模块页只写能力说明。
diff --git a/docs/v2/xaction/concepts/subprogram.md b/docs/v2/xaction/concepts/subprogram.md
index cf95525..cefe413 100644
--- a/docs/v2/xaction/concepts/subprogram.md
+++ b/docs/v2/xaction/concepts/subprogram.md
@@ -91,6 +91,8 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"
 
 本地所有动作都能用。标签页里可筛选、新建、编辑、分享到库、查找哪些动作在用、复制为动作内、高亮、删除。
 
+2.1.29 起，新建公共子程序后可以直接按 `Ctrl+S` 保存，不必先切换到其它位置再回来保存。
+
 **不要分享含恶意内容的子程序，否则会停用帐号。**
 
 ## 网络共享
diff --git a/docs/v2/xaction/concepts/xaction-editor.md b/docs/v2/xaction/concepts/xaction-editor.md
index ae9a28d..adddf2f 100644
--- a/docs/v2/xaction/concepts/xaction-editor.md
+++ b/docs/v2/xaction/concepts/xaction-editor.md
@@ -180,6 +180,8 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
 - 双击步骤，或点步骤行上的铅笔，打开参数窗。
 - 删除：点步骤上的 ×、按 `Delete`，或右键删除。
 
+2.2.0 起，步骤参数编辑窗口可以手动拉伸或贴靠到完整屏幕高度，不再受首次自动布局时的高度限制。
+
 ### 停用步骤
 
 停用后运行时跳过。适合暂时不用、又不想删的步骤，或调试时屏蔽一段。
diff --git a/docs/v2/xaction/modules/image/pinimage.md b/docs/v2/xaction/modules/image/pinimage.md
index 4de5624..faa458f 100644
--- a/docs/v2/xaction/modules/image/pinimage.md
+++ b/docs/v2/xaction/modules/image/pinimage.md
@@ -25,4 +25,4 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 
 2.1.27 起，HTML、公式或剪贴板贴图窗口已经显示后，不再因后续未生成位图提示而误弹“未产生位图”。
 
-2.1.28 起，贴图右键菜单「图像处理」可用 **抠出主体（透明背景）**，在本机完成主体抠图后继续保存或贴图。首次使用需要已登录 Quicker，并下载约 4.4 MB 的独立本地模型；它和 OCR 文字模型分开管理，不会重复下载已有 OCR 模型。
+2.1.28 起，贴图右键菜单「图像处理」可用 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。首次使用需要已登录 Quicker，并下载约 4.4 MB 的独立本地模型；它和 OCR 文字模型分开管理，不会重复下载已有 OCR 模型。
diff --git a/docs/v2/xaction/modules/input/automationscript.md b/docs/v2/xaction/modules/input/automationscript.md
index 581be09..9c59b53 100644
--- a/docs/v2/xaction/modules/input/automationscript.md
+++ b/docs/v2/xaction/modules/input/automationscript.md
@@ -13,7 +13,7 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 
 # 自动化脚本
 
-使用 JavaScript 编排鼠标、键盘、Quicker 提示消息和文本剪贴板操作。适合坐标数组、循环、网格、批量点击、键鼠组合以及根据运行结果显示消息或读写文本这类用普通步骤不方便表达的自动化。
+使用 JavaScript 编排鼠标、键盘、Quicker 提示消息、文本剪贴板以及屏幕识别相关操作。适合坐标数组、循环、网格、批量点击、键鼠组合以及根据运行结果显示消息或读写文本这类用普通步骤不方便表达的自动化。
 
 :::warning 安全提示
 
@@ -25,10 +25,10 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 
 - 只做一次移动、点击或找图定位：使用[鼠标输入](/v2/xaction/modules/mouse)。
 - 执行很短的键盘、鼠标指令串：使用[多步骤输入](/v2/xaction/modules/inputscript)。
-- 需要循环、数组、条件判断、坐标计算、热键、键鼠组合、提示消息或文本剪贴板操作：使用本模块。
+- 需要循环、数组、条件判断、坐标计算、热键、键鼠组合、提示消息、文本剪贴板或脚本化识别定位：使用本模块。
 - 需要通用 JavaScript、动作变量读写或可选 CLR：使用[运行 Javascript 代码](/v2/xaction/modules/jsscript)。它与本模块的语法和安全边界不同。
 
-本模块专门提供受控的桌面自动化能力，不是可任意访问系统资源的通用 JavaScript 环境，也不会替换已有的 JavaScript 模块。后续可在同一个 `"quicker"` 模块中扩展对话框和窗口 API，但当前版本尚未导出 `dialog` 或 `window`。
+本模块专门提供受控的桌面自动化能力，不是可任意访问系统资源的通用 JavaScript 环境，也不会替换已有的 JavaScript 模块。2.1.29 起，自动化脚本可面向窗口和区域做 OCR、找图、找色，并对识别或定位到的目标执行相对点击；目标窗口移动后，仍可按最新位置执行。完整 API 以软件编辑器当前提示与后续 `data/xaction` 同步为准，本页不编写尚未同步的方法名和参数。
 
 ## 当前模块定义
 
@@ -53,7 +53,7 @@ export default mouse.position();
 
 ### 导入方式
 
-`"quicker"` 是 Quicker 在内存中提供的模块，不是 npm 包或本地文件。当前提供 `mouse`、`key`、`screen`、`sleep`、`input`、`notify`、`clipboard` 七个命名导出。
+`"quicker"` 是 Quicker 在内存中提供的模块，不是 npm 包或本地文件。下方先列出当前结构化定义已覆盖的 `mouse`、`key`、`screen`、`sleep`、`input`、`notify`、`clipboard` 七个命名导出。
 
 按需导入：
 
@@ -606,7 +606,7 @@ export default {
 
 双击消耗 2 次鼠标按压额度，拖拽消耗 1 次。每次键盘 API 调用消耗 1 个键盘事务；`down` / `up` 各消耗 1 个边沿，`press` 消耗 2 个。节流等待仍计入步骤的总超时。
 
-## 首版不支持的能力
+## 仍需注意的限制
 
 - `async` / `await`、Promise、`setTimeout` 和后台任务
 - 动态 `import()`、其它静态模块、`require()`、npm 和 Node.js 模块
@@ -615,11 +615,13 @@ export default {
 - 剪贴板图片、文件列表、HTML 等非文本格式
 - 阻塞式对话框、消息按钮、点击动作、JavaScript 回调和 Windows 系统通知；当前尚未导出 `dialog`
 - 独立 `mouse.down()` / `mouse.up()`、原始键码、扫描码和任意键盘布局映射
-- 录制回放、图片定位、窗口句柄和窗口相对坐标；当前尚未导出 `window`
+- 录制回放
 - 水平滚轮、X1 / X2 按钮和任意点击次数
 - 游戏级、驱动级或硬实时鼠标轨迹
 
-需要这些能力时，请组合使用对应的 Quicker 步骤，不要试图从脚本绕过限制。
+2.1.29 新增的窗口 / 区域 OCR、找图、找色和相对点击能力，请以软件界面中的脚本提示为准；结构化定义同步前，本页暂不列新增导出、参数名或返回形状。
+
+需要上述仍未支持的能力时，请组合使用对应的 Quicker 步骤，不要试图从脚本绕过限制。
 
 ## 常见错误和排障
 
diff --git a/docs/v2/xaction/modules/system/windowoperations.md b/docs/v2/xaction/modules/system/windowoperations.md
index 434898f..02fe88d 100644
--- a/docs/v2/xaction/modules/system/windowoperations.md
+++ b/docs/v2/xaction/modules/system/windowoperations.md
@@ -31,6 +31,8 @@ legacyContentUpdatedAt: "2024-08-15T08:31:00.000Z"
 
 **类型**：移动窗口、移动窗口(增强)、置顶窗口、切换置顶状态、取消置顶窗口、置底窗口、设置显示状态、设置为前台窗口、关闭、强制关闭、设置或更新透明度、设置边框颜色。
 
+2.2.0 起，还新增了任意窗口贴边自动隐藏、关闭类似窗口、在类似窗口中切换等窗口整理操作。当前结构化定义尚未同步这些新类型 Key，本页不列枚举值或参数预览；完整参数以编辑器当前选项为准。
+
 **窗口句柄**：要操作的窗口句柄。留空表示前台窗口。
 
 **失败后停止**：失败是否中止动作。默认开启。