satis非必须，packagist功能更全但部署重；最小satis.json须含name、homepage、repositories三要素，且repositories为对象数组，require-all设true才拉取所有tag。
私有仓库必须用 Satis 还是 Packagist？
不是必须。Satis 是静态生成方案，适合纯内网、无运维资源的场景；Packagist（指官方开源版 packagist/packagist）依赖 PHP + PostgreSQL + Redis，部署重但支持实时索引、Web UI 和 Webhook 自动更新。企业选型关键看两点：是否需要自动同步 Git Tag、是否有专职 PHP 运维。没这两条，直接上 Satis 更稳。
用 Satis 搭建时 satis.json 最小必要配置是什么？
最小配置只含三块：name（仓库名，仅显示用）、homepage（访问地址，影响 Composer 客户端提示）、repositories（真实包源）。漏掉 repositories 或路径写错，composer update 会静默跳过你的包。
示例最小 satis.json：
{
"name": "MyCorp Private Packages",
"homepage": "https://packages.my-corp.com",
"repositories": [
{ "type": "vcs", "url": "https://git.my-corp.com/php/my-sdk" },
{ "type": "vcs", "url": "https://git.my-corp.com/php/my-utils" }
],
"require-all": true
}
注意：require-all 设为 true 才会拉取所有分支/Tag；设为 {} 或省略，Satis 默认只处理已打 Tag 的版本。
Composer 客户端怎么信任私有仓库？
两步缺一不可：在 composer.json 的 repositories 中声明仓库地址，并把 type 设为 composer；同时确保该地址 HTTPS 可达且证书有效（自签名证书必须提前导入系统 CA 或用 composer config -g cafile /path/to/cert.pem 指定）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误现象：
-
Could not fetch https://packages.my-corp.com/packages.json, please review your configured sources.—— 地址拼错、Nginx 未配try_files $uri /index.html =404（Satis 静态模式）、或证书不被信任 - 能访问
/packages.json但composer require mycorp/my-sdk找不到包 —— 检查 Satis 构建日志里是否成功解析了该仓库的composer.json，常见原因是 Git 仓库根目录下没有有效的composer.json或其name字段格式非法（如含大写字母或下划线）
为什么 Satis 构建后新 Tag 不生效？
因为 Satis 是快照式构建，不会监听 Git 变更。每次发新 Tag 后，必须手动运行 php bin/satis build satis.json web/ 并同步到 Web 目录。如果用 CI/CD，建议在 Git Tag 推送后触发构建流程，而非依赖定时任务。
另外注意：build 命令默认只处理 require 列表里的包；若新增了仓库，需先更新 satis.json 再构建，否则旧缓存会干扰结果。
构建慢？加 --skip-errors 跳过单个失败仓库，避免全量中断；加 -v 查看具体卡在哪——大概率是某个私有 Git 仓库 SSH 权限未配好，或 API Token 过期。
HTTPS 私有 Git 地址记得用 https://token:x-oauth-basic@git.my-corp.com/... 格式嵌入凭证，否则 Satis 拉不到代码。
