~1.2.3仅允许1.2.x版本，~1.2允许1.2.x至1.99.999但不跨2.0.0，~0.8.2仅允许0.8.x，~8.1.0仅允许8.1.x。

~1.2.3 到底允许装哪些版本？不是“差不多”，是精确截断

波浪号 ~ 不是模糊匹配，它按你写的最后一位非零数字“卡死升级边界”：写到修订号（如 ~1.2.3），就只允许 1.2.x；写到次版本号（如 ~1.2），就允许 1.2.x 到 1.99.999，但绝不跨 2.0.0。

• ~1.2.3 ≡ >=1.2.3 → 可装 <code>1.2.4、1.2.10，不装 1.3.0
• ~1.2 ≡ >=1.2.0 → 可装 <code>1.9.9，但不装 2.0.0
• ~0.8.2 ≡ >=0.8.2 → 0.x 阶段它比 <code>^ 更窄，连 0.9.0 都拦住

什么时候该用 ~ 而不是 ^？关键看你要不要卡死次版本

如果你的项目或中间件只在 2.7.x 上完整测试过，而 2.8.0 引入了未兼容变更，那 ^2.7.4 会升到 2.8.0，但 ~2.7.4 会稳在 2.7.x 区间——这是金融、支付类模块上线前最常用的保守锁法。

Workflow Decomposer

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

下载

• 用 ~2.7.4：明确跳过已知 bug 版本（如 2.7.5），又保留后续补丁（2.7.6、2.7.10）
• 用 ^2.7.4：接受所有 2.x 功能更新，适合开发环境或强信任主包
• 别混淆 ~2.7 和 ~2.7.0：它们等价，Composer 会自动补 .0，但写全更清晰

生产环境写 ~ 的实操细节：从 composer.json 到 composer.lock

写了 "monolog/monolog": "~2.8" 不代表你就装上了 2.8.x ——真正生效的是 composer.lock 里记录的版本。一旦锁文件存在，composer install 就完全忽略 composer.json 中的约束，只照着锁装。

• 查真实装的是哪个版本：composer show monolog/monolog -i，别只看 composer.json
• 想预览 update 会拉什么：composer update --dry-run monolog/monolog
• 发现装了不该装的版本（比如 3.0.0）：用 composer prohibits monolog/monolog:3.0.0 查谁强制抬高了依赖
• composer.lock 必须提交进 Git，否则 CI 构建结果不可控

PHP 自身版本也能用 ~ 锁？可以，但要小心语义差异

在 composer.json 的 require 下写 "php": "~8.1" 是合法的，它等价于 >=8.1.0 ，即只允许 <code>8.1.x，不升级到 8.2.0。这适合强依赖某个次版本特性的场景（比如某扩展仅适配 8.1.12 补丁行为）。

• 别写进 config.platform.php：那只是“假装”环境，不校验真实 PHP 版本
• 别写成 require-dev：它只约束 dev 包，对主运行环境无效
• CI 报错 Your requirements could not be resolved...？先确认本地 PHP 真的是 8.1.x，再检查是否误删了 composer.lock 导致重解析

波浪号的“保守”不是懒，是主动放弃一部分自动性来换取确定性。很多人写 ~2.8 却没意识到它拒绝 2.9.0，直到某天发现新功能用不了才回头翻文档——这种事，多看一眼 composer show -i 就能避开。