架构

Mister Download Manager 各部分如何协同工作。

Crates

依赖关系指向内部：app、cli、mcp 和 nmhost 使用 engine 和 ipc；引擎对 UI 一无所知。应用仅通过其事件（进度、分段表快照、完成、失败）查看引擎。

引擎

Download
 ├─ probe()              size, resumable?, validators (ETag / Last-Modified), file name
 ├─ Planner (pure)       segment table: when a connection is free, the largest remaining
 │                       part is split in half (planner.rs, tested by random simulation)
 ├─ Worker × N           one HTTP/1.1 connection each, reused across segments; slow ones
 │                       are dropped and their part re-split
 │    └─ writes at its offset into <name>.mdm.part (created sparse)
 ├─ HostLimits           learns how many connections each server accepts
 ├─ Limiter (shared)     per-download and global token buckets
 ├─ State                segment table saved atomically (craft-atomic) for crash-safe resume
 └─ events → channel     Progress, Done, Failed

当所有分段完成后，部分文件会根据预期大小进行检查并重命名到位；文件的日期可以跟随服务器的日期。

FTP 和 FTPS（ftp.rs）通过相同的规划器、工作器和状态：一个分段是控制会话上的 REST + RETR，而不是范围 GET，SIZE 和 MDTM 代表头部，会话按下载进行池化并在分段之间重用。

应用

一个绘制到固定像素坐标的 egui 窗口，加上每个对话框一个即时视口。app.rs 保存状态（下载、队列、设置、列表选择）并将菜单、工具栏、按键和 IPC 命令转换为操作。每个对话框都是自己的模块，并返回一个 Outcome（打开、关闭、带值完成）。仅限 Windows 的调用限制在 win32.rs 中，其 Linux 和 macOS 对应项限制在 unix.rs 中（从会话、浏览器主机、声音、在文件夹中显示、崩溃处理程序开始）；所有其他文件都是安全的、可移植的 Rust。字体来自系统：Windows 的 Fonts 文件夹、macOS 的系统字体、Linux 上的 fontconfig（theme.rs）。

下载列表和设置以原子方式保存到 %APPDATA%\misterdownloadmanager\（downloads.json）。浏览器主机读取相同的文件以获取捕获规则，因此“选项”中的更改适用于下一个捕获的下载。

浏览器集成

page ──► extension ──native messaging──► mdm-nmhost ──ipc──► app

扩展程序询问主机要捕获哪些文件类型，对照它们检查每个下载，并且只有在应用接受后才取消浏览器的下载；否则浏览器会保留它。

翻译

UI 显示的每个文本都通过 crate::i18n（craft-i18n 目录，i18n/<locale>.tsv）。tools/i18n/extract.py 从源代码重建 i18n/en.tsv，并在每个文本上为翻译人员提供注释（它是什么，在哪里显示，其占位符）。

测试和基准

cargo test针对注入故障（慢速、丢弃和拒绝连接、无范围服务器、文件更改）的 mdm-labserver 运行单元测试和端到端下载。tools/bench 运行已发布的速度比较；其原始数据在 docs/bench/ 中。