全局镜像配不生效主因是写入错误用户配置文件或被项目级composer.json中repositories字段覆盖；必须用composer config -g写入~/.composer/config.json，URL末尾需加/，且执行composer clear-cache后验证。
全局镜像配不生效，八成是写到了错的用户配置文件里，或者被项目级 composer.json 里的 repositories 覆盖了。直接用 composer config -g 写入 + 清缓存，是最稳的路径。
Mac 上必须用官方脚本装 Composer，别碰 brew install composer
Homebrew 的 composer 包自 2023 年起已被官方弃用，M1/M2 上尤其容易出问题：命令找不到、权限拒绝、版本卡在 v2.2.x、甚至 PHP 架构错配。可靠做法只有这一种：
- 先确保 PHP 已装且可用：
brew install php，然后php -v应输出 8.2+，which php返回/opt/homebrew/bin/php（M 系列）或/usr/local/bin/php（Intel） - 运行安装脚本：
curl -sS https://getcomposer.org/installer | php，当前目录生成composer.phar - 移动并赋权：
• M1/M2：sudo mv composer.phar /opt/homebrew/bin/composer && sudo chmod +x /opt/homebrew/bin/composer
• Intel：sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer - 验证：
composer --version输出 v2.7.x 才算成功
全局镜像必须用 composer config -g 写入，路径和格式不能错
全局配置只认一个文件：~/.composer/config.json（Linux/macOS），其他地方写的全无效。常见错误是用 sudo 运行导致写进 /root/.composer/config.json，而你的终端或 Web 服务以普通用户运行，根本读不到。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 正确命令（阿里云源）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 键名必须是
repo.packagist（不是repos、不是packagist.org） - URL 末尾的
/不能省，缺了会 404，Composer 静默回退到官方源 - 执行后检查：
cat ~/.composer/config.json，确认内容含"repo.packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
配完还是走 packagist.org？先查项目级 composer.json
Composer 加载顺序是：项目 composer.json > 全局 config.json > 默认值。哪怕项目里只写了 "repositories": [] 或 {"packagist.org": false}，全局镜像就彻底失效。
- 进项目目录，搜
repositories字段：grep -n "repositories" composer.json - 临时禁用项目源：
composer config --unset repositories - 清缓存：
composer clear-cache - 验证是否生效：
composer require monolog/monolog -vvv，看日志里请求的是不是mirrors.aliyun.com - Laravel 脚手架等模板常硬编码源，首次
create-project就得加参数：composer create-project laravel/laravel demo --repository-url=https://mirrors.aliyun.com/composer/
最易忽略的点：全局配置文件权限不对，或项目里 repositories 字段存在但为空对象——这种“空覆盖”比完全没配还难排查。
