composer config -g repo.packagist 命令总不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist（非 repos.packagist）、第二参数必须显式指定 composer（type 值）、url 必须 https 且末尾带 /；任一缺失即静默回退官方源，验证需输出完整 json 或 url 并通过 -vvv 日志确认真实请求域名。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但下载还是卡在 Downloading，90% 是因为三个硬性条件漏掉一个：repo.packagist 写成 repos.packagist（多一个 s 就静默忽略）；第二个参数漏掉 composer（这是必需的 type 声明，不是可选注释）；URL 末尾没加 /，比如 https://mirrors.aliyun.com/composer ❌，必须是 https://mirrors.aliyun.com/composer/ ✅。
验证是否真写进去了：运行 composer config -g repo.packagist。输出必须是完整 URL 字符串或 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）。如果为空、null、或仍是 https://packagist.org，说明根本没写成功。
- Windows 用户手动改过
C:\Users\用户名\AppData\Roaming\Composer\config.json？格式错误或权限不足会导致配置被忽略 - Mac/Linux 下执行命令前确认当前用户是谁——
whoami，别用sudo写了root的配置，结果 PHP 进程跑在www-data下根本读不到
如何验证镜像是否真在用
光看 config 输出没用，得看到网络请求打到镜像域名才算数。唯一可靠方式是加 -vvv 看日志。
执行：composer install -vvv 2>&1 | grep "Downloading"，观察输出里的域名。出现 mirrors.aliyun.com 或 mirrors.tuna.tsinghua.edu.cn 才算真正走镜像；如果还是 packagist.org，说明配置被覆盖或根本没生效。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 项目根目录存在
composer.json且含repositories字段时，全局配置会被覆盖——哪怕只写了"repositories": {}也会屏蔽镜像 - 临时绕过所有自定义源测试：
composer install --no-plugins --repository=https://packagist.org -vvv，如果这时反而快了，就是项目配置在作祟
项目级配置比全局更可靠
全局配置容易被权限、用户、Docker 容器环境干扰。项目级配置写进 composer.json，拉代码即生效，行为一致。
进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）。这条命令会自动向 repositories 数组追加 packagist 条目，不破坏已有私有源。
- 如果原
composer.json是"repositories": {}，命令会转成标准数组并插入 - 如果原
"repositories"是数组（如含私有 Git 源），命令会向末尾追加新项 - 改完务必运行
composer update --lock，否则composer.lock仍记录旧源地址，下载时实际不走镜像
换镜像后仍卡在 Resolving dependencies 怎么办
镜像只加速「元数据拉取」和「ZIP 包下载」，不参与依赖解析。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，和镜像无关。
- 常见原因是
composer.lock陈旧，或require版本约束太宽（如"^2.0"），导致回溯搜索过深 - 优先用
composer install恢复已有锁文件，避免无意义的update - 若必须更新，加
-vvv查看卡在哪一步——常见于某个包的dist地址返回404，此时镜像也救不了
最常被忽略的是：镜像只解决网络层问题，不解决本地计算瓶颈；而配置写错一个字符就静默失效，连报错都没有。
