satis build不能直接放进crontab因工作目录和权限不一致，需用绝对路径、显式cd、--no-interaction及重定向错误日志；不支持增量构建，可借git预检+--skip-unused优化；须注意php/composer版本兼容性及配置完整性。
为什么satis build不能直接放进crontab里跑
因为satis build默认依赖当前工作目录下的packages.json和缓存路径，而crontab执行时的$HOME和cwd往往不是你预期的位置，导致配置文件找不到、缓存写入失败或权限错误。常见报错包括：file_get_contents(packages.json): failed to open stream 或 Permission denied 写web/目录。
实操建议：
- 用绝对路径调用
satis命令，例如：/usr/local/bin/satis build /path/to/config.json /var/www/satis - 在crontab中显式指定
cd到配置目录再执行，避免路径歧义 - 确保运行crontab的用户对
config.json、输出目录/var/www/satis和cache/子目录有读写权限 - 加
--no-interaction参数防止交互阻塞（crontab无TTY）
如何让Satis只更新变动的包而非全量重建
全量satis build在包数量多时极慢，且会重写所有packages.json和HTML页面，浪费IO和CDN刷新成本。Satis本身不支持增量构建，但可通过--skip-unused和Git仓库的更新时间做轻量规避。
实操建议：
- 在
config.json中启用"archive": {"skip-dev": true}减少归档开销 - 用
git ls-remote或composer show --outdated预检哪些仓库有新tag，动态生成临时config.json再构建（适合中大型私有包源） - 加
--skip-errors防止单个包失败中断整个流程 - 输出目录建议分离：静态文件走
rsync增量同步，而非每次覆盖web/
crontab里怎么写才不会漏掉错误日志
静默失败是定时任务最头疼的问题——看起来每小时都跑了，其实从第三天起就因权限问题卡在第一步，而你完全不知情。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- crontab条目必须重定向
stderr，例如：0 * * * * cd /opt/satis && /usr/local/bin/satis build config.json web --no-interaction 2>> /var/log/satis-cron.log - 加
|| echo "$(date): build failed" >> /var/log/satis-cron.log捕获非零退出 - 避免用
>&1合并stdout/stderr，Satis的日志结构混乱，混合后难排查 - 定期
logrotate清理日志，否则satis-cron.log几个月后可达GB级
PHP版本和Composer兼容性踩坑点
Satis是PHP工具，但不同版本对Composer API调用差异很大。例如Satis 2.x要求PHP ≥7.4且composer/composer v2.x；若系统PHP是8.2但全局Composer是v1，satis build会报Class "Composer\Package\Version\VersionParser" not found。
实操建议：
- 不要依赖系统级
composer，改用php /path/to/composer.phar显式指定二进制 - Satis安装推荐用
composer create-project composer/satis:dev-main（最新稳定分支），而非global require - 检查
php -v和php -r "echo Composer\Autoload\ClassLoader::class;"是否能正常加载，确认Autoloader未被破坏 - 如果用Docker，镜像里PHP版本、OpenSSL扩展、cURL CA证书路径三者必须同时对齐，否则私有Git仓库HTTPS克隆失败
真正麻烦的不是写那行crontab，而是当某天某个包的composer.json里写了"minimum-stability": "dev"，而你的Satis配置没设"require-all": true，结果这个包悄悄消失了——连日志都不会报错，只有下游开发者拉不到包时才反馈。
