90%本地包命名空间报错源于PSR-4前缀与namespace声明不一致，或composer.json中name与require字符串不完全匹配；需确保PSR-4键末尾带双反斜杠、路径相对于包根目录、name大小写及分隔符严格一致、url指向含composer.json的目录且无尾部斜杠。
本地包命名空间报错，90% 是 PSR-4 前缀与文件内 namespace 声明不一致，或 composer.json 中的 name 与 require 字符串不完全匹配。
PSR-4 命名空间和文件路径没对齐
比如你在本地包的 composer.json 里写了：
"autoload": {
"psr-4": {"Acme\Utils\": "src/"}
}
但实际文件 src/Helper.php 里写的是 namespace Utils;，那 Composer 根本不会扫描它——因为前缀是 AcmeUtils，它只找 namespace AcmeUtils; 开头的文件。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
psr-4键值末尾必须带反斜杠："Acme\Utils\"✅，"Acme\Utils"❌（Windows 下双反斜杠是必须的） - 文件路径
"src/"是相对于该包根目录（即含composer.json的目录）的，不是相对于主项目 - 验证方式：运行
composer dump-autoload -o后，打开该包vendor/composer/autoload_psr4.php，搜索Acme\Utils\，确认映射值是类似$baseDir . '/src'的绝对路径，且对应目录下真有Helper.php
本地包 name 和 require 字符串大小写/分隔符不一致
错误现象：Could not find package acme/utils，但 composer show --all 里压根不显示这个包。
-
name字段必须和require中写的**逐字相同**：大小写、短横线-、无下划线、无空格。例如"acme/utils"≠"Acme/utils"≠"acme_utils" - 路径字段
url必须指向**含composer.json的目录**，且是相对于主项目composer.json的位置，如"../acme-utils"，不能写成"../acme-utils/"（末尾/会导致静默忽略） - Windows 下若用管理员权限启动终端仍失败，检查是否启用了符号链接支持（
fsutil behavior set SymlinkEvaluation L2L:1 R2R:1）
autoload 更新没生效或被跳过
即使配置全对，也常因缓存或执行时机出问题。
- path 仓库配置后，
composer require acme/utils不会自动触发dump-autoload；必须手动运行composer dump-autoload -o - 如果本地包里有
.php.bak、helper.php~这类非标准 PHP 文件，Composer 解析时会卡住并跳过整个目录——删掉再试 - 文件含 BOM 或用了短标签
（而非<?php），也会导致解析失败；用file -i src/Helper.php检查编码，用sed -i '1s/^//' src/Helper.php清 BOM - 确认主项目入口已加载
vendor/autoload.php，且在任何自定义类调用之前——漏掉这句，前面全白配
最易被忽略的一点：Composer 不会告诉你“我跳过了某个目录”，它只会安静地不映射。所以别只信命令输出，一定要打开 vendor/composer/autoload_psr4.php 手动搜你的命名空间前缀，看它到底在不在里面、路径对不对、文件存不存在。
