~1.2.3等价于>=1.2.3且=1.2.3且
波浪号 ~ 和折音号（即插入符）^ 的行为边界完全不同，不是“松一点”和“紧一点”的关系，而是锚点层级根本不同：一个锁 MINOR，一个锁 MAJOR。写错一个符号，可能让 composer update 装上你完全没测过的次版本，线上直接报错。
为什么 ~1.2.3 死活升不到 1.3.0？
因为 ~1.2.3 的语义是「至少 1.2.3，且必须卡在 1.3.0 之前」，等价于 >=1.2.3 。它把锚点定在 <code>MINOR 段（即 2），只允许 PATCH 段（3）往上浮动。
- ✅ 允许安装：
1.2.4、1.2.99 - ❌ 拒绝安装：
1.3.0、1.3.1，哪怕作者标着 “BC break free” - ⚠️ 常见误判：看到包发了
1.2.10却没自动升级 → 很可能是composer.lock里还锁着1.2.3，composer install不看约束，只认 lock - ⚠️ 更隐蔽的坑：
~1.2看似省事，实际等价于~1.2.0，和~1.2.3上限一致；但~1就变成>=1.0.0，范围陡然扩大到整个1.x
^1.2.3 真的向后兼容吗？
^1.2.3 等价于 >=1.2.3 ，锚点在 <code>MAJOR 段（1），允许 MINOR 和 PATCH 任意升 —— 但它**完全依赖包作者遵守 SemVer**。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- ✅ 合规场景：Laravel
^10.0.0装到10.42.1，中间所有10.x都应保持 API 兼容 - ❌ 违规现实：某 SDK 把
1.10.0当作配置结构大改发布，^1.2.3仍会装它，Composer 不校验变更内容 - ⚠️ 0.x 是特例：
^0.8.2实际等价于>=0.8.2 ，和 <code>~0.8.2行为一致 —— 因为 SemVer 规定0.x阶段任何MINOR变更都算破坏性 - ? 验证是否真生效：运行
composer show vendor/package -i，看输出末尾带*表示未被 lock 锁死，再配合composer update --dry-run预览实际会拉什么版本
生产环境到底该用哪个？
选 ~ 不是因为“保守”，而是因为你明确知道：只有 PATCH 升级是安全的。比如对接银行 SDK、硬件驱动、政府接口等更新节奏不可控、文档缺失、变更不透明的依赖。
- ✅ 推荐用
~的场景："stripe/stripe-php": "~12.5.2"（已验证过 12.5.x 的请求头签名逻辑） - ✅ 推荐用
^的场景："symfony/http-kernel": "^6.4"（Symfony 官方严格守 SemVer） - ❌ 别全用
~：会导致monolog/monolog卡在2.2.x，错过结构化日志、上下文传播等关键能力 - ❌ 别对
0.x包盲目信^：它不会帮你跨小版本，反而让你误以为能升，结果发现^0.9.0根本装不到0.10.0
最容易被忽略的真相：lock 文件比约束符更管用
composer.json 里的 ~ 或 ^ 只在 composer update 或首次 composer install 时起作用。一旦 composer.lock 写入具体版本，后续所有 composer install 都无视约束，只按 lock 装。
- ✅ 必须把
composer.lock提交进 Git，否则 CI 构建每次拉的版本都可能不同 - ✅ 查谁在拦你升级：
composer why-not vendor/package:2.4.0比盯着报错堆栈快十倍 - ⚠️ 最危险的情况：本地
composer update装了2.3.7，但composer.lock没提交，CI 拉的是旧 lock 里的2.2.1，功能差异直接线上出问题
