From 78b474108745a3c9acb5fe28851162c6416a1e30 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 22:55:47 +0000 Subject: [PATCH 1/8] =?UTF-8?q?fix(docs):=20=E7=BA=A0=E6=AD=A3=20V2=20?= =?UTF-8?q?=E4=B8=8B=E8=BD=BD=E5=85=A5=E5=8F=A3=E5=B9=B6=E8=A1=A5=E5=85=85?= =?UTF-8?q?=20Preview=20=E4=B8=8E=E4=BD=93=E9=AA=8C=E5=89=8D=E5=BF=85?= =?UTF-8?q?=E8=AF=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 安装页改为 getquicker.net/V2，明确不要从仍提供 1.x 的 /Download 下载。 六个用户入口页补充 Preview / 专业版 / 免费版暂不能登录 / 勿替关键环境。 重要提示扩为体验前必读，并写明 2.1.0 降级与回退 2.1.17 前需重填 API 密钥。 Co-authored-by: Cea --- docs/important-notice.md | 61 ++++++++++++++++++++++++++++++++----- docs/index.md | 8 ++++- docs/v2/getting-started.md | 6 +++- docs/v2/install/windows.md | 16 +++++++--- docs/v2/troubleshooting.md | 10 ++++-- docs/v2/what's-new/index.md | 17 ++++++++--- 6 files changed, 97 insertions(+), 21 deletions(-) diff --git a/docs/important-notice.md b/docs/important-notice.md index 2b5fe4f..4e4cf20 100644 --- 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) 为准。 + +## 相关链接 + + diff --git a/docs/index.md b/docs/index.md index d9c29ed..0deb8e4 100644 --- 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,6 +22,7 @@ V2 把动作内容和它出现的位置分开，组合动作用模块拼步骤 | 你想… | 去这篇 | | --- | --- | +| 体验前先看限制 | [体验前必读](./important-notice.md) | | 第一次打开 Quicker | [开始使用](./v2/getting-started.md) | | 安装或确认系统要求 | [安装 Quicker V2](./v2/install/windows.md) | | 自己写一个动作 | [怎样学会组合动作](./v2/xaction/guides/how-to-learn.md) | @@ -25,6 +30,7 @@ V2 把动作内容和它出现的位置分开，组合动作用模块拼步骤 | 截图、标注、贴图 | [截图 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/v2/getting-started.md b/docs/v2/getting-started.md index f88ef48..8d2ad26 100644 --- 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/install/windows.md b/docs/v2/install/windows.md index db8b908..7dab768 100644 --- a/docs/v2/install/windows.md +++ b/docs/v2/install/windows.md @@ -8,7 +8,11 @@ comments: true # 安装 Quicker V2 -从官网下载安装包，在受支持的 64 位 Windows 上安装。V2 与 1.x 使用不同的运行平台和数据目录，不能当成同一个程序的换皮升级。 +:::caution Preview · 仅专业版 +当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 +::: + +从官网 **V2 页面**下载安装包，在受支持的 64 位 Windows 上安装。V2 与 1.x 使用不同的运行平台和数据目录，不能当成同一个程序的换皮升级，也**不能同时安装**。 ## 系统要求 @@ -20,11 +24,13 @@ comments: true ## 下载和安装 -1. 打开官网下载页：[https://getquicker.net/Download](https://getquicker.net/Download)。 -2. 下载当前 V2 安装包，按向导完成安装。 +1. 打开官网 V2 页：[https://getquicker.net/V2](https://getquicker.net/V2)，下载当前 2.0 安装包。 +2. 按向导完成安装。若提示缺少 [.NET 10 桌面运行时](https://dotnet.microsoft.com/download/dotnet/10.0)，按提示安装后再打开 Quicker。 3. 若 Windows SmartScreen 或浏览器拦截，先确认文件来自上述官网，再选择保留并继续。 -不要从不明镜像或转发网盘下载。安装完成后从开始菜单或桌面快捷方式启动。 +**不要**从 [https://getquicker.net/Download](https://getquicker.net/Download) 下载。那个页面目前提供的是 Quicker **1.x**（例如 1.45.5），不是 V2。 + +不要从不明镜像或转发网盘下载。本机若已安装 1.x，先按 [从 V1 迁移](/v2/migration/from-v1.md) 备份并卸载，再装 V2。安装完成后从开始菜单或桌面快捷方式启动。 ## 首次启动 @@ -38,7 +44,7 @@ comments: true - 装不上：先核对 Windows 版本和是否为 64 位。1.x 能运行，不代表这台电脑能跑 V2。 - 装完打不开：确认没有用 32 位兼容方式启动，并查看是否被安全软件隔离。 -- 1.x 与 V2 不要同时改同一批动作。V2 不会把旧的 `quicker.db` 当作日常存储继续写入。 +- 1.x 与 V2 不能同时安装（浏览器扩展会冲突）。V2 不会把旧的 `quicker.db` 当作日常存储继续写入。 - 动作会在 Quicker 进程内加载 DLL、COM 或 Office 组件时，这些依赖也必须提供 x64 版本。 ## 相关链接 diff --git a/docs/v2/troubleshooting.md b/docs/v2/troubleshooting.md index 09aa4eb..a9ce7f2 100644 --- a/docs/v2/troubleshooting.md +++ b/docs/v2/troubleshooting.md @@ -8,13 +8,19 @@ comments: true # 常见问题 +:::caution Preview · 仅专业版 +当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 +::: + 先对照现象看下面几条。组合动作的参数和限制以各 [模块页](/v2/xaction/modules) 为准。 ## 安装和启动 -**装不上或打不开**：V2 只提供 x64，并且只能跑在 [.NET 10 支持的 Windows](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md) 上。1.x 能用，不代表这台电脑能跑 V2。见 [安装](/v2/install/windows.md) 和 [运行平台](/v2/what's-new/platform-and-compatibility.md)。 +**装不上或打不开**：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)。 -**1.x 的数据去哪了**：V2 使用按账号隔离的新存储，不会把旧的 `quicker.db` 当作日常库继续写入。迁移步骤见 [从 V1 迁移](/v2/migration/from-v1.md)。 +**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 bb21dc7..3b3766b 100644 --- a/docs/v2/what's-new/index.md +++ b/docs/v2/what's-new/index.md @@ -8,9 +8,13 @@ comments: true # Quicker V2 重要变化 +:::caution Preview · 仅专业版 +当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 +::: + Quicker V2 不只是更换界面。它升级了运行平台，并重做了动作、面板、场景管理、本地存储和云同步等基础结构。 -本节集中说明相对于 Quicker 1.x 的重要变化。具体版本新增的小功能和问题修复，请另行查看版本更新记录。 +本节集中说明相对于 Quicker 1.x 的重要变化。具体版本新增的小功能和问题修复，见 [更新记录](/release-notes)（指向 [官网版本记录](https://getquicker.net/v2/versions)）。 ## 先看结论 @@ -72,10 +76,13 @@ V2 把“动作内容”和“动作出现在哪里”分开。同一个动作 1. 在 1.x 中完成一次同步，并另外导出关键动作或做好数据备份。 2. 检查 Windows 版本和位数，以及动作依赖的 DLL、COM、Office 和数据库驱动位数。 -3. 安装 V2，等待账号数据迁移和首次同步完成。 -4. 先核对常用动作、动作页、公共子程序及重要触发规则。 -5. 再开始整理新面板场景和分组，避免一边迁移一边大规模改动。 -6. 确认 V2 已稳定使用后，再决定是否清理旧动作页或停止使用 1.x。 +3. **卸载 1.x**（两代不能同时安装），再从 [https://getquicker.net/V2](https://getquicker.net/V2) 安装 V2。 +4. 首次登录会分叉数据；等待迁移和首次同步完成。 +5. 先核对常用动作、动作页、公共子程序及重要触发规则。 +6. 再开始整理新面板场景和分组，避免一边迁移一边大规模改动。 +7. 需要回到 1.x 时，重新安装 1.x；不要用 V2 数据目录覆盖 1.x。 + +完整清单见 [从 V1 迁移](/v2/migration/from-v1.md)。 > **注意：不要把“切换新旧面板”理解为“切换 V1/V2 数据”** > From cf23977be9ec0878e19d8d5e978e36a02fc62f64 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 22:55:52 +0000 Subject: [PATCH 2/8] =?UTF-8?q?docs(v2):=20=E9=87=8D=E5=86=99=E4=BB=8E=201?= =?UTF-8?q?.x=20=E8=BF=81=E7=A7=BB=E6=B8=85=E5=8D=95=E5=B9=B6=E7=A6=81?= =?UTF-8?q?=E6=AD=A2=E4=B8=A4=E4=BB=A3=E5=8F=8C=E5=BC=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 迁移改为可执行步骤：同步备份、卸载 1.x、从 /V2 安装、首次登录分叉、验证、回退重装 1.x。 数据同步页同步写明浏览器扩展冲突，不能同时安装。 Co-authored-by: Cea --- docs/v2/migration/from-v1.md | 90 ++++++++++++++++++++++++----- docs/v2/what's-new/data-and-sync.md | 2 +- 2 files changed, 77 insertions(+), 15 deletions(-) diff --git a/docs/v2/migration/from-v1.md b/docs/v2/migration/from-v1.md index 10cf786..e94095f 100644 --- a/docs/v2/migration/from-v1.md +++ b/docs/v2/migration/from-v1.md @@ -1,6 +1,6 @@ --- title: 从 V1 迁移到 V2 -description: 从 Quicker V1 迁移到 Quicker V2 的说明。 +description: 从 Quicker 1.x 迁到 V2：备份、卸载 1.x、安装、验证和回退清单。 sidebar_position: 1 quickerDocKey: v2/migration/from-v1 comments: true @@ -8,29 +8,69 @@ comments: true # 从 V1 迁移到 V2 -Quicker 2.0 尽量兼容 1.x 的动作和组合动作模块，但动作存储、编辑器、表达式引擎、执行管道和调试能力已经发生变化。迁移的重点不是重新制作所有动作，而是先识别仍需维护的复杂动作，再逐步验证和替换。 +:::caution Preview · 仅专业版 +当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 +::: -## 迁移前 +Quicker 2.0 尽量兼容 1.x 的动作和组合动作模块，但存储、编辑器、表达式和执行管道已经换代。两代**不能同时安装**（浏览器扩展会冲突）。迁移是一份可执行清单，不是「两套程序并行、只是别交叉改动作」。 -1. 保留仍在使用的 1.x 数据和可恢复备份。 -2. 记录依赖第三方软件、浏览器扩展、脚本运行环境或本机文件的动作。 -3. 对多线程、循环、等待、C# 代码和复杂表达式动作，先制作测试副本。 -4. 不要在尚未验证时直接覆盖唯一可用的正式动作。 +## 迁移清单 -## 组合动作 +### 1. 在 1.x 里同步并导出备份 -大多数已有模块在 2.0 中继续保留，主要变化是增加模块、参数和新的执行/调试能力。可以通过[模块参考](/v2/xaction/modules)核对当前模块定义；页面中的参数表来自 2.0 程序导出的元数据，旧使用说明则作为兼容参考保留。 +1. 在最后使用的 1.x 客户端执行一次同步。 +2. 导出特别重要或难以重建的动作、公共子程序。 +3. 另外保留一份 1.x 数据备份（不要只依赖本机那个正在用的目录）。 +4. 记下常用动作页、复杂触发规则，以及依赖第三方软件、浏览器扩展、脚本环境或本机文件的动作。 +5. 对多线程、循环、等待、C# 代码和复杂表达式动作，先做测试副本。 +6. 关闭其它设备上的 Quicker，避免迁移时还在写入旧数据。 -旧版组合动作可以兼容运行和查看，但需要继续编辑的动作应迁移为新版组合动作。无法识别的步骤应保留为不可编辑占位，不应在保存其它内容时静默丢失。 +### 2. 卸载 1.x -## 建议验证顺序 +浏览器扩展会冲突，**不要把 1.x 和 V2 装在同一台电脑上同时使用**。备份确认无误后，先卸载 1.x，再装 V2。 + +### 3. 从官网 V2 页安装 + +打开 [https://getquicker.net/V2](https://getquicker.net/V2) 下载安装包。不要使用 [https://getquicker.net/Download](https://getquicker.net/Download)，那个页面目前提供的是 1.x。 + +系统要求和首次启动见 [安装 Quicker V2](/v2/install/windows.md)。 + +### 4. 首次登录会分叉数据 + +用专业版账号登录。首次登录会以「数据分叉」的方式迁入当前账号数据，之后 1.x 与 V2 **各自独立**，不是双向镜像。 + +- 之后在 1.x 里改的内容，不会自动进入 V2。 +- V2 里的新面板分组、场景位置和新版动作参数，也无法完整写回 1.x。 +- V2 不会把旧的 `quicker.db` 当作日常库继续写入。 + +背景见 [数据存储与同步变化](/v2/what's-new/data-and-sync.md)。 + +### 5. 核对动作、触发和子程序 + +等首次同步完成后再改面板。建议按这个顺序验证： 1. 先运行不修改外部数据的简单动作，确认变量、表达式和基本步骤。 2. 再验证文件写入、网络请求、软件控制等会影响外部状态的模块。 3. 最后验证并行分支、循环、等待、子程序和长时间运行的动作。 -4. 使用新版调试功能观察失败步骤、变量和输出，再判断是兼容问题、环境问题还是动作自身问题。 +4. 核对常用触发规则（快捷键、轮盘、手势、文本指令等）和公共子程序。 +5. 需要继续编辑的旧版组合动作，迁成新版组合动作；无法识别的步骤应保留为不可编辑占位，不应在保存其它内容时静默丢失。 +6. 启用 QkEval 后，失败不会回退到旧表达式引擎；复杂表达式先复制动作测试。 -## 需要重点检查的变化 +旧版组合动作可以兼容运行和查看，但不能继续编辑。模块参数以 [模块参考](/v2/xaction/modules) 为准。 + +### 6. 回退 = 重装 1.x + +需要回到 1.x 时： + +1. 卸载 V2。 +2. **重新安装 1.x**。 +3. 使用迁移前的 1.x 备份或导出文件恢复；不要把 V2 数据目录覆盖到 1.x。 + +两代的模型、同步状态和账号目录都不同，不能靠替换 `quicker.db` 在两边来回切。 + +## 组合动作还要重点看 + +大多数已有模块在 2.0 中继续保留。需要继续维护的复杂动作，先识别再逐步验证，不要在尚未验证时覆盖唯一可用的正式动作。 - 动作存储和使用位置分离，删除动作本体与从面板移除位置的影响不同； - 启用 QkEval 后，不再回退到旧表达式引擎； @@ -38,4 +78,26 @@ Quicker 2.0 尽量兼容 1.x 的动作和组合动作模块，但动作存储、 - 外部组件不响应取消时，并行分支可能不能立即结束； - .NET 10、64 位进程和第三方程序集兼容性需要单独检查。 -详细背景见[动作存储、执行与调试](/v2/what's-new/actions)、[组合动作执行与调试变化](/v2/what's-new/actions/xaction-steps)和[运行平台与兼容性](/v2/what's-new/platform-and-compatibility)。 +详细背景见 [动作存储、执行与调试](/v2/what's-new/actions)、[组合动作执行与调试变化](/v2/what's-new/actions/xaction-steps) 和 [运行平台与兼容性](/v2/what's-new/platform-and-compatibility)。 + +## 相关链接 + + diff --git a/docs/v2/what's-new/data-and-sync.md b/docs/v2/what's-new/data-and-sync.md index 4088e86..1b88670 100644 --- a/docs/v2/what's-new/data-and-sync.md +++ b/docs/v2/what's-new/data-and-sync.md @@ -98,7 +98,7 @@ V2 使用自己的本地数据空间和云端数据结构。首次初始化时 同样，V2 中的新面板分组、场景位置和新版动作参数，也无法完整反向写回 1.x。 -如果确实需要暂时保留 1.x，请指定一个版本作为主要编辑端。另一版本只用于查看或应急运行，避免两边同时改同一个动作。 +官网要求**不要同时安装** 1.x 和 V2（浏览器扩展会冲突）。需要回到 1.x 时，卸载 V2 后重新安装 1.x，不要覆盖 V2 数据目录。见 [从 V1 迁移](/v2/migration/from-v1.md)。 ## 备份和回退边界 From e585ac5a8645fbed34008441d69c2924e2b6efcf Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 22:55:52 +0000 Subject: [PATCH 3/8] =?UTF-8?q?docs(release-notes):=20=E6=94=B9=E4=B8=BA?= =?UTF-8?q?=E6=8C=87=E5=90=91=E5=AE=98=E7=BD=91=E7=89=88=E6=9C=AC=E8=AE=B0?= =?UTF-8?q?=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 去掉仍是编写建议的空 stub，入口指向 https://getquicker.net/v2/versions。 Co-authored-by: Cea --- docs/release-notes/index.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md index 791df0f..975b13e 100644 --- a/docs/release-notes/index.md +++ b/docs/release-notes/index.md @@ -1,6 +1,6 @@ --- title: 更新记录 -description: Quicker V2 的版本更新记录。 +description: Quicker V2 各版本说明在官网，本页是文档站入口。 sidebar_position: 1 quickerDocKey: v2/release-notes comments: true @@ -8,10 +8,12 @@ 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)。 From f02862b6b629b71f3c28721225ca8a432de2f1d5 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 22:55:52 +0000 Subject: [PATCH 4/8] =?UTF-8?q?docs(v2):=20=E8=A1=A5=E9=BD=90=E5=8A=9F?= =?UTF-8?q?=E8=83=BD=E5=85=A5=E5=8F=A3=E9=A1=B5=E4=B8=8E=20/v2=20=E5=88=86?= =?UTF-8?q?=E7=B1=BB=E8=90=BD=E5=9C=B0=E9=A1=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 把待补充 stub 改成指向已有说明的短枢纽页，并补写加载场景/动作页。 为 /v2、/v2/install、/v2/migration 增加 index，避免 generated-index 落到 /category/ 后 404。 Co-authored-by: Cea --- docs/v2/_category_.json | 3 +- docs/v2/features/account-and-sync.md | 25 ++++++--- docs/v2/features/scenes.md | 25 ++++++--- docs/v2/features/tools.md | 15 +++--- docs/v2/index.md | 53 +++++++++++++++++++ docs/v2/install/_category_.json | 6 ++- docs/v2/install/index.md | 24 +++++++++ docs/v2/install/update.md | 36 ++++++++++--- docs/v2/migration/_category_.json | 6 ++- docs/v2/migration/index.md | 24 +++++++++ .../new-main-win/load-action-page.md | 35 +++++++++++- 11 files changed, 221 insertions(+), 31 deletions(-) create mode 100644 docs/v2/index.md create mode 100644 docs/v2/install/index.md create mode 100644 docs/v2/migration/index.md diff --git a/docs/v2/_category_.json b/docs/v2/_category_.json index 274f814..6630ee4 100644 --- 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 index 8585b6f..b64e3de 100644 --- 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/scenes.md b/docs/v2/features/scenes.md index eaf5c7e..fc76191 100644 --- a/docs/v2/features/scenes.md +++ b/docs/v2/features/scenes.md @@ -1,6 +1,6 @@ --- title: 场景与分组 -description: Quicker V2 中场景的配置、切换与动作分组。 +description: 在新面板里按「场景 → 分组 → 动作」组织入口，以及场景如何和触发规则共用。 sidebar_position: 30 quickerDocKey: v2/features/scenes comments: true @@ -8,11 +8,22 @@ 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 index bc6b42d..dc90200 100644 --- a/docs/v2/features/tools.md +++ b/docs/v2/features/tools.md @@ -1,6 +1,6 @@ --- title: 内置工具 -description: Quicker V2 内置的截图、AI 等工具入口。 +description: Quicker V2 已有说明的截图、AI、搜索、选中文本和更新入口。 sidebar_position: 50 quickerDocKey: v2/features/tools comments: true @@ -8,7 +8,7 @@ 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/index.md b/docs/v2/index.md new file mode 100644 index 0000000..4cfd280 --- /dev/null +++ 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) | +| 面板、触发、截图、账号 | [功能使用](./features) | +| 自己写组合动作 | [组合动作](./xaction) | +| 运行出问题 | [常见问题](./troubleshooting.md) | + +安装包只从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载。`https://getquicker.net/Download` 目前提供的是 1.x，不要从那里装 V2。 + + diff --git a/docs/v2/install/_category_.json b/docs/v2/install/_category_.json index aa8206f..3d738fc 100644 --- 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" + } } diff --git a/docs/v2/install/index.md b/docs/v2/install/index.md new file mode 100644 index 0000000..7b6e0aa --- /dev/null +++ b/docs/v2/install/index.md @@ -0,0 +1,24 @@ +--- +title: 安装与更新 +description: 下载、安装和更新 Quicker V2，以及系统要求。 +slug: /v2/install +sidebar_position: 1 +quickerDocKey: v2/install/index +comments: false +--- + +# 安装与更新 + +:::caution Preview · 仅专业版 +当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 +::: + +V2 安装包从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载。不要使用 `https://getquicker.net/Download`，那个页面目前提供的是 Quicker 1.x。 + +| 文档 | 内容 | +| --- | --- | +| [安装 Quicker V2](./windows.md) | 系统要求、下载、首次启动；两代不能同时安装 | +| [更新 Quicker V2](./update.md) | 应用内检查更新、静默安装和校验 | +| [运行平台与兼容性](/v2/what's-new/platform-and-compatibility.md) | .NET 10、x64、脚本和组件位数 | + +从 1.x 迁数据请先看 [从 V1 迁移](/v2/migration/from-v1.md)，不要先装 V2 再回头找备份。 diff --git a/docs/v2/install/update.md b/docs/v2/install/update.md index 5d98ecc..92fe6a3 100644 --- a/docs/v2/install/update.md +++ b/docs/v2/install/update.md @@ -1,6 +1,6 @@ --- title: 更新 Quicker V2 -description: Quicker V2 的更新检查、下载和注意事项。 +description: 在 Quicker V2 内检查更新、下载并静默安装，以及失败时怎么处理。 sidebar_position: 20 quickerDocKey: v2/update comments: true @@ -8,11 +8,33 @@ comments: true # 更新 Quicker V2 -本文用于说明 Quicker V2 的更新机制和用户注意事项。 +:::caution Preview · 仅专业版 +当前 V2 是 **Preview 体验版**，仅面向专业版用户。回退到更早版本前，先看 [体验前必读](/important-notice) 和 [官网版本记录](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)。 -- 自动更新和手动检查更新 -- 安装器更新与主程序更新的关系 -- 更新失败后的处理步骤 -- 试用版本的风险提示 +## 应用内更新 + +更新窗口可以： + +- **下载并静默更新** +- 跳过当前版本 +- 暂不更新 + +自动安装要求服务端提供 HTTPS 下载地址和完整 SHA-256。下载完成后，Quicker 会再核一次文件哈希；独立更新程序还会验证安装包的 Windows 签名，并要求发布者与更新程序一致。 + +确认更新后，Windows 会在安装阶段请求一次管理员权限。Quicker 随后退出，使用 Windows Installer 静默安装，并在完成后尝试以普通用户身份重新启动。 + +签名、发布者、文件位置或哈希验证失败时，不会继续静默安装。安装成功但 Windows 要求重启时，更新程序会提示保存工作并重启电脑。 + +以上行为的背景见 [工具与使用体验 · 应用更新](/v2/what's-new/tools-and-experience.md)。 + +## 更新失败时 + +1. 确认当前装的是 V2，且安装包来自 `/V2` 或版本记录页。 +2. 核对 Windows 仍是受支持的 x64，并已安装 .NET 10 桌面运行时。 +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)。 diff --git a/docs/v2/migration/_category_.json b/docs/v2/migration/_category_.json index bbfce18..fcc8863 100644 --- a/docs/v2/migration/_category_.json +++ b/docs/v2/migration/_category_.json @@ -1,4 +1,8 @@ { "label": "迁移", - "position": 20 + "position": 20, + "link": { + "type": "doc", + "id": "v2/migration/index" + } } diff --git a/docs/v2/migration/index.md b/docs/v2/migration/index.md new file mode 100644 index 0000000..04b26f5 --- /dev/null +++ b/docs/v2/migration/index.md @@ -0,0 +1,24 @@ +--- +title: 迁移 +description: 从 Quicker 1.x 迁到 V2 的步骤，以及新面板里如何加载场景和动作页。 +slug: /v2/migration +sidebar_position: 1 +quickerDocKey: v2/migration/index +comments: false +--- + +# 迁移 + +:::caution Preview · 仅专业版 +当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 +::: + +1.x 和 V2 **不能同时安装**。迁移是「备份 → 卸载 1.x → 安装 V2」，不是两套程序并行。 + +| 文档 | 内容 | +| --- | --- | +| [从 V1 迁移](./from-v1.md) | 可执行清单：同步备份、卸载、安装、验证、回退 | +| [加载场景与加载动作页](./new-main-win/load-action-page.md) | 新面板里如何切到指定场景、分组或旧动作页 | +| [数据存储与同步变化](/v2/what's-new/data-and-sync.md) | 首次登录如何分叉数据，以及为什么不是双向镜像 | + +相对 1.x 的能力变化见 [V2 重要变化](/v2/what's-new/)。 diff --git a/docs/v2/migration/new-main-win/load-action-page.md b/docs/v2/migration/new-main-win/load-action-page.md index e697a9d..a1b5004 100644 --- a/docs/v2/migration/new-main-win/load-action-page.md +++ b/docs/v2/migration/new-main-win/load-action-page.md @@ -1,8 +1,41 @@ --- title: 加载场景与加载动作页动作 -description: '' +description: 在新面板里切换场景、分组或旧动作页，以及用「Quicker 操作」步骤自动加载。 sidebar_position: 10 quickerDocKey: v2/migration/new-main-win/load-action-page comments: true --- + # 加载场景与加载动作页动作 + +1.x 里常用「加载动作页」把面板切到某一张二维页。V2 新面板改成 **场景 → 分组**；旧动作页仍然可以加载，但日常整理应优先用场景和分组。 + +## 在面板上切换 + +- 单击场景标签：切到该场景。 +- 上下文区右上角的锁定：停住自动切换；右键可选择要加载并锁定的应用场景。 +- 开启「显示分组」后，用右侧导航或「每次显示单个分组」在组之间跳转。 +- 右键具名分组，可创建一个「加载此分组」的动作，以后一键回到这个组。 + +界面细节见 [新面板窗口的使用](/v2/what's-new/new-main-win/usage.md)。 + +## 用组合动作加载 + +在组合动作里加入 [Quicker 操作](/v2/xaction/modules/quickeroperations)，按 **类型** 选择： + +| 类型 | 做什么 | +| --- | --- | +| **加载动作页** | 把指定旧动作页加载到当前面板。动作页 ID 在「场景与动作管理」里复制。 | +| **加载场景动作（锁定切换）** | 切到某个程序或自定义场景，加载它的动作，并锁定（等同按下锁定按钮）。可填 **切换到分组**。 | +| **加载场景动作（不锁定切换）** | 同样加载场景，但不锁定，之后仍可随前台程序自动切走。 | +| **锁定/解锁 动作页自动切换** | 只切换锁定状态，不指定目标场景。 | + +**场景标识**一般填该场景关联的 exe 文件名。**切换到分组**留空则用场景默认；填「未分组」切到未分组。 + +要让面板跟着鼠标出现：先 **显示面板**（可打开 **跟随鼠标位置**），稍等，再加载动作页或场景。参数表和示例见该模块页。 + +## 和 1.x 的差别 + +- 「加载动作页」仍然针对旧的二维动作页，不会自动变成新面板里的分组。 +- 新面板里更常见的是加载场景，必要时再切分组。 +- 从某个场景或分组移除入口，不会删除动作本体。 From 97948a8cd96c6210a5ad6861945b38cba89713ba Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 22:55:55 +0000 Subject: [PATCH 5/8] =?UTF-8?q?fix(site):=20=E7=BC=96=E7=A0=81=20sitemap?= =?UTF-8?q?=20=E6=92=87=E5=8F=B7=E8=B7=AF=E5=BE=84=E5=B9=B6=E6=9B=B4?= =?UTF-8?q?=E6=AD=A3=E9=A1=B5=E8=84=9A=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit what's-new 目录不改名；sitemap loc 将 ' 编码为 %27，避免 XML 消费端失败。 页脚「文档中心」改为「1.x 文档」，并增加官网 V2 入口。 Co-authored-by: Cea --- docusaurus.config.ts | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 2a82ce8..a07030f 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -143,6 +143,19 @@ const config: Config = { ...(isProd ? ['**/lab/screenshot-review/**'] : []), ], }, + // Encode apostrophes in loc. The what's-new/ directory is not renamed + // in this change; raw "'" in can break XML consumers / some edges. + sitemap: { + lastmod: 'date', + createSitemapItems: async (params) => { + const {defaultCreateSitemapItems, ...rest} = params; + const items = await defaultCreateSitemapItems(rest); + return items.map((item) => ({ + ...item, + url: item.url.replaceAll("'", '%27'), + })); + }, + }, theme: { customCss: './src/css/custom.css', }, @@ -194,10 +207,10 @@ const config: Config = { footer: { style: 'light', links: [ - {label: 'Quicker V2', to: '/v2/getting-started'}, + {label: 'Quicker V2', to: '/v2'}, {label: '更新记录', to: '/release-notes'}, - {label: '官网', href: 'https://getquicker.net'}, - {label: '文档中心', href: 'https://getquicker.net/KC'}, + {label: '官网 V2', href: 'https://getquicker.net/V2'}, + {label: '1.x 文档', href: 'https://getquicker.net/KC'}, {label: '讨论区', href: 'https://getquicker.net/QA'}, { label: 'GitHub', From ec1d8d4417f84cb0502b696d9aee60de3b3abfc8 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 22:55:55 +0000 Subject: [PATCH 6/8] =?UTF-8?q?docs(v2):=20=E8=A1=A5=E5=85=85=20AI=20?= =?UTF-8?q?=E7=8E=B0=E7=8A=B6=E3=80=81=E8=A7=A6=E5=8F=91=E5=85=A5=E5=8F=A3?= =?UTF-8?q?=E5=B9=B6=E9=9A=90=E8=97=8F=E7=BC=96=E5=86=99=E7=BA=A6=E5=AE=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 AI/Agent 现状页，不承诺 Agent 或手机遥控已对普通用户开放。 触发概览去掉「即将补充」，并如实标出仍缺独立说明的项。 编写约定对用户侧栏隐藏；模块分类描述去掉重复用词。 Co-authored-by: Cea --- docs/contributing.md | 1 + docs/v2/features/ai-and-agent.md | 31 ++++++++++++++++++++ docs/v2/features/triggers/index.md | 18 ++++++------ docs/v2/what's-new/ai-services-and-models.md | 2 +- docs/v2/xaction/modules/_category_.json | 2 +- 5 files changed, 43 insertions(+), 11 deletions(-) create mode 100644 docs/v2/features/ai-and-agent.md diff --git a/docs/contributing.md b/docs/contributing.md index 5fab1b5..dfd3164 100644 --- 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/v2/features/ai-and-agent.md b/docs/v2/features/ai-and-agent.md new file mode 100644 index 0000000..67245f3 --- /dev/null +++ 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/triggers/index.md b/docs/v2/features/triggers/index.md index 5d7ab3a..90a988d 100644 --- 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/what's-new/ai-services-and-models.md b/docs/v2/what's-new/ai-services-and-models.md index e700fa4..3af19e5 100644 --- a/docs/v2/what's-new/ai-services-and-models.md +++ b/docs/v2/what's-new/ai-services-and-models.md @@ -63,6 +63,6 @@ API Key 不会直接写入普通 AI 设置 JSON。Quicker 使用 Windows DPAPI 统一设置页提供公共的连接、模型和用途配置，但不表示所有历史 AI 入口已经在同一版本中完成迁移。具体功能是否使用这里的候选模型，应以该功能页面和实际界面为准。 -部分 Agent、Web 动作设计器和动作助手仍可能处于开发或发布门控状态。看到“Agent 与工具调用”用途，不等同于当前版本已经开放全部相关界面。 +部分 Agent、Web 动作设计器和动作助手仍可能处于开发或发布门控状态。看到“Agent 与工具调用”用途，不等同于当前版本已经开放全部相关界面。普通用户当前范围见 [AI 与 Agent 现状](/v2/features/ai-and-agent.md)。 配置正式动作前，建议先执行连接测试和模型测试，并使用不含敏感信息的样例确认协议、模型 ID 和能力设置正确。 diff --git a/docs/v2/xaction/modules/_category_.json b/docs/v2/xaction/modules/_category_.json index b404598..e9848bb 100644 --- a/docs/v2/xaction/modules/_category_.json +++ b/docs/v2/xaction/modules/_category_.json @@ -5,6 +5,6 @@ "type": "generated-index", "slug": "/v2/xaction/modules", "title": "模块参考", - "description": "模块参考模块参考。参数表由 Quicker 当前模块元数据生成。" + "description": "按当前程序导出的模块参数表，并保留人工使用说明。" } } From d4e410a5596431d3ce02efe90ce375ce1efda468 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 22:57:28 +0000 Subject: [PATCH 7/8] =?UTF-8?q?fix(docs):=20=E4=BF=AE=E6=AD=A3=20V2=20?= =?UTF-8?q?=E6=9E=A2=E7=BA=BD=E9=A1=B5=E6=8C=87=E5=90=91=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E4=B8=8E=E7=BB=84=E5=90=88=E5=8A=A8=E4=BD=9C=E7=9A=84=E9=93=BE?= =?UTF-8?q?=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit slug 为 /v2 时，相对目录链接会被解析到站点根并触发 onBrokenLinks。 Co-authored-by: Cea --- docs/v2/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/v2/index.md b/docs/v2/index.md index 4cfd280..4408879 100644 --- a/docs/v2/index.md +++ b/docs/v2/index.md @@ -21,8 +21,8 @@ V2 重做了数据存储、同步、动作模型和主面板。动作内容和 | 下载安装 | [安装 Quicker V2](./install/windows.md) | | 从 1.x 过来 | [从 V1 迁移](./migration/from-v1.md) | | 相对 1.x 改了什么 | [V2 重要变化](./what's-new/index.md) | -| 面板、触发、截图、账号 | [功能使用](./features) | -| 自己写组合动作 | [组合动作](./xaction) | +| 面板、触发、截图、账号 | [功能使用](/v2/features) | +| 自己写组合动作 | [组合动作](/v2/xaction) | | 运行出问题 | [常见问题](./troubleshooting.md) | 安装包只从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载。`https://getquicker.net/Download` 目前提供的是 1.x，不要从那里装 V2。 From ea6b6f17342dafab1330b4d755f8af803c777dfd Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 16 Aug 2026 23:09:30 +0000 Subject: [PATCH 8/8] =?UTF-8?q?fix(docs):=20=E4=BD=BF=E7=94=A8=20MDX=20?= =?UTF-8?q?=E6=A0=87=E9=A2=98=E8=AF=AD=E6=B3=95=E6=B8=B2=E6=9F=93=20Previe?= =?UTF-8?q?w=20=E6=8F=90=E7=A4=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit :::caution 后的标题需写成 [Preview · 仅专业版]，否则会按普通段落输出。 Co-authored-by: Cea --- docs/index.md | 2 +- docs/v2/features/account-and-sync.md | 2 +- docs/v2/getting-started.md | 2 +- docs/v2/index.md | 2 +- docs/v2/install/index.md | 2 +- docs/v2/install/update.md | 2 +- docs/v2/install/windows.md | 2 +- docs/v2/migration/from-v1.md | 2 +- docs/v2/migration/index.md | 2 +- docs/v2/troubleshooting.md | 2 +- docs/v2/what's-new/index.md | 2 +- 11 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/index.md b/docs/index.md index 0deb8e4..96eec39 100644 --- a/docs/index.md +++ b/docs/index.md @@ -10,7 +10,7 @@ comments: false # Quicker 文档 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](./important-notice.md)。 ::: diff --git a/docs/v2/features/account-and-sync.md b/docs/v2/features/account-and-sync.md index b64e3de..f1fd62d 100644 --- a/docs/v2/features/account-and-sync.md +++ b/docs/v2/features/account-and-sync.md @@ -8,7 +8,7 @@ comments: true # 账号、登录与数据同步 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。完整限制见 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/getting-started.md b/docs/v2/getting-started.md index 8d2ad26..b8967c4 100644 --- a/docs/v2/getting-started.md +++ b/docs/v2/getting-started.md @@ -8,7 +8,7 @@ comments: true # 开始使用 Quicker V2 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/index.md b/docs/v2/index.md index 4408879..effe436 100644 --- a/docs/v2/index.md +++ b/docs/v2/index.md @@ -9,7 +9,7 @@ comments: false # Quicker V2 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/install/index.md b/docs/v2/install/index.md index 7b6e0aa..acf53b9 100644 --- a/docs/v2/install/index.md +++ b/docs/v2/install/index.md @@ -9,7 +9,7 @@ comments: false # 安装与更新 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/install/update.md b/docs/v2/install/update.md index 92fe6a3..a384202 100644 --- a/docs/v2/install/update.md +++ b/docs/v2/install/update.md @@ -8,7 +8,7 @@ comments: true # 更新 Quicker V2 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。回退到更早版本前，先看 [体验前必读](/important-notice) 和 [官网版本记录](https://getquicker.net/v2/versions) 里该版本的注意项。 ::: diff --git a/docs/v2/install/windows.md b/docs/v2/install/windows.md index 7dab768..13d05d1 100644 --- a/docs/v2/install/windows.md +++ b/docs/v2/install/windows.md @@ -8,7 +8,7 @@ comments: true # 安装 Quicker V2 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/migration/from-v1.md b/docs/v2/migration/from-v1.md index e94095f..d38b9d1 100644 --- a/docs/v2/migration/from-v1.md +++ b/docs/v2/migration/from-v1.md @@ -8,7 +8,7 @@ comments: true # 从 V1 迁移到 V2 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/migration/index.md b/docs/v2/migration/index.md index 04b26f5..0c4556c 100644 --- a/docs/v2/migration/index.md +++ b/docs/v2/migration/index.md @@ -9,7 +9,7 @@ comments: false # 迁移 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/troubleshooting.md b/docs/v2/troubleshooting.md index a9ce7f2..40b7c41 100644 --- a/docs/v2/troubleshooting.md +++ b/docs/v2/troubleshooting.md @@ -8,7 +8,7 @@ comments: true # 常见问题 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 ::: diff --git a/docs/v2/what's-new/index.md b/docs/v2/what's-new/index.md index 3b3766b..2950842 100644 --- a/docs/v2/what's-new/index.md +++ b/docs/v2/what's-new/index.md @@ -8,7 +8,7 @@ comments: true # Quicker V2 重要变化 -:::caution Preview · 仅专业版 +:::caution[Preview · 仅专业版] 当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。 :::