用途:检查 chengfeng-videocut Skills 的 Marketplace 更新,并在用户已看到确切版本、ref 与 checksum 后经明确确认才激活。不用于 Runtime 更新、项目数据迁移或静默安装。
主要能力与用法:先用 Codex 官方命令定位已启用插件根目录,仅允许从 Plugin 行的 source.path 获取,随后运行本地脚本 inspect;inspect 不刷新。用户明确说“检查更新”后,才执行带 --marketplace 与 --json 的刷新检查。结果可能是 current、update_available_confirmation_required、marketplace_not_refreshable、update_metadata_untrusted 等。激活必须发生在用户已确认 exact available version、ref、checksum 之后,通过 --activate --confirmed 并传入 --expected-version、--expected-ref、--expected-sha256;脚本用官方 marketplace upgrade 刷新快照、重算文件清单 SHA-256 并比对,之后才用官方 plugin add,再从 installed cache 复读版本、immutable ref、publisher SHA-256 并重算同一 digest,四项一致才报告 activated。激活成功后需重启 Codex。
限制:本地 marketplace 不视为可远程更新;缺 40-hex immutable commit 或发布者校验和时结果为 update_metadata_untrusted,裸 semver/tag 不可替代 commit,也不下载或调用 plugin add;官方 CLI 无独立 stage 命令,不声称已 stage;出现 refresh/parse/version 错误保留结构化 JSON 并停止,不复制目录、不删除 cache;plugin_activation_unsupported 时停止,不模拟升级。Plugin 可升级不等于 Runtime 更新,Runtime 兼容由 runtime-requirements.json 的 0.2.0 合同控制。