composer镜像配置失效主因是键名错（应为repo.packagist单数）、缺type值“composer”、url末尾无/，三者任一出错均静默回退官方源；且项目级repositories字段会完全屏蔽全局配置。
Composer下载卡在 Downloading，不是镜像没配，而是 zip 包还在直连 github.com——配了阿里云镜像却没提速，八成是这个原因。
composer config -g repo.packagist 命令为什么总不生效
这条命令写错任意一个字符都会静默失败，不报错、不提示，但实际没写进配置。必须同时满足三个硬性条件：
-
repo.packagist不能写成repos.packagist（多一个s就完全无效） - 中间的
composer是type值，不可省略，也不能替换成https或其他字符串 -
url必须是 HTTPS 协议，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或报 Key does not exist，说明根本没写进去。
为什么配了镜像还是从 github.com 下载 zip
Packagist 镜像只代理元数据（包名、版本、依赖关系），不托管实际 zip 包。Composer 默认仍从 github.com 拉取 dist 文件，这才是卡顿主因。
- 日志里看到
Downloading https://api.github.com/或Downloading https://codeload.github.com/，说明 zip 路径没被替换 -
composer.lock里已固化旧的 dist URL，哪怕你改了镜像，Composer 也会照单执行，无视新配置 - 临时加
--repository参数只影响元数据获取环节，对 lock 文件里的 dist 地址完全无效
真正起效的做法是：删掉 composer.lock 和 vendor/，再跑 composer install；或在 composer.json 中为特定包显式指定 dist 地址（适用于高频更新的私有包）。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
宝塔、CI、多用户环境里镜像为啥不生效
全局配置写在 ~/.composer/config.json，但它只对执行命令的用户生效。宝塔默认用 www 用户跑 PHP，GitHub Actions 用 runner 用户，它们读不到你本地 root 的配置。
- 先确认实际执行用户：在宝塔终端运行
whoami，或查 CI 日志里的 UID - 给对应用户单独配：比如是
www用户，就执行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级配置更可靠：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动安全写入composer.json的repositories字段
注意：composer.json 里已有 "repositories": {} 时，命令会自动转为数组格式并追加；如果是 "repositories": []，命令会向数组末尾插入，不破坏原有私有源。
如何验证镜像是否真正起作用
别只看 composer config -g 输出，要观察真实网络请求：
- 加
-vvv运行命令：composer install -vvv | grep "Loading composer repositories"，输出应含你设置的镜像域名，而非packagist.org - 再检查下载阶段：
composer install -vvv | grep "Downloading"，确认 URL 是mirrors.aliyun.com或codeload.github.com的代理地址（如https://ghproxy.com/） - 若仍见
api.github.com，说明 zip 包路径没绕过，得清理 lock 文件或部署ghproxy类反向代理
最易被忽略的一点：镜像同步有 5–30 分钟延迟，新发布的包可能还没同步到镜像站，此时 Composer 会 fallback 到官方源拉取元数据——这不是配置问题，是时间差。
