直接改composer config -g repo.packagist不行，因其仅更新元数据入口（packages.json），ZIP包仍从原始dist.url下载；国内镜像不托管ZIP，需确保所有dist URL均可局域网直连GET，且Web服务响应头、URL末尾斜杠、文件权限均正确。
为什么直接改 composer config -g repo.packagist 不行
这个命令只替换元数据入口（packages.json），但 ZIP 包仍从原始 dist.url 下载——比如 https://github.com/monolog/monolog/releases/download/2.10.0/monolog-2.10.0.zip。局域网打不开 GitHub，国内镜像（阿里云、USTC）也不托管 ZIP 文件，只缓存元数据。
验证真实 ZIP 地址：运行 composer show monolog/monolog --verbose，看 dist.url 字段。别信“换源就完事”，必须让所有 ZIP 都能通过局域网 HTTP 直接 GET 到。
-
composer config -g仅对当前用户生效，CI/CD 或 Docker 容器里默认读不到 - 全局配置无法区分私有包和公共包，私有包会 fallback 失败
- URL 少一个末尾
/，Composer 会拼成https://pkgs.internalpackages.json，直接 404
Satis 构建后 composer install 还 404 的真实原因
Satis 不是服务，只是静态文件生成器；它不监听端口、不启动进程，只把 packages.json 和 ZIP 写进输出目录。404 不是网络不通，是 Web 服务没暴露对路。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Nginx
root必须精确指向satis.json中output-dir的路径，例如root /var/www/satis/web; - 必须显式声明 JSON MIME 类型：
types { application/json json; }，否则返回text/plain，Composer 拒收 - 检查
dist/下 ZIP 路径是否可直连 GET，例如https://pkgs.internal/dist/monolog/monolog/2.10.0/xxx.zip，SELinux 或文件权限常锁死该路径 - 没把
packages.json设为默认索引文件，访问根路径https://pkgs.internal/时服务器去找index.html，但 Satis 默认不生成这个文件
项目级 composer.json 怎么写才真正生效
私有源必须写在你要装包的那个项目的根级 composer.json 里，不是 Satis 自己的配置文件，也不是包自己的 composer.json。
- 类型必须是
"type": "composer"，URL 是托管packages.json的根地址（含末尾/） - 务必加上
"packagist.org": false，且放在repositories数组里，不是嵌套在某个仓库对象内部 - 私有源必须放在
repositories数组第一位，Composer 按顺序查找，不会合并同名包 - 漏掉任意一项，
composer require acme/utils就会报Could not find package acme/utils
require-all: true 是个坑，慎用
它会让 Satis 把 Packagist 所有公开包全量同步，首构建可能超 40GB，加载时内存溢出或超时；更糟的是，它会把 dev- 分支也当版本暴露，导致 composer update 行为异常。
- 中小团队建议用白名单：
"require": {"monolog/monolog": "^2.0", "phpunit/phpunit": "^9.0"} - 若需同步私有 Git 仓库，必须在
satis.json中显式开启："archive": {"skip-dev": false} -
require-all: true和require: {}混用会导致行为不可预测，Satis 不会报错，但部分包静默缺失 - 构建命令必须带输出目录，例如：
php bin/satis build satis.json web/，漏掉web/参数会导致文件生成到错误位置
