composer dump-autoload 并非重置而是刷新映射，仅按当前 composer.json 的 autoload 配置重建 vendor/composer/autoload_*.php；若配置存在 psr-4 路径错位、大小写不一致或重复映射等问题，刷新后仍会 class not found。
composer dump-autoload 不是重置，只是刷新映射
执行 composer dump-autoload 并不会“重置”autoload 文件，它只是按当前 composer.json 的 autoload 和 autoload-dev 字段重新生成 vendor/composer/autoload_*.php。如果配置本身有冲突（比如 PSR-4 路径错位、命名空间与目录大小写不一致），刷新后照样报 Class not found。
真正要“重置”，得先清理错误配置的残留影响：
- 删掉
vendor/composer/autoload_classmap.php—— 它可能缓存了旧 classmap 扫描结果，尤其在你移动过类文件后仍指向已删除路径 - 确认
composer.json中autoload仅出现在顶层，不是嵌在require或拼成autoloader等无效字段名 - 检查是否有重复映射：比如
"App\": "src/"和"App\Http\": "app/Http/"同时存在，且后者路径实际不存在，会干扰前缀匹配
PSR-4 映射冲突时，必须手动校准路径和命名空间
最常见的 autoload “冲突”其实不是 Composer 内部逻辑冲突，而是 PSR-4 规则被违反导致的加载失败。例如：
-
"App\": "src/"配置下，类AppHttpControllersHomeController必须放在src/Http/Controllers/HomeController.php，不能是src/http/controllers/homecontroller.php（Linux 下大小写敏感） - 路径末尾缺
/，如写成"App\": "src"，Composer 会拼出srcHomeController.php，而非预期的src/HomeController.php - 命名空间声明是
namespace AppServices;，但目录结构是src/services/→ 实际加载路径变成src/services/MyService.php，而 PSR-4 期望的是src/Services/MyService.php
验证是否生效：运行 composer dump-autoload 后，直接 var_dump(include 'vendor/composer/autoload_psr4.php');，看数组里键是否为 "App"，值是否为 ["src/"]（注意尾部斜杠）。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
classmap 和 files 混用时，别让它们互相覆盖或漏扫
老项目常把无命名空间类塞进 classmap，同时又试图用 PSR-4 加载新模块。这时容易出两类问题：
-
classmap扫描了src/全目录，结果把本该走 PSR-4 的src/Models/User.php也登记进 classmap，但它的类名是User（无命名空间）→ 运行时new AppModelsUser()找不到，因为 classmap 里没这个全限定名 -
files里写了helpers.php，但它内部用了function_exists()包裹定义，而 Composer 的files是无条件require_once，多次加载会 fatal error
正确做法：
- PSR-4 专用于有命名空间的新代码，路径严格对应，目录名首字母大写
-
classmap只扫纯函数/无命名空间类所在目录，如"legacy/"、"database/seeds/"，别加tests/或examples/ -
files仅放全局函数文件，且确保内容可重复包含（或加defined()守卫）
开发期别用 -o，否则掩盖真实路径错误
composer dump-autoload -o 会生成扁平化的 autoload_classmap.php，跳过 PSR-4 的路径拼接逻辑，直接查哈希表。这在生产环境能提速，但在开发阶段非常危险：
- 你把
"App\": "lib/"错配成"App\": "src/"，但lib/下恰好有个同名类被classmap扫到了 → “看起来能跑”，换台机器或清掉vendor/就崩 -
classmap不感知新增类，除非你加-a（composer dump-autoload -o -a）强制重扫，否则改了文件也不生效 - 日常调试只用
composer dump-autoload（不带参数），确保 PSR-4 拼接逻辑走通；上线前再补-o
最易被忽略的一点：autoload 配置改了，但没运行任何命令——vendor/autoload.php 不会自己更新，哪怕只是多打了一个空格。
