QuickerOrg · ceastld · Aug 16, 2026 · Aug 16, 2026 · Aug 16, 2026 · Aug 16, 2026
diff --git a/docs/contributing.md b/docs/contributing.md
@@ -2,6 +2,7 @@
 title: 文档编写约定
 description: Quicker 文档站的 Markdown 编写和维护约定。
 sidebar_position: 50
+unlisted: true
 quickerDocKey: docs/contributing
 comments: false
 ---

diff --git a/docs/important-notice.md b/docs/important-notice.md
@@ -1,14 +1,61 @@
 ---
-title: 重要提示
-description: 有关数据完整性的重要提示信息
-sidebar_position: 10
+title: 体验前必读
+description: 安装或体验 Quicker V2 前需要知道的 Preview 范围、专业版限制、共存与降级风险。
+sidebar_position: 2
 quickerDocKey: important-notice
 comments: true
 ---
-# 重要提示
 
-## 从 2.1.0 降低到更低版本的风险提示（2026年7月28日版本）
+# 体验前必读
 
-2.1.0 相对于 2.0.x 增加了大量功能，以及对应的底层数据存储。
+官网 [Quicker 2.0](https://getquicker.net/V2) 当前标注为 **PREVIEW · 仅面向专业版用户**。下面几条会直接影响你能不能装、装完能不能登录、以及出问题后能不能退回 1.x。
 
-但是2.0.x里没有这些数据结构，因此，如果在2.1.0里使用了新增功能，且保存了新的配置数据，在2.0.x里，可能会被覆盖清除。
+## 当前是 Preview，只给专业版
+
+V2 仍在快速迭代，部分功能未完成，已有动作也可能需要调整。现阶段只建议专业版用户尝鲜和反馈，不适合当作已经稳定的正式版。
+
+## 免费版暂时不能登录
+
+免费版的数据迁移仍在开发。免费账号目前无法登录 2.0，不要按「装上就能接着用原来的免费数据」来规划。
+
+## 不要替换关键的 1.x 环境
+
+当前版本适合试用和反馈。如果这台电脑上的 1.x 承担着不能中断的日常工作，请另找一台机器或另开一个可回退的环境体验，不要直接替换那套关键安装。
+
+## 两代不能同时安装
+
+浏览器扩展会冲突，**不要同时安装 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) 为准。
+
+## 相关链接
+
+<RelatedDocs
+  items={[
+    {
+      href: '/v2/install/windows',
+      label: '安装 V2',
+      description: '从 /V2 下载，不要用 /Download',
+    },
+    {
+      href: '/v2/migration/from-v1',
+      label: '从 V1 迁移',
+      description: '先备份，再卸载 1.x',
+    },
+    {
+      href: 'https://getquicker.net/v2/versions',
+      label: '官网版本记录',
+      description: '各版本新增、修复与注意',
+    },
+  ]}
+/>
diff --git a/docs/index.md b/docs/index.md
@@ -10,6 +10,10 @@ comments: false
 
 # Quicker 文档
 
+:::caution[Preview · 仅专业版]
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](./important-notice.md)。
+:::
+
 Quicker 是 Windows 上的效率工具：把重复操作做成**动作**，用面板、快捷键或触发规则随时运行。
 
 V2 把动作内容和它出现的位置分开，组合动作用模块拼步骤，参数、变量和调试都按当前程序定义来写。
@@ -18,13 +22,15 @@ V2 把动作内容和它出现的位置分开，组合动作用模块拼步骤
 
 | 你想… | 去这篇 |
 | --- | --- |
+| 体验前先看限制 | [体验前必读](./important-notice.md) |
 | 第一次打开 Quicker | [开始使用](./v2/getting-started.md) |
 | 安装或确认系统要求 | [安装 Quicker V2](./v2/install/windows.md) |
 | 自己写一个动作 | [怎样学会组合动作](./v2/xaction/guides/how-to-learn.md) |
 | 从 1.x 升级 | [从 V1 迁移](./v2/migration/from-v1.md) |
 | 截图、标注、贴图 | [截图 Pro](./v2/features/screenshot/capture-pro.md) |
 | 面板、场景、分组 | [新面板窗口](./v2/what's-new/new-main-win/usage.md) |
 | 查某个步骤的参数 | [组合动作模块参考](./v2/xaction/modules) |
+| 现在能用哪些 AI | [AI 与 Agent 现状](./v2/features/ai-and-agent.md) |
 | 运行出问题 | [常见问题](./v2/troubleshooting.md) |
 
 ## 组合动作三条动手课
@@ -55,7 +61,7 @@ V2 把动作内容和它出现的位置分开，组合动作用模块拼步骤
     {
       href: '/release-notes',
       label: '更新记录',
-      description: '各版本新增与修复',
+      description: '官网各版本说明入口',
     },
   ]}
 />
diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md
@@ -1,17 +1,19 @@
 ---
 title: 更新记录
-description: Quicker V2 的版本更新记录。
+description: Quicker V2 各版本说明在官网，本页是文档站入口。
 sidebar_position: 1
 quickerDocKey: v2/release-notes
 comments: true
 ---
 
 # 更新记录
 
-这里记录 Quicker V2 对用户可见的重要变化。
+逐版本的新增、修复、校验值和注意事项写在官网，不在本站逐条转载：
 
-## 编写建议
+**[https://getquicker.net/v2/versions](https://getquicker.net/v2/versions)**
 
-- 优先写用户可感知变化
-- 明确试用版风险和兼容性提示
-- 避免只贴内部技术 diff
+请以官网记录为准（至少已更新到 2.1.18）。安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。
+
+本站补充的是安装、迁移、功能说明和相对 1.x 的结构变化，例如 [V2 重要变化](/v2/what's-new/)。文档会随版本抽查修订，但不会在每次发版时完整复述官网 changelog。
+
+体验、降级和回退风险见 [体验前必读](/important-notice)。
diff --git a/docs/v2/_category_.json b/docs/v2/_category_.json
@@ -2,6 +2,7 @@
   "label": "Quicker V2",
   "position": 30,
   "link": {
-    "type": "generated-index"
+    "type": "doc",
+    "id": "v2/index"
   }
 }
diff --git a/docs/v2/features/account-and-sync.md b/docs/v2/features/account-and-sync.md
@@ -1,17 +1,28 @@
 ---
 title: 账号、登录与数据同步
-description: Quicker V2 的账号登录、多账号切换、数据同步与离线使用。
+description: Quicker V2 的账号隔离、首次登录分叉、同步范围和离线使用。
 sidebar_position: 40
 quickerDocKey: v2/features/account-and-sync
 comments: true
 ---
+
 # 账号、登录与数据同步
 
-本文用于说明 Quicker V2 的账号、数据同步和离线使用。
+:::caution[Preview · 仅专业版]
+免费版数据迁移仍在开发，免费账号目前无法登录 2.0。完整限制见 [体验前必读](/important-notice)。
+:::
+
+V2 为每个账号建立独立的本地数据目录。业务数据、本机状态、缓存和日志分开；切换账号时不再共用同一份账号业务库。
+
+## 登录之后会发生什么
+
+- 建议登录专业版账号，便于同步；也可以先用本机离线账号（离线账号固定使用新面板）。
+- 从 1.x 过来时，**首次登录会分叉数据**：迁入当前账号的一份 V2 数据，之后与 1.x 不再双向镜像。
+- 同步以独立数据项为单位（动作、动作页、场景配置、文本指令、公共子程序等可以分别更新）。
+- 发生冲突时，不应假定一端会静默覆盖另一端。「用服务端数据重建」会以服务器数据重做本机账号库，不会自动合并尚未上传的本地修改。
+
+## 完整说明
 
-## 待补充内容
+机制、目录边界、迁移时序和回退注意见 [数据存储与同步变化](/v2/what's-new/data-and-sync.md)。从 1.x 迁过来的操作顺序见 [从 V1 迁移](/v2/migration/from-v1.md)。
 
-* 登录与账号状态
-* 多账号选择与切换
-* 数据同步的范围和时机
-* 离线使用的限制
+API Key 等本机凭据不会随普通设置 JSON 一起复制到另一台电脑，换设备后需要重填。见 [统一 AI 服务与模型设置](/v2/what's-new/ai-services-and-models.md)。
diff --git a/docs/v2/features/ai-and-agent.md b/docs/v2/features/ai-and-agent.md
@@ -0,0 +1,31 @@
+---
+title: AI 与 Agent 现状
+description: Quicker V2 当前对普通用户开放的 AI 能力，以及尚未普遍开放的 Agent 范围。
+sidebar_position: 55
+quickerDocKey: v2/features/ai-and-agent
+comments: true
+---
+
+# AI 与 Agent 现状
+
+这页只说明**现在普通用户能用什么**。不是 Agent、浏览器控制或桌面操控的教程。
+
+## 现在可以用
+
+- **统一 AI 设置**：设置里的「AI 服务」和「用途与模型」，用来管理连接、模型和用途优选。说明见 [统一 AI 服务与模型设置](/v2/what's-new/ai-services-and-models.md)。
+- **五个组合动作模块**，共用上面的全局设置，不必在每个步骤里重填地址和 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 只在本机加密保存，不随动作分享，也不随普通设置文件拷到另一台电脑。
+
+## 还没有对普通用户普遍开放
+
+- **Agent**、**隔离的浏览器控制**、**桌面 / Computer Use** 仍处于门控或开发中。
+- 设置里看到「Agent 与工具调用」这种**模型用途**，只表示可以给这类用途选模型，**不等于**这些界面已经对普通用户开放。
+- 不要把 1.x 的手机遥控或 Android 局域网遥控当成 V2 已有能力。V2 已移除手机 App 遥控器，目前也没有承诺替代方案。见 [不再支持的功能](/v2/what's-new/not-supported.md)。
+
+具体功能是否已经改用统一候选模型，以该功能自己的页面和软件界面为准。
diff --git a/docs/v2/features/scenes.md b/docs/v2/features/scenes.md
@@ -1,18 +1,29 @@
 ---
 title: 场景与分组
-description: Quicker V2 中场景的配置、切换与动作分组。
+description: 在新面板里按「场景 → 分组 → 动作」组织入口，以及场景如何和触发规则共用。
 sidebar_position: 30
 quickerDocKey: v2/features/scenes
 comments: true
 ---
 
 # 场景与分组
 
-本文用于说明 Quicker V2 中场景配置和动作分组的使用。
+V2 的面板按 **场景 → 分组 → 动作** 组织。场景回答「当前在哪个上下文」，分组用来替代 1.x 里「同一程序下的多张动作页」。
 
-## 待补充内容
+## 日常怎么用
 
-- 场景的概念和切换方式
-- 按程序自动切换场景
-- 场景内的动作分组
-- 动作移动到其它场景
+- **全局区**：不依赖当前程序、希望随时能用的动作。
+- **上下文区**：随前台程序或网址变化；末尾的 **通用** 适合所有程序都要用的动作。
+- 单击场景标签切换；双击打开「场景与动作管理」；右键可新建、导入或从旧动作页引入动作。
+- 开启「显示分组」后，组在同一列表里连续显示，右侧导航可跳转。
+- 动作本体和入口是分开的：从场景移除只去掉当前位置，删除才会去掉本体。
+
+完整操作（启用新面板、置顶、拖动、批量移动、锁定上下文）见 [新面板窗口的使用](/v2/what's-new/new-main-win/usage.md)。
+
+## 场景和触发是同一套上下文
+
+快捷键、轮盘、手势、文本指令等规则也按场景生效。更具体的场景可以覆盖或禁用上级规则。统一编辑入口在 **场景与动作管理**。
+
+相对 1.x 的管理方式和诊断见 [场景与触发方式](/v2/what's-new/scenes-and-triggers.md)。各入口怎么选见 [快速触发概览](./triggers/index.md)。
+
+需要用动作切到某个场景、分组或旧动作页时，见 [加载场景与加载动作页](/v2/migration/new-main-win/load-action-page.md)。
diff --git a/docs/v2/features/tools.md b/docs/v2/features/tools.md
@@ -1,14 +1,14 @@
 ---
 title: 内置工具
-description: Quicker V2 内置的截图、AI 等工具入口。
+description: Quicker V2 已有说明的截图、AI、搜索、选中文本和更新入口。
 sidebar_position: 50
 quickerDocKey: v2/features/tools
 comments: true
 ---
 
 # 内置工具
 
-Quicker V2 内置了一批可直接使用或在动作中调用的工具。截图相关能力已单独成章，其它工具说明会陆续补充。
+下面只列出本站已经写清的工具入口，不暗示还有一份未完成的「全部内置工具」清单。
 
 ## 截图与贴图
 
@@ -17,10 +17,13 @@ Quicker V2 内置了一批可直接使用或在动作中调用的工具。截图
 - [图片翻译](./screenshot/image-translate.md)：截图 / 贴图图到图翻译与百度 / 有道 API 配置
 - [JS 自定义工具栏](./screenshot/toolbar-script.md)：用脚本定制工具栏，并调用子程序或启动动作
 
-## AI 设置
+## AI
 
-- [统一 AI 服务与模型设置](../what's-new/ai-services-and-models.md)：配置服务连接、模型能力、用途优选和本机凭据
+- [统一 AI 服务与模型设置](/v2/what's-new/ai-services-and-models.md)：服务连接、模型能力和用途优选
+- [AI 与 Agent 现状](./ai-and-agent.md)：普通用户现在能用什么，以及 Agent / 计算机控制尚未普遍开放
 
-## 待补充
+## 搜索、选中文本与更新
 
-- 其它内置小工具
+- 面板内筛选和跨场景搜索：见 [工具与使用体验](/v2/what's-new/tools-and-experience.md)
+- [选中文本工具条](./triggers/text-selection-toolbar.md)
+- [更新 Quicker V2](/v2/install/update.md)：应用内下载、校验和静默安装
diff --git a/docs/v2/features/triggers/index.md b/docs/v2/features/triggers/index.md
@@ -40,18 +40,18 @@ flowchart LR
 | --- | --- | --- |
 | 鼠标手势 | 按住键并移动画出轨迹，匹配后执行动作 | [使用说明](./mouse-gestures.md) |
 | 选中文本工具条 | 划词后在指针附近显示候选操作 | [使用说明](./text-selection-toolbar.md) |
-| 动作快捷键 | 全局或按场景绑定组合键到动作 | [2.x 变化](/v2/what's-new/others/action-hotkeys)（使用说明即将补充） |
-| 扩展热键 | 引导键 + 第二键，适合字母键扩展 | [2.x 变化](/v2/what's-new/others/powerkeys)（使用说明即将补充） |
-| 热键联动 | 监听一段或两段快捷键再执行 | [2.x 变化](/v2/what's-new/others/hotkey-watchers)（使用说明即将补充） |
-| 文本指令 | 输入缩写或正则匹配后执行 | [2.x 变化](/v2/what's-new/others/text-commands)（使用说明即将补充） |
-| 按键双击 | 双击某键触发 | [2.x 变化](/v2/what's-new/others/key-double-click)（使用说明即将补充） |
-| 左键辅助 | 按住左键再配合其它键或滚轮 | [2.x 变化](/v2/what's-new/others/left-button-plus)（使用说明即将补充） |
-| 轮盘菜单 | 在指针周围用方向选动作 | [2.x 变化](/v2/what's-new/others/circle-menu)（使用说明即将补充） |
-| 高级鼠标触发 | 短按、长按、划动、角落、边界摩擦等 | [2.x 变化](/v2/what's-new/others/advanced-mouse-triggers)（使用说明即将补充） |
+| 动作快捷键 | 全局或按场景绑定组合键到动作 | [使用说明](/v2/what's-new/others/action-hotkeys) |
+| 扩展热键 | 引导键 + 第二键，适合字母键扩展 | [使用说明](/v2/what's-new/others/powerkeys) |
+| 热键联动 | 监听一段或两段快捷键再执行 | [2.x 变化](/v2/what's-new/others/hotkey-watchers) |
+| 文本指令 | 输入缩写或正则匹配后执行 | [使用说明](/v2/what's-new/others/text-commands) |
+| 按键双击 | 双击某键触发 | [2.x 变化](/v2/what's-new/others/key-double-click)（尚无独立使用说明） |
+| 左键辅助 | 按住左键再配合其它键或滚轮 | [2.x 变化](/v2/what's-new/others/left-button-plus)（尚无独立使用说明） |
+| 轮盘菜单 | 在指针周围用方向选动作 | [使用说明](/v2/what's-new/others/circle-menu) |
+| 高级鼠标触发 | 短按、长按、划动、角落、边界摩擦等 | [2.x 变化](/v2/what's-new/others/advanced-mouse-triggers)（尚无独立使用说明） |
 | 动作面板 | 弹出面板再点动作 | [开始使用](/v2/getting-started)、[新面板](/v2/what's-new/new-main-win/usage) |
 | 滚轮触发动作 | 在悬浮按钮等位置用滚轮连续调用 | [教程](/v2/xaction/guides/scroll-trigger) |
 
-「使用说明即将补充」的条目目前只有相对 1.x 的改进说明；配置路径仍以软件里 **场景与动作管理** 为准。
+快捷键、扩展热键、轮盘和文本指令已有相对完整的说明（含配置路径）。**按键双击、左键辅助、高级鼠标触发**目前只有相对 1.x 的变化说明，还没有单独的使用说明；配置仍以软件里 **场景与动作管理** 为准。
 
 ## 统一管理与排障
 

diff --git a/docs/v2/getting-started.md b/docs/v2/getting-started.md
@@ -8,6 +8,10 @@ comments: true
 
 # 开始使用 Quicker V2
 
+:::caution[Preview · 仅专业版]
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+:::
+
 Quicker 把一件重复的事做成一个**动作**。动作可以出现在面板里，也可以绑快捷键、场景或其它触发规则。组合动作则是用多个步骤按顺序完成这件事。
 
 ## 先记住三个词
@@ -33,7 +37,7 @@ Quicker 把一件重复的事做成一个**动作**。动作可以出现在面
 - **上下文区**：随前台程序或网址变化，例如在资源管理器里会看到对应场景。
 - 单击动作即可运行；在面板上直接键入名称或拼音可以筛选。
 
-从 1.x 过来的，先看 [从 V1 迁移](./migration/from-v1.md) 和 [V2 重要变化](/v2/what's-new/)。不要在 1.x 和 V2 里交叉改同一批动作。
+从 1.x 过来的，先看 [从 V1 迁移](./migration/from-v1.md) 和 [V2 重要变化](/v2/what's-new/)。两代**不能同时安装**（浏览器扩展会冲突）；回退只能重装 1.x。
 
 ## 自己写一个动作
 

diff --git a/docs/v2/index.md b/docs/v2/index.md
@@ -0,0 +1,53 @@
+---
+title: Quicker V2
+description: Quicker V2 文档入口：开始使用、安装、迁移、功能说明和重要变化。
+slug: /v2
+sidebar_position: 1
+quickerDocKey: v2/index
+comments: false
+---
+
+# Quicker V2
+
+:::caution[Preview · 仅专业版]
+当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
+:::
+
+V2 重做了数据存储、同步、动作模型和主面板。动作内容和它出现的位置分开，组合动作用模块拼步骤。
+
+| 你想… | 去这篇 |
+| --- | --- |
+| 第一次打开 | [开始使用](./getting-started.md) |
+| 下载安装 | [安装 Quicker V2](./install/windows.md) |
+| 从 1.x 过来 | [从 V1 迁移](./migration/from-v1.md) |
+| 相对 1.x 改了什么 | [V2 重要变化](./what's-new/index.md) |
+| 面板、触发、截图、账号 | [功能使用](/v2/features) |
+| 自己写组合动作 | [组合动作](/v2/xaction) |
+| 运行出问题 | [常见问题](./troubleshooting.md) |
+
+安装包只从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载。`https://getquicker.net/Download` 目前提供的是 1.x，不要从那里装 V2。
+
+<RelatedDocs
+  items={[
+    {
+      href: '/important-notice',
+      label: '体验前必读',
+      description: 'Preview、专业版和回退风险',
+    },
+    {
+      href: '/v2/getting-started',
+      label: '开始使用',
+      description: '面板、动作、第一次运行',
+    },
+    {
+      href: '/v2/install/windows',
+      label: '安装',
+      description: '系统要求和下载入口',
+    },
+    {
+      href: '/release-notes',
+      label: '更新记录',
+      description: '指向官网各版本说明',
+    },
+  ]}
+/>
diff --git a/docs/v2/install/_category_.json b/docs/v2/install/_category_.json
@@ -1,4 +1,8 @@
 {
   "label": "安装与更新",
-  "position": 30
+  "position": 30,
+  "link": {
+    "type": "doc",
+    "id": "v2/install/index"
+  }
 }