外置存储必须使用本地文件系统（如ext4、xfs、btrfs），NFS/NTFS挂载因不支持原子写入和权限透传会导致Composer解压失败，表现为Permission denied或extractto()错误；需验证挂载类型、权限、sticky bit及动态设置COMPOSER_CACHE_DIR。
外置存储必须用本地文件系统，NFS/NTFS挂载会失败
Composer 解压 ZIP 包时依赖 fopen() 和 ziparchive::extractto() 直接写入文件系统，而 NFS、Samba 或 Windows NTFS（通过 WSL 挂载）常不支持原子性写入或 chmod 权限透传。现象是 failed to open stream: Permission denied 或 ziparchive::extractto(): failed to open stream，但错误只在解压阶段抛出，前期缓存目录创建、HTTP 请求都正常。
实操建议：
- Linux 下确认挂载类型：
findmnt -T /path/to/mount，只接受ext4、xfs、btrfs等本地文件系统 - U 盘或移动硬盘务必格式化为 ext4（Linux/macOS 可读写）或 exFAT（跨平台，但需确保挂载时启用
uid/gid选项） - 避免使用
noexec、nosuid、nodev挂载参数——Composer 需要执行临时脚本和生成可执行 bin 文件 - 挂载命令示例（ext4 移动硬盘）：
sudo mount -t ext4 -o rw,relatime,uid=1000,gid=1000 /dev/sdb1 /mnt/usb-composer
挂载后必须验证用户权限与 sticky bit
即使挂载成功，Composer 仍可能静默回退到默认缓存路径（如 ~/.composer/cache），不报错也不提示。根本原因是目标目录对当前用户不可写，或父目录缺少执行权限（drwxr-xr-x 缺少 x 位导致无法进入子目录）。
检查与修复步骤：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
ls -ld /mnt/usb-composer，确认输出中包含drwxr-xr-x或更宽松权限，且所属用户 UID 匹配（id -u） - 执行
touch /mnt/usb-composer/test && rm /mnt/usb-composer/test，验证读写能力 - 若挂载点属 root，且你非 root 运行 Composer，加
uid=1000,gid=1000到 mount 参数；或改用umask=0022确保新文件可被当前用户修改 - 关键细节：Composer 创建子目录（如
repo/、files/）时依赖父目录的 sticky bit（drwxr-xr-t）来保证多项目安全写入，手动chmod +t /mnt/usb-composer可预防冲突
USB 设备热插拔下 cache-dir 不生效的排查路径
当外置设备未始终在线（比如 U 盘只在构建时插入），Composer 会因 cache-dir 路径不存在而跳过缓存写入，直接回退到默认位置——不是 bug，是设计行为。此时 composer config --global cache-dir 显示路径正确，但 du -sh 发现没增长。
应对方式：
- 不要依赖
cache-dir配置长期生效，改用环境变量COMPOSER_CACHE_DIR，并在每次使用前动态判断设备是否存在：[ -d /mnt/usb-composer ] && export COMPOSER_CACHE_DIR="/mnt/usb-composer" || unset COMPOSER_CACHE_DIR - Docker 构建中禁用该路径：CI 脚本里加判断，设备不存在时自动 fallback 到
/tmp/composer-cache-$CI_JOB_ID，避免污染共享缓存 - 避免在
~/.bashrc里硬编码 USB 路径——设备未插入时 shell 启动失败，影响日常开发 - 验证是否真正走外置路径：执行
composer clear-cache后观察输出末尾的 “Clearing cache contents…” 行，路径必须匹配你的挂载点
USB 3.0+ 设备仍慢？关掉 journaling 和 atime 更新
外置 SSD 或高速 U 盘理论上应比机械硬盘快，但实际 Composer 安装速度无明显提升，常见于 ext4 默认启用 journaling 和频繁更新 atime。每写一个小文件（Composer 缓存含数万 .json 和 .zip）都会触发日志写入和时间戳刷新，拖慢整体 IO。
优化挂载参数：
- 重新挂载时加
data=writeback,journal=none,noatime,nodiratime（仅限 ext4，且确保断电风险可控） - 对移动设备，禁用
barrier=1（默认开启）可减少同步等待，但需接受极小概率元数据损坏风险 - 对比测试：用
time composer require monolog/monolog --no-install（只下载不解压）测网络层；再加--no-dev测完整流程，确认瓶颈在 IO 还是 CPU - 注意：exFAT 格式不支持这些参数，若必须用 exFAT，请优先确保挂载选项含
uid/gid和utf8，其余靠硬件提速
chmod 失败或 stat() 返回异常，就足以让它放弃整个缓存机制。 
