根本原因是三个硬性条件缺一不可：键名必须为单数repo.packagist、type值必须显式写composer、URL须HTTPS且末尾带/；任一缺失即静默回退官方源，且不报错。
composer config -g repo.packagist 命令为什么总不生效
根本原因不是网络或权限，而是 Composer 3.x+ 完全忽略 repositories 数组里的 packagist 类型源——它只认全局配置项 repo.packagist，且必须严格满足三要素：-g 参数、键名是 repo.packagist（单数，不能是 repos.packagist）、url 值前必须带 composer type 标识。
常见失效组合：
-
composer config -g repos.packagist composer https://...→ 多了个s，静默忽略 -
composer config -g repo.packagist https://...→ 缺composertype， fallback 到默认源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ 少末尾/，后续请求拼出/packages.json导致 404
验证是否写入成功，只看这一行输出：composer config -g repo.packagist，正确应返回完整 JSON 对象，不是空、null 或报错。
镜像同步延迟导致 Could not fetch packages.json 怎么办
这不是网络故障，是镜像站“按需拉取”机制下的正常现象：只有首次被访问的 provider 文件（如 p2/laravel/framework/10.0.0.json）才会触发反向同步。官方源已有，镜像返回 404，就说明该文件尚未缓存。
快速验证和切换策略：
- 用
curl -I https://mirrors.aliyun.com/composer/p2/laravel/framework/10.0.0.json测响应；若 404，再比对curl -I https://repo.packagist.org/p2/laravel/framework/10.0.0.json - 阿里云镜像通常延迟 5–10 分钟；腾讯云、华为云、中科大源同步更及时，可临时切：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - CI 脚本中不要依赖“刚配好就立刻能用”，建议加
sleep 10或预热请求（如curl -s https://mirrors.ustc.edu.cn/composer/packages.json > /dev/null）
项目级配置比全局更可靠，但要注意 repositories 结构
全局配置在 CI、Docker、多用户环境里极易失效——GitHub Actions 用 runner 用户运行，-g 配的是你本地用户的 COMPOSER_HOME；而项目级配置直接写进 composer.json，可 Git 跟踪、环境一致。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
执行命令：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带 -g）
但它有个隐性前提：当前 composer.json 的 repositories 必须是对象结构（{}），不是数组（[]）。否则会覆盖整个数组，误删私有源。
安全做法：
- 先检查：
jq '.repositories' composer.json，确认结构 - 若已是数组，手动编辑，在首位插入：
{"packagist.org": false}和镜像源对象 - 或者用
composer config --unset repositories清空后重设（仅适用于无私有源项目）
自建镜像系统必须处理 OSS + Redis + 同步触发逻辑
阿里云开源的 packagist-mirror 不是简单 rsync，它依赖三个核心组件协同工作：OSS 存储元数据和 ZIP 包、Redis 管理任务队列与状态、Golang 同步器监听变更并拉取。
关键配置项不能错：
-
DATA_URL必须是上游镜像地址，且以/结尾，例如https://mirrors.aliyun.com/composer/ -
MIRROR_URL是你对外暴露的域名，Nginx 必须将请求代理到本地服务端口，不能直接静态托管 OSS -
GITHUB_TOKEN用于拉取 GitHub 托管的 dist 包，权限至少含public_repo，否则大量dist请求会限流 - 同步不是全量定时跑，而是靠 webhook 或定时扫描
packages.json变更，触发 provider 文件拉取——所以Last-Modified头校验必须开启
真正难的不是搭起来，是让 provider-*.json 和 packages.json 的版本键集合、sha256、Last-Modified 三者完全对齐；差一点，Composer 就会拒绝加载该 provider。
