如果 Dannex Download Manager 意外关闭或停止响应,会打开一个崩溃报告窗口。窗口会显示发生了什么,您可以阅读完整报告,也可以将报告发送给 GitHub 上的开发者。每份报告都有助于解决问题,让所有人受益。

您会看到什么
- Dannex Download Manager 意外关闭:DDM 崩溃,或遇到内部错误并关闭。
- Dannex Download Manager 停止响应:窗口连续 8 秒没有响应。DDM 仍在运行,但已冻结。结束并重启 DDM会关闭已冻结的程序副本并启动一个新的副本。如果 DDM 自行恢复响应,窗口会显示这一情况。
在窗口中:
- 发生时您在做什么?是可选项。写几个字就很有帮助,例如“我打开了添加 URL”。
- 报告会显示所有将要发送的内容。您可以先阅读。
- 在 GitHub 上发送会在浏览器中打开 GitHub 的崩溃报告表单,并预先填好内容,同时打开报告所在的文件夹。将报告文件拖到表单中,检查后提交。您需要一个 GitHub 帐户。不会自动发送任何内容。
- 如果有人已经报告了相同的问题,窗口会显示(已报告为问题 #…)。打开已报告的问题会打开该问题,并将您的报告复制到剪贴板,以便您将报告作为评论添加。
其他按钮可以复制报告、打开报告所在的文件夹,或重新启动 DDM。
报告包含的内容
- 发生了什么:错误,以及错误在 DDM 代码中发生的位置。
- 调用堆栈:DDM 代码中发生崩溃或冻结的位置,以及其他各部分当时正在执行的操作。
- DDM 的最新日志:例如“命令 AddUrl”或“窗口已打开:add-url”。
- 系统信息:DDM 的版本和安装方式、操作系统及其版本、处理器、语言和主题,以及下载和队列的数量。这些信息只包含数量。
不包含以下内容:
- 下载地址或文件名;
- 用户名(在文件夹路径中显示为
~)。
如果错误消息引用了您输入的内容,该内容也会包含在报告中,因此发送前请先阅读报告。
崩溃数据文件(.dmp)是 DDM 当时运行状态的快照。它对开发者最有帮助,但可能包含 DDM 内存中的部分内容,例如下载地址、Cookie 和已保存的密码。只有勾选同时附上崩溃数据后,才会附上此文件。
报告保存位置
在 DDM 的数据文件夹中:
crashes\:每个报告 (.txt) 及其崩溃数据 (.dmp);logs\:DDM 的日志 (mdm.log,较旧的日志为mdm.1.log等,每个 2 MB)。
DDM 的数据文件夹在 Windows 上是%APPDATA%\dannexdownloadmanager,在 macOS 上是~/Library/Application Support/dannexdownloadmanager,在 Linux 上是~/.local/share/dannexdownloadmanager。在便携模式下,数据文件夹是程序旁边的data文件夹。
日志会记录 DDM 的操作,因此报告可以显示问题的起因。要记录更详细的信息,请使用环境变量MDM_LOG=debug启动 DDM。
开发者信息
工作原理:DDM 的另一个副本(即监视器)会通过--crash-monitor在 DDM 旁边启动。崩溃处理代码位于crates/crash和crates/app/src/crash.rs中。
- 捕获问题。 当 DDM 崩溃(Windows 异常、Linux 信号、macOS Mach 异常)、程序异常终止或冻结时,它会向监视器请求一个转储。冻结是指窗口运行超过 8 秒的帧,由一个忽略休眠时间的看门狗线程检测。它会测量帧的两个部分:DDM 处理的部分(接收到的命令、下载时钟、队列和计划程序),这部分在最小化时也会运行,以及绘图部分;但不测量帧之间的等待时间。看门狗还会测量在此期间窗口线程获得了多少处理器时间,报告会说明这意味着什么:它一直在运行(一个循环),它在锁或 I/O 上等待(死锁),或者它几乎没有在普通代码中运行,这表示计算机太忙而无法运行 DDM 或从磁盘加载 DDM 太慢,这很可能不是 DDM 的错误(这些情况共享一个签名,
freeze while the computer was busy)。如果转储写入时窗口线程已经回到事件循环中,则冻结在快照之前已经结束,因此其堆栈无法解释冻结;这些报告会说明这一点并共享签名freeze over before the snapshot。macOS 尚未测量此项。然后,监视器通过minidumper和crash-handler从外部写入每个线程的小型转储。崩溃的进程从不写入自己的转储,Firefox、Crashpad 和 Sentry 也是如此。 - 读取转储文件。 监视器使用 Mozilla 的
rust-minidump读取转储文件。如果找到发布版本的 Breakpad 符号,就会使用这些符号。使用--features mdm-crash/native-symbols构建的源码版本也可以读取旁边的原生调试信息(其.pdb,DWARF);随附的应用不包含该读取器,因为它会占用几 MB。报告的签名(例如freeze in dannexdownloadmanager::winui::combo_edit)在同一问题的多份报告中保持不变,窗口会据此搜索现有问题。 - 符号。 发布版本保留行号表(
debug = "line-tables-only"),但下载文件不包含调试信息。CI 会将其转换为DannexDownloadManager-<version>-symbols-<platform>.zip(tools/installer/symbols.py,使用 Mozilla 的dump_syms),并与发布版本的其他文件一同发布。当堆栈中只有裸地址时,报告窗口会获取对应版本的 zip 文件。 - 来自问题的
.dmp:
cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp DannexDownloadManager-<version>-symbols-windows-x64.zip
- 测试。
cargo test -p mdm-crash会触发实际的冻结、panic 和崩溃(examples/crashy.rs),并检查每份报告的签名。要在应用中测试,请使用MDM_CRASH_TEST=1启动 DDM,然后运行dannexdownloadmanager /show crash-test:freeze(死锁;或者运行spin,让窗口线程忙碌 12 s;还可以运行panic、crash、abort)。cargo test -p mdm-app --test freeze_report -- --ignored会在屏幕外的应用副本中执行这些操作,窗口保持可见并处于最小化状态。
免费、开源、无广告、无试用版。
下载 Dannex Download Manager