composer 不自动处理包名变更，必须手动修改 require、命名空间及 autoload；否则 install 失败或类找不到。迁移需三步：改 composer.json 的 require、更新所有 use 语句、删 vendor 与 lock 后重装。
Composer 不会自动处理包名变更后的依赖迁移，必须手动干预；否则 composer install 会失败或拉取错误版本。
为什么 composer update 不解决包改名问题
Composer 的依赖解析完全基于 name 字段（即 vendor/name），不是根据源码内容、GitHub 仓库地址或历史别名。一旦包在 composer.json 中声明为 "oldvendor/oldpackage"，而该包已从 Packagist 下架或重定向到 "newvendor/newpackage"，Composer 就无法凭空映射——它不会查 GitHub 重定向、不读 replace 字段以外的元信息，也不支持模糊匹配。
常见错误现象：Could not find package oldvendor/oldpackage 或安装后运行时报 Class not found（因命名空间未同步更新）。
- Packagist 上原包被
abandoned标记，仅提示，不触发自动替换 -
replace字段只在当前包的composer.json中生效，不能反向作用于依赖方 - 即使原包作者在
composer.json里写了"replace": {"oldvendor/oldpackage": "self.version"}，对你项目里的require条目也无影响
正确迁移三步：改 require + 改命名空间 + 清缓存
核心是让 Composer “忘记旧名字，认准新名字”，同时确保代码能继续运行。
- 在项目根目录
composer.json的require（或require-dev）中，把"oldvendor/oldpackage": "^1.2"替换为"newvendor/newpackage": "^1.2"（注意版本号是否兼容） - 检查所有
use语句和类名引用，把oldvendor\oldpackage\SomeClass改成newvendor\newpackage\SomeClass；若命名空间也变了，这步不可跳过 - 删掉
vendor/和composer.lock，再跑composer install；不要只用update，否则可能残留旧包残留或锁文件冲突
示例：从 "monolog/monolog" 迁移到社区维护的 "php-monolog/monolog"（实际已不存在，仅为示意），就得同步改 require 和所有 use Monolog\Logger; 所在文件——哪怕命名空间没变，也要确认新包是否保留了相同入口。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
过渡期兼容方案：用 repositories 临时代理旧名
当团队无法一次性全量修改代码，或下游包还没适配，可用 repositories 把旧包名“指向”新包源，争取缓冲时间。
- 在项目
composer.json顶层加"repositories"数组，类型设为vcs或package - 用
package类型可伪造一个假的oldvendor/oldpackage包，dist指向新包的 ZIP，autoload映射新命名空间 - 务必加
"force"标志（"options": {"force": true}），否则 Composer 可能忽略自定义源
风险点：这种方案绕过了 Packagist 官方校验，composer validate 会报 Warning: Package oldvendor/oldpackage is abandoned，且未来 Composer 版本可能收紧 repositories 行为。
容易被忽略的点：autoload 的 psr-4 映射和插件钩子
有些包改名后不仅改了 vendor，还调整了内部目录结构或 autoloader 配置。如果只改了 require 和 use，但没更新 composer.json 里的 autoload 或 autoload-dev，composer dump-autoload 后仍会找不到类。
更隐蔽的是：某些包通过 composer-plugin 注入命令或事件（如 post-install-cmd），改名后这些钩子可能失效或执行旧逻辑。检查 composer.json 的 extra 和 scripts 字段，确认是否硬编码了旧包名。
事情说清了就结束
