Invalid target path for symlink 是路径校验失败，非权限问题：路径禁用~和$HOME，须为绝对或相对路径；目标目录必须真实存在且含有效composer.json；name字段须与require声明完全一致；symlinks:true须置于repositories对应path仓库对象内，Composer 2.2+才支持。
Invalid target path for symlink 是路径校验失败，不是权限问题
这个错误根本不是 Linux 文件权限或 Windows 开发者模式没开导致的，而是 Composer 在创建软链接前做了一次硬性路径校验，不通过就直接报错。它和 Permission denied、Failed to create symbolic link 完全不同类——后者才是权限或系统限制问题。
-
~或$HOME不能出现在url字段里，必须是绝对路径（如/home/user/my-pkg）或相对于项目根目录的相对路径（如../my-pkg） - 目标目录必须真实存在，且里面至少有合法的
composer.json；空目录、软链接嵌套目录（比如../my-pkg实际指向另一个 symlink）都会被拒绝 -
composer.json中的name字段必须与主项目require里的声明完全一致，包括大小写和 vendor 名（例如"acme/utils"就不能写成"ACME/utils"或"acme/Utils"） -
symlinks配置必须写在repositories的具体 path 类型条目里，不是全局config段：{"repositories": [{"type": "path", "url": "../my-pkg", "symlinks": true}]}
虚拟化环境（Docker/WSL/CI）下 symlink 创建失败的常见原因
宿主机和容器/子系统之间 UID 不一致、挂载卷权限继承异常、文件系统不支持符号链接，都会让 --prefer-source 模式下的 symlink 创建静默失败。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- Docker 中若未显式指定
user:或UID，容器默认以 root 运行，但挂载的宿主机目录属主是普通用户（如 UID 1001），ln -s会因跨用户权限被内核拒绝 - WSL2 默认使用 ext4，支持 symlink，但若启用了 Windows 的
metadata选项（options = "metadata"），某些旧版 WSL 可能无法正确解析路径中的父级引用（如../） - GitHub Actions 或 GitLab CI 使用的 runner 环境通常禁用 symlink 创建（尤其在 Windows runner 上），即使配置了
symlinks: true，Composer 也会 fallback 到 copy 模式，且不报错——但后续vendor/acme/utils就是副本而非链接，修改本地包不会实时生效 - 检查是否支持 symlink：进容器或 WSL 内运行
ln -s /tmp/testlink /tmp/testtarget && ls -la /tmp/testlink；失败则说明底层不支持，必须改用"options": {"symlink": true}（Composer
修复步骤：删干净再重装，别跳步
即使路径和配置全对，残留的 vendor/ 和 composer.lock 仍会让 Composer 忽略新配置，继续按 lock 文件里的旧记录复制安装。
- 先彻底清理：
rm -rf vendor/ composer.lock（注意不要漏掉composer.lock） - 确保终端环境干净：VS Code 内置终端要完全退出再新开，避免复用带污染 PATH 或 COMPOSER_HOME 的 shell
- 强制走 source 模式并尝试建链：
composer install --no-cache --prefer-source - 验证是否成功：进入
vendor/acme/utils，执行ls -la；Linux/macOS 下应看到类似utils -> ../../../my-pkg的输出；Windows（非 WSL）下看不到 symlink，但composer show acme/utils的 source 值应为path类型而非dist
容易被忽略的复杂点：symlinks 配置只在 Composer 2.2+ 生效
如果你用的是旧版 Composer（比如宝塔面板自带的 2.1.x 或更低），"symlinks": true 字段会被直接忽略，而你可能误以为是路径或权限问题。
- 查版本：
composer --version；低于 2.2 的必须改用旧语法：{"options": {"symlink": true}}，且只能放在 path 仓库对象内 - 两种写法不可混用：
"symlinks": true和"options": {"symlink": true}同时存在时，Composer 会优先读取前者（2.2+），旧版本则两者都不认 - CI 环境尤其危险：GitHub Actions 默认用最新版，但私有 runner 或 Docker image 可能固化旧版；建议在
composer.json顶层加"require": {"composer/composer": "^2.2"}锁死最低版本，或在 CI 脚本中显式升级：curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
