composer install --apcu-autoloader 不生效是因为它仅生成支持 APCu 的 autoload 文件，而非启用运行时缓存；真正生效需满足：FPM 环境、apc.enabled=1、apcu.stat=0、"optimize-autoloader": true，且 CLI 下 apc.enable_cli=0 是正确配置。
composer install --apcu-autoloader 为什么没生效？
它根本不会在 CLI 下真正起作用——除非你改了 apc.enable_cli=1，但这恰恰是错的。APCu 的用户缓存（apcu_store() / apcu_fetch()）设计上就不是为 CLI 进程服务的：每次 composer install 都是全新进程，缓存写进去立刻消失，后续 Web 请求也读不到。
真正生效的场景只有一种：PHP-FPM 或 Apache mod_php 环境下，由 Web 请求触发自动加载时，才可能命中 APCu 缓存。而 Composer 命令本身只是“生成支持 APCu 加载逻辑的 autoload 文件”，不是“开启运行时缓存”。
-
php -m | grep apcu必须有输出，否则扩展没加载 -
apc.enabled=1（不是On）且apcu.stat=0（否则每次检查文件修改时间，直接绕过缓存） - CLI 和 FPM 的
php.ini是两套配置，用php -i | grep "Loaded Configuration File"分别确认 -
apc.enable_cli=0是合理默认值，不要改成 1；FPM 下才应确保apc.enabled=1
怎么正确启用 APCu 自动加载器？
核心动作只有两个：生成带 APCu 支持的 autoload 文件 + 确保运行时环境能读取它。不是加个参数就完事，得配齐条件。
- 必须在
composer.json中开启"optimize-autoloader": true，否则--apcu-autoloader被静默忽略 - 安装或更新时显式加参数：
composer install --apcu-autoloader --no-dev --optimize-autoloader - 或固定配置到
composer.json的config段："config": { "apcu-autoloader": true, "optimize-autoloader": true } -
composer dump-autoload不支持--apcu-autoloader参数，强行加会报错：Unrecognized option: --apcu-autoloader - 如果已存在
vendor/autoload.php，加参数也不会重写它——得先删掉vendor/或加--no-scripts避免干扰
打开生成的 vendor/autoload.php，搜 apcu_fetch，有相关逻辑才算真启用了。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
类找不到、缓存不更新、首屏变慢？常见失效点
APCu autoloader 不是开关一开就稳如泰山，它非常依赖生命周期管理和环境一致性。
- 部署新代码后没清 APCu 用户缓存：
php -r "apcu_clear_cache('user');"必须加进部署脚本，否则旧映射还在，新类路径对不上 -
apc.shm_size太小（默认常为 32M），类多时缓存写满，新映射存不进，自动降级回文件查找 - 同时开了
opcache.file_cache，某些 PHP 版本下 APCu 缓存会被绕过 - Docker 容器里 APCu 只在 CLI 启用（
apc.enable_cli=1），FPM 进程却没加载扩展，结果 Web 请求完全不走 APCu - 开发时开了 Xdebug，APCu 键名计算和校验被拖慢，实测比原生 autoload 慢 10%~20%
怎么验证它真的在工作？
别信命令行输出“success”，要看运行时行为。
- 在 Web 请求中执行：
php -r "var_dump(apcu_cache_info('user')['num_hits'] ?? 0);"，刷新页面看数字是否增长 - 直接查缓存键是否存在：
php -r "var_dump(apcu_exists('composer-autoload-'.md5(<strong>DIR</strong>.'/vendor/autoload.php')));"，返回true才算写进去了 - 临时加一句日志到入口文件开头：
var_dump(apcu_fetch('ComposerAutoloadNspMap') !== false); - 手动清空后对比首屏时间：如果差异明显（比如快 8–12ms），说明确实在起作用
APCu autoloader 只缓存“类名 → 文件路径”的映射，不缓存文件内容，也不加速 require 或 include。它只对高并发、类数量大（>1000）、依赖稳定的生产环境有意义——开发机上开着反而容易踩坑。
