解决Composer中文镜像无法下载包含特定修饰符的包-composer-PHP中文网

先确认远程仓库是否存在main分支，再检查packagist是否同步、包名是否拼写正确、私有源配置及鉴权是否有效，最后用@dev后缀临时调试。

解决composer中文镜像无法下载包含特定修饰符的包

不是网络卡，也不是镜像没配对，而是 Composer 根本没把 dev-main 当作一个可匹配的“版本”。它只在远程仓库元数据里找 tag 或稳定分支别名，dev-main 这种写法需要真实存在且被正确索引。

先用 git ls-remote --heads https://github.com/vendor/package.git 确认 main 分支是否存在（注意：不是 dev-main，那是 Composer 的内部标识）
再跑 composer show -a vendor/package —— 如果返回空或只显示 dev-master，说明 Packagist 没同步该分支，或包名拼错
访问 https://packagist.org/packages/vendor/package → “Versions” 标签页，看 dev-main 是否列在可选版本中（很多私有库或新 repo 默认不自动同步开发分支）
私有包必须确保 repositories 配置正确，且其 composer.json 里 version 字段是合法字符串（如 "dev-main" 或 "2.0.x-dev"），不能是 "dev" 或空值

^2.0 是语义化版本约束，只匹配带明确稳定性标记的 tag（如 v2.0.0、2.1.0-beta.1），不匹配任何分支名。分支名本身没有版本等级，也不参与 SemVer 解析。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

想让 ^2.0 生效，唯一办法是发布一个符合规则的 tag，比如 v2.0.0 或 2.0.0
临时调试可用 @dev 后缀：composer require vendor/package:dev-main@dev，但这会绕过 stability 检查，不适合生产环境
extra.branch-alias 在 Composer 2.0+ 中已被完全移除，写了也无效；验证方式很简单：运行 composer show vendor/package，如果没出现你写的别名（如 2.0.x-dev），就说明没生效

Packagist 上刚发布的 dev-main 或新 tag，在阿里云镜像通常要等 5–30 分钟才同步完成。这期间所有 composer show 或 require 都会报 “package not found”，不是命令错，是镜像还没更新。

用 curl -I https://mirrors.aliyun.com/composer/p/vendor/package.json 查响应头：Last-Modified 时间接近当前时间才算同步到位
composer clear-cache 不管用——它只清 zip 缓存，不删元数据；真正有效的是删元数据缓存目录：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（路径按你实际镜像 URL 转义）
项目根目录若存在 composer.json 里的 repositories 字段，会直接屏蔽全局镜像，此时 composer config -g 的设置完全无效

私有包走的是你配置的 repositories，跟阿里云镜像无关；但如果这个私有源本身没启用分支同步、没暴露 packages.json、或鉴权失败，dev-main 就永远查不到。

确保 auth.json 放在项目根目录或 ~/.composer/auth.json，格式为：{"http-basic": {"your-mirror.example.com": {"username": "api", "password": "token123"}}
用 curl -v -u api:token123 https://your-mirror.example.com/packages.json 直接测通，比 composer install 日志更准
检查私有源返回的 packages.json 是否真包含 vendor/package 条目，且 dev-main 出现在 versions 列表里
如果私有源基于 Artifactory/Nexus，确认 Realm 值（如 Artifactory Realm）和 Composer 发送的 Authorization 头匹配，否则 403 不报具体原因

镜像同步、分支别名、私有源鉴权这三块容易串在一起出问题，但它们彼此独立——查问题时得一层层剥开，别一看到“找不到”就换镜像或清缓存。