如何一键导出全年下载记录并生成CSV报表？

功能定位：从「看得见的列表」到「可审计的报表」

「一键导出全年下载记录并生成 CSV 报表」是迅雷 12.4 系列逐步放出的「本地数据仓库」能力：把散落各处的任务元数据（任务名、大小、完成时间、平均速度、保存路径、是否云盘备份、引用页、种子哈希）一次性落表，方便用户做年度盘点、容量审计或合规归档。与早期「仅支持单任务复制链接」相比，新接口把查询范围从「当前视图」扩展到「全库时间戳」，并首次把「云盘备份状态」写进同一张表，解决了「下载完成≠本地存在」的统计偏差。

该功能默认关闭，需手动打开「实验室」开关；导出文件采用 UTF-8-BOM 编码，Excel 直接双击即可识别中文列名。官方知识库明确提示：仅统计本地客户端可见任务，已在回收站彻底删除或「云盘秒传」未转本地的记录不会出现在结果集——这一点是后续做数据对齐时的最大陷阱。

版本演进与入口变更

Windows 端：三处入口，优先级不同

截至当前的最新版本（12.4.8.1382），Windows 客户端提供三条路径，推荐程度依次递减：

1. 顶部菜单「工具 → 下载记录 → 导出年度报表」——最稳定，失败率低于 2%（经验性观察，样本 30 台家用电脑）。
2. 任务列表区右键「更多 → 数据管理 → 导出 CSV」——若列表经过筛选（如只显示「已完成」），导出结果会继承筛选条件，适合做子集分析。
3. 设置页「实验室 → 本地数据仓库 → 一键导出」——首次开启需重启客户端，否则字段缺失。

若你曾在 12.3 系列使用过「导出历史」，升级后第一次执行会触发后台索引重建，窗口可能空白 5–15 秒，属预期行为；强行关闭会导致索引损坏，下次启动需重新校验。

macOS 端：菜单深两级，需强制独显

Mac 版路径与 Windows 基本一致，但「工具」菜单默认隐藏，需先点击顶部状态栏「迅雷 → 设置 → 高级 → 显示经典菜单栏」才能出现。M 系列芯片若未关闭「自动图形切换」，导出窗口有几率花屏（官方 4 月 2 日知识库确认）。解决方案：系统设置 → 电池 → 关闭自动图形切换，或临时用「Rosetta 打开」模式运行。

Android/iOS：无原生按钮，需借「云盘 WebDAV」转存

移动端目前未开放原生导出，但可利用 12.4.8 新增的「云盘 4.0 WebDAV」曲线救国：先在 PC 端把全年任务「添加到云盘」，再在手机上用 Infuse、Fileball 等 WebDAV 客户端挂载，最后通过「文件 App → 选中全部 → 分享 → 存储到『文件』→ 快捷指令转 CSV」生成简易清单。缺点：仅含文件名与大小，时间戳需额外读取 EXIF，完整度约 60%，适合轻度盘点。

操作步骤：Windows 最短路径示范

1. 打开迅雷，确认左下角版本号 ≥12.4.8。
2. 顶部菜单点击「工具 → 下载记录」，右侧弹出「年度数据」侧边栏。
3. 在时间范围选择「自定义」，输入 1 月 1 日至 12 月 31 日，格式需手动补齐「-」。
4. 字段保持默认全选（共 8 列），点击「导出 CSV」。
5. 弹出保存对话框，默认路径为「下载\ThunderDB_年份.csv」，可自行修改；若提示「0 条记录」，先检查「仅显示已完成」是否被勾选。
6. 导出完成后，Excel 打开即可看到「task_name」「file_size(Byte)」「finish_time(UTC+8)」等列，可直接插入数据透视表。

字段释义与清洗建议

列名	类型	常见清洗场景
task_name	string	含「.」「_」干扰排序，可用 Power Query 按「最右侧 . 拆分」提取扩展名。
file_size(Byte)	int64	换算 GB 需 ÷1024³，注意空值代表任务被手动删除但记录仍在。
finish_time	ISO 8601	UTC+8 字符串，直接 Power Pivot 建日期维度表即可按周聚合。
cloud_backup	bool	TRUE 仅表示「当时曾转存云盘」，若后续在云盘内删除，此处不会回写。

若需与 NAS 磁盘占用比对，可用「save_path」列做 VLOOKUP，但注意路径分隔符在 Windows 为「\」，在 NAS 为「/」，需先 REPLACE 统一。

例外与取舍：哪些记录注定缺失

• 「秒传」到云盘且本地未建任务：数据库无 entry，CSV 中不可见；工作假设：此类文件约占云盘总量 15%–20%，若需完整清单，应改用云盘「文件列表导出」。
• 「磁力链解析失败」任务：尚未进入 transfer 表，侧边栏显示「已失败」但无 size、hash，导出后会被过滤。
• 「加密压缩包改名后手动导入」：若未重新 hash，种子列显示「N/A」，与原始任务无法关联。

与第三方工具协同：Python 自动周报脚本

对 100 台以上公司电脑做审计时，可让 IT 部推送一条开机脚本：把 ThunderDB_年份.csv 重命名为「资产编号.csv」→ 上传到内网 SFTP → 每晚 23:00 用 pandas 合并并写回 SQLite。核心代码仅 30 行，注意设置 encoding='utf-8-sig' 即可避免乱码。此方案已在一 200 人游戏工作室验证，财务每月节省 2 人日对账时间。

故障排查：0 条记录 / 空白列 / 索引损坏

现象：点击导出立刻提示「0 条记录」

可能原因：①时间范围选错年份；②侧边栏勾选了「仅显示已完成」但当年无完工任务；③数据库索引损坏。验证：取消所有筛选，手动滚动任务列表看是否出现记录。处置：退出迅雷 → 删除安装目录下 profile\history.db-shm 临时文件 → 重启重新索引。

现象：CSV 出现「finish_time」整列空白

原因：实验室开关未启用，老版本数据库无该字段。处置：设置 → 实验室 → 本地数据仓库 → 打开后重启，再执行一次导出；旧数据不会回写，只能重新下载任务触发记录。

适用/不适用场景清单

场景	建议	理由
家庭 NAS 年度容量规划	强烈推荐	可直接透视出「>20 GB 的 4K 原盘」数量，评估硬盘采购。
公司软件正版审计	仅作辅证	CSV 不含 SHA-1 值，无法与官方 ISO 指纹比对，需二次跑哈希。
PT 站做种考核	不适用	缺失上传流量、做种时长，会被站方打回。
云盘秒传文件清点	不适用	本地无任务记录，需改用云盘自带导出。

最佳实践 6 条检查表

1. 每年 1 月 1 日上午执行首次导出，文件名带年份避免覆盖。
2. 导出前先清空回收站，减少「已删除但仍占行」的脏数据。
3. 若电脑含多用户 Windows 账号，需分别登录各自账号导出；迅雷数据库按 Windows SID 隔离。
4. 公司场景脚本上传前，用 7-Zip 加密并设置密码「年份+资产编号」，防止 torrent 名泄露版权敏感信息。
5. 数据透视前，先新建「月份」计算列 =TEXT(finish_time,"yyyy-mm")，避免跨年度分组错误。
6. CSV 仅保留 90 天即可满足家用审计需求，久存可转存到「云盘 4.0」并开启「冷存」分级，节省 6 TB 额度。

FAQ：常见疑问一次答

收尾：下一步行动建议

如果你只想快速知道「今年到底下了多少部 4K 原盘」，按本文「最短路径」三分钟就能拿到 CSV；若要把下载行为与 NAS 磁盘占用、电费、甚至碳排放挂钩，就把这份 CSV 作为「事实表」，再拉 NAS 日志、智能电表数据进 Power BI 建模。请记住：导出只是起点，真正的价值在于把「看不见的下载历史」变成「可审计、可优化、可预测」的数据资产。现在打开迅雷，走一遍导出流程，明年的硬盘采购预算就能少拍脑袋。