还原镜像后报错主因是缓存或配置残留：先运行composer diagnose定位问题，再执行composer config -g --unset repos.packagist和composer clear-cache；检查auth.json凭据、minimum-stability设置及版本约束语法是否合规。
Composer还原镜像后报错：先看 composer diagnose 输出
镜像还原（比如从阿里云切回 packagist.org）后报错，大概率不是网络问题，而是本地缓存或配置残留导致的协议/签名不一致。执行 composer diagnose 是最快定位入口——它会检查 CA 证书、composer.json 格式、仓库可访问性、以及最关键的「是否启用了不兼容的 repo 配置」。
常见现象：composer install 卡住、报 file could not be downloaded、或提示 Signature error。这些往往是因为 composer config -g repos.packagist 仍指向旧镜像，但该镜像已不可用，而 Composer 又没 fallback 到官方源。
- 运行
composer config -g repos.packagist，确认输出是{"type": "composer", "url": "https://packagist.org"}，不是https://mirrors.aliyun.com/composer或空值 - 若输出为 null 或旧镜像地址，立刻执行
composer config -g --unset repos.packagist清除全局覆盖 - 再运行
composer clear-cache，避免本地缓存的元数据仍带旧镜像签名
报 Could not parse version constraint？检查 composer.json 中的 require 版本写法
镜像切换后，某些国内镜像曾宽松解析非标准版本号（如把 "^1.2.3-beta" 当作合法），而 packagist.org 的官方解析更严格。一旦还原，Composer 就会抛这个错误。
这不是网络问题，是语法校验升级。重点排查 composer.json 的 require 和 require-dev 字段：
- 避免使用带空格或括号的版本字符串，例如
"dev-master as 1.0"或"1.2.3 (beta)" - 测试命令：
composer validate --strict，它比默认validate更早暴露这类问题 - 临时降级验证（仅调试）：
composer install --ignore-platform-reqs可绕过部分约束，但不能解决根本问题
还原后 composer update 慢或失败？关掉 http-basic 认证残留
有些团队在镜像时期为私有包配置了 http-basic 凭据（比如 composer config -g http-basic.repo.example.com user pass），切换回官方源后，Composer 仍会尝试对 packagist.org 发起带认证头的请求，触发 401 或超时。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
检查方式很简单：
- 运行
composer config -g --list | grep http-basic - 若输出包含非私有域名（尤其是
packagist.org或空白 host），说明凭据被错误绑定 - 清除它：
composer config -g --unset http-basic.packagist.org（注意 host 名必须完全匹配） - 顺手删掉
auth.json里对应条目（路径通常为~/.composer/auth.json）
为什么 composer show 显示包存在，但 install 找不到？注意 minimum-stability 和 prefer-stable
国内镜像常默认开启 prefer-stable: true 并放宽 minimum-stability，导致开发时无意装了 dev 分支；还原后，官方源按标准策略过滤，那些未显式声明 "@dev" 的包就消失了。
典型表现：composer show monolog/monolog 能查到，但 composer require monolog/monolog 提示「no matching package found」。
- 检查项目根目录
composer.json是否含"minimum-stability": "dev"或"prefer-stable": false - 运行
composer show -a monolog/monolog，观察哪些版本被标记为dev-或RC；如果依赖的是这类版本，需显式指定，如composer require monolog/monolog:dev-main - 更稳妥的做法：删掉
minimum-stability字段，让 Composer 使用默认stable，再逐个确认依赖是否真需要不稳定版本
镜像还原本身只是切换 URL，真正出问题的永远是本地配置、缓存和历史妥协写法。最常被忽略的是 auth.json 里的残留凭据和全局 repos.packagist 设置——它们不会随 composer self-update 改变，也不会被 clear-cache 清掉。
