直接运行composer self-update常失败，主因是镜像源缓存误判版本、权限不足导致写入失败、或跨主版本（如2→3）被默认禁止；需临时切官方源、改用户级安装、或用--3参数升v3。
直接运行 composer self-update 就能升级，但大概率会失败或“升了个寂寞”——不是命令不对，而是你没绕开权限、镜像、主版本锁定这三道坎。
为什么 composer self-update 显示 “Up to date” 却不是最新版？
国内用户最常踩的坑：你配了阿里云或腾讯云镜像源（https://mirrors.aliyun.com/composer/），但 self-update 会把镜像当“官方”，缓存旧响应，误判版本。它根本没连上 https://getcomposer.org/。
- 先临时切回官方源：
composer config -g repo.packagist composer https://packagist.org - 再执行：
composer self-update - 升级完立刻换回镜像（推荐阿里云）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否真生效：
composer --version，别只信“Updated”输出
Permission denied 或 Could not write to /usr/local/bin/composer 怎么办？
这不是 Composer 的 bug，是你当前用户没权限写入系统路径。硬加 sudo composer self-update 看似解燃眉之急，但下次更新还会卡住，且可能破坏插件加载逻辑。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 查安装位置：
which composer；再看是不是软链接：ls -l $(which composer) - 优先改用用户级安装：
curl -sS https://getcomposer.org/installer | php -- --install-dir=$HOME/bin --filename=composer - 确保
$HOME/bin在$PATH中靠前（检查echo $PATH，必要时加到~/.bashrc或~/.zshrc） - Windows 用户别用 GUI 安装版，改用手动下载
composer.phar放进C:\Users\YourName\bin\，再配PATH
想升 v3，但 self-update 没反应？
v2 和 v3 不兼容，self-update 默认策略就是拦住跨主版本升级。它不会自动从 v2.8.x 跳到 v3.x，哪怕 v3 已正式发布（截至 2026 年 4 月已稳定）。
- 升到最新 v3：
composer self-update --3（注意是两个短横线 + 数字 3，不是--preview或--snapshot） - 退回 v2 最新版：
composer self-update --2 - 确认当前支持哪些通道：
composer self-update --list（需 Composer ≥ 2.5） - v3 会重写
composer.lock格式（移除content-hash），老项目首次用 v3install可能报错The lock file does not contain require-dev information，此时得删掉composer.lock重建
真正容易被忽略的是签名验证和 PATH 冲突：Composer 2.2+ 默认启用 GPG 校验，代理或网络拦截导致签名不匹配，更新会静默中止；升级后 composer --version 显示正常，但实际调用的可能是旧二进制（尤其 Windows 缓存或 Linux shell hash 缓存），记得跑 hash -d composer（bash）或重启终端。
