Composer 中不存在“中文架构”，Downloader 组件是纯英文、语言无关的 PHP 机制，其行为由 PackageInterface::getDistType() 动态匹配 DownloadManager 注册的下载器，且仅在存在 dist 段时触发 DownloaderInterface::download()。
Composer 里没有“中文架构”——Downloader 组件的设计与语言无关，它是一套基于接口契约和运行时分发的纯 PHP 架构机制。所谓“中文”只是本地化文档或误传，实际代码中所有类名、接口名、方法签名全是英文，DownloaderInterface 不会因为你的 composer.json 是中文注释就改变行为。
DownloaderInterface 是怎么被调用的
Composer 不是靠配置文件决定用哪个下载器，而是由 DownloadManager 根据 PackageInterface 的 getDistType() 动态匹配。比如一个包的 dist.type 是 "zip"，DownloadManager 就找注册在 "zip" key 下的 downloader 实例。
- 必须用
$dm->setDownloader('zip', $yourDownloader)显式注册，且 key（如'zip'）要和包的dist.type完全一致 - 如果包没
dist段（只有source），DownloaderInterface::download()根本不会被触发——此时该看InstallerInterface -
PackageInterface::getDistUrl()返回null或空字符串，Composer 会跳过下载器，直接 fallback 到 git clone - 调试时别只看命令行输出，要在
download()方法开头加file_put_contents('/tmp/down-hit.log', "yes\n", FILE_APPEND)确认是否真进来了
为什么继承 ZipDownloader 比实现 DownloaderInterface 更稳妥
从头实现 DownloaderInterface 容易漏掉关键逻辑：重试策略、HTTP 头设置、临时文件清理、SHA256 校验、并发限流支持。而 ZipDownloader 这类基类已封装好这些，并留出 extract()、doDownload() 等钩子供定制。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 基类自动处理
dist.url解析、dist.reference插值、响应流式写入 - 若你只改下载源（比如走私有 CDN），重写
doDownload()即可，不用碰校验和解压 - 若要改解压逻辑（比如跳过 vendor 目录、过滤敏感文件），覆盖
extract()更安全 - 不继承基类而手写
download()，大概率会在vendor/composer/installed.json写入错误的dist元数据，导致后续composer update行为异常
常见失败现象和对应检查点
现象：Package operations: 1 install... 正常显示，但你的 downloader 没执行，vendor 里文件来自 Packagist 而非你的服务。
- 检查插件是否真正激活：在
activate()开头加file_put_contents('/tmp/plugin-activated', 'x')，确认文件生成 - 检查
composer.json中该包的dist.type值，是否和你setDownloader()的 key 一致（大小写敏感） - 运行
composer install -v，看日志里有没有Downloading ... from [your-url]；没有就说明没走到你的 downloader - 确认包定义中
dist.url不为空且可访问，用curl -I测试返回码，403/404 会静默 fallback - Windows 下若用路径 URL（如
file://C:/xxx.zip），需确保 PHP 的allow_url_fopen开启，否则CurlDownloader会抛Invalid URL
Downloader 组件真正的复杂点不在代码量，而在它和 Package 对象生命周期、dist/source 决策链、以及 DownloadManager 调度顺序的耦合。最容易被忽略的是：哪怕你注册了 downloader，只要 Package 对象在创建时 dist 数据已固化（比如来自 composer.lock），后续就不会再查 getDistUrl() —— 所以改 downloader 逻辑前，先清掉 composer.lock 和 vendor/，用 composer install --no-cache 重走全流程。
