必须用官方脚本安装composer，避免一键包或包管理器预编译版；运行composer --version确认版本：1.x须重装，2.x低于2.7.0建议重装，≥2.7.0仍需执行composer diagnose排查隐性问题。
必须用官方脚本装，别信一键安装包或包管理器预编译版本——它们大概率卡在 PHP 8.2+ 兼容性上，报 Class 'Composer\Autoload\ClassLoader' not found 或直接 segfault。
怎么确认当前 Composer 版本并判断是否要重装
运行 composer --version 看输出：
- 显示
1.x：必须重装，Composer 1 已停更，不支持 PHP 8.2+ 新语法 - 显示
2.x但版本号低于2.7.0：建议重装，PHP 8.3 兼容性和依赖解析死循环 bug 在此版本后才修复 - 显示
2.7.0或更高：可跳过安装，但建议仍跑一次composer diagnose查 CA 证书、home 目录可写性等隐藏问题
Linux/macOS 下用官方脚本装最新稳定版（推荐）
绕过 brew install composer 或 apt install composer 的滞后风险，全程手动校验哈希值：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 先清理旧版：
which composer查路径，若为/usr/bin/composer这类系统路径，执行sudo rm /usr/bin/composer - 下载安装脚本：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 校验完整性（务必去 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 复制最新 SHA-384 值）：
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e826a4d0cc4b77f883902bb78de46181d610') { echo 'OK'; } else { echo 'Installer corrupt'; }" - 执行安装：
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 加执行权限：
sudo chmod +x /usr/local/bin/composer
Windows 上别双击 Composer-Setup.exe
它不检查 php.ini 关键项，静默失败是常态：
- 先验证环境：
php -m | findstr openssl确保有输出；没输出就打开php.ini去掉;extension=php_openssl.dll前的分号 - 确认
php.exe路径不含空格或中文，且已加入系统PATH - 仍失败？直接跳过安装器：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"→php composer-setup.php→ 得到composer.phar后，把它丢进C:\ProgramData\ComposerSetup\bin\（该目录通常已在 PATH 中） - 验证：
composer --version，不是php composer.phar --version
装完立刻配国内镜像源
不配镜像，composer install 卡在 Loading composer repositories with package information 是必然结果，不是网速问题：
- 全局生效（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应返回镜像地址，不是https://packagist.org - 清旧缓存：
composer clear-cache，否则可能还在用失效的 packagist.org 缓存 - 阿里云偶尔同步延迟？临时切回官方源：
composer config -g --unset repos.packagist
最容易被忽略的是：装完 composer --version 成功 ≠ 能用。真正要跑通的是 composer diagnose 和第一次 composer install —— 前者暴露证书、权限等底层隐患，后者才检验镜像、网络、PHP 扩展三者是否真正协同。
