docs: 补齐 2.2.17 用户可见说明

docs/important-notice.md

@@ -74,6 +74,13 @@ V2 仍在快速迭代，部分功能未完成，已有动作也可能需要调
 
 「悬浮分组」动作（按名称打开、关闭或切换）需要 2.2.14 或更高版本客户端；旧版无法识别此动作类型。创建前建议升级所有同步设备；必须回退时，请先备份悬浮布局，并避免在旧版编辑或同步依赖该动作的内容。
 
+
+## 2.2.17 浏览器父场景归属的多设备与回退
+
+2.2.17 起，自定义程序的浏览器归属统一纳入父场景管理，并随账号同步。将自定义程序添加到浏览器父场景下后，需要重新设置一次归属。
+
+使用浏览器父场景归属前，请将同一账号的所有设备升级到 2.2.17 或更高版本。回退到旧版本或新旧客户端混用时，包含浏览器归属的整份父场景归属配置会暂时失效并变为只读；数据不会因此删除，全部设备重新升级后可恢复。
+
 ## 相关链接
 
 <RelatedDocs

docs/release-notes/index.md

@@ -12,7 +12,7 @@ comments: true
 
 **[https://getquicker.net/v2/versions](https://getquicker.net/v2/versions)**
 
-本站功能说明已按 2.2.16 补充；版本是否已开放下载、完整条目及安装包校验值，以官网为准。
+本站功能说明已按 2.2.17 补充；版本是否已开放下载、完整条目及安装包校验值，以官网为准。
 
 安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。
 
@@ -32,6 +32,8 @@ comments: true
 
 2.2.16 补充了 [悬浮分组受控合并与中间拆分](/v2/features/floating-actions#移动和整理)、[搜索引擎 JSON 批量导入导出](/v2/features/tools#自定义搜索引擎的导入导出)，以及 [截图 Pro 自定义工具栏可视化编排](/v2/features/screenshot/capture-pro#标注)（拖动排序、添加子程序或动作、图标大小）；并修了网络路径图标探测卡顿、表单多行高度、提示消息悬停消失、录屏结束与缩略图等。
 
+2.2.17 补充了 [贴图鼠标穿透与独立工具条](/v2/features/screenshot/capture-pro#贴图窗口截图后)、[录屏预览焦点与播放速度](/v2/features/screenshot/capture-pro#确认复制保存与其它出口)、[本机 ffmpeg 实时录屏](/v2/features/screenshot/capture-pro#截图-pro-设置页)、[提示消息保持 1 秒](/v2/xaction/modules/notify)、[Everything 通信接口替代服务](/v2/xaction/modules/everythingsearch)、[浏览器父场景归属纳入父场景管理与同步](/v2/features/scenes#作为浏览器程序与父场景归属)、[动作日志并入运行记录窗口](/v2/features/tools#动作运行与触发记录)，以及 [Mastercam 第三方 FT 命令筛选](/v2/features/software-connections/software/mastercam)；截图 Pro 步骤可在框选后直接走截图 / 复制 / 贴图 / 保存 / 识别等出口（参数页待 `data/xaction` 同步后再补，详见[官网版本记录](https://getquicker.net/V2/Versions)）。选择窗口会跳过鼠标穿透覆盖层；并修了 Windows 应用拖放启动参数、显示菜单子程序生命周期等。
+
 升级到 2.1.23 或更高版本时仍需特别检查：**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其它旧动作升级后请打开动作确认录制范围，避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。
 
 体验、降级和回退风险见 [体验前必读](/important-notice)。

docs/v2/features/scenes.md

@@ -26,6 +26,9 @@ V2 的面板按 **场景 → 分组 → 动作** 组织。场景回答「当前
 
 2.1.28 起，可在“场景与动作管理”里对第三方浏览器程序的场景条目右键选择 **作为浏览器程序**，让小众浏览器使用浏览器场景和对应触发规则。
 
+## 作为浏览器程序与父场景归属
+
+2.2.17 起，自定义程序的浏览器归属统一纳入父场景管理，并随账号同步；此前可能出现“重启后归属失效”的情况已按此修复。把自定义程序添加到浏览器父场景下之后，需要重新设置一次归属。多设备或可能回退时，请先阅读 [2.2.17 浏览器父场景归属的多设备与回退](/important-notice#2217-浏览器父场景归属的多设备与回退)。
 
 ## 场景与动作管理中的右键
 

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

@@ -40,7 +40,11 @@ comments: true
 
 2.2.14 起，文件名模板支持 `{date:格式}`（.NET DateTime，例如 `{date:yyyy_MM_dd_HH_mm_ss}`），设置页会提供实时文件名示例。原独立日期格式选项已并入文件名模板；编辑时会把旧日期格式转换并保留效果。回退旧版后需将 `{date:格式}` 改回 `{date}`、`{time}` 等旧语法，见 [体验前必读](/important-notice#2214-截图文件名模板与悬浮分组动作)。同版起，工具栏的确认与复制按钮不再重复显示。
 
-这些设置影响手动截图和未显式指定行为的场景。通过组合动作步骤调用截图 Pro 时，**步骤参数优先**；例如动作里已经指定了写入剪贴板、截图后贴图或工具栏配置，就按动作步骤当前参数执行。完整发版注意见[官网版本记录](https://getquicker.net/V2/Versions)。
+这些设置影响手动截图和未显式指定行为的场景。通过组合动作步骤调用截图 Pro 时，**步骤参数优先**；例如动作里已经指定了写入剪贴板、截图后贴图或工具栏配置，就按动作步骤当前参数执行。
+
+2.2.17 起，截图设置可指定**本机 ffmpeg** 用于 MP4 实时录屏：默认关闭；需自行准备 `ffmpeg.exe`，在设置中检测通过后再启用。未启用时仍使用原有录制路径。
+
+完整发版注意见[官网版本记录](https://getquicker.net/V2/Versions)。
 
 ## 选择区域
 
@@ -224,6 +228,8 @@ comments: true
 
 2.2.12 起，本机 Windows 10 2004 或更高版本上，可视化录屏默认不把录屏工具栏录入成品。远程桌面或系统不支持排除时，Quicker 会自动回退到可用的录制方式；开录后请先做一次短录制确认效果。
 
+2.2.17 起，录屏结束后预览会自动获得焦点，可用空格暂停或继续；预览工具条支持调整播放速度。需要边录边生成 MP4 时，可在截图设置中启用本机 ffmpeg（见上文[截图 Pro 设置页](#截图-pro-设置页)）。
+
 说明：
 
 - 步骤的 **写入剪贴板** 和 **截图后贴图** 只叠加到默认确认出口（双击、`Enter` 或工具栏确认）。
@@ -252,6 +258,8 @@ comments: true
 - **`T`**：切换置顶
 - **`Ctrl+W` / `Esc`**：关闭贴图
 
+2.2.17 起，贴图支持**鼠标穿透**：开启后鼠标可点到贴图后方的窗口；可用独立工具条调节不透明度、恢复操作，或关闭贴图。需要临时对照文档又不想挡住点击时，打开穿透即可。
+
 ### 图像处理与工具栏
 
 - 右键菜单「图像处理」中可用 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。
@@ -281,6 +289,8 @@ comments: true
 
 ## 动作步骤参数
 
+2.2.17 起，组合动作里的 **截图 Pro** 步骤可选择框选后直接走 **截图 / 复制 / 贴图 / 保存 / 识别** 等出口，不必再在工具栏里点一次确认。当前 `data/xaction` 尚未同步对应参数字段，本站先说明能力；具体参数名与默认值以客户端步骤编辑器为准，完整条目见[官网版本记录](https://getquicker.net/V2/Versions)。
+
 | 参数 | 默认 | 说明 |
 | --- | --- | --- |
 | 截图前延迟时间 | `0` | 开始截图前等待的毫秒数，便于先打开菜单或隐藏 Quicker 面板 |

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.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机抠图后继续保存或贴图。2.2.12 起，“常用功能”可直接选择 **截图+复制**：确认选区后把结果写入剪贴板，不必另外创建组合动作；标注工具栏也新增荧光笔。更复杂的自动化仍可在动作链中用独立步骤完成。截图历史、已关闭贴图与录屏成品可在采集历史中心统一查看与管理；2.1.23 起，进行中的录屏也可以在这里管理，并可在页内预览、复制、另存和切换播放速度。
+截图界面内已集成 OCR、图片翻译、智能马赛克、斜铺文字水印等常用后处理。2.1.27 起，快速截图选区可正确命中部分透明顶层弹窗，贴图窗口已显示后也不再误弹“未产生位图”。2.1.28 起，截图 Pro 可用 **套索裁切** 自由圈选保留区域；贴图右键菜单的「图像处理」可用 **抠出主体（透明背景）**，2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机抠图后继续保存或贴图。2.2.12 起，“常用功能”可直接选择 **截图+复制**：确认选区后把结果写入剪贴板，不必另外创建组合动作；标注工具栏也新增荧光笔。更复杂的自动化仍可在动作链中用独立步骤完成。截图历史、已关闭贴图与录屏成品可在采集历史中心统一查看与管理；2.1.23 起，进行中的录屏也可以在这里管理，并可在页内预览、复制、另存和切换播放速度。2.2.17 起，贴图支持鼠标穿透与独立工具条；录屏结束预览可自动获焦并用空格暂停，预览工具条可调播放速度；截图设置可选用本机 ffmpeg 做 MP4 实时录屏（默认关闭）。

docs/v2/features/software-connections/software/mastercam.md

@@ -32,7 +32,7 @@ comments: true
 
 ## 创建动作
 
-在命令工具中，可浏览 Bridge 提供的命令，以及当前宿主 `Mastercam.ft` 中的界面命令：按来源、分类或名称筛选，立即试运行，或 **生成动作** 后粘贴到 Quicker 面板。
+在命令工具中，可浏览 Bridge 提供的命令，以及当前宿主 `Mastercam.ft` 中的界面命令：按来源、分类或名称筛选，立即试运行，或 **生成动作** 后粘贴到 Quicker 面板。2.2.17 起，命令工具还支持筛选和查找**第三方 FT** 命令，便于在自定义 Function Table 中定位目标。
 
 组合动作里也可使用 Mastercam 控制步骤（模块标识 `sys:mastercamcontrol`）。本站模块参数参考尚未同步到 `data/xaction`；创建动作时请以命令工具生成结果和客户端步骤参数为准，不要手工猜测参数 Key。
 

docs/v2/features/tools.md

@@ -31,6 +31,9 @@ comments: true
 
 2.2.12 起，运行记录可按动作及调用链查看相关日志，并从动作设计器或 AI 工作区定位、查询和导出。排查“主动作调用子程序后失败”时，先选择主动作运行，再沿调用链查看对应步骤；导出前仍应检查日志中是否含本机路径、网址或其它私密内容。
 
+2.2.17 起，主菜单原「动作日志」入口已移到本窗口的「动作日志」页签；已有日志继续保留。排查运行问题时，可在同一窗口切换「动作执行」「触发记录」和「动作日志」。
+
+
 ## AI
 
 - [统一 AI 服务与模型设置](/v2/what's-new/ai-services-and-models.md)：服务连接、模型能力和用途优选

docs/v2/what's-new/tools-and-experience.md

@@ -22,9 +22,9 @@ V2 将截图、贴图、长截图和录屏整理为更完整的工作流。
 
 步骤工具栏既可用可视化方式拖放内置工具、分组和自定义命令，也可配置 **自定义工具栏脚本**（JavaScript）：用压缩写法 `sp` / `act` 给默认工具栏加「调子程序 / 开动作」按钮，需要分支时再写完整 `run`。2.2.16 起，可视化编排可直接拖动排序、添加子程序或动作，并设置图标大小。说明见 [截图 Pro](../features/screenshot/capture-pro.md#标注) 与 [JS 自定义工具栏](../features/screenshot/toolbar-script.md)。
 
-贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。2.1.28 起，右键菜单「图像处理」可 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。重启后恢复贴图时，原显示器仍在则尽量保留上次屏幕位置；HTML 和公式贴图使用隔离渲染后以普通图片窗口显示，可继续拖移、显示阴影并选字复制。Quicker 或 PixPin 复制的图片位置可随剪贴板保留，配合贴图步骤的「截图原位置」把图片贴回原处。2.2.8 起，「恢复贴图」可连续恢复最近关闭的贴图；常用功能 / 侧栏的「剪贴板贴图」支持富文本 HTML、公式、纯文本和图片文件。
+贴图支持缩略图视口、图像处理、标注、透明度和拖出图片。2.1.28 起，右键菜单「图像处理」可 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。重启后恢复贴图时，原显示器仍在则尽量保留上次屏幕位置；HTML 和公式贴图使用隔离渲染后以普通图片窗口显示，可继续拖移、显示阴影并选字复制。Quicker 或 PixPin 复制的图片位置可随剪贴板保留，配合贴图步骤的「截图原位置」把图片贴回原处。2.2.8 起，「恢复贴图」可连续恢复最近关闭的贴图；常用功能 / 侧栏的「剪贴板贴图」支持富文本 HTML、公式、纯文本和图片文件。2.2.17 起，贴图支持鼠标穿透，并可通过独立工具条调节不透明度、恢复操作或关闭贴图。
 
-截图、贴图与录屏历史使用统一的采集历史中心。录屏成品可页内预览、复制、另存和切换播放速度；进行中的录屏也可以在这里管理。交互式和后台录屏步骤支持选择保存文件夹，写到自定义目录的成品只建立历史索引，不再为了入库额外复制一份。2.2.1 起，可视化录屏可预选主屏幕、所有屏幕或固定区域，跳过手动框选并直接打开录屏工具栏。
+截图、贴图与录屏历史使用统一的采集历史中心。录屏成品可页内预览、复制、另存和切换播放速度；进行中的录屏也可以在这里管理。交互式和后台录屏步骤支持选择保存文件夹，写到自定义目录的成品只建立历史索引，不再为了入库额外复制一份。2.2.1 起，可视化录屏可预选主屏幕、所有屏幕或固定区域，跳过手动框选并直接打开录屏工具栏。2.2.17 起，录屏结束预览自动获得焦点，可用空格暂停或继续，预览工具条可调播放速度；截图设置可选用本机 ffmpeg 做 MP4 实时录屏（默认关闭，需自行准备并检测通过）。
 
 2.2.1 起，设置中新增 **截图 Pro** 页，可集中管理工具栏、确认后动作、快速保存、贴图和历史偏好；通过动作步骤调用时，步骤参数优先。2.2.5 起，保存图片可选择内置日期格式与文件名模板，贴图支持分组；百度图片翻译 V2.0 需在 **设置 → 识别与翻译** 同时填写 APP ID 与 API Key，并且凭证只保存在本机。
 
@@ -54,7 +54,7 @@ V2 改为轻量的“选中文本工具条”。它可以在选中文字后显
 
 动作搜索会显示动作所在的新面板场景和分组，也可以从结果打开实际位置。搜索框为空时，历史动作按使用时间排列，便于再次运行近期内容。
 
-文件搜索改用新版 Everything 接口并复用连接。Windows 应用搜索、图标加载和结果刷新也进行了调整。2.2.16 起，设置中的自定义搜索引擎列表支持 JSON 批量导入与导出，便于备份和迁移；详见 [自定义搜索引擎的导入导出](/v2/features/tools#自定义搜索引擎的导入导出)。
+文件搜索改用新版 Everything 接口并复用连接。Windows 应用搜索、图标加载和结果刷新也进行了调整。2.2.17 起，也兼容提供 Everything 通信接口的替代服务。2.2.16 起，设置中的自定义搜索引擎列表支持 JSON 批量导入与导出，便于备份和迁移；详见 [自定义搜索引擎的导入导出](/v2/features/tools#自定义搜索引擎的导入导出)。
 
 “打开所在位置”会尽量复用已有资源管理器窗口。对部分支持的第三方文件管理器，也可以复用已有标签页，而不是重复打开窗口。
 
@@ -80,6 +80,8 @@ V2 对设置、动作管理、确认框和通知窗口的生命周期进行了
 
 新版主窗口默认采用不抢占前台焦点的面板行为。进入搜索输入状态后才允许正常输入，结束搜索后恢复面板的被动显示方式。
 
+2.2.17 起，选择窗口时会跳过鼠标穿透覆盖层，便于点选其后方的真实窗口。
+
 ## 场景动作的批量整理
 
 “场景与动作管理”支持多选、连续选择、全选、批量移动、同时添加和安全剪切。

docs/v2/xaction/modules/basic/notify.md

@@ -65,7 +65,7 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z"
 
 **最大行数**：按换行计。`0` 不限制。
 
-**保持秒数**：`0` 用默认时长，`-1` 一直显示，或填 2～30 秒。
+**保持秒数**：`0` 用默认时长，`-1` 一直显示，或填秒数。2.2.17 起按设置可保持 **1 秒**；更早版本界面与元数据常见范围为 2～30 秒。
 
 **显示时间**：有标题时在右上角显示发出时间；无标题的紧凑条不显示。
 

docs/v2/xaction/modules/files/everythingsearch.md

@@ -17,6 +17,9 @@ legacyContentUpdatedAt: "2024-06-19T03:24:46.000Z"
 
 调用本机 [Everything](https://www.voidtools.com/zh-cn/) 的接口搜索文件。需要已安装并正在运行 Everything 1.4.1.969 或更高版本。
 
+2.2.17 起，文件搜索也兼容提供 Everything 通信接口的替代服务（只要实现兼容的 IPC）。本机仍需有可用的搜索服务在运行；具体兼容范围以客户端实际探测为准。
+
+
 2022-09-08 有传闻称 Everything 更新服务疑似被劫持，参见 [V2EX 讨论](https://www.v2ex.com/t/878475)。请关闭「启动时检查更新」，需要时到官网手动下载。
 
 ## 当前模块定义

docs/v2/xaction/modules/image/pinimage.md

@@ -26,3 +26,5 @@ metadataGeneratedAt: "2026-08-24 20:01:39"
 2.1.27 起，HTML、公式或剪贴板贴图窗口已经显示后，不再因后续未生成位图提示而误弹“未产生位图”。
 
 2.1.28 起，贴图右键菜单「图像处理」可用 **抠出主体（透明背景）**；2.1.29 起可手动选择 **通用抠图** 或 **人像抠图**，在本机完成抠图后继续保存或贴图。首次使用需要已登录 Quicker，并下载约 4.4 MB 的独立本地模型；它和 OCR 文字模型分开管理，不会重复下载已有 OCR 模型。
+
+2.2.17 起，贴图支持**鼠标穿透**，并可通过独立工具条调节不透明度、恢复操作或关闭贴图。交互细节见 [截图 Pro · 贴图窗口](/v2/features/screenshot/capture-pro#贴图窗口截图后)。