Codex 插件。读、搜不打扰；第一次要改文件时先本地自检，高置信命中弱模型路由就暂停问你。确认后本会话放行，结束时提醒人工检查。另带 $pelican-test / $candy-test 两套手动体检。
最近这段时间，很多人的 GPT / Codex 都在降智。
明着降智还好办——跑一遍体检就能看出来，换个号或者换个模型就行。
麻烦的是另一种：会话还显示原来的模型名，实际已经被静默路由到更弱的模型。 你以为在用 Astra，它已经在用一条明显更笨的路。表现通常不是直接报错，而是：
- 把能跑的项目改坏
- 写出一堆低质量、能编译但逻辑不对的代码
- 你过很久才发现，再回滚已经晚了
社区里已经有糖果题、鹈鹕骑车这类检测方法，但它们是事后体检。真正改文件的时候，没有人站在闸门前面。
所以做了这个插件：写/删发生之前先打卡，命中弱模型路由就停手。
判定口径来自社区公开观察，是启发式，不是鉴定。出处见 docs/background.md。
| 能力 | 说明 |
|---|---|
| 写前闸门 | 高置信命中弱模型路由时，暂停写/删并询问 |
| 不打扰阅读 | 读、搜直接放行，不插入体检题 |
| 手动体检 | $pelican-test / $candy-test，空会话对照正常号和降智号 |
| 本地判定 | 打分在本机完成，不上传代码，不发网络请求 |
| 结束提醒 | 降智会话里真写过东西，才提醒不要直接提交 |
同一件「更新当前分支版本号」的任务：
未降智：闸门放行，任务照常做完。
命中弱模型：写/删暂停，先问你要不要继续。
上面这张里，模型已经把版本号核对完了，但文件一行都没改——插件拦在写之前。回复「继续」本会话放行，或先检查 / 切换模型。
就算开着「完全访问」，闸门仍然有效。Codex 在 bypassPermissions 下会忽略 ask，所以本插件用的是 deny，不是权限询问框。
codex plugin marketplace add Awfp1314/codex-degrade-guard
codex plugin add model-degradation-guard@model-degradation-guard
codex plugin list列表里应能看到 model-degradation-guard，状态为 installed, enabled。
必须信任钩子，否则写前闸门不会运行。 安装或启用都不会自动信任。没点信任时，技能和 MCP 还在，但 UserPromptSubmit / PreToolUse / Stop 会被跳过，等于没装闸门。
- CLI： 新开会话若出现
Hooks need review，选 Review 或 Trust all。也可以输入/hooks，把本插件三条钩子标成信任。 - Codex App： 打开 设置 → 钩子，找到
model-degradation-guard的三条（写前检查、本轮自检注入、结束提醒），全部允许 / 信任。App 不一定弹窗，不进设置就可能被静默跳过。
然后新开一个对话（钩子和技能是会话启动时加载的）。右侧「来源」里应出现 model-degradation-guard。
本地克隆后再装也可以：
git clone https://github.com/Awfp1314/codex-degrade-guard.git
codex plugin marketplace add ./codex-degrade-guard
codex plugin add model-degradation-guard@model-degradation-guard把下面整段复制进 Codex（CLI 或 App 都行）：
请帮我安装 GitHub 上的 Codex 插件 Model Degradation Guard。
仓库：https://github.com/Awfp1314/codex-degrade-guard
插件名：model-degradation-guard
按顺序执行，每步看输出，失败就根据报错修好再继续：
1. codex plugin marketplace add Awfp1314/codex-degrade-guard
2. codex plugin add model-degradation-guard@model-degradation-guard
3. codex plugin list
确认 list 里这一项是 installed 且 enabled。
不要改我的项目代码。
装完后你必须单独提醒我去信任钩子，不能只说「装好了」。用下面这段原话（可略作换行），不要省略：
⚠️ 还没完：必须信任钩子，写前闸门才会生效。
安装不会自动信任。请立刻去设置：
- Codex App：设置 → 钩子，把 model-degradation-guard 的 UserPromptSubmit、PreToolUse、Stop 全部点允许/信任。
- CLI：新开会话若出现 Hooks need review，选 Trust all；或输入 /hooks 把这三条标成信任。
不点的话技能还在，但拦不住写/删。信任后再新开一个对话。
改完仓库要重新安装才生效。重装同一版本号时，若还有 Codex 会话在跑，它拉起的 MCP 进程会占着 ~/.codex/plugins/cache/.../<version>/，安装会报 拒绝访问。把 version 加一位再装更稳妥。
codex plugin marketplace upgrade model-degradation-guard
codex plugin add model-degradation-guard@model-degradation-guard然后新开对话，并重新信任钩子。装过带通知的版本之后，仓库有新版本时对话里会说一句（每个版本一次；几天没更新会再补一句）。不自动安装。设 MODEL_DEGRADATION_GUARD_UPDATE_CHECK=0 可关掉检查。已经装了更早版本、钩子里还没有这段逻辑的，只能按上面两条命令手动升一次。
写前闸门是自动的。想主动看当前号正不正常，在对话里说：
| 技能 | 测什么 | 怎么看 |
|---|---|---|
$pelican-test |
固定原句「鹈鹕骑自行车」，默认 gpt-6-astra / medium，约 8 分钟 | 并排展示未见降智参考图和本次画面，由你自己比对；差很多就是降智 |
$candy-test |
同一道排列组合题跑 5 次 | 正确 ≥ 3 次 → 未见降智；少于 3 次 → 疑似降智 |
两个技能都会另起空会话、消耗真实额度（糖果 5 次 = 5 个空会话）。结果只是参考，不能单独当作「必须停手」的鉴定。
鹈鹕：自己对照参考图。差很多就是降智。
| 未见降智参考（仓库里这一张） | 差很多的例子：人车分离 | 差很多的例子：贴纸风 |
|---|---|---|
 |
 |
 |
糖果：正常号 vs 降智号
| 5/5 正确（≥3 即未见降智） | 0/5 正确（少于 3 次即疑似降智） |
|---|---|
 |
 |
CLI 直接跑：
node probes/pelican.cjs --json
node probes/candy.cjs -n 5 --json用户提问 ──► 每轮注入一次性 token，要求先提交自检
│
├─ 读 / 搜 ──────────────────────────► 直接放行（不打扰）
│
└─ 写 / 删 ─► PreToolUse
├─ 已放行本会话 ──────► 放行（继续检测并记录）
├─ 本轮没提交自检 ────► deny：先调用 submit_check 再写
├─ Tibo 失败 / 组合命中 ► deny + 询问；回复「继续」后本会话不再阻断
└─ 通过 ──────────────► 放行
Stop ─► 降智会话里真的写下了东西，才提醒「这段内容质量可能很低，请勿直接提交」
（首次必提，之后每 5 个降智写入回合或每 30 分钟再提一次）
自检走 MCP 工具 model_degradation_guard.submit_check，不出现在回复正文里。钩子读不到模型思考（transcript 里是密文），所以不能「让它在思考里偷偷打卡」。
| 字段 | 通过 | 失败 / 旁证 |
|---|---|---|
| tibo | 能说出 Thibault/Tibo 属于 OpenAI 或 Codex，且不靠搜索 | 不认识、要去搜、无法确认（单独即暂停） |
| cutoff | 拒答 / refuse，或非 2024-06 |
2024-06 仅旁证 |
| juice | 正整数 | 0 / none 仅旁证 |
暂停条件：Tibo 失败；或 Tibo 含糊 且 cutoff=2024-06 且 juice 为 0/none。
只有截止年金丝雀、Juice 偏低但非 0、上游 capacity 过载，都不暂停。预期答案只活在 lib/score.cjs，注入文案里不出现。
~/.codex/model-degradation-guard/<session_id>.json
| 状态 | 行为 |
|---|---|
unknown / healthy |
写前仍要本轮打卡 |
degraded |
写/删暂停并询问 |
degraded_approved |
本会话不再阻断，只检测并记录 |
overloaded |
只提示过载，不当降智 |
批准只绑当前 session_id。回复「继续」后本会话不再拦工具；降智证据照常记录，交给 Stop 提醒。
降智的表现会变，社区口径也会过期。这个插件要靠大家一起把它补全、跑快、少误报。
特别欢迎这几类贡献：
- 新的检测规则
你发现了可复现的弱模型特征（稳定、能本地判定、不靠搜答案），请带到 Issues 或直接开 PR。写清楚：信号是什么、正常模型怎么答、弱模型怎么答、误报风险。主打分在lib/score.cjs，社区背景在docs/background.md。 - 误报 / 漏报样本
带上codex plugin list、相关会话里插件说了什么、以及node probes/pelican.cjs --json/candy.cjs -n 5 --json的输出。有样本才能收紧规则。 - 性能
写前闸门目标是热路径 不到 50ms、超时 5s、失败放行。探针已经是最多 2 路并行；还能再稳、再快、少占额度的改动都欢迎。 - 平台验证
目前实测是 Windows + Codex CLI 0.150.1 / Codex app 0.154.0-alpha。macOS / Linux 上跑通或踩坑，请开 issue。
本地开发：
git clone https://github.com/Awfp1314/codex-degrade-guard.git
cd codex-degrade-guard
npm test提交信息用 Conventional Commits，摘要用中文，例如 fix(score): 收紧 tibo 含糊判定。设计说明见 docs/design.md。
- 读取：当前会话 rollout transcript，只取本轮 assistant 文本与工具调用。打分全部本地解析。
- 联网：每次用户消息触发时访问 GitHub 上的
plugin.json看有没有新版本；只要本地版本落后，就让模型在回复里持续提醒。失败则静默，不自动安装。MODEL_DEGRADATION_GUARD_UPDATE_CHECK=0可关。 - 写入：
$CODEX_HOME/model-degradation-guard/<session_id>.json（7 天后清理），以及同目录update.json。 - 注入：每轮向模型上下文追加一段自检要求（含一次性 token）；有新版本时另加一句请模型转述。
- 拦截：会对写/删工具返回
deny；回复「继续」后本会话不再拦截。 - 关闭：设置 → 钩子里逐个关，或设
MODEL_DEGRADATION_GUARD_DISABLE=1。
- 判定是启发式，会被统一话术污染；只拦高置信，所以会漏报，也可能误报。
- 体检探针消耗真实额度，只反映启动它们的那个 CLI / 凭据环境。
- 平台细节会变。插件按 Codex 0.150 / 0.154 的行为实现。
.codex-plugin/plugin.json # 清单：skills / hooks / mcpServers
.mcp.json # 体检探针的 MCP 入口
hooks/guard.cjs # 注入、闸门、结束提醒
lib/score.cjs # 本地打分（预期答案只在这里）
lib/state.cjs # 会话状态机
lib/update.cjs # 限频查版本，只通知不安装
probes/ # 鹈鹕 / 糖果
scripts/mcp-server.cjs
skills/ # pelican-test / candy-test
test/
环境变量：MODEL_DEGRADATION_GUARD_STATE_DIR、MODEL_DEGRADATION_GUARD_DISABLE、MODEL_DEGRADATION_GUARD_UPDATE_CHECK（0 关掉版本检查）、MODEL_DEGRADATION_GUARD_CODEX_BIN、MODEL_DEGRADATION_GUARD_PROBE_TIMEOUT_MS、MODEL_DEGRADATION_GUARD_PELICAN_TIMEOUT_MS（默认 12 分钟）、MODEL_DEGRADATION_GUARD_WARN_EVERY_TURNS、MODEL_DEGRADATION_GUARD_WARN_MIN_INTERVAL_MS、MODEL_DEGRADATION_GUARD_RUN_TIMEOUT_MS。状态目录跟随 CODEX_HOME（默认 ~/.codex）。
.mcp.json 的 cwd 必须写 ./。${PLUGIN_ROOT} 在这里不会被展开。
实现上几处取舍（都有实测依据）：暂停用 deny 不用 ask；自检走 MCP 不走正文；结束提醒用 Stop 的 block 让模型转述；放行覆盖整个会话、不再重复询问。细节见 docs/design.md。
变更见 CHANGELOG.md。
MIT © HUTAO667
GitHub · Issues · X @HUTAO667
如果这个插件帮你拦住过一次偷偷换模，欢迎点 Star，也欢迎把新的检测规则开过来。