旧版 Composer 1.x 必须使用 repo.packagist 键名并显式声明 type 为 composer，URL 末尾需带 /；解析失败时应切回官方源、清缓存、重建索引，最终升级至 Composer 2.x 才能彻底解决兼容性问题。
旧版 Composer 1.x 不能直接用新版镜像地址，强行配置会卡在 “Loading composer repositories…” 或抛出 “Could not parse version constraint” —— 这不是镜像坏了，是协议不兼容。
Composer 1.x 镜像配置必须用 repo.packagist（单数、小写、带 type）
Composer 1.x 只认 repo.packagist 这个键名，写成 repositories、repos.packagist 或 packagist.org 全部静默失效。它还要求显式声明 type 值为 composer，漏掉就 fallback 到官方源。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/是唯一安全写法（注意末尾/） - 手动编辑
~/.composer/config.json时，必须确保字段是："repo.packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - URL 缺少末尾
/会导致请求路径拼成/composerpackages.json直接 404 - 旧版不支持 HTTPS 镜像？先检查 PHP 的
openssl扩展是否启用，而非降级为 HTTP
换镜像后报 “Could not parse version constraint” 怎么办
这是 Composer 1.x 解析国内镜像精简后的 packages.json 失败的典型表现——镜像为加速裁剪了 conflict、require-dev 等字段，而 1.x 版本依赖这些字段做版本推导。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 立刻切回官方源：
composer config -g repo.packagist composer https://packagist.org/ - 清缓存：
composer clear-cache（不清等于白配） - 再执行
composer update，让 Composer 加载原始元数据重建本地索引 - 确认无误后再换回中文镜像，但建议项目级配置替代全局：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
升级到 Composer 2.x 是一劳永逸的解法
Composer 1.x 已于 2022 年底停止维护，2.x 不仅原生支持中文镜像所有路径，还修复了元数据解析、并发下载、lock 文件校验等关键问题。升级不是可选项，而是必要动作。
- 运行
composer self-update—— 如果卡住或提示 “Up to date”，先切回官方源再执行（镜像会缓存版本检查响应） - 升级后，
repo.packagist仍可用，但推荐改用repositories.packagist.org键名以适配未来版本 - 升级后必须重跑
composer update，否则composer.lock里仍是 1.x 格式 dist URL，install 仍走 packagist.org - Homebrew 用户注意：2.5.0+ 已移除
self-update，需brew reinstall composer
真正卡住你的从来不是镜像地址，而是 Composer 版本、配置键名、缓存状态三者之间的错位。1.x 下硬套 2.x 配置，或升级后不重建 lock 文件，都会让镜像形同虚设。
