diff --git a/docs/important-notice.md b/docs/important-notice.md
index 2bfee2e..0caacb6 100644
--- a/docs/important-notice.md
+++ b/docs/important-notice.md
@@ -1,162 +1,70 @@
 ---
-title: 体验前必读
-description: 安装或体验 Quicker V2 前需要知道的 Preview 范围、专业版限制、共存与降级风险。
+title: 安装前准备
+description: 确认 Quicker V2 的体验范围，准备安装环境和 V1 数据迁移。
 sidebar_position: 2
 quickerDocKey: important-notice
 comments: true
 ---
 
-# 体验前必读
+import LegacyNoticeRedirect from '@site/src/components/LegacyNoticeRedirect';
 
-官网 [Quicker 2.0](https://getquicker.net/V2) 当前标注为 **PREVIEW · 仅面向专业版用户**。下面几条会直接影响你能不能装、装完能不能登录、以及出问题后能不能退回 1.x。
+# 安装前准备
 
-## 当前是 Preview，只给专业版
+第一次体验 Quicker V2，先确认账号和安装环境，再选择下方的安装或迁移步骤。
 
-V2 仍在快速迭代，部分功能未完成，已有动作也可能需要调整。现阶段只建议专业版用户尝鲜和反馈，不适合当作已经稳定的正式版。
+## 适用范围
 
-## 免费版暂时不能登录
+V2 当前是 **Preview 体验版，仅面向专业版用户**。功能仍在快速迭代，已有动作也可能需要调整，适合尝鲜和反馈。
 
-免费版的数据迁移仍在开发。免费账号目前无法登录 2.0，不要按「装上就能接着用原来的免费数据」来规划。
+免费版数据迁移仍在开发，**免费账号目前无法登录 2.0**。
 
-## 不要替换关键的 1.x 环境
+## 安装与迁移
 
-当前版本适合试用和反馈。如果这台电脑上的 1.x 承担着不能中断的日常工作，请另找一台机器或另开一个可回退的环境体验，不要直接替换那套关键安装。
+- **保留可回退的环境。** 如果 1.x 承担着不能中断的日常工作，建议另找一台电脑体验 V2。
+- **先备份，再安装。** 1.x 与 V2 不能同时安装，浏览器扩展会冲突。迁移前先同步并备份，再卸载 1.x、安装 V2。
+- **确认数据独立。** 首次登录会迁移一份 1.x 数据，之后两代数据各自独立，不是双向同步。回到 1.x 时，不要用 V2 数据目录覆盖旧版。
 
-## 两代不能同时安装
+已经在使用 V2，准备降级或混用不同版本？请看 [升级与回退](/v2/migration/upgrade-and-rollback)，按功能查找兼容注意项。
 
-浏览器扩展会冲突，**不要同时安装 1.x 和 V2**。需要回退时，重新安装 1.x 即可；不要用 V2 的数据目录覆盖 1.x。
-
-首次登录会按「数据分叉」迁移：1.x 与 V2 的数据随后各自独立，不是双向镜像。步骤见 [从 V1 迁移](/v2/migration/from-v1)。
-
-## 从 2.1.0 降级会清掉 2.0.x 没有的数据（2026-07-28）
-
-2.1.0 相对 2.0.x 增加了大量功能和对应的底层存储。2.0.x 里没有这些数据结构。如果在 2.1.0 里用过新功能并保存了新配置，再降回 2.0.x，这些数据可能被覆盖清除。
-
-## 回退到 2.1.17 之前可能要重填 API 密钥
-
-2.1.17 起，AI 设置可以同步（API Key 仍只在本机加密保存）。官网版本记录写明：若回退到 2.1.15，请在旧版中重新填写 AI API 密钥；新版保存后的凭据格式，旧版不能正确读取。使用新 AI 模块的动作也无法在 2.1.15 及更旧版本运行。
-
-更早的回退也有类似情况，例如回退到 2.1.12 可能清除图片翻译凭证。逐版本注意以 [官网版本记录](https://getquicker.net/v2/versions) 为准。
-
-## 2.1.29 侧边栏快捷按钮的回退注意
-
-2.1.29 起可配置新版主窗口侧边栏快捷按钮。配置后若再用 2.1.28 或更早版本修改并同步动作面板偏好，旧客户端可能清除快捷按钮配置，恢复为仅默认「截图 Pro」。多设备使用同一账号时，建议先升级所有设备；回退旧版后也避免修改该项。
-
-## 回退到 2.2.4 后保存截图设置会清除 2.2.5 的保存日期格式（2026-09-04）
-
-2.2.5 起截图保存设置增加了日期格式选项。若回退到 2.2.4 后又保存截图设置，旧客户端会清除新版的保存日期格式选择；再次升级后需重新选择。此设置只保存在本机，不影响已经保存的图片，也不影响云端数据。
-
-## 回退到 2.2.6 后保存截图设置会丢弃 2.2.7 的阴影与边框配置（2026-09-07）
-
-2.2.7 起截图 Pro 可为选区添加阴影和边框。若回退到 2.2.6 后又保存截图工具设置，旧客户端会丢弃新版阴影 / 边框配置；再次升级后需重新设置。截图文件本身不受影响。需要保留配置时，请先备份本机 `ScreenCapture/settings/image-drawing-tool-state.json`。
-
-## 2.2.11 触发设置的多设备与回退风险
-
-新增的功能级黑白名单、左键辅助多键及短长按模式不受旧客户端支持。旧客户端可能按旧的适用范围触发；再次保存并同步设置，还可能清除新增字段，影响同账号其它设备。
-
-请先备份配置，并把所有编辑这些设置的设备升级到 2.2.11 或更高版本。必须回退时，避免在旧版修改和同步这些设置。已经丢失的字段需要从备份恢复或重新配置。
-
-触碰屏幕边框规则请在新版维护，降级前停用或移除。
-
-“指定类型”变量不能生成 V1 分享制品，旧版 V2 也不能保证按指定类型正常执行；不要把含此类变量的动作交给旧客户端运行。
-
-## 2.2.12 规则父场景与 2.2.13 面板自由布局
-
-2.2.13 起，新面板可保存动作的格子坐标、空位和分组高度。这些数据会随账号同步，但 2.2.12 及更旧客户端不识别新字段。如果回退后又在旧版编辑或同步同一场景，可能清除自由布局；再次升级后需重新摆放。
-
-规则父场景的归属也从 2.2.12 开始保存。旧版客户端不会应用这层共享规则或它的面板动作。
-
-多设备使用同一账号时，规则父场景需要所有设备至少升级到 2.2.12；要编辑自由格子布局，则建议全部升级到 2.2.13 或更高版本。必须回退时，不要在旧版修改或同步这些场景。
-
-## 2.2.14 截图文件名模板与悬浮分组动作
-
-2.2.14 起，截图保存的独立日期格式选项已并入文件名模板，支持 `{date:格式}`（.NET DateTime）。编辑时会把旧日期格式转换并保留效果。若回退到更旧版本，需将模板中的 `{date:格式}` 改回 `{date}`、`{time}` 等旧语法，才能正常使用文件名模板。
-
-「悬浮分组」动作（按名称打开、关闭或切换）需要 2.2.14 或更高版本客户端；旧版无法识别此动作类型。创建前建议升级所有同步设备；必须回退时，请先备份悬浮布局，并避免在旧版编辑或同步依赖该动作的内容。
-
-
-## 2.2.17 浏览器父场景归属的多设备与回退
-
-2.2.17 起，自定义程序的浏览器归属统一纳入父场景管理，并随账号同步。将自定义程序添加到浏览器父场景下后，需要重新设置一次归属。
-
-使用浏览器父场景归属前，请将同一账号的所有设备升级到 2.2.17 或更高版本。回退到旧版本或新旧客户端混用时，包含浏览器归属的整份父场景归属配置会暂时失效并变为只读；数据不会因此删除，全部设备重新升级后可恢复。
-
-## 2.2.18 远程文件账号与 AI 助手工作区
-
-2.2.18 起，组合动作可通过远程文件步骤访问 WebDAV 网盘或 NAS。远程文件账号在 **设置 → 软件连接 → 远程文件账号** 中配置，只保存在本机；它不会随账号云同步、状态备份或动作导出迁移。换电脑、重装或分享动作给别人时，需要在目标电脑重新配置相同的账号引用名。旧版客户端不能运行包含远程文件步骤的动作，升级前不要把这类动作交给仍停留在旧版的设备执行。
-
-AI 助手正式版支持选择本地工作区。选择本地文件夹后，AI 对普通文件的修改会直接保存到该文件夹；请先确认目录、备份和版本管理方式。打开历史对话时会恢复对应目录，但切换工作区会开启新对话，不会把原对话、未提交草稿或上下文迁移过去。
-
-如果回退到不支持自选工作区的旧正式版，已经选择工作区的项目对话不能继续按原目录工作。请升级到支持该功能的版本后，再继续对应项目对话。
-
-## 2.2.19 S3 账号与凭据导出
-
-2.2.19 起，保存 S3 账号会升级本机的远程文件账号配置。旧版会拒绝修改整份账号列表（包括其中的 WebDAV 账号），以避免丢失 S3 字段和密钥引用。数据不会因打开旧版而删除，但删除全部 S3 账号也不会自动降回旧格式。回退前先在新版导出必要账号，详见[远程文件](/v2/features/remote-files#回退旧版)。
-
-远程文件账号的导出 JSON 包含明文密码或密钥。不要上传到公开网盘、聊天群、动作分享或源码仓库；传输完成后及时删除，外泄后立即在服务端轮换凭据。
-
-## 2.2.20 显示器与虚拟桌面步骤
-
-2.2.20 起新增的显示器、虚拟桌面步骤需要新版客户端。含这些步骤的动作在旧版客户端中可能无法识别或运行；多设备同步或分享给他人前，请确认目标设备已升级到 2.2.20 或更高版本。
-
-## 2.2.21 代码补全服务
-
-2.2.21 起，组合动作与表达式等编辑器的代码补全默认走在线服务，以减小安装包并节约本机内存。需要离线或不希望上传代码时，可在 **设置 → 动作设计 → 代码补全服务** 中单独安装本地补全组件，并勾选 **使用本地补全服务** 后保存。该选项默认关闭。
-
-使用在线补全时，Quicker 会向服务器发送正在编辑的代码、变量类型和默认 using。本地模式下，组件不可用时不会自动改用在线服务。操作入口见 [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)。
-
-## 2.2.22 列表项自定义子程序与提示消息默认设置
-
-2.2.22 起，「管理和排序列表」可通过高级参数指定 **添加项子程序**、**编辑项子程序**，用多字段表单等方式处理复杂列表项。依赖这些子程序的动作需要 **2.2.22 或更高版本**客户端；分享给他人时请注明最低版本要求。旧版没有对应回调，不能当作退回内置编辑器的等价行为。操作说明见 [管理和排序列表](/v2/xaction/modules/managelist#用子程序自定义添加和编辑)。
-
-同版起，可在 **设置 → 模块功能选项** 配置提示消息的默认显示位置和停留时间，并随账号同步。旧客户端不认识这两项设置；若在旧版保存设置并同步，可能把它们重置。建议先记下所选值，把所有会改设置的设备升级后再修改；若已被重置，可在新版重新设置。步骤或脚本里单独指定的位置、时长仍优先于全局默认。详见 [提示消息](/v2/xaction/modules/notify#默认位置与停留时间)。
-
-同版起，截图、贴图和录屏标注中 `Ctrl+Shift+Z` 改为 **重做**（不再清空全部标注）；清空全部标注请用 `Shift+Delete`。首次按旧习惯的 `Ctrl+Shift+Z` 时，客户端会提示一次并执行重做。
-
-旧「底部居中」步骤选项现在跟随全局默认位置；需要固定时，请重新选择本版的「底部居中」。
-
-新导出的 Agent `.jsonl` 对话文件请用本版或更新版本导入；仍兼容旧版完整会话 JSON，已有对话无需迁移。导入的对话仅供查看，不能继续发送消息。见[AI 与 Agent](/v2/features/ai-and-agent)。
-
-## 2.2.23 分享适用软件与浏览器通用
-
-2.2.23 起，分享动作可选择 **浏览器通用** 作为适用软件，使同一动作出现在 Chrome、Edge、Firefox 等支持的浏览器动作页中。从浏览器通用场景分享时默认选此分类。
-
-更新已有分享时，若原「适用软件」保存的是非法值，需要重新选择有效分类，不再自动改为「通用」。已有 Chrome 等具体程序分类**不会**自动改成「浏览器通用」；需要跨浏览器展示时请手动改选。操作说明见 [分享动作与公共子程序](/v2/features/action-sharing#适用软件与浏览器通用)。
-
-## 2.2.24 获取最后打开编辑器的动作
-
-2.2.24 起，「Quicker操作」新增 **获取最后打开编辑器的动作**，可取得本次启动期间最近打开或重新激活编辑器的已安装动作 ID。含此操作类型的动作需要 **2.2.24 或更高版本**客户端；旧版无法识别该类型。多设备同步或分享给他人前，请确认目标设备已升级。说明见 [Quicker操作](/v2/xaction/modules/quickeroperations#获取最后打开编辑器的动作)。
-
-## 2.2.25 设置窗口改版与本机界面状态
-
-2.2.25 起，设置窗口改为树形导航，支持搜索并跳转到具体设置项。分类与入口有调整；找不到原位置时，优先用设置内搜索。已改版的设置页逐项自动保存，不再提供整页「应用／撤销」；无效或尚未提交的输入会在离开当前页时提示。
-
-回退到 **2.2.24** 后，旧版保存本机状态可能清除新版 AI 助手侧栏宽度、开关和设置导航展开记录；这些界面偏好可重新设置，不影响动作内容。需要保留时，请先备份本机 `data/app-state.json`。
-
-## 2.2.26 轮盘 F2 编辑指向的动作
-
-2.2.26 起，轮盘显示时可按 `F2` 编辑鼠标指向的动作。该选项**默认开启**，可在轮盘设置中关闭。已有 F2 子动作，以及 F2 重复触发相关设置优先于本开关。
-
-回退到旧版后，若再保存或同步轮盘设置，可能丢弃此开关；再次升级会恢复为默认开启。建议各设备升级后再调整，必要时在升级后重新关闭。操作说明见 [轮盘菜单](/v2/features/triggers/circle-menu#按-f2-编辑指向的动作)。
-
-## 相关链接
+## 开始使用
 
 <RelatedDocs
   items={[
     {
       href: '/v2/install/windows',
       label: '安装 V2',
-      description: '从 /V2 下载，不要用 /Download',
+      description: '下载、环境要求与安装步骤',
     },
     {
       href: '/v2/migration/from-v1',
       label: '从 V1 迁移',
-      description: '先备份，再卸载 1.x',
+      description: '备份、迁移、检查和回退',
     },
     {
-      href: 'https://getquicker.net/v2/versions',
-      label: '官网版本记录',
-      description: '各版本新增、修复与注意',
+      href: '/v2/getting-started',
+      label: '首次使用',
+      description: '打开面板并运行第一个动作',
     },
   ]}
 />
+
+<LegacyNoticeRedirect hashes={[
+  "从-210-降级会清掉-20x-没有的数据2026-07-28",
+  "回退到-2117-之前可能要重填-api-密钥",
+  "2129-侧边栏快捷按钮的回退注意",
+  "回退到-224-后保存截图设置会清除-225-的保存日期格式2026-09-04",
+  "回退到-226-后保存截图设置会丢弃-227-的阴影与边框配置2026-09-07",
+  "2211-触发设置的多设备与回退风险",
+  "2212-规则父场景与-2213-面板自由布局",
+  "2214-截图文件名模板与悬浮分组动作",
+  "2217-浏览器父场景归属的多设备与回退",
+  "2218-远程文件账号与-ai-助手工作区",
+  "2219-s3-账号与凭据导出",
+  "2220-显示器与虚拟桌面步骤",
+  "2221-代码补全服务",
+  "2222-列表项自定义子程序与提示消息默认设置",
+  "2223-分享适用软件与浏览器通用",
+  "2224-获取最后打开编辑器的动作",
+  "2225-设置窗口改版与本机界面状态",
+  "2226-轮盘-f2-编辑指向的动作"
+]} />
diff --git a/docs/index.md b/docs/index.md
index 8fcc0cd..5748eaa 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -20,7 +20,7 @@ Quicker 是 Windows 上的效率工具。你可以从面板运行动作，也可
 
 <div className="docs-landing__notice">
 
-**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [使用限制与回退说明](./important-notice.md)，不建议替换无法中断的 1.x 关键环境。
+**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [安装前准备](./important-notice.md)，不建议替换无法中断的 1.x 关键环境。
 
 </div>
 
diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md
index 64f5710..edd3b29 100644
--- a/docs/release-notes/index.md
+++ b/docs/release-notes/index.md
@@ -26,7 +26,7 @@ comments: true
 升级到 **2.1.23 或更高版本**时，后台屏幕录制步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其他旧动作请打开并确认录制范围，避免录到不符合预期的屏幕区域。
 :::
 
-多设备使用、降级或回退前，请阅读[体验前必读](/important-notice)。各版本的具体风险也在下方对应条目中标出。
+多设备使用、降级或回退前，请阅读[升级与回退](/v2/migration/upgrade-and-rollback)。各版本的具体风险也在下方对应条目中标出。
 
 ## 近期文档补充
 
@@ -34,14 +34,14 @@ comments: true
 
 - [动作编辑窗口 AI](/v2/features/ai-and-agent#用-ai-编写和修改动作)支持「运行并分析」：可查看最近运行结果、定位失败步骤并分析运行问题。
 - [上下文菜单](/v2/features/tools#上下文菜单)可按文本、图片、文件分别调整内置功能显隐；「管理关联动作」支持自动显示或手动挑选并调整顺序。
-- [轮盘菜单](/v2/features/triggers/circle-menu#按-f2-编辑指向的动作)显示时可按 `F2` 编辑鼠标指向的动作（默认开启，可在轮盘设置中关闭）；已有 F2 子动作及 F2 重复触发设置优先。回退注意见[体验前必读](/important-notice#2226-轮盘-f2-编辑指向的动作)。
+- [轮盘菜单](/v2/features/triggers/circle-menu#按-f2-编辑指向的动作)显示时可按 `F2` 编辑鼠标指向的动作（默认开启，可在轮盘设置中关闭）；已有 F2 子动作及 F2 重复触发设置优先。回退注意见[升级与回退](/v2/migration/upgrade-and-rollback#2226-轮盘-f2-编辑指向的动作)。
 - 「动作管理」整合到 **设置 → 动作 → 全部动作**，「公共子程序管理」整合到 **设置 → 动作 → 公共子程序**；独立公共子程序窗口已移除。原「场景与动作」管理窗口更名为 **场景、动作与触发**。按键双击管理入口移至 **设置 → 功能快捷键**，原有数据沿用。入口说明见[动作面板](/v2/features/action-panel/usage#侧边栏快捷按钮)、[按键双击](/v2/features/triggers/key-double-click)。
 - [AI 对话](/v2/features/ai-and-agent#对话界面)合并展示同轮程序变更，支持撤销已记录完整快照的整轮修改，并保留新对话与输入草稿；粘贴附件与图片文字识别改为按需处理。
 - 录屏鼠标点击提示改为中空圆环；旧 C# 脚本 `Marshal.GetActiveObject` 编译失败等修复见[官网版本记录](https://getquicker.net/V2/Versions)。
 
 ### 2.2.25 · 设置改版、设计器 AI 与截图增强
 
-- [设置窗口](/important-notice#2225-设置窗口改版与本机界面状态)改为树形导航，支持搜索并定位具体设置项；选项修改通常立即生效，不再提供整页「应用／撤销」。找不到原位置时可用搜索；无效或尚未提交的输入会在离页时提示。
+- [设置窗口](/v2/migration/upgrade-and-rollback#2225-设置窗口改版与本机界面状态)改为树形导航，支持搜索并定位具体设置项；选项修改通常立即生效，不再提供整页「应用／撤销」。找不到原位置时可用搜索；无效或尚未提交的输入会在离页时提示。
 - [动作编辑窗口](/v2/features/ai-and-agent#在设计器内修改)在配置好 AI 参数后，可点右上角 AI 按钮或按 `Ctrl+J` 打开面板，用 AI 编写和修改当前动作。
 - [动作面板](/v2/features/action-panel/usage#移动或复制动作)拖动动作时，悬停在场景标签上即可切换场景，便于跨场景整理。
 - [截图 Pro](/v2/features/screenshot/capture-pro#预选截图区域与快捷出口)所有操作均可使用预选截图区域；「框选即出图」和快速保存可同时选择复制到剪贴板、截图后贴图。
@@ -50,21 +50,21 @@ comments: true
 
 ### 2.2.24 · Quicker操作、自定义操作窗设计与 AI 对话
 
-- [Quicker操作](/v2/xaction/modules/quickeroperations#获取最后打开编辑器的动作)新增「获取最后打开编辑器的动作」，可取得本次启动期间最近打开或重新激活编辑器的已安装动作 ID，便于接续编辑。使用该类型的动作需要 **2.2.24 或更高版本**，详见[升级注意](/important-notice#2224-获取最后打开编辑器的动作)。
+- [Quicker操作](/v2/xaction/modules/quickeroperations#获取最后打开编辑器的动作)新增「获取最后打开编辑器的动作」，可取得本次启动期间最近打开或重新激活编辑器的已安装动作 ID，便于接续编辑。使用该类型的动作需要 **2.2.24 或更高版本**，详见[升级注意](/v2/migration/upgrade-and-rollback#2224-获取最后打开编辑器的动作)。
 - [自定义操作窗](/v2/xaction/modules/custompanel#可视化设计窗)可从步骤编辑窗口的「设计」按钮打开可视化设计窗，编辑按钮、分组和布局并实时预览；操作项定义使用变量或表达式时不可用。操作项编辑窗口按操作类型显示相关字段，路径可选文件，多行脚本更便于编辑。
 - [AI 对话](/v2/features/ai-and-agent#对话界面)支持选中文字后「添加到对话」作为引用；模型菜单可切换上下文窗口大小；侧栏可收起、展开并记住状态。
 - 截图编号标注字体更清晰；修复轮盘菜单子动作扩展圈触发距离与命中优先级，以及长截图结束编辑、关闭贴图后残留窗口或占用内存的问题。完整改动见[官网版本记录](https://getquicker.net/V2/Versions)。
 
 ### 2.2.23 · 浏览器通用分享、侧边栏与贴图标题
 
-- 分享动作可选[「浏览器通用」适用软件](/v2/features/action-sharing#适用软件与浏览器通用)，可在 Chrome、Edge、Firefox 等支持的浏览器动作页中找到同一动作；从浏览器通用场景分享时默认选此分类。更新已有分享时若原适用软件为非法值需重选，详见[升级注意](/important-notice#2223-分享适用软件与浏览器通用)。
+- 分享动作可选[「浏览器通用」适用软件](/v2/features/action-sharing#适用软件与浏览器通用)，可在 Chrome、Edge、Firefox 等支持的浏览器动作页中找到同一动作；从浏览器通用场景分享时默认选此分类。更新已有分享时若原适用软件为非法值需重选，详见[升级注意](/v2/migration/upgrade-and-rollback#2223-分享适用软件与浏览器通用)。
 - [主面板侧边栏快捷按钮](/v2/features/action-panel/usage#侧边栏快捷按钮)按可用高度显示更多，放不下的收进「更多」。
 - [贴图窗口](/v2/features/screenshot/capture-pro#贴图窗口截图后)标题不再随内容变化；图片标题改在窗口内（图片下方）显示。
 - 步骤选中轮廓更清晰且保留底色；锁屏时悬浮分组不显示；托盘程序激活误报等多窗口的修复。完整改动见[官网版本记录](https://getquicker.net/V2/Versions)。
 
 ### 2.2.22 · 列表编辑、提示消息与长截图
 
-- [管理和排序列表](/v2/xaction/modules/managelist#用子程序自定义添加和编辑)支持通过子程序自定义添加、编辑列表项，可用多字段表单处理复杂内容。使用该能力的动作需要 **2.2.22 或更高版本**，详见[升级注意](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。
+- [管理和排序列表](/v2/xaction/modules/managelist#用子程序自定义添加和编辑)支持通过子程序自定义添加、编辑列表项，可用多字段表单处理复杂内容。使用该能力的动作需要 **2.2.22 或更高版本**，详见[升级注意](/v2/migration/upgrade-and-rollback#2222-列表项自定义子程序与提示消息默认设置)。
 - [提示消息](/v2/xaction/modules/notify#默认位置与停留时间)可在「设置 → 模块功能选项」配置默认显示位置和停留时间，并随账号同步；步骤里单独指定的位置或时长仍优先。
 - [表单多选列表](/v2/xaction/modules/form#多选列表已选标签图标)的已选标签会显示选项图标。
 - [长截图](/v2/features/screenshot/capture-pro#长截图编辑)支持「重来」；截图、贴图和录屏标注中 `Ctrl+Shift+Z` 改为重做，「清空全部标注」改用 `Shift+Delete`，详见[快捷键说明](/v2/features/screenshot/capture-pro#快捷键一览)。
@@ -73,19 +73,19 @@ comments: true
 
 ### 2.2.21 · 代码补全与动作面板
 
-- [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)默认在线提供，也可在「设置 → 动作设计」安装本地组件。在线补全会向服务器发送编辑中的代码等信息，详见[升级注意](/important-notice#2221-代码补全服务)。
+- [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)默认在线提供，也可在「设置 → 动作设计」安装本地组件。在线补全会向服务器发送编辑中的代码等信息，详见[升级注意](/v2/migration/upgrade-and-rollback#2221-代码补全服务)。
 - [文本窗口](/v2/xaction/modules/showtext#记住上次位置和大小)可记住上次的位置和大小。
 - [动作面板](/v2/features/action-panel/usage#复制后同时添加与删除关联)补充了复制后「同时添加到这里」及删除时查看场景关联位置的说明。
 
 ### 2.2.20 · 显示器、录屏与 AI
 
-- 新增[显示器与虚拟桌面步骤](/v2/features/displays-and-desktops)及其参数说明。包含这些步骤的动作需要 **2.2.20 或更高版本**客户端，详见[升级注意](/important-notice#2220-显示器与虚拟桌面步骤)。
+- 新增[显示器与虚拟桌面步骤](/v2/features/displays-and-desktops)及其参数说明。包含这些步骤的动作需要 **2.2.20 或更高版本**客户端，详见[升级注意](/v2/migration/upgrade-and-rollback#2220-显示器与虚拟桌面步骤)。
 - 补充[子程序输入参数的代码语言与高级分组](/v2/xaction/modules/subprogram#输入参数)，以及[屏幕录制](/v2/xaction/modules/screen-recording-ui#参数说明)和[后台屏幕录制](/v2/xaction/modules/screen-recording#参数说明)的 FFmpeg 编码参数。
 - 补充[AI 对话导入导出与侧边设计器](/v2/features/ai-and-agent)，以及[贴图窗口按 `Y` 切换阴影、右键菜单调整](/v2/features/screenshot/capture-pro#移动模式)。
 
 ### 2.2.18 · 远程文件与工作区
 
-- 补充[远程文件（WebDAV）步骤及本机账号限制](/v2/xaction)、[远程文件账号入口和 HTTP / WebSocket 设置迁移](/v2/features/software-connections)。跨设备或可能回退时，请先看[远程文件账号与 AI 助手工作区注意](/important-notice#2218-远程文件账号与-ai-助手工作区)。
+- 补充[远程文件（WebDAV）步骤及本机账号限制](/v2/xaction)、[远程文件账号入口和 HTTP / WebSocket 设置迁移](/v2/features/software-connections)。跨设备或可能回退时，请先看[远程文件账号与 AI 助手工作区注意](/v2/migration/upgrade-and-rollback#2218-远程文件账号与-ai-助手工作区)。
 - 补充[主面板自由格子边缘插队、工具菜单及未配置程序提示](/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#贴图窗口截图后)。网络子程序、焦点切换和贴图工具栏等其他修复见官网完整记录。
 
@@ -110,13 +110,13 @@ comments: true
 ### 2.2.14 · 自由格子与表单
 
 - 补充[自由格子触发键](/v2/features/action-panel/usage#触发键)、[用动作控制悬浮分组](/v2/features/floating-actions#用动作控制悬浮分组)、[轮盘继承动作预览](/v2/features/triggers/circle-menu#按场景覆盖与来源切换)。
-- 补充[表单扩展选项及 `$=` 校验](/v2/xaction/modules/form)、[截图文件名模板 `{date:格式}`](/v2/features/screenshot/capture-pro#截图-pro-设置页)，以及面板分组导航、确认与复制按钮等交互调整。回退前请看[截图文件名模板与悬浮分组动作注意](/important-notice#2214-截图文件名模板与悬浮分组动作)。
+- 补充[表单扩展选项及 `$=` 校验](/v2/xaction/modules/form)、[截图文件名模板 `{date:格式}`](/v2/features/screenshot/capture-pro#截图-pro-设置页)，以及面板分组导航、确认与复制按钮等交互调整。回退前请看[截图文件名模板与悬浮分组动作注意](/v2/migration/upgrade-and-rollback#2214-截图文件名模板与悬浮分组动作)。
 
 ### 2.2.13 · 长截图与自由格子
 
 - 新增[长截图裁剪与删段](/v2/features/screenshot/capture-pro#长截图编辑)、[新面板自由格子布局](/v2/features/action-panel/usage#自由格子布局)、[多字段表单单选按钮与表达式校验](/v2/xaction/modules/form)、[逐行打开网址、文件和文件夹](/v2/xaction/modules/openurl)说明。
 - 补充[动作运行状态提示](/v2/features/action-panel/usage#查找和运行动作)、[Ctrl 拖动调整全局区和上下文区高度](/v2/features/action-panel/usage#窗口尺寸)、[悬浮分组显示模式](/v2/features/floating-actions#紧凑半透明和名称显示)、[动作更新策略集中管理](/v2/features/action-sharing#安装和检查更新)、[Illustrator 2023 支持](/v2/features/software-connections/software/illustrator)。
-- 多设备使用或可能回退时，请阅读[规则父场景与面板自由布局注意](/important-notice#2212-规则父场景与-2213-面板自由布局)。
+- 多设备使用或可能回退时，请阅读[规则父场景与面板自由布局注意](/v2/migration/upgrade-and-rollback#2212-规则父场景与-2213-面板自由布局)。
 
 ### 2.2.12 · 备份、API 与截图
 
@@ -127,7 +127,7 @@ comments: true
 
 - 补充[左键辅助连续按键](/v2/features/triggers/left-button-plus#一次按住连续执行)、[触碰屏幕边框](/v2/features/triggers/advanced-mouse-triggers#触碰屏幕边框)、[云端动作回收站](/v2/features/account-and-sync#云端动作回收站)。
 - 更新[变量](/v2/xaction/concepts/variables)、[运行记录](/v2/features/tools#动作运行与触发记录)、[截图 Pro](/v2/features/screenshot/capture-pro)、[AI 与外部助手](/v2/features/ai-and-agent)的操作说明；动作更新方式、只读动作外观及分享限制见[动作分享](/v2/features/action-sharing)。
-- 升级前请阅读[触发设置的多设备与回退风险](/important-notice#2211-触发设置的多设备与回退风险)。
+- 升级前请阅读[触发设置的多设备与回退风险](/v2/migration/upgrade-and-rollback#2211-触发设置的多设备与回退风险)。
 
 ## 早期文档补充
 
@@ -151,7 +151,7 @@ comments: true
 
 - 补充[截图 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 会丢失阴影与边框配置；可先备份 `image-drawing-tool-state.json`，详见[回退注意](/important-notice)。
+- 回退到 2.2.6 会丢失阴影与边框配置；可先备份 `image-drawing-tool-state.json`，详见[回退注意](/v2/migration/upgrade-and-rollback#回退到-226-后保存截图设置会丢弃-227-的阴影与边框配置2026-09-07)。
 
 ### 2.2.6 · 悬浮动作与分组
 
@@ -162,7 +162,7 @@ comments: true
 
 - 补充[软件连接与 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)。
+- 百度图片翻译 V2.0 使用 [APP ID 与 API Key 双凭证](/v2/features/screenshot/image-translate)；可能回退时请先查看该功能的凭证说明，并核对[官网版本记录](https://getquicker.net/v2/versions)中对应版本的注意项。
 
 ### 2.2.4 · 软件连接与 OCR 结果窗
 
diff --git a/docs/v2/features/account-and-sync.md b/docs/v2/features/account-and-sync.md
index 9ad086d..5a02ec1 100644
--- a/docs/v2/features/account-and-sync.md
+++ b/docs/v2/features/account-and-sync.md
@@ -9,7 +9,7 @@ comments: true
 # 账号、登录与数据同步
 
 :::caution[Preview · 仅专业版]
-免费版数据迁移仍在开发，免费账号目前无法登录 2.0。完整限制见 [体验前必读](/important-notice)。
+免费版数据迁移仍在开发，免费账号目前无法登录 2.0。完整限制见 [安装前准备](/important-notice)。
 :::
 
 V2 为每个账号建立独立的本地数据目录。业务数据、本机状态、缓存和日志分开；切换账号时不再共用同一份账号业务库。
diff --git a/docs/v2/features/ai-and-agent.md b/docs/v2/features/ai-and-agent.md
index de6241b..521fbfa 100644
--- a/docs/v2/features/ai-and-agent.md
+++ b/docs/v2/features/ai-and-agent.md
@@ -74,7 +74,7 @@ comments: true
 
 在 2.2.22 中，导入的对话仅供查看，不能继续发送消息；该版本的对话文件不打包附件文件、工作区文件或模型上下文，也不会重放工具操作。2.2.23 起的续聊条件见[导入后继续对话](#导入后继续对话)。发送前请检查是否含私人内容、路径或工具返回的数据。
 
-新版对话文件请用 **2.2.22 或更高版本**导入，旧版离线查看流程不保证兼容；已有普通对话无需迁移。工作区回退限制见 [体验前必读](/important-notice#2218-远程文件账号与-ai-助手工作区)。
+新版对话文件请用 **2.2.22 或更高版本**导入，旧版离线查看流程不保证兼容；已有普通对话无需迁移。工作区回退限制见 [升级与回退](/v2/migration/upgrade-and-rollback#2218-远程文件账号与-ai-助手工作区)。
 
 ### 针对步骤提问
 
diff --git a/docs/v2/features/floating-actions.md b/docs/v2/features/floating-actions.md
index b3e107c..376da27 100644
--- a/docs/v2/features/floating-actions.md
+++ b/docs/v2/features/floating-actions.md
@@ -28,7 +28,7 @@ comments: true
 
 2.2.14 起，可在基础动作 → Quicker功能 → 「悬浮分组」中，按**名称**创建打开、关闭或切换悬浮分组窗口的动作。
 
-需要 2.2.14 或更高版本客户端；旧版无法识别此动作类型。创建前建议升级所有同步设备；回退前请先备份悬浮布局，见 [体验前必读](/important-notice#2214-截图文件名模板与悬浮分组动作)。
+需要 2.2.14 或更高版本客户端；旧版无法识别此动作类型。创建前建议升级所有同步设备；回退前请先备份悬浮布局，见 [升级与回退](/v2/migration/upgrade-and-rollback#2214-截图文件名模板与悬浮分组动作)。
 
 ## 移动和整理
 
diff --git a/docs/v2/features/scenes.md b/docs/v2/features/scenes.md
index d02f182..b923047 100644
--- a/docs/v2/features/scenes.md
+++ b/docs/v2/features/scenes.md
@@ -28,7 +28,7 @@ V2 的面板按 **场景 → 分组 → 动作** 组织。场景回答「当前
 
 ## 作为浏览器程序与父场景归属
 
-2.2.17 起，自定义程序的浏览器归属统一纳入父场景管理，并随账号同步；此前可能出现“重启后归属失效”的情况已按此修复。把自定义程序添加到浏览器父场景下之后，需要重新设置一次归属。多设备或可能回退时，请先阅读 [2.2.17 浏览器父场景归属的多设备与回退](/important-notice#2217-浏览器父场景归属的多设备与回退)。
+2.2.17 起，自定义程序的浏览器归属统一纳入父场景管理，并随账号同步；此前可能出现“重启后归属失效”的情况已按此修复。把自定义程序添加到浏览器父场景下之后，需要重新设置一次归属。多设备或可能回退时，请先阅读 [2.2.17 浏览器父场景归属的多设备与回退](/v2/migration/upgrade-and-rollback#2217-浏览器父场景归属的多设备与回退)。
 
 ## 场景、动作与触发管理中的右键
 
@@ -64,7 +64,7 @@ V2 的面板按 **场景 → 分组 → 动作** 组织。场景回答「当前
 
 旧版本的本机自定义浏览器名单**不会迁移**，请重新设置浏览器父场景归属。原文件不会删除，浏览器公共场景已有的规则、动作和布局继续保留。
 
-使用浏览器归属前，请把同一账号的设备全部升级到 **2.2.17 或更高版本**。回退或混用旧版时，只要归属配置中包含浏览器父场景，旧客户端就会将整份归属配置视为只读，其他自定义父场景归属也会暂时失效；数据不会因此删除，重新升级后可恢复。详见[体验前必读](/important-notice#2217-浏览器父场景归属的多设备与回退)。
+使用浏览器归属前，请把同一账号的设备全部升级到 **2.2.17 或更高版本**。回退或混用旧版时，只要归属配置中包含浏览器父场景，旧客户端就会将整份归属配置视为只读，其他自定义父场景归属也会暂时失效；数据不会因此删除，重新升级后可恢复。详见[升级与回退](/v2/migration/upgrade-and-rollback#2217-浏览器父场景归属的多设备与回退)。
 
 ### 拖动设置场景归属
 
diff --git a/docs/v2/features/screenshot/capture-pro.md b/docs/v2/features/screenshot/capture-pro.md
index 07a4a8e..052a910 100644
--- a/docs/v2/features/screenshot/capture-pro.md
+++ b/docs/v2/features/screenshot/capture-pro.md
@@ -46,7 +46,7 @@ comments: true
 
 2.2.1 起，Quicker 设置中提供 **截图 Pro** 页，用来集中管理截图工具栏、确认后的默认动作、快速保存、贴图和历史偏好。2.2.5 起，截图 Pro 和贴图菜单也可控制工具栏显示；保存图片时可选择内置日期格式与文件名模板。
 
-2.2.14 起，文件名模板支持 `{date:格式}`（.NET DateTime，例如 `{date:yyyy_MM_dd_HH_mm_ss}`），设置页会提供实时文件名示例。原独立日期格式选项已并入文件名模板；编辑时会把旧日期格式转换并保留效果。回退旧版后需将 `{date:格式}` 改回 `{date}`、`{time}` 等旧语法，见 [体验前必读](/important-notice#2214-截图文件名模板与悬浮分组动作)。同版起，工具栏的确认与复制按钮不再重复显示。
+2.2.14 起，文件名模板支持 `{date:格式}`（.NET DateTime，例如 `{date:yyyy_MM_dd_HH_mm_ss}`），设置页会提供实时文件名示例。原独立日期格式选项已并入文件名模板；编辑时会把旧日期格式转换并保留效果。回退旧版后需将 `{date:格式}` 改回 `{date}`、`{time}` 等旧语法，见 [升级与回退](/v2/migration/upgrade-and-rollback#2214-截图文件名模板与悬浮分组动作)。同版起，工具栏的确认与复制按钮不再重复显示。
 
 这些设置影响手动截图和未显式指定行为的场景。通过组合动作步骤调用截图 Pro 时，**步骤参数优先**；例如动作里已经指定了写入剪贴板、截图后贴图或工具栏配置，就按动作步骤当前参数执行。
 
@@ -148,7 +148,7 @@ comments: true
 
 2.2.7 起，确认选区后可为截图添加**阴影**和**边框**；效果会随复制、保存和贴图一起输出。圆角设置会记住；阴影与边框的启用状态默认不带到下次截图，需要时再勾选记忆。2.2.10 起，选区**圆角可单独开关**：关闭圆角后仍会记住上次使用的半径，再次打开时直接恢复，不必重新调。
 
-回退到 2.2.6 后若再保存截图工具设置，会丢弃新版阴影 / 边框配置；重新升级后需重新设置（截图文件本身不受影响）。需要保留配置时，可先备份本机 `ScreenCapture/settings/image-drawing-tool-state.json`。详见 [体验前必读](/important-notice)。升级后首次使用本地 OCR 或抠图可能需要下载新版引擎及原生库；已有识别模型继续复用。
+回退到 2.2.6 后若再保存截图工具设置，会丢弃新版阴影 / 边框配置；重新升级后需重新设置（截图文件本身不受影响）。需要保留配置时，可先备份本机 `ScreenCapture/settings/image-drawing-tool-state.json`。详见 [升级与回退](/v2/migration/upgrade-and-rollback#回退到-226-后保存截图设置会丢弃-227-的阴影与边框配置2026-09-07)。升级后首次使用本地 OCR 或抠图可能需要下载新版引擎及原生库；已有识别模型继续复用。
 
 ### 工具栏位置
 
@@ -376,7 +376,7 @@ HTML、公式贴图缩放时先显示预览，停稳后按倍率重绘；复制
 ## 快捷键一览
 
 :::caution[2.2.22 标注快捷键变化]
-截图、贴图和录屏标注中，`Ctrl+Shift+Z` 改为 **重做**，不再清空全部标注；清空请用 `Shift+Delete`。首次仍按旧习惯按下时，客户端会提示一次并执行重做。详见[体验前必读](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。
+截图、贴图和录屏标注中，`Ctrl+Shift+Z` 改为 **重做**，不再清空全部标注；清空请用 `Shift+Delete`。首次仍按旧习惯按下时，客户端会提示一次并执行重做。详见[升级与回退](/v2/migration/upgrade-and-rollback#2222-列表项自定义子程序与提示消息默认设置)。
 :::
 
 
diff --git a/docs/v2/features/triggers/circle-menu.md b/docs/v2/features/triggers/circle-menu.md
index a93cdd8..f50b46e 100644
--- a/docs/v2/features/triggers/circle-menu.md
+++ b/docs/v2/features/triggers/circle-menu.md
@@ -110,7 +110,7 @@ comments: true
 如果当前动作已经给 `F2` 或任意键绑定了子动作，或将重复触发按键设为 `F2`，原有绑定优先。带 `Ctrl`、`Shift` 等修饰键的 `F2` 不作为这里的编辑快捷键；刚切换轮盘来源后，请先重新移动指针指向目标。
 
 :::caution[回退旧版可能丢弃此开关]
-回退到旧版后保存或同步轮盘设置，可能丢弃「按 F2 编辑指向的动作」开关；再次升级会恢复为默认开启。建议各设备升级后再调整，必要时重新关闭。详见[体验前必读](/important-notice#2226-轮盘-f2-编辑指向的动作)。
+回退到旧版后保存或同步轮盘设置，可能丢弃「按 F2 编辑指向的动作」开关；再次升级会恢复为默认开启。建议各设备升级后再调整，必要时重新关闭。详见[升级与回退](/v2/migration/upgrade-and-rollback#2226-轮盘-f2-编辑指向的动作)。
 :::
 
 ## 覆盖粘贴与跨场景剪切
@@ -159,7 +159,7 @@ comments: true
 
 2.2.11 起，轮盘菜单功能设置增加独立程序黑名单，可在指定程序中禁止内置入口触发，不必影响其它功能。名单编辑支持搜索、选择程序与批量粘贴。若通过高级鼠标规则启动，还应检查该规则自身及引导键的适用范围。
 
-旧客户端可能忽略并在保存、同步时丢失此设置，请先升级所有编辑设备，见 [回退注意](/important-notice#2211-触发设置的多设备与回退风险)。
+旧客户端可能忽略并在保存、同步时丢失此设置，请先升级所有编辑设备，见 [回退注意](/v2/migration/upgrade-and-rollback#2211-触发设置的多设备与回退风险)。
 
 ## 限制与排障
 
diff --git a/docs/v2/features/triggers/left-button-plus.md b/docs/v2/features/triggers/left-button-plus.md
index f102c34..55585c5 100644
--- a/docs/v2/features/triggers/left-button-plus.md
+++ b/docs/v2/features/triggers/left-button-plus.md
@@ -47,7 +47,7 @@ comments: true
 功能设置可分别保存白名单和黑名单。白名单非空时只允许其中的程序；白名单为空时使用黑名单；两者都为空时适用所有程序。名单支持搜索、选择运行中程序、选窗口和批量粘贴，不需要先创建程序场景。
 
 :::warning[多设备与回退]
-旧客户端不支持新增的多键、短长按模式和白名单，保存并同步设置可能丢失这些字段。请先备份，并升级所有维护这些规则的设备；回退后避免修改、同步相关设置。丢失后需要从备份恢复或重新配置。详见 [体验前必读](/important-notice#2211-触发设置的多设备与回退风险)。
+旧客户端不支持新增的多键、短长按模式和白名单，保存并同步设置可能丢失这些字段。请先备份，并升级所有维护这些规则的设备；回退后避免修改、同步相关设置。丢失后需要从备份恢复或重新配置。详见 [升级与回退](/v2/migration/upgrade-and-rollback#2211-触发设置的多设备与回退风险)。
 :::
 
 ## 按场景覆盖与禁用
diff --git a/docs/v2/features/triggers/mouse-gestures.md b/docs/v2/features/triggers/mouse-gestures.md
index 57248fb..3b81500 100644
--- a/docs/v2/features/triggers/mouse-gestures.md
+++ b/docs/v2/features/triggers/mouse-gestures.md
@@ -80,7 +80,7 @@ comments: true
 
 2.2.11 起，鼠标手势功能设置增加独立程序黑名单，可在指定程序中禁止内置入口触发，不必影响其它功能。名单编辑支持搜索、选择程序与批量粘贴。若通过高级鼠标规则启动，还应检查该规则自身及引导键的适用范围。
 
-旧客户端可能忽略并在保存、同步时丢失此设置，请先升级所有编辑设备，见 [回退注意](/important-notice#2211-触发设置的多设备与回退风险)。
+旧客户端可能忽略并在保存、同步时丢失此设置，请先升级所有编辑设备，见 [回退注意](/v2/migration/upgrade-and-rollback#2211-触发设置的多设备与回退风险)。
 
 ## 限制与排障
 
diff --git a/docs/v2/features/triggers/powerkeys.md b/docs/v2/features/triggers/powerkeys.md
index e407724..8575c66 100644
--- a/docs/v2/features/triggers/powerkeys.md
+++ b/docs/v2/features/triggers/powerkeys.md
@@ -34,7 +34,7 @@ comments: true
 
 名单支持搜索、选择运行中程序、选窗口和批量粘贴，不要求先建立程序场景。可以添加“未知进程（无法识别程序）”，但它表示所有无法识别的目标，不是某一个指定软件。
 
-范围限制也影响使用同一引导键的高级鼠标触发，其它引导键不受此项影响。旧客户端可能忽略并在保存、同步时丢失新版白名单；请先升级所有编辑设备，见 [回退注意](/important-notice#2211-触发设置的多设备与回退风险)。
+范围限制也影响使用同一引导键的高级鼠标触发，其它引导键不受此项影响。旧客户端可能忽略并在保存、同步时丢失新版白名单；请先升级所有编辑设备，见 [回退注意](/v2/migration/upgrade-and-rollback#2211-触发设置的多设备与回退风险)。
 
 ## 三种激活策略
 
diff --git a/docs/v2/features/triggers/text-commands.md b/docs/v2/features/triggers/text-commands.md
index 2aee0d1..a9134d8 100644
--- a/docs/v2/features/triggers/text-commands.md
+++ b/docs/v2/features/triggers/text-commands.md
@@ -59,7 +59,7 @@ comments: true
 
 2.2.11 起，文本指令功能设置可集中编辑程序白名单和黑名单。非空白名单优先；白名单为空则使用黑名单；两者为空则适用所有程序。支持搜索、选择运行中程序、选窗口与批量粘贴。
 
-这是整个文本指令功能的范围，和下文逐条规则的“生效进程”不同，两者都需要满足。旧客户端可能忽略并丢失新增名单字段，见 [多设备与回退提醒](/important-notice#2211-触发设置的多设备与回退风险)。
+这是整个文本指令功能的范围，和下文逐条规则的“生效进程”不同，两者都需要满足。旧客户端可能忽略并丢失新增名单字段，见 [多设备与回退提醒](/v2/migration/upgrade-and-rollback#2211-触发设置的多设备与回退风险)。
 
 ## 批量修改生效进程
 
diff --git a/docs/v2/getting-started.md b/docs/v2/getting-started.md
index 9ec6d22..da33acd 100644
--- a/docs/v2/getting-started.md
+++ b/docs/v2/getting-started.md
@@ -9,7 +9,7 @@ comments: true
 # 开始使用 Quicker V2
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [安装前准备](/important-notice)。
 :::
 
 Quicker 把一件重复的事做成一个**动作**。动作可以出现在面板里，也可以绑快捷键、场景或其它触发规则。组合动作则是用多个步骤按顺序完成这件事。
diff --git a/docs/v2/index.md b/docs/v2/index.md
index 4effa47..6976a0b 100644
--- a/docs/v2/index.md
+++ b/docs/v2/index.md
@@ -17,7 +17,7 @@ hide_table_of_contents: true
 
 <div className="docs-landing__notice">
 
-**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [使用限制与回退说明](/important-notice)，不建议替换无法中断的 1.x 关键环境。
+**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [安装前准备](/important-notice)，不建议替换无法中断的 1.x 关键环境。
 
 </div>
 
diff --git a/docs/v2/install/index.md b/docs/v2/install/index.md
index acf53b9..86fe908 100644
--- a/docs/v2/install/index.md
+++ b/docs/v2/install/index.md
@@ -10,7 +10,7 @@ comments: false
 # 安装与更新
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [安装前准备](/important-notice)。
 :::
 
 V2 安装包从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载。不要使用 `https://getquicker.net/Download`，那个页面目前提供的是 Quicker 1.x。
diff --git a/docs/v2/install/update.md b/docs/v2/install/update.md
index a384202..d97bda6 100644
--- a/docs/v2/install/update.md
+++ b/docs/v2/install/update.md
@@ -9,7 +9,7 @@ comments: true
 # 更新 Quicker V2
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。回退到更早版本前，先看 [体验前必读](/important-notice) 和 [官网版本记录](https://getquicker.net/v2/versions) 里该版本的注意项。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。回退到更早版本前，先看 [升级与回退](/v2/migration/upgrade-and-rollback) 和 [官网版本记录](https://getquicker.net/v2/versions) 里该版本的注意项。
 :::
 
 日常升级优先用软件内的更新窗口，不要去 `https://getquicker.net/Download` 找 1.x 安装包。需要手动下载某个 2.x 安装器时，用 [https://getquicker.net/V2](https://getquicker.net/V2) 或 [版本记录](https://getquicker.net/v2/versions)。
@@ -37,4 +37,4 @@ comments: true
 3. 看安全软件是否隔离了安装器或更新程序。
 4. 仍失败时，从 [版本记录](https://getquicker.net/v2/versions) 下载对应安装包手动安装；不要覆盖 1.x 数据目录。
 
-降级不是「点一下就回去」。从 2.1.0 降到 2.0.x 可能清掉新数据结构；从 2.1.17 降到 2.1.15 需要重填 AI API 密钥。见 [体验前必读](/important-notice)。
+降级不是「点一下就回去」。从 2.1.0 降到 2.0.x 可能清掉新数据结构；从 2.1.17 降到 2.1.15 需要重填 AI API 密钥。见 [升级与回退](/v2/migration/upgrade-and-rollback)。
diff --git a/docs/v2/install/windows.md b/docs/v2/install/windows.md
index 5815848..2cbbb24 100644
--- a/docs/v2/install/windows.md
+++ b/docs/v2/install/windows.md
@@ -9,7 +9,7 @@ comments: true
 # 安装 Quicker V2
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [安装前准备](/important-notice)。
 :::
 
 从官网 **V2 页面**下载安装包，在受支持的 64 位 Windows 上安装。V2 与 1.x 使用不同的运行平台和数据目录，不能当成同一个程序的换皮升级，也**不能同时安装**。
diff --git a/docs/v2/migration/from-v1.md b/docs/v2/migration/from-v1.md
index 5e88ead..4848b77 100644
--- a/docs/v2/migration/from-v1.md
+++ b/docs/v2/migration/from-v1.md
@@ -9,7 +9,7 @@ comments: true
 # 从 V1 迁移到 V2
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [安装前准备](/important-notice)。
 :::
 
 Quicker 2.0 尽量兼容 1.x 的动作和组合动作模块，但存储、编辑器、表达式和执行管道已经换代。两代**不能同时安装**（浏览器扩展会冲突）。迁移是一份可执行清单，不是「两套程序并行、只是别交叉改动作」。
@@ -98,8 +98,8 @@ Quicker 2.0 尽量兼容 1.x 的动作和组合动作模块，但存储、编辑
     },
     {
       href: '/important-notice',
-      label: '体验前必读',
-      description: 'Preview、专业版和降级风险',
+      label: '安装前准备',
+      description: '体验范围、安装环境与迁移准备',
     },
   ]}
 />
diff --git a/docs/v2/migration/index.md b/docs/v2/migration/index.md
index e126de2..ca6f435 100644
--- a/docs/v2/migration/index.md
+++ b/docs/v2/migration/index.md
@@ -1,6 +1,6 @@
 ---
 title: 迁移
-description: 从 Quicker 1.x 迁到 V2 的步骤，以及新面板里如何加载场景和动作页。
+description: 从 Quicker 1.x 迁到 V2 的步骤，以及升级、回退和多设备使用注意事项。
 slug: /v2/migration
 sidebar_position: 1
 quickerDocKey: v2/migration/index
@@ -10,7 +10,7 @@ comments: false
 # 迁移
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [安装前准备](/important-notice)。
 :::
 
 1.x 和 V2 **不能同时安装**。迁移是「备份 → 卸载 1.x → 安装 V2」，不是两套程序并行。
@@ -18,6 +18,7 @@ comments: false
 | 文档 | 内容 |
 | --- | --- |
 | [从 V1 迁移](./from-v1.md) | 可执行清单：同步备份、卸载、安装、验证、回退 |
+| [升级与回退](./upgrade-and-rollback.md) | 按功能查找版本兼容、降级与多设备同步注意项 |
 | [动作作者迁移指南](./action-authors.md) | 选择 V1/V2 支持范围、保留旧版修订和继续发布 V2 |
 | [加载场景与加载动作页](./new-main-win/load-action-page.md) | 新面板里如何切到指定场景、分组或旧动作页 |
 | [数据存储与同步变化](/v2/what's-new/data-and-sync.md) | 首次登录如何分叉数据，以及为什么不是双向镜像 |
diff --git a/docs/v2/migration/upgrade-and-rollback.md b/docs/v2/migration/upgrade-and-rollback.md
new file mode 100644
index 0000000..a68cbe9
--- /dev/null
+++ b/docs/v2/migration/upgrade-and-rollback.md
@@ -0,0 +1,138 @@
+---
+title: 升级与回退
+description: 按功能查找 Quicker V2 的版本兼容、降级风险和多设备同步注意事项。
+sidebar_position: 3
+quickerDocKey: v2/migration/upgrade-and-rollback
+comments: true
+toc_max_heading_level: 2
+---
+
+# 升级与回退
+
+准备降级、混用不同版本，或把动作分享给旧版用户时，按下方功能查找对应注意项。首次安装请先看 [安装前准备](/important-notice)。
+
+## 操作前确认
+
+1. **先备份。** 按相关条目备份数据或本机配置，再更换版本。
+2. **核对所有设备。** 新版设置在旧版保存或同步后，可能被清除；把会维护这些设置的设备一并升级。
+3. **确认动作的最低版本。** 新增步骤和操作类型可能无法在旧客户端运行，分享时请注明版本要求。
+
+回到 1.x 的安装步骤见 [从 V1 迁移](/v2/migration/from-v1)；各版本原始说明见 [官网版本记录](https://getquicker.net/v2/versions)。
+
+## 数据与多设备
+
+### 2.1.0 · 数据结构 {/* #从-210-降级会清掉-20x-没有的数据2026-07-28 */}
+
+2.1.0 相对 2.0.x 增加了大量功能和对应的底层存储。2.0.x 里没有这些数据结构。如果在 2.1.0 里用过新功能并保存了新配置，再降回 2.0.x，这些数据可能被覆盖清除。
+
+### 2.1.29 · 侧边栏按钮 {/* #2129-侧边栏快捷按钮的回退注意 */}
+
+2.1.29 起可配置新版主窗口侧边栏快捷按钮。配置后若再用 2.1.28 或更早版本修改并同步动作面板偏好，旧客户端可能清除快捷按钮配置，恢复为仅默认「截图 Pro」。多设备使用同一账号时，建议先升级所有设备；回退旧版后也避免修改该项。
+
+### 2.2.11 · 触发规则 {/* #2211-触发设置的多设备与回退风险 */}
+
+新增的功能级黑白名单、左键辅助多键及短长按模式不受旧客户端支持。旧客户端可能按旧的适用范围触发；再次保存并同步设置，还可能清除新增字段，影响同账号其它设备。
+
+请先备份配置，并把所有编辑这些设置的设备升级到 2.2.11 或更高版本。必须回退时，避免在旧版修改和同步这些设置。已经丢失的字段需要从备份恢复或重新配置。
+
+触碰屏幕边框规则请在新版维护，降级前停用或移除。
+
+“指定类型”变量不能生成 V1 分享制品，旧版 V2 也不能保证按指定类型正常执行；不要把含此类变量的动作交给旧客户端运行。
+
+### 2.2.12 / 2.2.13 · 场景与布局 {/* #2212-规则父场景与-2213-面板自由布局 */}
+
+2.2.13 起，新面板可保存动作的格子坐标、空位和分组高度。这些数据会随账号同步，但 2.2.12 及更旧客户端不识别新字段。如果回退后又在旧版编辑或同步同一场景，可能清除自由布局；再次升级后需重新摆放。
+
+规则父场景的归属也从 2.2.12 开始保存。旧版客户端不会应用这层共享规则或它的面板动作。
+
+多设备使用同一账号时，规则父场景需要所有设备至少升级到 2.2.12；要编辑自由格子布局，则建议全部升级到 2.2.13 或更高版本。必须回退时，不要在旧版修改或同步这些场景。
+
+### 2.2.17 · 浏览器归属 {/* #2217-浏览器父场景归属的多设备与回退 */}
+
+2.2.17 起，自定义程序的浏览器归属统一纳入父场景管理，并随账号同步。将自定义程序添加到浏览器父场景下后，需要重新设置一次归属。
+
+使用浏览器父场景归属前，请将同一账号的所有设备升级到 2.2.17 或更高版本。回退到旧版本或新旧客户端混用时，包含浏览器归属的整份父场景归属配置会暂时失效并变为只读；数据不会因此删除，全部设备重新升级后可恢复。
+
+### 2.2.26 · 轮盘 F2 开关 {/* #2226-轮盘-f2-编辑指向的动作 */}
+
+2.2.26 起，轮盘显示时可按 `F2` 编辑鼠标指向的动作。该选项**默认开启**，可在轮盘设置中关闭。已有 F2 子动作，以及 F2 重复触发相关设置优先于本开关。
+
+回退到旧版后，若再保存或同步轮盘设置，可能丢弃此开关；再次升级会恢复为默认开启。建议各设备升级后再调整，必要时在升级后重新关闭。操作说明见 [轮盘菜单](/v2/features/triggers/circle-menu#按-f2-编辑指向的动作)。
+
+## 截图与悬浮布局
+
+### 2.2.5 · 保存日期 {/* #回退到-224-后保存截图设置会清除-225-的保存日期格式2026-09-04 */}
+
+2.2.5 起截图保存设置增加了日期格式选项。若回退到 2.2.4 后又保存截图设置，旧客户端会清除新版的保存日期格式选择；再次升级后需重新选择。此设置只保存在本机，不影响已经保存的图片，也不影响云端数据。
+
+### 2.2.7 · 阴影与边框 {/* #回退到-226-后保存截图设置会丢弃-227-的阴影与边框配置2026-09-07 */}
+
+2.2.7 起截图 Pro 可为选区添加阴影和边框。若回退到 2.2.6 后又保存截图工具设置，旧客户端会丢弃新版阴影 / 边框配置；再次升级后需重新设置。截图文件本身不受影响。需要保留配置时，请先备份本机 `ScreenCapture/settings/image-drawing-tool-state.json`。
+
+### 2.2.14 · 文件名与悬浮分组 {/* #2214-截图文件名模板与悬浮分组动作 */}
+
+2.2.14 起，截图保存的独立日期格式选项已并入文件名模板，支持 `{date:格式}`（.NET DateTime）。编辑时会把旧日期格式转换并保留效果。若回退到更旧版本，需将模板中的 `{date:格式}` 改回 `{date}`、`{time}` 等旧语法，才能正常使用文件名模板。
+
+「悬浮分组」动作（按名称打开、关闭或切换）需要 2.2.14 或更高版本客户端；旧版无法识别此动作类型。创建前建议升级所有同步设备；必须回退时，请先备份悬浮布局，并避免在旧版编辑或同步依赖该动作的内容。
+
+## 账号与 AI
+
+### 2.1.17 · AI 密钥 {/* #回退到-2117-之前可能要重填-api-密钥 */}
+
+2.1.17 起，AI 设置可以同步（API Key 仍只在本机加密保存）。官网版本记录写明：若回退到 2.1.15，请在旧版中重新填写 AI API 密钥；新版保存后的凭据格式，旧版不能正确读取。使用新 AI 模块的动作也无法在 2.1.15 及更旧版本运行。
+
+更早的回退也有类似情况，例如回退到 2.1.12 可能清除图片翻译凭证。逐版本注意以 [官网版本记录](https://getquicker.net/v2/versions) 为准。
+
+### 2.2.18 · 远程账号与工作区 {/* #2218-远程文件账号与-ai-助手工作区 */}
+
+2.2.18 起，组合动作可通过远程文件步骤访问 WebDAV 网盘或 NAS。远程文件账号在 **设置 → 软件连接 → 远程文件账号** 中配置，只保存在本机；它不会随账号云同步、状态备份或动作导出迁移。换电脑、重装或分享动作给别人时，需要在目标电脑重新配置相同的账号引用名。旧版客户端不能运行包含远程文件步骤的动作，升级前不要把这类动作交给仍停留在旧版的设备执行。
+
+AI 助手正式版支持选择本地工作区。选择本地文件夹后，AI 对普通文件的修改会直接保存到该文件夹；请先确认目录、备份和版本管理方式。打开历史对话时会恢复对应目录，但切换工作区会开启新对话，不会把原对话、未提交草稿或上下文迁移过去。
+
+如果回退到不支持自选工作区的旧正式版，已经选择工作区的项目对话不能继续按原目录工作。请升级到支持该功能的版本后，再继续对应项目对话。
+
+### 2.2.19 · S3 与账号导出 {/* #2219-s3-账号与凭据导出 */}
+
+2.2.19 起，保存 S3 账号会升级本机的远程文件账号配置。旧版会拒绝修改整份账号列表（包括其中的 WebDAV 账号），以避免丢失 S3 字段和密钥引用。数据不会因打开旧版而删除，但删除全部 S3 账号也不会自动降回旧格式。回退前先在新版导出必要账号，详见[远程文件](/v2/features/remote-files#回退旧版)。
+
+远程文件账号的导出 JSON 包含明文密码或密钥。不要上传到公开网盘、聊天群、动作分享或源码仓库；传输完成后及时删除，外泄后立即在服务端轮换凭据。
+
+### 2.2.21 · 代码补全 {/* #2221-代码补全服务 */}
+
+2.2.21 起，组合动作与表达式等编辑器的代码补全默认走在线服务，以减小安装包并节约本机内存。需要离线或不希望上传代码时，可在 **设置 → 动作设计 → 代码补全服务** 中单独安装本地补全组件，并勾选 **使用本地补全服务** 后保存。该选项默认关闭。
+
+使用在线补全时，Quicker 会向服务器发送正在编辑的代码、变量类型和默认 using。本地模式下，组件不可用时不会自动改用在线服务。操作入口见 [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)。
+
+## 动作与日常操作
+
+### 2.2.20 · 显示器与虚拟桌面 {/* #2220-显示器与虚拟桌面步骤 */}
+
+2.2.20 起新增的显示器、虚拟桌面步骤需要新版客户端。含这些步骤的动作在旧版客户端中可能无法识别或运行；多设备同步或分享给他人前，请确认目标设备已升级到 2.2.20 或更高版本。
+
+### 2.2.22 · 列表、提示与标注 {/* #2222-列表项自定义子程序与提示消息默认设置 */}
+
+2.2.22 起，「管理和排序列表」可通过高级参数指定 **添加项子程序**、**编辑项子程序**，用多字段表单等方式处理复杂列表项。依赖这些子程序的动作需要 **2.2.22 或更高版本**客户端；分享给他人时请注明最低版本要求。旧版没有对应回调，不能当作退回内置编辑器的等价行为。操作说明见 [管理和排序列表](/v2/xaction/modules/managelist#用子程序自定义添加和编辑)。
+
+同版起，可在 **设置 → 模块功能选项** 配置提示消息的默认显示位置和停留时间，并随账号同步。旧客户端不认识这两项设置；若在旧版保存设置并同步，可能把它们重置。建议先记下所选值，把所有会改设置的设备升级后再修改；若已被重置，可在新版重新设置。步骤或脚本里单独指定的位置、时长仍优先于全局默认。详见 [提示消息](/v2/xaction/modules/notify#默认位置与停留时间)。
+
+同版起，截图、贴图和录屏标注中 `Ctrl+Shift+Z` 改为 **重做**（不再清空全部标注）；清空全部标注请用 `Shift+Delete`。首次按旧习惯的 `Ctrl+Shift+Z` 时，客户端会提示一次并执行重做。
+
+旧「底部居中」步骤选项现在跟随全局默认位置；需要固定时，请重新选择本版的「底部居中」。
+
+新导出的 Agent `.jsonl` 对话文件请用本版或更新版本导入；仍兼容旧版完整会话 JSON，已有对话无需迁移。导入的对话仅供查看，不能继续发送消息。见[AI 与 Agent](/v2/features/ai-and-agent)。
+
+### 2.2.23 · 分享分类 {/* #2223-分享适用软件与浏览器通用 */}
+
+2.2.23 起，分享动作可选择 **浏览器通用** 作为适用软件，使同一动作出现在 Chrome、Edge、Firefox 等支持的浏览器动作页中。从浏览器通用场景分享时默认选此分类。
+
+更新已有分享时，若原「适用软件」保存的是非法值，需要重新选择有效分类，不再自动改为「通用」。已有 Chrome 等具体程序分类**不会**自动改成「浏览器通用」；需要跨浏览器展示时请手动改选。操作说明见 [分享动作与公共子程序](/v2/features/action-sharing#适用软件与浏览器通用)。
+
+### 2.2.24 · 获取编辑中的动作 {/* #2224-获取最后打开编辑器的动作 */}
+
+2.2.24 起，「Quicker操作」新增 **获取最后打开编辑器的动作**，可取得本次启动期间最近打开或重新激活编辑器的已安装动作 ID。含此操作类型的动作需要 **2.2.24 或更高版本**客户端；旧版无法识别该类型。多设备同步或分享给他人前，请确认目标设备已升级。说明见 [Quicker操作](/v2/xaction/modules/quickeroperations#获取最后打开编辑器的动作)。
+
+### 2.2.25 · 设置与界面状态 {/* #2225-设置窗口改版与本机界面状态 */}
+
+2.2.25 起，设置窗口改为树形导航，支持搜索并跳转到具体设置项。分类与入口有调整；找不到原位置时，优先用设置内搜索。已改版的设置页逐项自动保存，不再提供整页「应用／撤销」；无效或尚未提交的输入会在离开当前页时提示。
+
+回退到 **2.2.24** 后，旧版保存本机状态可能清除新版 AI 助手侧栏宽度、开关和设置导航展开记录；这些界面偏好可重新设置，不影响动作内容。需要保留时，请先备份本机 `data/app-state.json`。
diff --git a/docs/v2/troubleshooting.md b/docs/v2/troubleshooting.md
index 0fd99be..a6ded93 100644
--- a/docs/v2/troubleshooting.md
+++ b/docs/v2/troubleshooting.md
@@ -9,7 +9,7 @@ comments: true
 # 常见问题
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [安装前准备](/important-notice)。
 :::
 
 先对照现象看下面几条。组合动作的参数和限制以各 [模块页](/v2/xaction/modules) 为准。
@@ -18,7 +18,7 @@ comments: true
 
 **装不上或打不开**：V2 只提供 x64，并且只能跑在 [.NET 10 支持的 Windows](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md) 上。1.x 能用，不代表这台电脑能跑 V2。安装包只从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要用 `/Download` 上的 1.x。见 [安装](/v2/install/windows.md) 和 [运行平台](/v2/what's-new/platform-and-compatibility.md)。
 
-**免费账号登不进去**：免费版数据迁移仍在开发，目前只有专业版能登录 2.0。见 [体验前必读](/important-notice)。
+**免费账号登不进去**：免费版数据迁移仍在开发，目前只有专业版能登录 2.0。见 [安装前准备](/important-notice)。
 
 **1.x 的数据去哪了**：V2 使用按账号隔离的新存储，不会把旧的 `quicker.db` 当作日常库继续写入。两代不能同时安装。迁移步骤见 [从 V1 迁移](/v2/migration/from-v1.md)。
 
diff --git a/docs/v2/what's-new/index.md b/docs/v2/what's-new/index.md
index 4b115e2..e7cc41d 100644
--- a/docs/v2/what's-new/index.md
+++ b/docs/v2/what's-new/index.md
@@ -9,7 +9,7 @@ comments: true
 # Quicker V2 重要变化
 
 :::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [安装前准备](/important-notice)。
 :::
 
 Quicker V2 不只是更换界面。它升级了运行平台，并重做了动作、面板、场景管理、本地存储和云同步等基础结构。
diff --git a/docs/v2/xaction/concepts/xaction-editor.md b/docs/v2/xaction/concepts/xaction-editor.md
index 7ccaeb1..2ba6da8 100644
--- a/docs/v2/xaction/concepts/xaction-editor.md
+++ b/docs/v2/xaction/concepts/xaction-editor.md
@@ -494,7 +494,7 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
 - 在线模式下，补全会向服务器发送正在编辑的代码、变量类型和默认 using。
 - 本地模式下，组件不可用时 **不会** 自动改回在线服务。
 
-隐私与风险说明见 [体验前必读](/important-notice#2221-代码补全服务)。表达式侧的补全交互仍见 [表达式高级话题](/v2/xaction/concepts/expression-adv#补全与验证)。
+隐私与风险说明见 [升级与回退](/v2/migration/upgrade-and-rollback#2221-代码补全服务)。表达式侧的补全交互仍见 [表达式高级话题](/v2/xaction/concepts/expression-adv#补全与验证)。
 
 ## 限制与排障
 
@@ -538,8 +538,8 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
       description: '运行钮、选中步骤和日志',
     },
     {
-      href: '/important-notice#2221-代码补全服务',
-      label: '体验前必读：代码补全',
+      href: '/v2/migration/upgrade-and-rollback#2221-代码补全服务',
+      label: '代码补全的隐私与兼容',
       description: '在线补全会发送代码；本地默认关闭',
     },
   ]}
diff --git a/docs/v2/xaction/modules/basic/notify.md b/docs/v2/xaction/modules/basic/notify.md
index 5c76ded..5d9e306 100644
--- a/docs/v2/xaction/modules/basic/notify.md
+++ b/docs/v2/xaction/modules/basic/notify.md
@@ -83,7 +83,7 @@ legacyContentUpdatedAt: "2022-07-01T09:39:34.000Z"
 
 升级前保存的旧「底部居中」选项在本版对应「默认位置（使用全局设置）」。没有改动全局位置时，外观仍为底部居中；需要始终固定在底部时，请重新选择本版的「底部居中」。
 
-回退旧客户端后，保存设置并同步可能重置新增的默认位置和时长；建议先记录所选值，并在所有设备升级后再修改。详见[升级注意](/important-notice#2222-列表项自定义子程序与提示消息默认设置)。
+回退旧客户端后，保存设置并同步可能重置新增的默认位置和时长；建议先记录所选值，并在所有设备升级后再修改。详见[升级注意](/v2/migration/upgrade-and-rollback#2222-列表项自定义子程序与提示消息默认设置)。
 
 ### 点击操作
 
diff --git a/src/components/LegacyNoticeRedirect/index.tsx b/src/components/LegacyNoticeRedirect/index.tsx
new file mode 100644
index 0000000..4afe510
--- /dev/null
+++ b/src/components/LegacyNoticeRedirect/index.tsx
@@ -0,0 +1,28 @@
+import {useEffect, useRef} from 'react';
+import {useHistory, useLocation} from '@docusaurus/router';
+
+/** Keep version links shared before the installation page was shortened. */
+export default function LegacyNoticeRedirect({hashes}: {hashes: readonly string[]}) {
+  const {pathname, hash} = useLocation();
+  const history = useHistory();
+  const redirectedId = useRef<string | null>(null);
+
+  useEffect(() => {
+    if (pathname.replace(/\/$/, '') !== '/important-notice') {
+      return;
+    }
+    let id: string;
+    try {
+      id = decodeURIComponent(hash.slice(1));
+    } catch {
+      return;
+    }
+    if (hashes.includes(id) && redirectedId.current !== id) {
+      // A lazy route may keep this page mounted during the transition.
+      redirectedId.current = id;
+      history.replace(`/v2/migration/upgrade-and-rollback#${encodeURIComponent(id)}`);
+    }
+  }, [pathname, hash, hashes, history]);
+
+  return null;
+}
diff --git a/src/css/custom.css b/src/css/custom.css
index e956e72..5016a02 100644
--- a/src/css/custom.css
+++ b/src/css/custom.css
@@ -653,7 +653,11 @@ html[data-theme='dark'] .theme-code-block .token.parameter {
   color: var(--quicker-text-muted);
   font-size: 0.8rem;
 }
-.theme-doc-markdown h1 { font-size: 1.9rem; }
+/* Docusaurus sets larger heading sizes inside .markdown; use article sizes here. */
+.theme-doc-markdown h1 { font-size: 1.7rem; }
+.theme-doc-markdown h2 { font-size: 1.28rem; }
+.theme-doc-markdown h3 { font-size: 1.1rem; }
+.theme-doc-markdown h4 { font-size: 1rem; }
 .docs-landing { padding: 0.5rem 0 0.75rem; }
 .markdown .docs-landing > h1 {
   font-size: clamp(1.9rem, 3vw, 2.35rem);