换源是唯一可靠解法，因Composer死守https://repo.packagist.org且不fallback；国内镜像仅缓存元数据不托管ZIP包，需自建Satis私有源并严格配置URL斜杠、Nginx MIME类型及repositories顺序。
内网服务器跑 composer install 卡住或报错，不是因为“没网”，而是它死守 https://repo.packagist.org 不放，且不 fallback —— 换源是唯一可靠解法，其他如改 DNS、加 hosts、开代理，都绕不开这个硬限制。
为什么不能只用 composer config -g repo.packagist 指向一个镜像地址
这个命令只替换元数据入口（packages.json），但 ZIP 包仍从原始 dist.url 下载。比如某个包的 dist.url 是 https://github.com/monolog/monolog/releases/download/2.10.0/monolog-2.10.0.zip，Composer 会直接请求 GitHub，而你的内网根本打不开它。
- 国内公开镜像（阿里云、USTC）只缓存
packages.json和provider-*.json，不托管 ZIP 文件 - 真正全量可控，必须自己生成并托管 ZIP + 元数据，即用
satis或packagist-mirror - 若强行用反向代理镜像官方源，需透传
X-OAuth-Scopes头，否则 GitHub/GitLab 的 ZIP 下载必 403
satis build 后 composer install 仍 404 的真实原因
不是网络不通，是 Web 服务没正确暴露静态文件 —— satis 只生成文件，不启动服务。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- Nginx
root必须精确指向satis.json中output-dir的路径，例如root /var/www/satis/web; - 必须显式声明 JSON MIME 类型：
types { application/json json; }，否则返回text/plain，Composer 直接拒收 - 镜像 URL 必须以
/结尾：写成"url": "https://pkgs.internal/"，写成"url": "https://pkgs.internal"会导致 Composer 拼出https://pkgs.internalpackages.json -
dist/下 ZIP 路径要可直连 GET，例如https://pkgs.internal/dist/monolog/monolog/2.10.0/xxx.zip，检查 SELinux、文件权限、Nginx 是否能读取该路径
项目里怎么写 repositories 才真正生效
必须写在你要装私有包的那个项目的根级 composer.json 里，不是 Satis 自己的配置文件，也不是包自己的 composer.json。
- 类型必须是
"type": "composer"，URL 是托管packages.json的根地址（含末尾/） - 务必加上
"packagist.org": false，否则同名包会从官方源拉取，覆盖你的私有版本 - 私有源必须放在
repositories数组第一位，Composer 按顺序查找，不会合并同名包 - 漏掉任意一项，
composer require acme/utils就会报Could not find package acme/utils
私有 Git 仓库构建失败却静默跳过
satis build 不报错，但包没进 packages.json，下游完全感知不到 —— 这是最隐蔽的坑。
- HTTPS 私有仓库：运行
satis build的用户需提前执行git config --global credential.helper store并输一次密码；或改用 token，写进satis.json的config.github-oauth - SSH 私有仓库：确保运行用户能
ssh -T git@gitlab.internal连通，且~/.ssh/config配好 Host 别名和 key 路径 - 包被 skip：检查目标仓库是否有合法
composer.json；是否打了符合语义化格式的 tag（v2.1.0或2.1.0），dev-main默认不收录，除非设"minimum-stability": "dev" -
"require-all": true和"require": {}绝对不能混用，Satis 会静默跳过部分包，不提示任何冲突
最关键的细节往往藏在路径结尾的斜杠、Nginx 的 MIME 声明、以及 repositories 在哪个 composer.json 里 —— 这些地方错一个，整个链路就断在看不见的地方。
