Composer require vendor/package:alpha报错因缺少@符号，正确写法为@alpha/@beta/@rc，且需包已发布对应语义化预发布tag；若仅存在dev分支则无效。
为什么composer require vendor/package:alpha会报错
漏了@符号，Composer 会把它当普通字符串版本号去匹配，结果找不到对应 tag，直接抛出 Could not find a matching version。真正有效的写法只有带@的：@alpha、@beta、@rc——前提是包本身发布了符合语义化规范的预发布 tag（如 v2.3.0-alpha.1）。如果作者只打了 dev-feature-x 这类分支名，@alpha 完全无效。
常见错误现象：
- 执行
composer require monolog/monolog:@alpha报错：包没发过 alpha tag，只能装 stable - 执行
composer require myorg/mylib:dev-main@alpha却提示Invalid version string：因为dev-main@alpha不是标准语法，应写成dev-main as 1.0.0-alpha.1
minimum-stability 必须显式设为 dev 才生效
Composer 默认只允许安装 stable 级别版本，alpha 属于 dev 稳定性级别，不放开策略就根本不会进入版本解析流程。光在 require 命令里加 @alpha 不够，项目级必须配 minimum-stability。
实操建议：
- 在项目根目录运行
composer config minimum-stability dev，再加composer config prefer-stable true（保底 fallback 到 stable） - 或直接编辑
composer.json，加入："minimum-stability": "dev",<br>"prefer-stable": true
- 改完必须删掉
vendor/和composer.lock，再跑composer install——旧 lock 文件会锁死历史版本，导致新配置不生效
用 dev-main 还是 @alpha？看你要的是“快”还是“稳”
dev-main 指向默认分支最新 commit，代码可能没测、没文档、API 随时变；@alpha 是作者打的 tag，至少过了基础验证，版本号明确（如 3.1.0-alpha.2），CI/CD 中更可控。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
使用场景判断：
- 你急需某个刚合入但还没打 tag 的功能 → 用
dev-main或dev-feature-xxx - 你想在测试环境试一个已发布、有 changelog、支持 rollback 的预发布版 → 用
@alpha（或@beta） - CI 流水线里慎用
dev-main：commit-hash 不固定，构建不可重现；@alpha对应确定 tag，可审计可回滚
装完命令不生效或类找不到，先查 autoload 和实际 tag
Alpha 版本常伴随 autoloading 路径调整、命名空间变更、bin 脚本迁移等结构性改动，不是装上就能用。
排查步骤：
- 运行
composer show vendor/package，确认实际安装的是哪个 tag 或 commit（比如显示dev-main 6a7b8c9，说明没走 alpha） - 检查该 commit 对应的
composer.json中autoload段是否新增了 psr-4 映射，路径是否和你代码中use的命名空间匹配 - 运行
composer dump-autoload -o强制刷新自动加载映射（尤其当你手动增删类后） - 某些 alpha 版把 bin 命令从
bin/移到了vendor/bin/，记得检查执行路径是否更新
最隐蔽的坑在于：Composer 不校验类是否存在，只按 composer.json 的 autoload 段生成映射。tag 里 autoload 配错了，用户 require 成功也照样 Class not found。
