答案是95%的缓存目录权限错误源于~/.composer/cache属主为root，需用ls -ld检查归属，再执行sudo chown -r $user:$user修复所有权，禁用chmod -r 777；报错含writing cache file、/tmp或%appdata%\roaming\composer\cache即可定位。
缓存目录权限错误导致 composer update 失败，95% 是 ~/.composer/cache 归属为 root，不是权限数字太小，必须用 chown 修复所有权，不能靠 chmod -R 777。
怎么快速定位是缓存目录的问题
报错里出现 Writing cache file、Extracting archive 或路径含 ~/.composer/cache、/tmp、%APPDATA%\Roaming\Composer\Cache，基本就是它。运行这三行命令看归属：
ls -ld $(composer config --global cache-dir)php -i | grep "sys_temp_dir"composer install -v 2>&1 | grep -E "(cache|temp|Using temp)"
只要任意一行输出第三列（属主）不是你当前用户名（$(whoami)），就确认是所有权错配。
Linux/macOS 下安全清理并重设缓存目录
别删 /tmp，只动 Composer 实际用的缓存路径。执行顺序不能乱：
- 删旧缓存：
rm -rf $(composer config --global cache-dir) - 重建目录：
mkdir -p $(composer config --global cache-dir) - 归还所有权：
sudo chown -R $USER:$USER $(composer config --global cache-dir) - 设合理权限：
chmod 755 $(composer config --global cache-dir)（不是777）
如果 composer config --global cache-dir 输出的是 /root/.composer/cache，说明 COMPOSER_HOME 被污染，先 unset COMPOSER_HOME 再重试。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
Windows 下 ACL 权限必须显式处理
单纯删 %APPDATA%\Roaming\Composer\Cache 没用，因为 Windows ACL 会阻止 PHP 进程写入。必须授予权限：
- 图形方式：右键该文件夹 → “属性” → “安全” → “编辑…” → “添加…” → 输入当前用户名 → 勾选“完全控制”
- 管理员 PowerShell：
icacls "$env:APPDATA\Roaming\Composer\Cache" /grant "$env:USERNAME:(OI)(CI)F" /t - 长期规避：
composer config -g cache-dir "%USERPROFILE%\composer-cache"，再手动mkdir "%USERPROFILE%\composer-cache"
注意：PHPStudy/XAMPP 等集成环境常把 sys_temp_dir 指向带空格或 ACL 限制的路径，建议用官方 PHP CLI 验证是否真由 Composer 引起。
为什么 clear-cache 命令经常没用
composer clear-cache 本身依赖缓存目录可写——如果它已经不可写，命令会静默失败或只清掉部分子目录。更隐蔽的是：
-
~/.composer/cache/files/下某个 ZIP 文件损坏，clear-cache会删整个files/，但 Composer 后续可能跳过校验直接复用残留结构 -
~/.composer/cache/repo/https---packagist.org/里的 metadata 缓存滞后，clear-cache不强制刷新，update仍读旧索引 - 真正卡住的往往是嵌套归属异常：比如缓存目录属你，但里面某个
.zip是root下载的，解压时仍失败
所以遇到反复失败，不要只信 clear-cache，要盯住 composer install -v 输出末尾的真实路径，逐层 ls -l 确认归属。
