必须用WebStation绑定的PHP路径（如/volume1/@appstore/PHP82/usr/bin/php）执行composer config -g配置中文镜像，否则设置仅作用于错误CLI环境（如PHP 5.6），对WebStation项目无效；需同步关闭phar.readonly、校准CA证书路径，并用同一PHP路径验证diagnose及install实际请求域名。
群晖 NAS 上配置 Composer 中文镜像，必须用 WebStation 绑定的 PHP 路径执行 composer config，否则镜像设置只生效于错误的 CLI 环境（比如系统默认的 PHP 5.6），对 WebStation 实际运行的项目完全无效。
确认当前 composer 是否真在目标 PHP 环境下运行
很多用户配完镜像发现没加速，是因为 composer 命令实际调用的是旧版 PHP（如 /usr/bin/php），而 WebStation 用的是 /volume1/@appstore/PHP82/usr/bin/php。先验证：
- 查你站点绑定的 PHP 路径：DSM → WebStation → PHP 设置 → 找到已启用版本（如 PHP 8.2）→ 记下
PHP Path（典型为/volume1/@appstore/PHP82/usr/bin/php） - 确认该路径下的 composer 可执行且版本正确：
/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer --version - 如果报错
Command "config" is not defined或找不到命令，说明composer不是用这个 PHP 安装的——得先按标准流程重装，别跳步
用目标 PHP 路径执行 config 命令设镜像
Composer 镜像配置保存在用户家目录下的 ~/.composer/config.json，但该文件只对**调用它的 PHP 解释器**生效。必须用 WebStation 对应的 PHP 路径来运行 composer config，否则写入的配置会被忽略。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 执行命令（以 PHP 8.2 为例）：
/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer config -g repo.packagist composer https://packagist.phpcomposer.com - 国内常用镜像地址（选其一即可）：
https://packagist.phpcomposer.com、https://packagist.laravel-china.org、https://mirrors.aliyun.com/composer/ - 验证是否写入成功：
/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer config -g repo.packagist—— 应返回你刚设的 URL - 注意：
-g表示全局配置；若只想改某个项目，cd 进项目目录后去掉-g，并确保该目录下composer.json存在
常见失效原因和绕过方式
即使 composer config -g 成功，composer install 仍走官方源？大概率是以下三类问题：
-
phar.readonly = On：WebStation 的 CLI php.ini 默认开启此限制，导致 composer 无法写入缓存或修改自身配置。需进 DSM → WebStation → PHP 设置 → 对应版本 → 「编辑」php.ini → 搜索phar.readonly→ 改为Off→ 重启该 PHP 版本 - CA 证书路径不一致：CLI 模式下 OpenSSL 可能读不到 DSM 的证书包，导致 HTTPS 请求失败（表现为超时或 SSL handshake failed）。运行
/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer diagnose，重点看The openssl extension is loaded和CA cert bundle行；若后者为空或路径错误，手动在 php.ini 中加一行：openssl.cafile="/etc/ssl/certs/ca-certificates.crt" - 项目级配置覆盖全局：某些项目自带
composer.json里写了"repositories"，会优先于全局镜像。此时要么删掉项目里的仓库定义，要么在项目目录下运行/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer config repo.packagist https://mirrors.aliyun.com/composer/（不带-g）
验证镜像是否真正生效
别只信 composer config -g 输出，要测真实请求行为：
- 新建测试目录，运行：
/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer create-project laravel/laravel test-app --no-install - 再进
test-app目录，运行：/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer install -vvv - 观察终端输出：如果看到
Downloading https://mirrors.aliyun.com/composer/...或类似镜像域名，说明生效；若仍是https://repo.packagist.org，说明环境或配置未对齐 - 注意：首次安装会下载大量包，耗时较长，但后续
install或update应明显快于官方源
最常被忽略的一点：群晖上 composer 命令本身只是个软链接，它背后依赖的 PHP 解释器、扩展、php.ini、CA 证书路径，全部必须和 WebStation 运行时一致——镜像配置只是其中一环，环境割裂了，再好的镜像也白搭。
