分享动作与公共子程序

Quicker 2.2.1 起，动作和公共子程序使用统一的分享与版本体系。同一个分享只有一个网址和一组修订版本，但每个修订可以同时包含供 Quicker 1.x 和 Quicker 2.0 使用的内容。

这意味着作者不必维护两条互不关联的分享记录，使用者也可以从同一个网页查看版本历史、安装适合当前 Quicker 的内容。

一个分享如何保存多个格式​

新版分享中的几个概念分别表示：

• 分享 ID：分享的网址身份。以后更新仍沿用同一个 ID。
• 修订版本（revision）：每次发布正文更新都会增加一个修订版本，旧修订不会被新正文覆盖。
• V1：界面中的“Quicker 1.x（兼容制品）”，供 1.x 客户端使用。
• V2：界面中的“Quicker 2.0（原生制品）”，完整保存 Quicker 2.0 动作或子程序。

V1 和 V2 只是同一修订中的两种可安装内容，不是两条独立分享。网页版本历史会在每个修订旁显示 V1、V2 或两者。

分享或更新动作​

在动作的右键菜单中选择分享命令，打开分享窗口后：

1. 检查名称、说明、适用软件和关键词。
2. 选择用户许可。
3. 更新已有分享时填写本次更新说明。
4. 在“本次发布格式”中至少选择一种格式。
5. 选择公开分享或不公开分享。
6. 点击“分享”，或使用“分享并打开网页”继续编辑网页信息。

公开分享需要填写动作说明，并为动作设置合适的图标，不能使用默认图标。标签、分类和更详细的图文介绍可以在分享后的网页中继续编辑。

如何选择发布格式​

本次选择	Quicker 1.x	Quicker 2.0	适用情况
V1 + V2	安装 V1	优先安装同修订的 V2	计划支持两代客户端，并已分别验证
仅 V2	无法安装该修订	安装 V2	使用了 2.0 专属能力，或无法无损生成 V1
仅 V1	安装 V1	已有 V2 时继续使用 V2；没有 V2 时使用 V1	补修旧版兼容内容等情况

如果计划支持两代客户端，并已在目标版本验证，可以同时选择 V1 和 V2。Quicker 2.0 会优先使用同一修订中的原生 V2 内容；该修订没有 V2 时，仍可安装 V1 兼容内容。作者也可以保留最后一个可用的 V1 修订，后续仅更新 V2，不必长期保持两版功能一致。

从兼容两版转向仅维护 V2 的操作建议见动作作者：迁移到 V2 与维护 V1 兼容版本。

某些 Quicker 2.0 动作使用了 1.x 不支持的模块或结构，客户端会说明为什么无法生成 V1。此时可以取消 V1，只发布 V2，不要为了兼容而删除动作必需的步骤。

2.2.2 起继续完善统一分享：Quicker 2.0 可以从统一分享中安装只有 V2 制品的动作，不应再因为缺少 V1 制品而无法安装。若旧客户端仍提示格式不支持或安装失败，请先升级 Quicker，再重新从分享链接安装。

快速更新会沿用当前分享已有的格式。如果动作后来已经无法生成原有的 V1 内容，快速更新会停止并提示打开完整分享窗口，由作者决定是否改为仅发布 V2。

旧版兼容检查​

2.2.10 起，分享前会按 V1 能力清单做旧版兼容检查。若动作含有 1.x 不支持的功能，可选择仅分享 V2；在快速更新路径上若触发兼容性警告，客户端会提示进入完整分享窗口确认后再发布，避免误把无法兼容的修订推给 1.x 用户。

• 无法生成 V1：例如使用了清单中不存在的模块、确定不受支持的固定选项或无法转换的结构。需要调整实现，或仅发布 V2。
• 兼容性需验证：例如新增参数可能被旧版忽略，或参数使用变量、表达式，无法静态判断。完整分享窗口允许作者确认后继续发布，但应先在目标版本验证。

检查会遍历主程序、条件分支和子程序。把 V2 专属模块放进“仅 V2 执行”的分支，并不能绕过格式检查。检查通过也不保证任意脚本 API、动态依赖及更早的 1.x 版本都能正常运行。

2.2.11 的“指定类型”变量属于明确不支持 V1 的能力，包括主程序和嵌入子程序中的声明。应仅发布 V2；动态对象的可选补全类型提示不属于此限制。

公开、审核和不公开分享​

• 公开分享会提交到动作库或子程序库。普通动作通常需要审核；部分账号或资源可能按当前规则直接通过。
• 不公开分享不会进入公共列表和搜索，但持有网址的已登录用户仍可以安装。
• 将原来的不公开分享改成公开分享后，如果不符合免审核条件，新修订会显示为待审核。

公开动作更新进入审核时，之前已经审核通过的版本会继续公开，不会被待审核正文立即替换。审核通过后，新修订才成为对应格式的最新公开版本；审核未通过也不会破坏此前已经公开的修订。

如果新修订只包含 V2，审核通过后 Quicker 2.0 可以使用新修订，而 Quicker 1.x 继续停留在此前最后一个包含 V1 的公开修订。网页会将没有 V1 内容的分享标记为“仅 V2”。

安装和检查更新​

Quicker 2.0 检查更新时，优先使用该分享当前可分发的 V2 修订；没有 V2 时，才使用 V1 兼容内容。后来单独发布更高修订的 V1 补丁，不会使已有 V2 分享的用户退回 V1 内容。

2.2.3 修复了从分享链接安装动作时可能读错格式的问题。动作设计器中下载网络共享子程序时，也修复了因格式判断或下载过程异常导致失败的情况。遇到这类问题时，先确认本机 Quicker 版本，再重新打开分享链接或重新下载子程序。

如果新修订要求更高版本的 Quicker，客户端会提示需要升级，而不是悄悄退回到更早的历史修订。升级 Quicker 后，可以再次安装或更新该动作。

Quicker 1.x 只能识别包含 V1 的修订。仅 V2 分享在 1.x 中不会伪装成“动作已删除”；客户端应提示该分享需要 Quicker 2.0 或更高版本。

2.2.11 起，安装确认和动作使用设置统一提供三种更新方式：

方式	行为
不检查更新	不检查该动作的新版本
提示更新	检查并提示，由用户决定是否更新
自动更新	在来源和更新条件满足时自动更新

静默重装、跳过预览的重装会保留原选择；全新静默安装默认提示更新。取消安装确认不会应用新的选择。自动更新仍受分享来源、可分发版本和更新资格限制。

2.2.13 起，可在“场景与动作管理”中集中查看和修改来自统一动作分享的动作更新策略。非统一分享来源的动作不会出现该管理项，避免设置一个实际无法执行的更新方式。

安装标识与副本​

2.2.6 起：

• 作者重装自己的分享：若原动作标识尚未被占用，会尽量恢复原来的动作标识，而不是每次生成一个全新身份。
• 安装信息：安装或更新后，客户端会补全作者、版本和更新说明等展示信息，便于对照分享页。
• 复制动作：复制得到的副本不再沿用原动作的分享关系；需要再次分享时，按新动作单独发布或更新。

批量更新动作针对动作本体，不再依赖它是否放在某个动作页槽位里。

版本历史怎么看​

每次正文更新都会创建新的 revision。网页的版本历史中：

• V1 表示该修订包含 Quicker 1.x 兼容内容；
• V2 表示该修订包含 Quicker 2.0 原生内容；
• 同时显示两个标记表示两代客户端都能使用这个修订中的对应内容。

历史记录还会显示更新时间和更新说明。能否安装某个历史修订，仍取决于该分享的公开状态、登录状态、客户端版本以及该修订是否包含当前客户端可用的格式。

2.2.3 起，预览动作窗口标题会显示当前制品与 revision 版本号。对照用户反馈或旧修订时，可先看标题确认自己正在预览的是哪一种制品和哪一个修订。

分享公共子程序​

公共子程序沿用与普通动作相同的分享身份和版本规则，每个分享有自己的 ID 和 revision。当前子程序分享窗口可以选择是否同时提供 V1 兼容内容；无法生成 V1 或不再支持旧版时，可以取消 V1，仅发布 V2。兼容检查同样适用于子程序。

公开子程序会进入子程序库。动作设计器可以从“网络共享子程序”中搜索并添加它；新建引用使用统一分享身份，以后可以按 revision 获取和缓存对应正文。

分享包含公共子程序的 Quicker 2.0 组合动作时，2.2.3 起会把这些子程序完整内嵌到分享制品中。若旧版组合动作无法安全转换为可用制品，发布会被明确阻止；这比生成一个安装后缺少子程序或无法运行的分享更安全。遇到阻止发布提示时，请先把旧版组合动作迁移或拆分成可转换的内容。

只有能够解决通用需求、没有敏感数据的子程序才适合公开。仅供自己或少数人使用时，可以保持不公开并通过网址传递。

修改只读动作的外观和使用设置​

2.2.11 起，编辑已安装的只读组合动作时，可点击“修改外观和使用设置…”。编辑器关闭后打开设置小窗口，可改标题、图标、关联和更新方式等允许项。

这不会开放作者的步骤正文或运行选项。预览、强制只读视图、暂存草稿和公共子程序没有此跳转入口。保存时若动作已被其它操作更新或删除，会提示冲突并保留当前输入，请重新核对后处理。

用户许可和大小限制​

动作分享窗口提供三种许可：

• 允许修改和再分享；
• 可修改，不可再分享；
• 只读，不可再分享。

“只读”会限制标准客户端中的编辑、复制、导出和再次分享，但不能防止修改版客户端或调试工具绕过。不要把它当作加密或秘密保护措施。

使用普通许可时，每种发布格式的内容上限为 500 KB。动作超过 500 KB 时，可以在动作分享窗口选择“只读”，上限提高到 2 MB。新分享的公共子程序使用普通许可，超过 500 KB 时需要精简内容；更新已有子程序则沿用该分享原来的许可。

客户端按 UTF-8 实际字节数计算并显示大小，不使用网页列表中的历史显示值判断是否允许发布。

旧版 V2 分享​

Quicker 2.1.20～2.2.0 曾使用独立的 V2 分享通道。新版客户端不会再通过该通道新建或更新分享，也不会把旧 V2 内容加入新的公共目录。

为了让已经安装的动作和旧网络子程序继续运行，旧分享在过渡期内仍可按原网址或 ID 读取。作者需要继续维护旧分享时，应使用 Quicker 2.2.1 或更高版本重新分享，使它进入新的统一版本体系。

常见问题​

为什么 Quicker 1.x 找不到这个分享？​

该分享可能只有 V2 内容。请使用 Quicker 2.2.1 或更高版本安装，或请作者重新发布包含 V1 的修订。

为什么 Quicker 2.0 也安装不了仅 V2 分享？​

先确认本机版本。2.2.2 起已修复只有 V2 制品的动作无法安装的问题，2.2.3 还修复了从分享链接安装时可能读错格式的情况。升级后重新打开分享链接，通常比反复下载旧文件更可靠。

为什么改成公开后显示待审核？​

不公开分享本身不进入公共审核。改成公开后，如果作者或动作不符合免审核条件，当前修订需要先通过审核。

为什么作者已经更新，动作库里仍是旧版本？​

新修订可能仍在审核中。审核期间，动作库继续分发此前已经通过的版本。

如果你使用 Quicker 1.x，而作者后续只发布 V2，1.x 会继续使用最后一个包含 V1 的可分发修订。这是保留旧版兼容内容的正常情况。请对照版本历史中的 V1/V2 标记和作者说明，确认新功能是否需要升级 Quicker。

为什么提示升级 Quicker，而不是安装旧版本？​

Quicker 2.0 优先选择当前可分发的 V2 修订；如果它要求更高的客户端版本，会提示升级，不会自动改装更早的 V2 修订或 V1 内容。没有 V2 时，所选 V1 修订也需要满足其最低客户端版本要求。

为什么快速更新要求打开完整分享窗口？​

常见原因是当前动作已经无法生成原分享包含的 V1 格式，或兼容检查存在需要作者确认的警告。完整窗口允许作者查看原因、验证兼容性，并明确决定是否改为仅发布 V2。

不公开分享等于只有作者能下载吗？​

不是。不公开只表示不进入动作库或搜索；持有网址的已登录用户仍可安装。不要在其中保存需要保密的数据。