Composer config -g repo.packagist未生效是因为键名必须为单数repo.packagist、type值必须显式写composer、URL须HTTPS且末尾带/，三者缺一即静默回退官方源；验证需输出完整JSON对象，且项目级repositories字段会完全覆盖全局配置。
composer config -g repo.packagist 命令为什么没写进去
不是命令报错，是它压根没生效——Composer 2.x 对这个配置有三个硬性门槛，漏一个就静默 fallback 到 https://packagist.org，连 warning 都不给。
-
repo.packagist必须是单数，写成repos.packagist或repositories.packagist.org都无效 - 中间那个
composer是type值，不是可选参数，也不是注释：正确写法是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 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、报 Key not found，说明配置失败，立刻重试。
项目里配了 repositories 却还是走官方源
只要 composer.json 顶层存在 "repositories" 字段，全局镜像就完全失效——这不是优先级低，是 Composer 直接跳过全局配置。
- 哪怕
"repositories": {}这种空对象，也会触发“禁用默认源”逻辑 - 搜一下项目里有没有
"packagist.org": false或"packagist": false，这种写法会彻底关掉回退机制，镜像一挂就全崩 - 运行
composer config repo.packagist（不加-g），如果返回空或报错，说明项目配置已接管；如果有输出，说明你写的镜像地址就在composer.json里
安全做法是手动编辑 composer.json，确保 "repositories" 是数组格式，并把阿里云镜像放在首位：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，已有私有 Git 源保留在同一数组中即可。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
换镜像后 install 还是卡在 Downloading 或报 hash 不匹配
不是镜像慢，是旧缓存和旧 lock 文件还在按老路径找包——Composer 不会自动适配新源的内部路径映射。
- 删掉
vendor/和composer.lock：否则composer install仍会尝试从旧 dist URL 下载 ZIP，校验必然失败 - 清缓存：
composer clear-cache，再手动删掉~/.composer/cache/repo/https---packagist.org/（Linux/macOS）或%APPDATA%\Composer\Cache\repo\https---packagist.org\（Windows） - 改完必须跑
composer install（不是update），让 Composer 从头解析依赖、生成适配新镜像的 lock 文件
临时验证是否真走镜像：加 -vvv 参数，composer install -vvv 2>&1 | grep "Downloading"，日志里出现的域名必须是你配的镜像地址，比如 mirrors.aliyun.com。
宝塔、CI、Docker 里镜像为啥不生效
全局配置写在 ~/.composer/config.json，但它只对当前用户生效。宝塔后台默认用 www 用户执行，CI runner 用的是 runner 用户，Docker 容器里甚至没有这个路径——你配的镜像它根本读不到。
- 宝塔环境：先确认 PHP CLI 实际运行用户（比如
whoami），再用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - GitHub Actions 等 CI：不能依赖全局配置，需在 workflow 中显式设置
COMPOSER_HOME，或直接用--repository-url参数临时指定：composer install --repository-url=https://mirrors.aliyun.com/composer/ - Docker 构建时：在
Dockerfile中用RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，并确保该命令在非 root 用户上下文中执行（如USER www-data后再运行）
最稳的方式其实是项目级配置：进项目目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/，然后提交 composer.json 到 Git——团队成员拉代码后行为一致，不用猜谁的环境配对了没。
