Intervention Image 无法正常使用的核心原因是未启用 PHP 的 gd 或 imagick 扩展，而非包名错误；需先确认并启用对应扩展，再执行 composer require intervention/image 安装，Laravel 旧版本还需手动注册服务提供者与门面。
Intervention Image 不能直接通过 Composer 安装成功，根本原因不是包名写错，而是你没装对 PHP 扩展依赖 —— gd 或 imagick 缺一不可。
确认 PHP 环境已启用 gd 或 imagick 扩展
Intervention Image 是个封装层，底层必须调用 PHP 的图像处理扩展。没装扩展，composer require intervention/image 虽然能执行成功，但运行时会报 Class 'Intervention\Image\ImageManager' not found 或更隐蔽的 Call to undefined function imagecreatefromstring()。
- 运行
php -m | grep -i gd或php -m | grep -i imagick查看是否启用 - Linux（如 Ubuntu）缺
gd：执行sudo apt install php-gd，然后重启 Web 服务（如sudo systemctl restart apache2或sudo service php-fpm restart） - macOS（Homebrew + PHP）：用
brew install php@8.2-gd（版本号按实际调整），再检查php.ini中是否包含extension=gd - Windows：打开
php.ini，取消注释;extension=gd或;extension=php_gd2.dll，保存后重启 Apache/Nginx
正确执行 Composer 安装命令
包名是 intervention/image，不是 intervention/image-manager 或带下划线的旧别名。Composer 8+ 已不支持旧式包命名习惯。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在项目根目录运行：
composer require intervention/image - 如果项目已锁定 PHP 版本（如
"php": "^8.1"），而本地 PHP 是 8.3，Composer 可能因平台配置拒绝安装 —— 此时加--ignore-platform-reqs是临时解法，但不推荐长期使用 - 若提示
Root composer.json requires intervention/image ^2.7 -> satisfiable by intervention/image[2.7.0]却卡住，大概率是网络问题，可尝试切换镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com（国内用户）
Laravel 项目中需额外注册服务提供者（Laravel ≤ 5.4）
Laravel 5.5+ 支持自动发现（auto-discovery），无需手动配置；但老版本必须显式注册，否则 Image::make() 会报 Class 'Image' not found。
- 编辑
config/app.php，在'providers'数组中添加：Intervention\Image\ImageServiceProvider::class - 在
'aliases'中添加：'Image' => Intervention\Image\Facades\Image::class - 执行
php artisan config:clear清除配置缓存，否则新配置不生效 - 注意：Laravel 9/10 默认使用 PHP 8.1+，而 Intervention Image v2 不完全兼容 PHP 8.2+ 的严格类型提示 —— 若遇到
Deprecated: Return type of Intervention\Image\Image::jsonSerialize()类警告，应升级到intervention/image:^3.0@beta（目前为 RC 阶段）
最常被跳过的一步是验证扩展是否真在 CLI 和 Web SAPI 下同时启用 —— php -m 看到的扩展，不一定等于 Apache 或 PHP-FPM 加载的那套。用 phpinfo() 页面确认更可靠。
