升级 Compound Engineering 前如何先刷新 marketplace 再更新插件以避免停留在旧版本-港品优选

升级 Compound Engineering 前如何先刷新 marketplace 再更新插件以避免停留在旧版本

【免费下载链接】compound-engineering-pluginOfficial Compound Engineering plugin for Claude Code, Codex, Cursor, and more项目地址: https://gitcode.com/GitHub_Trending/ev/compound-engineering-plugin

如果你在安装 Compound Engineering（CE）时使用的是迁移前的布局，现在直接运行“更新插件”命令，命令可能正常结束，但技能仍然停留在旧版本。原因在 docs/install/upgrading.md 中写得很明确：CE 已经迁移到 root-native、skills-only 布局，而旧安装留下的 host 端仍保留一份缓存的 marketplace 快照，这份快照还指向旧的plugins/compound-engineering路径。只执行插件更新时，host 读取的就是这份陈旧快照，于是更新形同虚设。

README 的安装区也有一条醒目的警告：已经安装过 Compound Engineering 的用户，必须先刷新 marketplace，再更新插件。本文按你实际使用的 host 给出这两步的具体命令，以及旧安装路径可能遗留的两处需要清理的内容。

适用前提

你已经通过 marketplace 安装过 Compound Engineering，且安装时间早于 root-native、skills-only 布局的迁移。
你知道自己当时用的哪个 host（Claude Code、Codex CLI、Codex App、Grok Bot 等），命令按 host 选择，不要混用。
全新安装不走本文流程，见 README 的 Install 一节。

Claude Code：两条命令的顺序不能颠倒

在 Claude Code 中依次执行：

/plugin marketplace update compound-engineering-plugin /plugin update compound-engineering

第一步刷新的是名为compound-engineering-plugin的 marketplace 缓存快照；第二步才让插件compound-engineering基于新快照更新。如果只跑/plugin update compound-engineering，结果就是停留在旧版本——这是 README 警告的直接后果，也是本文标题要解决的整件事。

Codex CLI：没有 update 子命令，用 add 重装

codex plugin marketplace upgrade compound-engineering-plugin codex plugin add compound-engineering@compound-engineering-plugin

Codex CLI 没有codex plugin update；重跑add就是从刷新后的快照重新安装。如果你使用非默认 profile，两条命令必须针对同一个CODEX_HOME执行。README 给出了针对workprofile 的示例（该示例是首次注册场景，升级时把marketplace add换成marketplace upgrade即可，其余保持同一CODEX_HOME）：

CODEX_HOME="$HOME/.codex/profiles/work" codex plugin marketplace add EveryInc/compound-engineering-plugin CODEX_HOME="$HOME/.codex/profiles/work" codex plugin add compound-engineering@compound-engineering-plugin

marketplace 步骤只让插件对该 profile 可见，第二条命令才真正激活原生 CE 技能。

Codex App：在 Plugins 面板刷新

Codex App 走界面操作：

在Plugins面板刷新 marketplace；如果面板没有刷新控件，就把EveryInc/compound-engineering-plugin这个 marketplace 删除后重新添加。
重新安装compound-engineering。
重启 Codex。

Grok Bot：在 Cursor 账户里更新

Grok Bot 本身复用你的 Cursor 账户和插件库，所以更新操作发生在 Cursor 侧：在 Cursor Agent 聊天中执行/add-plugin compound-engineering，或在插件市场搜索 “compound engineering” 重装。之后 Grok Bot 会从共享插件库加载新快照。文档同时提醒：普通更新不要把本仓库 clone 到 Grok Bot 所在的机器上。

其他 host 的更新命令

README 的 “More Install Options” 一节为下列 host 给出了明确的更新方式：

Host	更新命令	文档给出的附带说明
Devin CLI	`devin plugins update compound-engineering`	插件在会话启动时加载，更新后开新会话；可用`devin plugins list`和`devin plugins info compound-engineering`查看安装状态
Grok Build CLI（`grok`）	`grok plugin update`	该安装路径直接跟踪仓库，更新后开新会话使技能加载
oh-my-pi（omp）	`omp plugin upgrade compound-engineering@compound-engineering-plugin`	也可以执行`omp config set marketplace.autoUpdate auto`开启自动更新；默认`notify`模式只把“可更新”写入 debug log，不会提示

如果更新后技能仍像旧版本：清理两处旧安装遗留

docs/install/upgrading.md 除了刷新顺序，还覆盖两类“旧安装路径遗留物”。这两处都会让旧技能继续干扰新安装，属于升级流程的收尾，只在出现对应症状时处理。

旧 Bun 安装副本遮蔽原生插件技能

文档给出的判定条件是：“如果之前 Bun 安装的副本仍在遮蔽原生插件技能”，就从这个仓库的一份 checkout 中运行官方 cleanup 命令：

git clone https://github.com/EveryInc/compound-engineering-plugin.git /tmp/compound-engineering-plugin-cleanup cd /tmp/compound-engineering-plugin-cleanup bun install bun run cleanup --target all

副作用说明：第一条命令会发起网络下载，在本机/tmp/compound-engineering-plugin-cleanup创建一个临时 checkout；整套命令需要本机已安装 Bun。--target all表示遍历所有受支持的 host 目录。cleanup 命令本身的定位是“备份旧安装遗留的过期 compound-engineering 产物”（见 cleanup 命令实现），它按清单识别 CE 写入过的过期技能、prompt 等文件并移入备份目录，而不是直接删除。

移除遗留的 Codex tool map（仅 pre-native 安装）

如果你早年通过 Bun 的convert/install --to codexCLI 安装过 CE，那条路径可能往你的全局Codex 指令文件$CODEX_HOME/AGENTS.md（默认~/.codex/AGENTS.md）插入了一个受管代码块：

<!-- BEGIN COMPOUND CODEX TOOL MAP --> … <!-- END COMPOUND CODEX TOOL MAP -->

文档说明这份 Claude 兼容 tool map 已废弃——CE 技能现在直接在行内标注 Codex 工具名——且其中一行还错误地指示 Codex 把 subagent 派发折叠到主线程。原生插件安装不会添加这个块。文档给出的处理方式是，把下面这段指令粘贴给 Codex（或任何能访问你主目录的 agent）：

Remove the obsolete Compound Engineering Codex tool-map block from my Codex home AGENTS.md. 1. Check `$CODEX_HOME/AGENTS.md` if CODEX_HOME is set, otherwise `~/.codex/AGENTS.md`. 2. Delete the managed block: the line `<!-- BEGIN COMPOUND CODEX TOOL MAP -->` through the next line `<!-- END COMPOUND CODEX TOOL MAP -->`. If that pair is not present as two whole lines in that order, the block is not there -- change nothing. 3. Leave the rest of the file untouched, and delete the file if nothing is left. Do not add a replacement tool map, and do not edit project/repo AGENTS.md. 4. Show a short before/after summary of what you changed (or say the block was already absent).

最后一条就是验证方式：agent 会报告改动前后的摘要，或说明该块本来就不存在。另外，如果该块仍在，重跑 Bun 的 convert/install CLI 也会把它移除，且不再插入新块。

判断是否升级成功，以及最后的边界

文档给出的核心判断方法很直接：更新后如果技能行为仍是旧版本，先回到第一步检查 marketplace 快照是否真的刷新了，而不是重复执行插件更新命令。各 host 还有各自的生效条件：Codex App 需要重启 Codex；Devin CLI、Grok Build CLI、omp 都需要开新会话，插件才会在会话启动时按新版本加载。

最后一种情况：如果你的 host 当初是用指向plugins/compound-engineering下的 direct path 或 sparse path 配置的，刷新 marketplace 也解决不了路径指向问题——需要编辑或重装该 source，让它指向仓库根目录且不带 sparse path。其余各 host 的完整刷新命令以 docs/install/upgrading.md 为准。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析