换阿里云或华为云镜像源是解决composer下载慢的首要步骤，需正确配置repo.packagist、确保url结尾有/、执行clear-cache，并通过-vvv日志验证是否真正生效。
直接换阿里云或华为云镜像源，90% 的 Composer 下载慢问题当场解决——不是“试试看”，而是必须做的第一步，且必须配对、配全、配准。
确认当前用的是哪个镜像源
很多人以为配了就生效，其实根本没走镜像。先验证：
- 运行
composer config -g repo.packagist，输出必须是完整 URL，比如https://mirrors.aliyun.com/composer/ - 如果输出是
{"type": "composer", "url": "https://packagist.org"}、null、空值，或压根没反应，说明配置失败 - 常见拼错：
repos.packagist（多一个 s），Composer 会静默忽略，不报错也不生效 - 旧版 Composer（1.x）不识别
repo.packagist，得用composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}'
全局设置阿里云镜像（推荐）
执行这条命令即可立即生效，无需重启终端：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
注意三点：
- 必须带
composer这个 type 值，不能省略 - URL 结尾必须有
/，少写会报Could not parse version constraint - 设完立刻清缓存：
composer clear-cache，否则旧元数据还在，仍会尝试从 packagist.org 拉取
验证是否真走镜像
光看 config 输出不够，要亲眼看到请求发到了镜像域名：
- 运行
composer install -vvv 2>&1 | grep "Downloading" - 日志里必须出现
mirrors.aliyun.com或mirrors.huaweicloud.com才算真正生效 - 如果还看到
packagist.org，说明 fallback 了——可能是项目级repositories覆盖了全局配置，可用composer config --list和composer config --list --global对比确认 - PHPStorm 用户尤其要注意：它调用的是系统 PATH 里的
composer，不是 IDE 自带的；先确认 Settings → PHP → Composer 中的路径是否和终端which composer一致
换了镜像还卡在 Resolving dependencies 怎么办
这个阶段完全不走网络，换镜像毫无作用。卡在这里的真实原因通常是：
-
memory_limit过低（如 128M），导致依赖图解析失败重试 —— 临时加COMPOSER_MEMORY_LIMIT=-1再试 - 启用了 xdebug（运行
php -v可确认），会让解析慢 5–10 倍 —— 用php -d xdebug.mode=off $(which composer) install临时禁用 -
"platform"配置与实际 PHP 版本不匹配（如"php": "7.4"却在 PHP 8.2 上运行），触发降级查找逻辑 -
composer.lock残留已下线包的引用，导致回退搜索 —— 删掉vendor/和composer.lock，再用composer install --no-cache
并发下载配置也容易踩坑：parallel-downloads 已被弃用，新版 Composer（2.2+）只认 http-max-concurrent-downloads，正确命令是 composer config -g http-max-concurrent-downloads 10。
