升级与回退
准备降级、混用不同版本，或把动作分享给旧版用户时，按下方功能查找对应注意项。首次安装请先看 安装前准备。
操作前确认
- 先备份。 按相关条目备份数据或本机配置，再更换版本。
- 核对所有设备。 新版设置在旧版保存或同步后，可能被清除；把会维护这些设置的设备一并升级。
- 确认动作的最低版本。 新增步骤和操作类型可能无法在旧客户端运行，分享时请注明版本要求。
回到 1.x 的安装步骤见 从 V1 迁移；各版本原始说明见 官网版本记录。
数据与多设备
2.1.0 · 数据结构
2.1.0 相对 2.0.x 增加了大量功能和对应的底层存储。2.0.x 里没有这些数据结构。如果在 2.1.0 里用过新功能并保存了新配置，再降回 2.0.x，这些数据可能被覆盖清除。
2.1.29 · 侧边栏按钮
2.1.29 起可配置新版主窗口侧边栏快捷按钮。配置后若再用 2.1.28 或更早版本修改并同步动作面板偏好，旧客户端可能清除快捷按钮配置，恢复为仅默认「截图 Pro」。多设备使用同一账号时，建议先升级所有设备；回退旧版后也避免修改该项。
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.17 · 浏览器归属
2.2.17 起，自定义程序的浏览器归属统一纳入父场景管理，并随账号同步。将自定义程序添加到浏览器父场景下后，需要重新设置一次归属。
使用浏览器父场景归属前，请将同一账号的所有设备升级到 2.2.17 或更高版本。回退到旧版本或新旧客户端混用时，包含浏览器归属的整份父场景归属配置会暂时失效并变为只读；数据不会因此删除，全部设备重新升级后可恢复。
2.2.26 · 轮盘 F2 开关
2.2.26 起，轮盘显示时可按 F2 编辑鼠标指向的动作。该选项默认开启，可在轮盘设置中关闭。已有 F2 子动作，以及 F2 重复触发相关设置优先于本开关。
回退到旧版后，若再保存或同步轮盘设置，可能丢弃此开关；再次升级会恢复为默认开启。建议各设备升级后再调整，必要时在升级后重新关闭。操作说明见 轮盘菜单。
截图与悬浮布局
2.2.5 · 保存日期
2.2.5 起截图保存设置增加了日期格式选项。若回退到 2.2.4 后又保存截图设置，旧客户端会清除新版的保存日期格式选择；再次升级后需重新选择。此设置只保存在本机，不影响已经保存的图片，也不影响云端数据。
2.2.7 · 阴影与边框
2.2.7 起截图 Pro 可为选区添加阴影和边框。若回退到 2.2.6 后又保存截图工具设置，旧客户端会丢弃新版阴影 / 边框配置；再次升级后需重新设置。截图文件本身不受影响。需要保留配置时，请先备份本机 ScreenCapture/settings/image-drawing-tool-state.json。
2.2.14 · 文件名与悬浮分组
2.2.14 起，截图保存的独立日期格式选项已并入文件名模板，支持 {date:格式}（.NET DateTime）。编辑时会把旧日期格式转换并保留效果。若回退到更旧版本，需将模板中的 {date:格式} 改回 {date}、{time} 等旧语法，才能正常使用文件名模板。
「悬浮分组」动作（按名称打开、关闭或切换）需要 2.2.14 或更高版本客户端；旧版无法识别此动作类型。创建前建议升级所有同步设备；必须回退时，请先备份悬浮布局，并避免在旧版编辑或同步依赖该动作的内容。
账号与 AI
2.1.17 · AI 密钥
2.1.17 起，AI 设置可以同步（API Key 仍只在本机加密保存）。官网版本记录写明：若回退到 2.1.15，请在旧版中重新填写 AI API 密钥；新版保存后的凭据格式，旧版不能正确读取。使用新 AI 模块的动作也无法在 2.1.15 及更旧版本运行。
更早的回退也有类似情况，例如回退到 2.1.12 可能清除图片翻译凭证。逐版本注意以 官网版本记录 为准。
2.2.18 · 远程账号与工作区
2.2.18 起，组合动作可通过远程文件步骤访问 WebDAV 网盘或 NAS。远程文件账号在 设置 → 软件连接 → 远程文件账号 中配置，只保存在本机；它不会随账号云同步、状态备份或动作导出迁移。换电脑、重装或分享动作给别人时，需要在目标电脑重新配置相同的账号引用名。旧版客户端不能运行包含远程文件步骤的动作，升级前不要把这类动作交给仍停留在旧版的设备执行。
AI 助手正式版支持选择本地工作区。选择本地文件夹后，AI 对普通文件的修改会直接保存到该文件夹；请先确认目录、备份和版本管理方式。打开历史对话时会恢复对应目录，但切换工作区会开启新对话，不会把原对话、未提交草稿或上下文迁移过去。
如果回退到不支持自选工作区的旧正式版，已经选择工作区的项目对话不能继续按原目录工作。请升级到支持该功能的版本后，再继续对应项目对话。
2.2.19 · S3 与账号导出
2.2.19 起，保存 S3 账号会升级本机的远程文件账号配置。旧版会拒绝修改整份账号列表（包括其中的 WebDAV 账号），以避免丢失 S3 字段和密钥引用。数据不会因打开旧版而删除，但删除全部 S3 账号也不会自动降回旧格式。回退前先在新版导出必要账号，详见远程文件。
远程文件账号的导出 JSON 包含明文密码或密钥。不要上传到公开网盘、聊天群、动作分享或源码仓库；传输完成后及时删除，外泄后立即在服务端轮换凭据。
2.2.21 · 代码补全
2.2.21 起，组合动作与表达式等编辑器的代码补全默认走在线服务，以减小安装包并节约本机内存。需要离线或不希望上传代码时，可在 设置 → 动作设计 → 代码补全服务 中单独安装本地补全组件，并勾选 使用本地补全服务 后保存。该选项默认关闭。
使用在线补全时，Quicker 会向服务器发送正在编辑的代码、变量类型和默认 using。本地模式下，组件不可用时不会自动改用在线服务。操作入口见 代码补全服务。
动作与日常操作
2.2.20 · 显示器与虚拟桌面
2.2.20 起新增的显示器、虚拟桌面步骤需要新版客户端。含这些步骤的动作在旧版客户端中可能无法识别或运行；多设备同步或分享给他人前，请确认目标设备已升级到 2.2.20 或更高版本。
2.2.22 · 列表、提示与标注
2.2.22 起，「管理和排序列表」可通过高级参数指定 添加项子程序、编辑项子程序，用多字段表单等方式处理复杂列表项。依赖这些子程序的动作需要 2.2.22 或更高版本客户端；分享给他人时请注明最低版本要求。旧版没有对应回调，不能当作退回内置编辑器的等价行为。操作说明见 管理和排序列表。
同版起，可在 设置 → 模块功能选项 配置提示消息的默认显示位置和停留时间，并随账号同步。旧客户端不认识这两项设置；若在旧版保存设置并同步，可能把它们重置。建议先记下所选值，把所有会改设置的设备升级后再修改；若已被重置，可在新版重新设置。步骤或脚本里单独指定的位置、时长仍优先于全局默认。详见 提示消息。
同版起，截图、贴图和录屏标注中 Ctrl+Shift+Z 改为 重做（不再清空全部标注）；清空全部标注请用 Shift+Delete。首次按旧习惯的 Ctrl+Shift+Z 时，客户端会提示一次并执行重做。
旧「底部居中」步骤选项现在跟随全局默认位置；需要固定时，请重新选择本版的「底部居中」。
新导出的 Agent .jsonl 对话文件请用本版或更新版本导入；仍兼容旧版完整会话 JSON，已有对话无需迁移。导入的对话仅供查看，不能继续发送消息。见AI 与 Agent。
2.2.23 · 分享分类
2.2.23 起，分享动作可选择 浏览器通用 作为适用软件，使同一动作出现在 Chrome、Edge、Firefox 等支持的浏览器动作页中。从浏览器通用场景分享时默认选此分类。
更新已有分享时，若原「适用软件」保存的是非法值，需要重新选择有效分类，不再自动改为「通用」。已有 Chrome 等具体程序分类不会自动改成「浏览器通用」；需要跨浏览器展示时请手动改选。操作说明见 分享动作与公共子程序。
2.2.24 · 获取编辑中的动作
2.2.24 起，「Quicker操作」新增 获取最后打开编辑器的动作，可取得本次启动期间最近打开或重新激活编辑器的已安装动作 ID。含此操作类型的动作需要 2.2.24 或更高版本客户端；旧版无法识别该类型。多设备同步或分享给他人前，请确认目标设备已升级。说明见 Quicker操作。
2.2.25 · 设置与界面状态
2.2.25 起，设置窗口改为树形导航，支持搜索并跳转到具体设置项。分类与入口有调整；找不到原位置时，优先用设置内搜索。已改版的设置页逐项自动保存，不再提供整页「应用／撤销」；无效或尚未提交的输入会在离开当前页时提示。
回退到 2.2.24 后，旧版保存本机状态可能清除新版 AI 助手侧栏宽度、开关和设置导航展开记录；这些界面偏好可重新设置，不影响动作内容。需要保留时，请先备份本机 data/app-state.json。