classmap必须显式配置路径并执行composer dump-autoload -a生成，否则vendor/composer/autoload_classmap.php为空或不存在；路径需写入composer.json的autoload.classmap数组，目录末尾加/才递归扫描，单个文件不加/，路径须真实存在且大小写敏感。
类映射（classmap）不是“自动”生成的，它必须显式配置路径 + 显式执行命令才能出现；不配 classmap 字段、不跑 composer dump-autoload -a，vendor/composer/autoload_classmap.php 就是空的或根本不存在。
classmap 路径怎么写才被扫描到
必须把路径写进 composer.json 的 autoload.classmap（或 autoload-dev.classmap）数组里，且格式要对：
- 目录路径末尾带
/才递归扫描，比如"src/"有效，"src"会被当作文本文件读取，报Could not scan for classes - 单个文件不加
/，比如"includes/functions.php"—— 但注意：它只把文件里声明的class/interface/trait加入映射，函数不会被索引 - 支持 glob，如
"legacy/DB_*.php"，但不支持**或*单独用（如"legacy/*.php"无效） - 路径必须真实存在，否则
dump-autoload会 warning 并跳过，但不会中断 - Windows 下也统一用
/分隔，Composer 内部自动适配
为什么 dump-autoload -o 没生成 classmap
-o（即 --optimize-autoloader）本身不“创建” classmap，它只是优化已存在的 autoload 规则。如果 composer.json 里没配 classmap，也没声明 PSR-4/PSR-0，那 -o 就无事可做。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 真正触发 classmap 生成的最小动作是：
composer dump-autoload -a（--classmap-authoritative不是必需，但-a强制重扫所有classmap路径） -
-o只对已声明的规则生效：它会把 PSR-4 目录下的类也“转成” classmap 条目，但前提是这些目录已在autoload.psrr-4中正确声明 - 误以为
composer optimize-autoloader是合法命令？它根本不存在，运行就报Command "optimize-autoloader" is not defined - 新增类、改名、删文件后，classmap 不会自动更新 —— 必须重跑
dump-autoload -a
生成后怎么确认 classmap 生效了
别只看终端输出，直接查文件和运行时行为：
- 打开
vendor/composer/autoload_classmap.php，确认它是非空 PHP 数组，且包含你预期的类名，例如：'App\Helper\Str'=>__DIR__ . '/..' . '/src/Helper/Str.php' - 运行
var_dump(class_exists('Your\Full\ClassName'));，返回true才算真正加载成功 - 如果仍报
Class not found，大概率是：路径没配对、文件没 class 声明、命名空间拼错、或大小写不一致（Linux 严格区分Src/和src/） - 注意
autoload-dev下的路径默认不进生产 classmap，加--no-dev后更干净；若要包含测试类，得显式加--dev
classmap 的本质是静态词法扫描，不执行代码、不依赖目录结构、也不 fallback —— 配错或漏扫，就会直接失败，没有“试一下”的余地。
