用途:按需让机器上真正会加载的 Claude Code 插件保持为 marketplace 发布的最新版本,覆盖用户作用域,以及当前所在仓库的 project/local 作用域安装,并暴露实际运行的是较旧或非预期版本的状况。
与 CC 自带 autoUpdate 的区别:autoUpdate 只在会话启动时按自身计划静默刷新 marketplace 数据并升级已安装插件,不会安装新目录插件,不检查 enabledPlugins 完整性,不检测或报告作用域分歧,也不支持按需运行。
主要动作:sync(默认,会变更状态,仅通过 CLI 操作);audit(只读预演,把每个变更调用替换为“would run: <命令>”,不发出任何变更调用);converge(唯一可触碰已提交 .claude/settings.json 的动作,先逐插件预览意图并确认)。无参数时对默认 marketplace 执行 sync;help 或无法识别的动作显示动作表。
用法要点:解析 $ARGUMENTS,第一个词为动作,第二个词可选 marketplace 名称或 all。默认 marketplace 由 fleet-state.sh 动态解析(claude-ops 自身安装来源),不硬编码;all 覆盖 known_marketplaces.json 中全部,单个失败内联报告不中断。所有动作先调用只读脚本:"${CLAUDE_PLUGIN_ROOT}"/skills/plugins/scripts/fleet-state.sh [--marketplace <name> | --all],不要手工解析或写入内部 JSON。解释输出前需阅读 context/scope-semantics.md,其中 divergences[].versionsMatch 用于区分同版本多作用域安装(正常)与真实版本偏差。新插件安装策略由 userConfig install_new 控制,默认 ask,可选 all 或 none;未设置时会渲染为字面占位符,按默认 ask 处理,不算无效值。报告为固定精简分节,仅在需要行动处给出细节;结束建议默认裸执行 /reload-plugins,仅当更新组件含不延迟的 MCP 服务器工具时建议 --force;若含 monitor 需单独指出并需重启会话。已知限制:enabledPlugins 各作用域逐项不一致属盲区,脚本只暴露合并后的有效值,无法检测。