直接改 composer config -g repo.packagist 不行，因该命令仅替换 packages.json 入口，ZIP 包仍从原始 dist.url（如 GitHub）下载，而国内镜像不托管 ZIP 文件，必须确保所有 ZIP 可通过局域网 HTTP 直接 GET。

为什么直接改 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）也只缓存 packages.json 和 provider-*.json，不托管 ZIP 文件。

• 验证真实 ZIP 地址：运行 composer show monolog/monolog --verbose，看 dist.url 字段
• 别信“换源就完事”，必须让所有依赖的 ZIP 都能通过局域网 HTTP 直接 GET 到
• 全局配置 composer config -g repo.packagist 只影响当前用户，CI 环境默认读不到，必须项目级双保险

satis build 后 composer install 仍 404 的真实原因

Satis 不是服务，只是静态文件生成器；它不监听端口、不启动进程，只把 packages.json 和 ZIP 写进输出目录。404 不是网络不通，是 Web 服务没暴露对路。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 拒收
• 镜像 URL 必须以 / 结尾："url": "https://pkgs.internal/"，少一个斜杠会拼成 https://pkgs.internalpackages.json
• 检查 dist/ 下 ZIP 路径是否可直连 GET，例如 https://pkgs.internal/dist/monolog/monolog/2.10.0/xxx.zip，SELinux 或文件权限常锁死该路径

项目级 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": { "acme/utils": "^2.1", "acme/logging": "1.0.0" }
• 不要混用 require 和 require-all，Satis 会静默忽略 require
• 如果包没打 tag，dev-main 是唯一可用版本，但项目级 composer.json 必须加 "minimum-stability": "dev"
• archive 配置缺失时，composer install --prefer-dist 会退回到 git clone，CI 构建慢且易失败

关键点不在“搭起来”，而在“每个 ZIP 能不能被 GET 到”、“每个 packages.json 返回的 Content-Type 是不是 application/json”、“每个 URL 末尾是不是 /”。少一个斜杠、少一行 MIME 配置、少一个 false，就卡在 Loading composer repositories。