优化文档首页、功能导航与目录卡片体验

docs/index.md

@@ -6,63 +6,55 @@ description: Quicker V2 使用说明：安装、面板、组合动作教程、
 sidebar_position: 1
 quickerDocKey: docs/home
 comments: false
+hide_title: true
+hide_table_of_contents: true
 ---
 
+<div className="docs-landing">
+
 # Quicker 文档
 
-:::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](./important-notice.md)。
-:::
+<p className="docs-landing__lead">从第一次运行动作，到把重复操作变成自己的工具。</p>
+
+Quicker 是 Windows 上的效率工具。你可以从面板运行动作，也可以用快捷键、鼠标手势等方式随时调用。
+
+<div className="docs-landing__notice">
 
-Quicker 是 Windows 上的效率工具：把重复操作做成**动作**，用面板、快捷键或触发规则随时运行。
+**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [使用限制与回退说明](./important-notice.md)，不建议替换无法中断的 1.x 关键环境。
 
-V2 把动作内容和它出现的位置分开，组合动作用模块拼步骤，参数、变量和调试都按当前程序定义来写。
+</div>
 
 ## 从这里开始
 
-| 你想… | 去这篇 |
-| --- | --- |
-| 体验前先看限制 | [体验前必读](./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/features/action-panel/index.md) |
-| 查某个步骤的参数 | [组合动作模块参考](./v2/xaction/modules) |
-| 现在能用哪些 AI | [AI 与 Agent 现状](./v2/features/ai-and-agent.md) |
-| 连接设计、建模或办公软件 | [软件连接与 Bridge](./v2/features/software-connections/index.md) |
-| 运行出问题 | [常见问题](./v2/troubleshooting.md) |
-
-## 组合动作三条动手课
-
-跟着做一遍，就能理解步骤、变量和分支：
-
-1. [弹出一条提示](./v2/xaction/guides/helloworld.md)
-2. [把选中文字变成大写](./v2/xaction/guides/selected-text.md)
-3. [选中文字就搜索](./v2/xaction/guides/search-selected.md)
-
-<RelatedDocs
-  items={[
-    {
-      href: '/v2/getting-started',
-      label: '开始使用',
-      description: '面板、动作、第一次运行',
-    },
-    {
-      href: '/v2/xaction/guides/how-to-learn',
-      label: '学习路径',
-      description: '组合动作怎么学',
-    },
-    {
-      href: "/v2/what's-new",
-      label: 'V2 重要变化',
-      description: '相对 1.x 改了什么',
-    },
-    {
-      href: '/release-notes',
-      label: '更新记录',
-      description: '官网各版本说明入口',
-    },
-  ]}
-/>
+<RelatedDocs layout="cards" className="docs-start-paths" items={[
+  {href: '/v2/getting-started', label: '第一次使用 Quicker', description: '安装、打开面板，运行第一个动作。'},
+  {href: '/v2/xaction/guides/how-to-learn', label: '自己编写动作', description: '跟着三个小练习，学会步骤、变量和分支。'},
+  {href: '/v2/migration/from-v1', label: '从 1.x 升级', description: '先了解迁移、兼容性和新版的使用方式。'},
+]} />
+
+## 常用内容
+
+<RelatedDocs layout="cards" items={[
+  {href: '/v2/features/action-panel/usage', label: '动作面板', description: '呼出面板、查找动作，用场景和分组整理入口。'},
+  {href: '/v2/features/triggers/', label: '快捷键与鼠标触发', description: '选择合适的快捷键、手势、轮盘或划词入口。'},
+  {href: '/v2/features/screenshot/', label: '截图与贴图', description: '截图、标注、滚动截图，以及将图片贴在桌面上。'},
+  {href: '/v2/xaction/modules', label: '组合动作模块参考', description: '按分类查找步骤，查看参数、输出和使用说明。'},
+  {href: '/v2/features/software-connections', label: '软件连接', description: '通过 Bridge 连接设计、建模和办公软件。'},
+  {href: '/v2/features/ai-and-agent', label: 'AI 与 Agent', description: '配置模型，用 AI 编写动作，连接外部助手。'},
+]} />
+
+<div className="docs-landing__more">
+
+[浏览全部功能](/v2/features) · [安装与系统要求](./v2/install/windows.md) · [常见问题](./v2/troubleshooting.md) · [更新记录](/release-notes)
+
+</div>
+
+## 跟着做一个组合动作
+
+<ol className="docs-landing__lessons">
+  <li><a href="/v2/xaction/guides/helloworld"><span className="docs-landing__lesson-number" aria-hidden="true">01</span><strong>弹出一条提示</strong><span>认识动作编辑器和步骤</span></a></li>
+  <li><a href="/v2/xaction/guides/selected-text"><span className="docs-landing__lesson-number" aria-hidden="true">02</span><strong>把选中文字变成大写</strong><span>用变量传递和处理文本</span></a></li>
+  <li><a href="/v2/xaction/guides/search-selected"><span className="docs-landing__lesson-number" aria-hidden="true">03</span><strong>选中文字就搜索</strong><span>加入条件，打开搜索网址</span></a></li>
+</ol>
+
+</div>

docs/v2/_category_.json

@@ -1,6 +1,7 @@
 {
   "label": "Quicker V2",
   "position": 30,
+  "collapsed": false,
   "link": {
     "type": "doc",
     "id": "v2/index"

docs/v2/features/_category_.json

@@ -2,9 +2,7 @@
   "label": "功能使用",
   "position": 40,
   "link": {
-    "type": "generated-index",
-    "slug": "/v2/features",
-    "title": "功能使用",
-    "description": "Quicker V2 各项功能的使用说明。"
+    "type": "doc",
+    "id": "v2/features/index"
   }
 }

docs/v2/features/index.md

@@ -0,0 +1,48 @@
+---
+title: 功能使用
+description: 按使用场景查找 Quicker V2 的面板、触发、截图、账号和软件连接说明。
+slug: /v2/features
+quickerDocKey: v2/features
+comments: false
+hide_title: true
+hide_table_of_contents: true
+---
+
+<div className="docs-landing">
+
+# 功能使用
+
+<p className="docs-landing__lead">按你想做的事情，找到对应的使用说明。</p>
+
+第一次使用，建议先看 [开始使用 Quicker V2](../getting-started.md)。
+
+## 运行动作与整理面板
+
+<RelatedDocs layout="cards" items={[
+  {href: '/v2/features/action-panel/', label: '动作面板', description: '打开面板、查找和运行动作，使用暂存区。'},
+  {href: '/v2/features/scenes', label: '场景与分组', description: '按当前程序或网址组织动作，让常用入口出现在合适的位置。'},
+  {href: '/v2/features/triggers/', label: '快捷键与鼠标触发', description: '快捷键、手势、轮盘、划词工具条和其他触发方式。'},
+  {href: '/v2/features/floating-actions', label: '悬浮动作与分组', description: '把动作留在桌面上，整理悬浮布局或跟随程序窗口。'},
+  {href: '/v2/features/actions', label: '动作的运行与管理', description: '了解动作、面板入口和引用关系，避免误删动作本体。'},
+  {href: '/v2/features/action-sharing', label: '分享动作与公共子程序', description: '发布、安装和更新动作，了解 V1 / V2 格式与版本历史。'},
+]} />
+
+## 截图与日常工具
+
+<RelatedDocs layout="cards" items={[
+  {href: '/v2/features/screenshot/', label: '截图与贴图', description: '截图、标注、滚动截图，以及桌面贴图。'},
+  {href: '/v2/features/tools', label: '内置工具', description: '查找截图、搜索、选中文本及动作运行记录等工具入口。'},
+  {href: '/v2/features/displays-and-desktops', label: '显示器与虚拟桌面', description: '查询显示器、调整亮度，管理 Windows 虚拟桌面。'},
+  {href: '/v2/features/ai-and-agent', label: 'AI 与 Agent', description: '设置模型，用 AI 编写动作，连接外部助手。'},
+]} />
+
+## 账号、文件与软件连接
+
+<RelatedDocs layout="cards" items={[
+  {href: '/v2/features/account-and-sync', label: '账号与数据同步', description: '了解账号隔离、首次登录、同步范围和离线使用。'},
+  {href: '/v2/features/remote-files', label: '远程文件', description: '配置 WebDAV 或 S3 账号，在动作中上传、下载和查询文件。'},
+  {href: '/v2/features/software-connections', label: '软件连接', description: '安装 Bridge，连接设计、建模和办公软件。'},
+  {href: '/v2/features/http-websocket', label: 'HTTP 与 WebSocket 服务', description: '让脚本、快捷指令或其他设备调用这台电脑上的 Quicker。'},
+]} />
+
+</div>

docs/v2/index.md

@@ -5,50 +5,40 @@ slug: /v2
 sidebar_position: 1
 quickerDocKey: v2/index
 comments: false
+hide_title: true
+hide_table_of_contents: true
 ---
 
+<div className="docs-landing">
+
 # 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) |
-| 连接设计、建模或办公软件 | [软件连接与 Bridge](./features/software-connections/index.md) |
-| 运行出问题 | [常见问题](./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: '指向官网各版本说明',
-    },
-  ]}
-/>
+<p className="docs-landing__lead">安装、使用和编写动作，都从这里开始。</p>
+
+<div className="docs-landing__notice">
+
+**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [使用限制与回退说明](/important-notice)，不建议替换无法中断的 1.x 关键环境。
+
+</div>
+
+## 安装与入门
+
+<RelatedDocs layout="cards" items={[
+  {href: '/v2/install/windows', label: '安装 Quicker V2', description: '确认系统要求，下载并完成首次启动。'},
+  {href: '/v2/getting-started', label: '开始使用', description: '认识动作、面板和场景，运行第一个动作。'},
+  {href: '/v2/migration/from-v1', label: '从 1.x 迁移', description: '迁移动作与设置，了解兼容性和回退方式。'},
+  {href: "/v2/what's-new/", label: 'V2 重要变化', description: '了解新版面板、数据同步和动作模型的变化。'},
+]} />
+
+安装包请从 [Quicker V2 官网](https://getquicker.net/V2) 下载；官网 `/Download` 页面目前提供的是 1.x。
+
+## 继续探索
+
+<RelatedDocs layout="cards" items={[
+  {href: '/v2/features', label: '功能使用', description: '面板、快捷触发、截图、工具和账号设置。'},
+  {href: '/v2/xaction', label: '组合动作', description: '从入门练习到模块参考，编写自己的自动化动作。'},
+  {href: '/v2/features/software-connections', label: '软件连接', description: '安装 Bridge，调用设计、建模和办公软件。'},
+  {href: '/v2/troubleshooting', label: '常见问题', description: '排查面板呼出、选中文本和动作运行问题。'},
+]} />
+
+</div>

docs/v2/xaction/index.md

@@ -12,10 +12,6 @@ hide_table_of_contents: true
 
 组合动作把多个步骤按顺序执行，用来完成打开网页、处理文本、操作窗口这类自动化。Quicker 2.0 沿用 1.x 的主要模块，并补充了参数、执行和调试能力。
 
-2.2.18 起，客户端新增[远程文件](/v2/xaction/modules/remotefile)步骤，可通过 WebDAV 上传、下载、列出、查询、删除或移动网盘及 NAS 文件，并创建目录；2.2.19 起进一步支持 S3、文本与图片内容、复制文件和批量传输。账号在 **设置 → 软件连接 → 远程文件账号** 中配置，只保存在本机；换电脑或分享动作时，需要在目标电脑配置相同的账号引用名。
-
-2.2.20 起，客户端新增 [显示器](/v2/xaction/modules/monitor) 与 [虚拟桌面](/v2/xaction/modules/virtualdesktop) 步骤。显示器步骤可获取屏幕列表、坐标和工作区，并对鼠标所在屏、主屏、指定屏或全部屏读取、设置或增减亮度，也可显示可交互亮度 OSD；复制显示导致无法唯一对应物理显示器时，请明确指定目标。虚拟桌面步骤可查询、切换、创建、删除、重命名、排序桌面，查询窗口所在桌面并移动窗口，也可读取或设置窗口是否固定到所有桌面；能力取决于 Windows 完整版本，删除桌面时需要指定窗口迁移目标，且不能删除最后一个桌面。更多操作说明见[显示器与虚拟桌面](/v2/features/displays-and-desktops)。
-
 <XActionLanding
   moduleCount={175}
   generatedAt="2026-09-30 06:04:10"
@@ -35,3 +31,9 @@ hide_table_of_contents: true
     Input: 2,
   }}
 />
+
+## 近期新增步骤
+
+2.2.18 起，客户端新增[远程文件](/v2/xaction/modules/remotefile)步骤，可通过 WebDAV 上传、下载、列出、查询、删除或移动网盘及 NAS 文件，并创建目录；2.2.19 起进一步支持 S3、文本与图片内容、复制文件和批量传输。账号在 **设置 → 软件连接 → 远程文件账号** 中配置，只保存在本机；换电脑或分享动作时，需要在目标电脑配置相同的账号引用名。
+
+2.2.20 起，客户端新增 [显示器](/v2/xaction/modules/monitor) 与 [虚拟桌面](/v2/xaction/modules/virtualdesktop) 步骤。显示器步骤可获取屏幕列表、坐标和工作区，并对鼠标所在屏、主屏、指定屏或全部屏读取、设置或增减亮度，也可显示可交互亮度 OSD；复制显示导致无法唯一对应物理显示器时，请明确指定目标。虚拟桌面步骤可查询、切换、创建、删除、重命名、排序桌面，查询窗口所在桌面并移动窗口，也可读取或设置窗口是否固定到所有桌面；能力取决于 Windows 完整版本，删除桌面时需要指定窗口迁移目标，且不能删除最后一个桌面。更多操作说明见[显示器与虚拟桌面](/v2/features/displays-and-desktops)。

docusaurus.config.ts

@@ -185,13 +185,14 @@ const config: Config = {
       },
       items: [
         {
-          type: 'docSidebar',
-          sidebarId: 'docsSidebar',
+          to: '/v2/getting-started',
           position: 'left',
-          label: '文档',
+          label: '开始使用',
         },
+        {to: '/v2/features', label: '功能使用', position: 'left'},
+        {to: '/v2/xaction', label: '组合动作', position: 'left'},
         {to: '/release-notes', label: '更新记录', position: 'left'},
-        {type: 'search', position: 'left'},
+        {type: 'search', position: 'right'},
         ...(!isProd
           ? [
               {