Satis可行但非实时服务，仅生成静态文件；必须用type:"composer"配置仓库URL，末尾斜杠不可少，且需确保packages.json可访问、MIME正确、包已打tag或显式声明。
直接用 Satis 搭建私有 Composer 仓库是可行的，但必须明确：它不提供实时服务，只生成静态文件；所有包必须已打 tag 或显式声明分支，否则 composer require 会 fallback 到 packagist.org。
为什么 composer config repositories.xxx 总报 “Invalid repository type”
错误根源是把 Satis 当成 VCS 源来配。Satis 输出的是静态 packages.json，客户端必须用 type: "composer" 去读它，不是 vcs、package 或空类型。
-
composer config repositories.myrepo composer https://packages.internal/—— URL 必须指向packages.json所在根目录，末尾斜杠不能少 - 如果 Satis 的
output-dir是web/，那 URL 就得是https://packages.internal/web/，否则 404 - 检查
composer.json里是否真新增了"type": "composer"字段，不是靠猜测或复制粘贴 - Nginx/Apache 要显式支持
.jsonMIME 类型：types { application/json json; }，否则响应头错，Composer 拒绝解析
satis build 成功但私有包始终 require 不到
Satis 不扫描未发布的代码 —— 它只处理 Git 仓库中已存在的 tag 和分支，且默认只认 v1.2.0 这类带 v 前缀的 tag。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 确认私有包的
composer.json里name字段（如"company/sdk"）和你在项目中require的完全一致，大小写敏感 - 没打 tag？运行
git tag v1.0.0 && git push --tags，再重新php bin/satis build - 想支持
1.2.0（无v）？在satis.json加"version-regex": "[v]?[0-9]+(?:\.[0-9]+)*" - 要拉
dev-main？需同时设"minimum-stability": "dev"和"prefer-stable": false，且require-all不生效，得用"require": {"company/sdk": "dev-main"}
内网部署时 satis build 报 “Could not clone”
构建过程在服务器上执行，不是你本地终端。Git 认证凭据、网络通路、SSH key 权限都得单独配给 Satis 运行环境。
- HTTPS 私仓？确保
~/.composer/auth.json（或 Satis 进程用户家目录下的该文件）含对应 token：{"github.com": "xxx"}或自建 Git 地址的 token - SSH 私仓？Satis 进程用户（如
www-data）的~/.ssh/下要有可用的id_rsa，且ssh -T git@git.internal能通 - GitLab/Gitea 自签名证书？PHP 的 OpenSSL 配置可能拒绝连接，临时方案是在
satis.json的 repo 配置里加"no-api": true并确保能走 SSH - 别用全局安装的 Satis —— 依赖冲突高发，推荐
composer create-project composer/satis局部安装
如何让团队不用改每个项目的 composer.json
用全局配置锁定私有源优先级，但要注意 Composer 8+ 的安全限制。
- 执行
composer config -g repositories.packages.type composer - 执行
composer config -g repositories.packages.url "https://packages.internal/" - 如果仓库用 HTTP（非 HTTPS），必须补一句
composer config -g secure-http false，否则直接被拦截 - 真正容易被忽略的是：Satis 构建后不会自动刷新。新 tag 推送后，必须重新运行
build—— 这步必须接入 CI，在 push tag 后触发
