Composer镜像配置失效的主因是命令错误：必须用-g、键名严格为repo.packagist（单数小写无s）、URL以https://开头且末尾带/，三者缺一即静默回退官方源；验证需输出完整JSON对象。
composer config -g repo.packagist 命令总不生效？检查这三处
不是镜像挂了，是命令写错了——漏 -g、键名写成 repos.packagist、URL 缺末尾 /，任一出错都会静默 fallback 到 packagist.org，且完全不报错。
-
repo.packagist必须是单数、全小写、无s；写成repos.packagist或repositories.packagist都存进无效字段 - 中间那个
composer是必填的type值，不是注释：漏掉就等同于没配 - URL 必须 HTTPS 开头 + 末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径成/composerpackages.json导致 404）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没配对。
阿里云/腾讯云/华为云镜像地址怎么填才对
不同镜像 URL 格式差异大，尤其华为云含 /repository/php/，不能直接套用阿里云模板。别手敲，复制粘贴执行（注意空格和斜杠）：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/ - 清华源（教育网优选）：
composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
中科大源仍可用：https://packagist.mirrors.ustc.edu.cn/，但同步延迟略高；旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host 或 cURL error 60。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
换完镜像还是卡在 “Loading composer repositories”？排查顺序
这不是镜像响应慢，而是请求根本没发出去——大概率被更高优先级配置拦截了。按顺序查：
- 分别运行
composer config -g repo.packagist和composer config repo.packagist，看哪一层实际生效 - 检查项目
composer.json是否含"packagist.org": false、"packagist": false或空数组"repositories": []—— 这些会彻底屏蔽镜像 - 临时验证镜像服务是否可达：
curl -I https://mirrors.aliyun.com/composer/packages.json，返回200 OK才算正常 - Windows 用户注意：PowerShell 和 CMD 的环境变量不共享，改完配置后务必新开终端再验证
冷门包装不上？别硬等镜像同步
阿里云、腾讯云等镜像只同步热门包，冷门或新发布包可能延迟数小时甚至不收录。确认方式：直接访问镜像搜索接口，如 https://mirrors.aliyun.com/composer/p/phpstan/phpstan-deprecation-rules/，返回 404 就说明没同步。
- 临时切回官方源最安全：
composer config repositories.packagist --unset，再跑composer require phpstan/phpstan-deprecation-rules - 或者单次命令指定源：
composer require phpstan/phpstan-deprecation-rules:^1.0 -d'{"repositories": {"packagist.org": {"type": "composer", "url": "https://packagist.org/"}}}' - 长期项目可设兜底策略：在
composer.json中保留官方源为"canonical": false的备用源，不覆盖主镜像
镜像同步延迟是服务端行为，你控制不了；能控制的是——别把“等同步”当成“配错了”，也别让 composer.json 里的 repositories 字段变成全局镜像的单点故障。
