Skip to content

精简安装准备页并整理升级回退文档 #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ceastld merged 1 commit into from
Oct 1, 2026
Merged

精简安装准备页并整理升级回退文档 #62

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
172 changes: 40 additions & 132 deletions docs/important-notice.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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-编辑指向的动作"
]} />
2 changes: 1 addition & 1 deletion docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down
Loading
Loading