chengfeng-check-updates

1# 检查更新（环境总管）
2 
3环境的一切逻辑只写在本 Skill：skills 版本、Runtime 安装与体检。业务 Skill 第 0 步
4一行引用下面的「就绪检查」，自己不带任何环境逻辑——环境策略要变，只改这一个文件。
5本 Skill 不建项目、不打开 Studio、不转录任何媒体。
6 
7## 就绪检查（业务 Skill 的第 0 步从这里执行）
8 
9三步走完，输出三态之一：**就绪 / 需新会话 / 停**。
10 
11### 一、定位当前 Plugin cache（只读）
12 
13从 host 提供的**本 Skill 实际源文件路径**定位：本文件所在目录向上两级就是
14`<插件根>`。用文件读取工具确认 `<插件根>/.codex-plugin/plugin.json` 与
15`<插件根>/scripts/check-plugin-update.cjs` 都存在。路径不可取得、目录层级不符或
16文件不存在时，以 `installed_identity_missing` 停止更新比较；不得调用用户
17`CODEX_HOME` 下的 `codex plugin list` 补猜，也不得搜索整个磁盘。
18 
19**此后所有命令里的 `<插件根>` 都代入这个字面路径**（含空格时整段引号包住）。
20命令块不用 shell 变量与命令替换——bash 和 PowerShell 的赋值语法互不兼容。
21检查脚本会从自己所在的 cache 直接读取 installed manifest、provenance、Marketplace
22exact revision 与 bundle digest；检查阶段不依赖用户 Marketplace CLI 输出。
23 
24### 二、skills 最新吗
25 
26```bash
27node "<插件根>/scripts/check-plugin-update.cjs" --marketplace chengfeng-videocut --json
28```
29 
30（Marketplace 名默认 `chengfeng-videocut`；用户自己配过别的名字就用他配的。）
31 
32- `current` → 继续第三步
33- `update_available_confirmation_required` → 展示 `installed`、`candidate` 与候选四项：
34  version、40-hex `snapshotRevision`（B）、40-hex `contentRevision`（A）、
35  `publisherChecksum`（SHA-256），停下等用户确认；确认后走下面「激活」节。
36  激活成功 = **需新会话**：会话开始时 skill 文本已载入，中途更新对本会话不生效，
37  请用户新开会话再继续任务
38  - 若同时有 `legacyInstalledIdentity=true`，说明这是历史 0.10.5 到新证明格式的
39    一次性兼容迁移；仍使用同一确认门，不要求用户预先修改 Marketplace ref
40- `marketplace_not_found` / `marketplace_source_untrusted` /
41  `marketplace_ref_unsafe` → 当前用户 Marketplace 缺失、来源不可信或不是 exact
42  40-hex pin；不调用用户 Codex CLI 修复，报告后继续第三步
43…