用途:检查 chengfeng-videocut 剪辑 Skills 在 Codex 官方 Marketplace 的更新情况,并在用户已看到可信版本信息后按需激活。属支持入口,不触碰 Product Runtime、项目、媒体或 live cache。
主要能力:先以只读 --inspect 模式查看,不刷新;用户明确说“检查更新”后,才通过官方 marketplace upgrade 刷新,报告 current/latest、Marketplace 与已刷新事实。更新可用时展示 installed、available、40-hex immutable commit 与发布者 SHA-256,停止等待用户确认,随后才激活。
使用方式:从已启用 Plugin 行的 source.path 定位根目录,确认 .codex-plugin/plugin.json 存在,脚本路径为 scripts/check-plugin-update.cjs。只读检查执行 node "$UPDATE" --marketplace "$marketplaceName" --inspect --json;明确检查更新后执行 node "$UPDATE" --marketplace "$marketplaceName" --json。用户确认后执行带 --activate --confirmed 及 --expected-version、--expected-ref、--expected-sha256 的命令,须在已展示确切版本、ref 与 checksum 之后。激活成功后告知用户重启 Codex。
适用场景:用户说检查更新、检查剪辑 Skills 更新、更新 chengfeng-videocut Skills,或在已展示的可信版本后明确确认激活。
限制:不用于 Runtime 更新、项目数据迁移或静默安装;不发布、不改 Product Runtime、5190、项目数据或媒体。缺 40-hex immutable commit、发布者校验和或 snapshot 清单哈希不一致时结果为 update_metadata_untrusted,裸 semver/tag 不能替代 commit,不下载、不调用 plugin add。本地 marketplace 不可远程刷新时不伪造检查。官方 CLI 无独立 stage 命令,不声称已 stage;无原子版本选择时明确 unsupported,停止且不删 cache、不复制 sources、不重装 Runtime。Plugin 可升级不等于 Runtime 更新,Runtime 最低兼容由 runtime-requirements.json 的 0.2.0 合同控制。