沙盒中composer install越跑越卡，根本原因是未配置--prefer-dist、未禁用xdebug、缓存路径未持久化且缺失--no-interaction等关键参数，导致每次重复下载、解压、校验和autoload生成。
本地开发沙盒里反复执行 composer install，不是“多跑几遍就能快”，而是必须控制环境变量、缓存路径和命令参数——否则每次都在重蹈覆辙。
为什么沙盒里 install 越跑越卡？
沙盒环境（比如 Docker 容器、临时 VM 或 CI 模拟目录）默认不保留 Composer 缓存，也不禁用 Xdebug，更常漏掉 --no-interaction。结果就是：每轮都重新下载 zip、重复校验哈希、逐个解压、再生成 autoload —— 这些步骤本可跳过。
-
composer install默认会检查每个包的 SHA256（来自composer.lock），哪怕缓存里已有相同 zip，只要没显式启用--prefer-dist，它可能仍走 source 分支 - PHP CLI 若启用了
xdebug（很多本地 MAMP/XAMPP/DevEnv 默认开），composer install会慢 3–5 倍，且不报错、只卡在 “Loading composer repositories” 阶段 - 沙盒中未提前设置
cache-dir，所有下载包都写进内存或临时文件系统，重启即丢，下次又从头拉
沙盒专用的 install 命令组合
别用裸 composer install。沙盒场景下，以下参数是硬性要求：
composer install --no-dev --prefer-dist --optimize-autoloader --no-interaction --no-progress-
--no-dev：跳过require-dev的解析与安装（注意：不是“不解析”，而是彻底跳过 dev 包的 metadata 加载，省 CPU） -
--prefer-dist：强制走压缩包而非 Git clone，避免沙盒里缺 git 或 SSH key 导致卡死 -
--no-interaction和--no-progress：防止因 stdin 不可用或日志输出阻塞导致命令挂起（Docker 构建常见）
如果沙盒支持 APCu（如 PHP CLI 启用了 apcu.so），还可加 --apcu-autoloader，但需确认 apc.enable_cli=1 已设 —— 否则 autoload 失效。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
缓存必须绑定到宿主机或 SSD 路径
沙盒里 composer clear-cache 没用，关键是让缓存目录“活下来”。运行前先配好：
-
composer config -g cache-dir /host/path/to/composer-cache（Docker 可 bind mount 到容器内） - 验证是否生效：
composer config -g cache-dir输出应为绝对路径，且该路径可写 - 别用
/tmp或 NFS 卷 ——cache-dir在慢盘上，比没缓存还拖累
若沙盒是轻量级（如 GitHub Codespaces 或 Dev Container），建议把 ~/.composer/cache 挂载为 volume，并在 devcontainer.json 中预置镜像源配置。
沙盒启动前必须检查三件事
不是 install 报错才排查，而是每次启动沙盒就该自动验：
- 确认
composer.lock存在且非空（ls -lh composer.lock | awk '{print $5}'> 1KB）；若不存在，说明项目交付不完整，install会退化成update行为 - 运行
php -m | grep -E '^(openssl|curl|mbstring|json)$'，缺失任一模块都会在 install 中期失败（不是开头报错，而是卡在某个包的 autoloader 生成） - 执行
php -v和composer show php，对比composer.lock里"platform": {"php": "..."}字段 —— 版本小数点后一位不匹配（如锁了"8.2.10"，本地是8.2.9）也会静默失败
沙盒不是“隔离即安全”，而是“隔离即脆弱”。一次 install 失败背后，往往是 PHP 版本、扩展、缓存路径、镜像源四者中至少两个没对齐。别等报错，先对齐这四个点。
