path仓库本地调试不生效，根本原因是默认不启用符号链接且composer install不刷新已有链接；必须显式配置"options":{"symlink":true}、以管理员权限运行、执行composer update vendor/name重建链接，并确保路径、name、版本三者完全匹配。
为什么 path 仓库在本地调试时经常不生效
Composer 的 path 类型仓库本质是软链接（symlink）或硬拷贝，但默认只在 composer install 或首次 composer require 时建立。后续你改了本地库代码，composer update vendor/name 不会自动同步——它只看 composer.lock 和远程包版本，完全忽略本地文件变动。
- 必须显式执行
composer update --with-dependencies才可能触发重链接（取决于 Composer 版本） - 更可靠的做法是删掉
vendor/name目录后运行composer install，强制重建 symlink - Windows 用户要注意：默认禁用 symlink，需以管理员身份运行 CMD/PowerShell，或启用
composer config -g system-config --enable-symlinks true
如何正确配置 repositories 的 path 类型
关键不是写对路径，而是路径必须指向含有效 composer.json 的目录，且该 JSON 中的 name 必须与你 require 的包名**完全一致**（包括大小写和 vendor 名）。
- 项目根目录
composer.json中添加：
{
"repositories": [
{
"type": "path",
"url": "../my-shared-lib"
}
],
"require": {
"acme/my-shared-lib": "*"
}
}
-
../my-shared-lib必须是相对当前项目composer.json的路径，不能是绝对路径（如/Users/xxx/lib） -
acme/my-shared-lib必须与../my-shared-lib/composer.json里声明的"name": "acme/my-shared-lib"完全匹配 - 如果本地库未发布过任何版本，
"*"是唯一可用约束；若已发过 v1.0.0，可写"dev-main as 1.0.0"强制走本地分支
composer dump-autoload 为什么解决不了类找不到问题
autoload 本身没问题，问题常出在自动加载路径没被正确注册——因为 path 仓库的 symlink 没建好，或者 composer.json 里的 autoload 配置有误。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 检查
vendor/acme/my-shared-lib是否为真实目录（不是空文件夹），且内容是否与../my-shared-lib一致 - 确认本地库的
composer.json中autoload正确，例如：
"autoload": {
"psr-4": {
"Acme\Shared\": "src/"
}
}
- 运行
composer show acme/my-shared-lib查看实际加载路径；若显示source: dist而非source: path，说明没走path仓库 - 不要依赖 IDE 自动索引，手动在代码里
var_dump(class_exists('Acme\Shared\SomeClass'))验证
微服务间多 path 依赖时的常见冲突
当 A 服务 require B 库，B 库又 require C 库，而你同时把 B 和 C 都设为 path 仓库时，Composer 可能因解析顺序混乱导致 symlink 错乱或版本锁死。
- 优先使用
path+dev-*别名（如"dev-main as 2.0.0"），避免"*"导致版本推导冲突 - 所有本地库的
composer.json中，minimum-stability统一设为"dev"，并加"prefer-stable": false - 若出现
Root composer.json requires acme/c-lib * -> found acme/c-lib[dev-main] but it does not match your minimum-stability，就是稳定性配置不一致 - 最稳妥做法：每次只激活一个
path仓库，其他仍走 packagist，等单点验证通过再逐步放开
路径别名、版本别名、稳定性设置这三者稍有不匹配，path 就会静默退回到远程包——这种失败没有明显报错，只能靠 composer show 和 ls -la vendor/ 交叉验证。
