必须同步清理三处：~/.composer/cache/repo/https---packagist.org/（元数据索引）、composer.lock（版本锁定）和vendor/composer/installed.json（安装快照），否则composer update仍复用旧数据。
清理缓存后 composer update 仍报错，大概率不是缓存没清干净，而是你没动到真正卡住更新的三处关键状态：metadata 索引、composer.lock 锁定、vendor/composer/installed.json 快照。
为什么 composer clear-cache 无效？
它只删 ~/.composer/cache/files/（ZIP 包）和部分 repo/ 子目录，但不会碰：
• ~/.composer/cache/repo/https---packagist.org/ 下的 packages.json 主索引（默认缓存 15 分钟，且不随 clear-cache 刷新）
• composer.lock 里硬编码的 dist.sha256 和版本号（只要它存在，install 就绝不会升版）
• vendor/composer/installed.json 记录的当前安装快照（若手动删过 vendor 子目录，这里就变成“幻影包”，composer depends 会误判）
报错含 “nothing to install or update” 怎么办？
这几乎 100% 是 metadata 滞后。必须同步操作以下三步：
• 手动删掉整个 repo 元数据目录：rm -rf ~/.composer/cache/repo/https---packagist.org/（Linux/macOS）或 rd /s /q "%APPDATA%\Composer\Cache\repo\https---packagist.org\"（Windows）
• 删除 composer.lock 和 vendor/composer/installed.json
• 运行 composer update --dry-run -v 验证：看到 Downloading https://packagist.org/packages.json 才算真正重载元数据
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
报错含 “Corrupted zip file” 或 “hash verification failed” 怎么办？
这不是网络问题，是缓存 ZIP 文件损坏，且 composer.lock 里的 dist.sha256 与之不匹配。必须：
• 定位坏 ZIP：盯紧 composer install -v 输出末尾的 Extracting vendor/symfony/console，进 cache/files/ 用包名模糊搜索并仅删对应 ZIP
• 同步删 composer.lock 和 vendor/（不能只删 vendor）
• 重装时加 --no-cache --force-checksums：前者跳过本地 ZIP，后者让校验失败立刻退出，不污染 vendor
权限错配导致 Permission denied 却反复出现
常见于之前误用 sudo composer install，导致 vendor/、composer.lock 或缓存目录属主变成 root。
• 检查归属：ls -ld vendor/ composer.lock $(composer config --global cache-dir)
• 若任一输出第一列含 root，执行：sudo chown -R $USER:$USER vendor/ composer.lock $(composer config --global cache-dir)
• WSL 用户务必避开 /mnt/c/ 路径，改用 ~/projects/ 等原生路径
真正卡住更新的从来不是 ZIP 缓存本身，而是那三个相互咬合的状态文件：元数据索引、锁文件、安装快照。漏掉任意一个，清理都只是表面功夫。
