体验前必读
官网 Quicker 2.0 当前标注为 PREVIEW · 仅面向专业版用户。下面几条会直接影响你能不能装、装完能不能登录、以及出问题后能不能退回 1.x。
当前是 Preview，只给专业版
V2 仍在快速迭代，部分功能未完成，已有动作也可能需要调整。现阶段只建议专业版用户尝鲜和反馈，不适合当作已经稳定的正式版。
免费版暂时不能登录
免费版的数据迁移仍在开发。免费账号目前无法登录 2.0，不要按「装上就能接着用原来的免费数据」来规划。
不要替换关键的 1.x 环境
当前版本适合试用和反馈。如果这台电脑上的 1.x 承担着不能中断的日常工作，请另找一台机器或另开一个可回退的环境体验，不要直接替换那套关键安装。
两代不能同时安装
浏览器扩展会冲突，不要同时安装 1.x 和 V2。需要回退时，重新安装 1.x 即可；不要用 V2 的数据目录覆盖 1.x。
首次登录会按「数据分叉」迁移：1.x 与 V2 的数据随后各自独立，不是双向镜像。步骤见 从 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 可能清除图片翻译凭证。逐版本注意以 官网版本记录 为准。
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 账号也不会自动降回旧格式。回退前先在新版导出必要账号，详见远程文件。
远程文件账号的导出 JSON 包含明文密码或密钥。不要上传到公开网盘、聊天群、动作分享或源码仓库；传输完成后及时删除，外泄后立即在服务端轮换凭据。
2.2.20 显示器与虚拟桌面步骤
2.2.20 起新增的显示器、虚拟桌面步骤需要新版客户端。含这些步骤的动作在旧版客户端中可能无法识别或运行；多设备同步或分享给他人前，请确认目标设备已升级到 2.2.20 或更高版本。
2.2.21 代码补全服务
2.2.21 起，组合动作与表达式等编辑器的代码补全默认走在线服务，以减小安装包并节约本机内存。需要离线或不希望上传代码时，可在 设置 → 动作设计 → 代码补全服务 中单独安装本地补全组件，并勾选 使用本地补全服务 后保存。该选项默认关闭。
使用在线补全时，Quicker 会向服务器发送正在编辑的代码、变量类型和默认 using。本地模式下，组件不可用时不会自动改用在线服务。操作入口见 代码补全服务。