启用 --classmap-authoritative 后自动加载变慢的错觉实为配置不当所致：它要求所有类必须预载入 classmap，否则直接报错；正确做法是配合 -o 使用 composer dump-autoload -o --classmap-authoritative 并确保扫描覆盖全部源码目录。
classmap 生成后为什么自动加载反而变慢了
不是 classmap 本身慢，而是没配对用——composer install 默认不生成完整 classmap，只在 vendor/autoload_classmap.php 里塞少量核心类；真正要靠它提速，得显式触发全量扫描。
常见错误现象：composer dump-autoload --classmap-authoritative 执行后，新增类突然“找不到”，报 Class not found，但文件明明存在。
- 根本原因是：启用了
--classmap-authoritative后，Composer 会**完全跳过 PSR-4/PSR-0 动态查找**，只信任 classmap 里的路径 - 所以必须确保所有类（包括你自己的 src/、tests/、甚至 bin/ 下的可执行类）都进了 map，否则就是硬报错
- 推荐做法是加
--optimize-autoloader（简称-o）一起用：composer dump-autoload -o --classmap-authoritative - 如果项目有动态注册的类（比如通过
spl_autoload_register手动加载），classmap 模式下它们不会被触发——这点容易被忽略
哪些场景必须用 --classmap-authoritative
生产环境部署、CLI 工具、容器镜像构建——只要满足“代码不再动态增删类”这个前提，就值得开。
典型使用场景：
- Docker 构建阶段执行
composer install --no-dev --optimize-autoloader --classmap-authoritative，减少运行时 IO - PHP-FPM 子进程启动快 10%~20%，尤其在大量小文件项目中（如 Laravel 的 helpers、traits 分散在各处）
- 共享主机或低配 VPS 上，避免每次请求都 stat 数百个 PHP 文件
- 注意：开发时别开——改一个类就得重跑
dump-autoload，否则改了也白改
vendor/autoload.php 被 require 后的行为变化
启用 --classmap-authoritative 后，vendor/autoload.php 加载的 autoloader 不再包含 PSR 查找逻辑，只保留 ClassLoader::findFile() 对 classmap 的哈希查找。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
你可以用这段代码验证是否生效：
var_dump(class_exists('SomeRandomClass')); // 如果 classmap 里没有，直接 false，不会去文件系统找
性能影响很实在：
- 无 classmap：每次
new Foo()可能触发 3~5 次file_exists()调用 - 有 classmap + authoritative：一次数组 key 查找，O(1)
- 但 classmap 文件体积会变大（尤其是含 tests/ 或 docs/ 目录时），内存占用略升——这不是问题，除非你跑在 32MB 内存的嵌入式 PHP 环境里
为什么 composer install --optimize-autoloader 不等于 --classmap-authoritative
这是最常混淆的点。--optimize-autoloader 只做两件事：生成 classmap（有限范围）、把 PSR 映射转成静态数组。但它**仍保留 fallback 到文件系统的能力**。
而 --classmap-authoritative 是开关级控制——一旦打开，连 fallback 都砍掉。
- 不加 authoritative：classmap 找不到时，继续按 PSR 规则拼路径、
file_exists() - 加了 authoritative：classmap 找不到，立刻抛
ClassNotFoundException，不试探 - 所以线上部署命令必须是
composer install --no-dev -o --classmap-authoritative，少一个 flag 就没意义 - CI/CD 中建议加个检查：
grep -q 'classmap-authoritative' vendor/autoload.php || exit 1
classmap 的边界很硬——它不猜，不妥协，也不给你留后路。生成前想清楚哪些目录该扫，扫完记得验证关键类是否存在。
