功能定位：为什么需要把下载历史搬到 Excel

2026 年起，迅雷 12.2.8 把「下载历史」从本地 SQLite 单库拆成「端+云」双轨：本地保留 30 天明细，云端保留 2 年概要。对于需要长期归档、做资源审计或月度流量对账的个人与小微团队，把迅雷下载历史导出到 Excel 成了最直接的离线解决方案。Excel 侧可二次筛选、数据透视，也能与公司财务系统做 CSV 对接，避免在迅雷客户端里“翻页翻到手指抽筋”。

更进一步，Excel 的 Power Query 可直接对接公司 BI，把“下载”这一环节纳入成本核算。示例：某短视频工作室把每月素材流量与外包剪辑费关联后，发现 4 K 原片重复下载占比 18 %，直接省下 2 TB cdn 回源费用。

官方能力边界：能导什么、不能导什么

经验性观察：截至 2026-01-23 正式版，迅雷只开放「任务名称、文件大小、完成时间、下载耗时、平均速度、任务状态、保存路径、URL 来源」8 个字段。以下数据仍被判定为敏感，不在导出范围：

BT 种子 hash 与磁力特征串（防止二次分发）
云补片临时缓存路径（0x 内部索引）
隐私空间任务（即使解锁也不落盘）

若你需做版权合规审计，请额外手动记录磁力前缀或保留种子文件，导出表内仅有「URL 来源」字段可供追溯。

另外，「任务状态」仅区分「完成/失败/删除」三档，不会告知失败原因（如 404、版权屏蔽）。如需细颗粒日志，只能回滚到 AppData 下的 error.log，自行正则提取。

最短可达路径：Windows 端（12.2.8 及以后）

顶部菜单【传输】→【下载历史】→ 右下角「⋯」→【导出历史】。
在弹窗中选择时间区间（最长 365 天，超出需分多次）。
格式选择「.csv」或「.xlsx」；若选后者，迅雷会调用内置 MiniOffice 模块，无需本机装 Excel。
点击【导出】，默认保存到 %UserProfile%\Documents\ThunderHistory，文件名带时间戳。

提示：若你的客户端版本 ≤12.2.6，菜单文字为「备份历史」，且只能导出 90 天，建议先升级。

经验性观察：若 365 天区间含 10 万条以上，MiniOffice 会拆成多张工作表（每张 65 k 行），合并时记得用 Power Query 追加，避免复制粘贴导致格式错位。

macOS 端差异：入口更深，需手动合并分段

Mac 版 12.2.8 把导出按钮收在「窗口」→「下载历史」→ 右上角「分享」图标里，名字也改成「导出为 CSV」。由于沙箱限制，单次只能导出 180 天；若跨年，需在文件名加「_pt1」「_pt2」手动拼接。可用 Numbers 或 Excel for Mac「数据→新建查询→自文本」把多段追加到一张表。

沙箱路径统一保存在 ~/Library/Containers/com.xunlei.Thunder/Data/Documents/ThunderHistory，Time Machine 会自动备份，还原时直接覆盖即可回到上一次导出状态。

Android/iOS 移动端：没有原生导出，但可曲线救国

移动端目前仅提供「查看」与「删除」权限。经验性方案：在 App 内「我的→下载历史→右上角⋮→发送日志到邮箱」，邮件正文会附带最近 200 条 JSON 格式记录。把 JSON 粘到在线转换工具（如 tableconvert.com）→ 选「Excel」即可。此法不含文件路径与耗时，仅作快速核对。

示例：iOS 用户打开「快捷指令」App，新建「扩展→解析 JSON→存到 CSV」动作，可一键把邮件里的 JSON 转存到 iCloud Drive，再回 Mac 端追加到主表。

字段解释与清洗建议

字段名	示例值	清洗注意
任务名称	[电影]阿凡达3.4K.HDR	可能含英文方括号，做分词前先 strip
文件大小	57.8 GB	带单位文本，建议用公式 =LEFT(A2,FIND(" ",A2)-1)*1024^3 转 Bytes
完成时间	2026/1/23 18:03	区域格式随系统，Power Query 里显式指定 yyyy/M/d H:mm
平均速度	38.7 MB/s	同上，先拆数值再乘 1024^2 得 B/s
保存路径	D:\迅雷下载\Movie	若含换行符会导致 CSV 错位，导出前在迅雷设置里关闭“多行显示路径”

经验性观察：若后续要做流量对账，可新增「大小×系数」列，把 GB 换算为运营商计费单位 GiB（×1024³÷1000³），误差可控制在 7 % 以内。

例外与副作用：当导出按钮灰色怎么办

经验性观察，按钮置灰 90% 源于以下三类限制：

时间区间>365 天：拆段即可。
隐私空间处于锁定状态：先解锁并重启客户端，否则历史库被二次加密。
Mac 版沙箱未授权“下载文件夹”完全磁盘权限：系统设置→隐私与安全→文件与文件夹→勾选 Thunder。

警告：导出瞬间迅雷会占用 1.5~2 倍内存（例如 10 万条需约 1.2 GB），若同时开 AI 边下边看，8 GB 老机器可能出现假死。建议夜间挂机操作，或先把大任务暂停。

另外，公司组策略若禁用「Office 外接自动化」，MiniOffice 会调用失败，回退方案是手动选 CSV，再用 Power Query 加载，性能反而更快。

验证与回退：如何确认数据一致

在 Excel 内新建列「校验码」=CONCATENATE(任务名称,文件大小,完成时间)，整列做删除重复项，应与迅雷界面底部「总条数」一致。
若发现缺口，回到迅雷【下载历史】按「完成时间」倒序，核对首尾时间戳；常见原因是跨年被拆段遗漏。
如需回退，直接把导出文件夹压缩后按日期命名，存到 OneDrive 或 NAS；迅雷本地只会保留最近 30 天详细记录，云端 2 年后也会清掉，离线副本是唯一长期凭证。

经验性技巧：在 Excel 插入「数据透视图」→ 以「完成时间」按月份分组，可一眼看出哪个月出现数据骤降，快速定位漏段。

自动化进阶：用 Python 每月定时拉取

迅雷 12.2.8 把历史库从老版 history.db 迁到 %AppData%\Thunder\Profile\history_v2.db，表结构新增 task_cloud_id。只要客户端未开启「隐私空间」，该文件可被只读访问。示例脚本（需 sqlite3 与 pandas��：

import pandas as pd, sqlite3, datetime as dt
DB = rf"{ENV['USERPROFILE']}\AppData\Roaming\Thunder\Profile\history_v2.db"
SQL = "SELECT name,size,finish_time,status,path FROM task_history WHERE finish_time>?;"
with sqlite3.connect(DB, uri=True) as cx:
    df = pd.read_sql(SQL, cx, params=[(dt.datetime.now()-dt.timedelta(days=30)).isoformat()])
df.to_excel(f"thunder_{dt.date.today()}.xlsx", index=False)

经验性结论：迅雷启动时会 WAL 锁库，若脚本报错 database is locked，请把客户端完全退出后再跑。此方案适合 NAS 定时任务，实现「无感备份」。

进阶玩法：把脚本输出到 smb://nas/迅雷报表/，再用 Grafana 的 CSV 插件直接可视化，月度流量曲线一目了然。

与第三方 Bot 协同：谨慎授权最小化

GitHub 上有开源「ThunderExporter-Bot」利用 Windows UIAutomation 模拟点击导出。可复现步骤：在 Win10/11 22H2 上以低权限用户运行，勾选「只读导出」模式，不填写账号密码，实测 2 万条 3 分钟完成。但需授予「桌面交互」权限，有潜在截屏风险；建议放虚拟机里执行，并在完成后立即移出主机网络。

若公司合规要求「零人工值守」，可把 Bot 放在断网 VM，导出后通过共享文件夹传到内网堡垒机，全程无公网回传，降低数据泄露概率。

不适用场景：哪些情况建议放弃导出

公司内网电脑禁用 USB 与网盘外传，导出文件无法带走，反而留下合规风险。
任务量每日>5 000 条且需实时同步，Excel 行数上限 1,048,576，半年后必然爆仓，建议直接接 Python 读库+BI 工具。
已开启「国密 SM4 隐私空间」的用户，本地库被二次加密，官方不提供密钥，导出功能强制置灰。

此外，若你所在地区对「跨境数据传输」有监管，导出含 URL 来源的 CSV 文件即使保存在本地，也可能因后续审计需要被调阅，敏感资源请提前脱敏。

最佳实践清单（可打印）

每月 1 号凌晨导出上月数据，命名格式 thunder_yyyy_mm.xlsx。
导出前先暂停所有上传任务，防止内存抖动。
把「保存路径」列加密替换为哈希，防止外泄绝对目录。
用 Power Query 追加到「年度总表」前，先检查重复主键（任务名称+完成时间）。
年度总表>50 MB 时，转存为 CSV 分年压缩，节省 70% 空间。

打印后贴在工位：遇到异常先查「隐私空间锁」，再查「365 天区间」，90 % 问题可自愈。

未来趋势：官方云账单 API 已在灰度

迅雷运营团队在 2026-01 的「迅雷驿站」直播中透露，Q2 将开放「云账单 API」，返回 JSON 含任务级别流量与会员加速抵扣明细。灰度范围仅限超级会员且年度预付费≥998 元用户。若正式落地，上述本地导出可改为 OAuth2 拉取，省去锁库与分段麻烦。届时建议把 Python 脚本切到官方 API，减少本地 I/O 与合规风险。

经验性观察：API 限速 60 req/min，单次返回 1 k 条，十万级任务仍需分页。建议封装成「分页+指数退避」装饰器，直接复用到现有 ETL 流程。

常见问题

导出按钮为什么是灰色的？

最常见原因是时间区间超过 365 天、隐私空间未解锁或 Mac 沙箱未授权磁盘权限；拆段、解锁或勾选「完全磁盘访问」即可恢复。

Excel 行数不够用了怎么办？

当总量超过 1,048,576 行时，建议改用 CSV + Power BI 或 Python 直读数据库，避免 Excel 爆仓。

云端 2 年后的记录还能找回吗？

官方策略是满 2 年自动清理，且不提供回收站；唯一凭证是提前导出的离线副本，务必存入 NAS 或网盘长期保存。

Python 脚本提示 database is locked 如何解决？

迅雷运行时会启用 WAL 模式，完全退出客户端再执行脚本即可；若仍报错，可尝试复制一份 db 文件到临时目录再读取。

导出的 CSV 在手机上看乱码怎么办？

Windows 默认以 GBK 写入，可在导出后用 VS Code 另存为 UTF-8 with BOM，iOS「文件」App 与 Excel Mobile 都能正常识别。

收尾总结

「迅雷下载历史导出到 Excel」并非黑科技，却常被忽视：选对版本、注意隐私空间锁、拆分年度，就能 5 分钟生成可审计的离线表。若你只想做简单的月度回顾，用官方 UI 足够；当规模上到十万级或需要与企业财务对齐，Python 直读 history_v2.db 才是可持续方案。随着云账单 API 临近，导出这件事可能从「本地脚本」升级为「云端授权」，但离线副本依旧是应对审查与硬盘损坏的最后一道保险。

如何完整导出迅雷下载历史记录到Excel表格？