docs(release-notes): 同步 Quicker 2.1.29 / 2.2.0 用户可见说明

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

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 或更高版本时仍需特别检查：**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其它旧动作升级后请打开动作确认录制范围，避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。
 

docs/v2/features/ai-and-agent.md

@@ -13,14 +13,15 @@ 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)
   - [AI 文本分类](/v2/xaction/modules/ai-classify)
   - [AI 结构化提取](/v2/xaction/modules/ai-extract)
   - [AI 交互对话](/v2/xaction/modules/ai-chat)
 
-API Key 只在本机加密保存，不随动作分享，也不随普通设置文件拷到另一台电脑。
+首次使用 AI 能力前，需要在「配置 API」中添加服务商、模型和 API Key。多数服务需要自备账号和额度；API Key 只在本机加密保存，不随动作分享，也不随普通设置文件拷到另一台电脑。
 
 ## 还没有对普通用户普遍开放
 

docs/v2/features/screenshot/capture-pro.md

@@ -205,7 +205,7 @@ comments: true
 
 ### 图像处理与工具栏
 
-- 右键菜单「图像处理」中可用 **抠出主体（透明背景）**，在本机完成主体抠图后继续保存或贴图。
+- 右键菜单「图像处理」中可用 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。
 - **工具栏隐藏时**：数字键 `1`–`8` 可快速旋转、翻转、灰度、反色、亮度等；`0` 重置滤镜、方向与不透明度。
 - **工具栏显示时**：数字键优先选择标注工具（见「快捷键一览」），不再触发图像处理。
 

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 起，进行中的录屏也可以在这里管理，并可在页内预览、复制、另存和切换播放速度。

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 新增了本机动作暂存区。它适合保存尚未确定放置位
 
 暂存动作不会注册到正式动作库，也不会出现在普通动作选择器和触发规则选择器中。试运行只执行暂存区最近保存的内容，不会临时建立正式动作引用。
 
-暂存内容保存在当前账号的本机数据中，不参与云同步。切换账号后会看到该账号自己的暂存区；换一台电脑也不会自动出现这里的动作。
+暂存动作、暂存分组和本机版本历史保存在当前账号的本机数据中，不参与云同步。切换账号后会看到该账号自己的暂存区；换一台电脑也不会自动出现这里的动作。
 
 如果希望跨设备使用，请先把动作保留到正式场景，并等待正式动作同步完成。
 

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」。多设备使用同一账号时，建议先升级所有设备；回退旧版后也避免修改该项。配置丢失后，可在「快捷按钮设置」中重新配置。
+
+::::
 
 ## 查找和运行动作
 

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 复制的图片位置可随剪贴板保留，配合贴图步骤的「截图原位置」把图片贴回原处。
 
 截图、贴图与录屏历史使用统一的采集历史中心。录屏成品可页内预览、复制、另存和切换播放速度；进行中的录屏也可以在这里管理。交互式和后台录屏步骤支持选择保存文件夹，写到自定义目录的成品只建立历史索引，不再为了入库额外复制一份。
 

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，因此模块页只写能力说明。

docs/v2/xaction/concepts/subprogram.md

@@ -91,6 +91,8 @@ legacyContentUpdatedAt: "2025-06-06T03:33:32.000Z"
 
 本地所有动作都能用。标签页里可筛选、新建、编辑、分享到库、查找哪些动作在用、复制为动作内、高亮、删除。
 
+2.1.29 起，新建公共子程序后可以直接按 `Ctrl+S` 保存，不必先切换到其它位置再回来保存。
+
 **不要分享含恶意内容的子程序，否则会停用帐号。**
 
 ## 网络共享

docs/v2/xaction/concepts/xaction-editor.md

@@ -180,6 +180,8 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
 - 双击步骤，或点步骤行上的铅笔，打开参数窗。
 - 删除：点步骤上的 ×、按 `Delete`，或右键删除。
 
+2.2.0 起，步骤参数编辑窗口可以手动拉伸或贴靠到完整屏幕高度，不再受首次自动布局时的高度限制。
+
 ### 停用步骤
 
 停用后运行时跳过。适合暂时不用、又不想删的步骤，或调试时屏蔽一段。

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 模型。