Composer镜像源配不生效主因是composer config -g repo.packagist未满足三硬性条件：键名必须为单数repo.packagist（非repos或packagist.org）、第二参数必须显式写composer（type值）、URL必须以/结尾且为HTTPS；缺一即静默回退官方源。
Composer 镜像源配不生效，不是网络慢，而是根本没走镜像——90% 的配置失败，是因为 composer config -g repo.packagist 命令漏了三个硬性条件，Composer 2.x+ 会静默 fallback 到 https://packagist.org，连报错都没有。
为什么 composer config -g repo.packagist 总是不生效
这条命令看似执行成功，但 Composer 内部校验极严，缺一即失效：
-
repo.packagist必须是单数、全小写、无 s；写成repos.packagist或packagist.org都会被忽略 - 第二参数必须显式写
composer，它是type值，不是注释或可选项 - URL 必须是 HTTPS 且末尾带
/：例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼出/composerpackages.json导致 404） - 必须加
-g，否则只改当前项目composer.json，换目录就失效
验证是否真写进去了，只看这一条命令输出：composer config -g repo.packagist。正确结果必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报 Key not found，或只返回字符串，说明全白配了。
repositories 数组里配镜像为什么没用
Composer 2.2+ 开始，官方包元数据（packages.json、p2/xxx.json）请求完全绕过 repositories 数组，直连硬编码的 repo.packagist.org。你在 composer.json 里加：
"repositories": [
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
]
——这根本不会接管元数据请求，只对私有 VCS 源有效。
真正能覆盖元数据入口的，只有全局配置：composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/。它修改的是 Composer 内部的 base URL，后续所有 provider 查询都发往镜像站。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
项目级配置若想生效，必须满足两个前提：
- 先确保
composer.json顶层没有"packagist.org": false这类屏蔽项 - 运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动写入repositories并设为首位
换源后仍卡在 Loading composer repositories 怎么办
这不是镜像没同步，而是 Composer 还在读旧缓存和旧 composer.lock：
- 先清本地缓存：
composer clear-cache - 手动删掉项目下的
vendor/和composer.lock - 再跑
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或mirrors.ustc.edu.cn - 如果日志里还是
packagist.org，说明镜像根本没走通，回头检查前两个副标题里的硬性条件
注意：composer update 没用——它照着旧 composer.lock 里的 dist URL 下载，不会重新解析元数据源。
镜像同步滞后导致 404 怎么判断
国内镜像不是实时全量同步，而是“首次请求触发拉取”。你遇到 Could not fetch p2/laravel/framework/10.0.0.json，可能只是该版本还没被镜像站缓存：
- 用
curl -I https://mirrors.aliyun.com/composer/p2/laravel/framework/10.0.0.json看是否返回 200 - 对比官方源：
curl -I https://repo.packagist.org/p2/laravel/framework/10.0.0.json - 如果官方有、镜像返回 404 或空响应，说明暂未同步，可临时切中科大源：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/
新包通常延迟 1–2 小时，别急着换源，先确认是不是本地环节出问题——比如缓存没清、URL 少斜杠、或 repo.packagist 键名拼错。
