composer.json中中文命名空间必须写成"app控制器"（双反斜杠转义），否则psr-4前缀匹配失败；需确保json语法正确、目录与命名空间严格一致、系统utf-8环境支持，且执行composer dump-autoload -v验证扫描日志。
composer.json里中文命名空间配置必须带末尾反斜杠
写成"App控制器"会失效，必须写成"App控制器\"——JSON字符串中反斜杠要转义，否则PSR-4前缀匹配失败，Composer静默丢弃整条映射。常见错误是复制粘贴时漏掉第二个，或编辑器自动把\显示为单个却未实际保存。验证方法：执行composer dump-autoload -v，终端输出里必须出现类似Scanning /path/to/project/控制器/用户管理 for namespace App控制器用户管理的行，否则说明前缀没被识别。
autoload_psr4.php里中文路径含URL编码或乱码
打开vendor/composer/autoload_psr4.php，搜索你的中文命名空间（如'App控制器'），右边路径如果显示%E4%B8%AD%E6%96%87/或一堆问号，说明文件系统或终端locale不支持UTF-8。检查LANG环境变量：echo $LANG，应为zh_CN.UTF-8或en_US.UTF-8；Docker容器需在Dockerfile里显式设置ENV LANG=C.UTF-8；Git仓库若提交过乱码目录，用git config --global core.precomposeUnicode true（macOS）或重置目录名。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
中文目录名与namespace声明必须严格一致
PHP支持UTF-8命名空间，但Composer不做转换——namespace 中文服务;要求物理路径必须是中文/服务/XXX.php，不能是zhongwen/service/XXX.php或中文/service/XXX.php。IDE自动生成类时容易把命名空间错写成拼音或英文，而文件仍放在中文目录下，导致脱钩。排查时用ls -la确认目录真实名称（是否含不可见空格、零宽字符U+200B），再比对namespace声明和composer.json里psr-4的key值。
dump-autoload -v输出没扫到中文目录？先查JSON语法
composer dump-autoload -v不报错不代表配置生效——如果终端压根没出现你的中文命名空间扫描日志，问题一定出在composer.json格式上。高频雷区：
• 用了中文引号“”代替英文""，JSON解析失败，整个autoload段被忽略
• 中文键名后多加了空格或Tab，某些JSON解析器截断后续内容
• psr-4字段拼错成autoloader或psr4
• 末尾缺逗号导致上一行配置被吞掉
建议用php -l composer.json校验语法，或粘贴到JSONLint网站验证。
