Repository navigation
v0.3.2 — 进度页 + 数据库修复
新增
-
★ 「进度」页:同步/下载全程看得见在干什么**。
以前同步 147 首到 iPod,界面在最长的那一段(无损档要把每首 FLAC 转成
ALAC,加上往设备里拷 3.3 GB,实测 6 分钟)什么都不显示——进度条停在
0% 一动不动,看起来就是卡死了。现在:- 进度条上方显示当前阶段:读取歌单 → 下载到本地 → 读取本地文件 →
写入 iPod → 把 N MB 刷到设备 → 重建数据库并签名 - 每一段按自己的总数算百分比;不会拿「下载了 3/3」去比「要写 147 个文件」
- 切不出等份的步骤(刷盘、整库重写)显示一直在滚的条,并写明
「它在滚就说明没卡住」——以前这里画的是停在 0% 的死条 - 显示已用时间;剩余时间按当前这一步的速度算
左侧导航的「下载」改名「进度」,因为它现在同时管下载和同步。
- 进度条上方显示当前阶段:读取歌单 → 下载到本地 → 读取本地文件 →
-
★ 「数据库修复」:扫出数据库和磁盘对不上的地方,勾选后清掉。
「iPod 音乐管理」页新增一个按钮。扫完会列出三类,每一项都写明后果:
类别 现象 处理 孤儿文件 磁盘上有、数据库不认 删文件。iPod 上看不见它们,但白占空间 残留临时文件 写入被打断留下的中间文件 删文件 断链记录 数据库有记录、磁盘没文件 删记录。iPod 上显示得出来但播不了 孤儿文件是怎么来的:同步是「先拷文件、再写数据库」两步。第二步失败
(异常、或者进程被杀),文件已经在设备上了,而 iPod 的界面只认数据库 ——
于是它们既看不见、又占着空间,下次同步还会重新分配文件名再拷一遍,
失败一次多一份。实测在一台设备上堆到过 294 个文件、6.4 GB。几处刻意的设计:
- 断链记录默认不勾。它要重写整个数据库,风险最高,必须用户自己勾
(界面上也会写明"其他歌不会丢")。 - 清理时重新扫一遍,不用界面上那份清单。从扫到点确认可能过了几分钟,
设备也许被外部改过;重扫最多多花几秒,但保证删的每一刀看的是当前状态。 - 路径比对折叠大小写。iPod 是 FAT32,大小写回显不一致;按敏感去比
会把正常文件判成孤儿然后删掉。 - 数据库读不出来时给中文原因和下一步("先在电脑上用 iTunes / Finder 看一眼
……必要时用备份恢复"),而不是甩一个InsufficientDataError。
- 断链记录默认不勾。它要重写整个数据库,风险最高,必须用户自己勾
变更
-
★ 删掉界面上的「健康检查」(「iPod 音乐管理」页那个按钮)。
它只诊断不动手,而结论写在一个看不到的地方:点完只弹一句"已开始
健康检查,到「下载」页看结果",可那页根本不显示这类作业 —— 于是它唯一
的用途就是让人以为"检查过了,没问题"。更糟的是它那句总结:找到 6 个孤儿文件时,报告里写的是**「检查完成:
全部通过」**("警告"不算"失败")。同一台设备上,「数据库修复」一扫就报
出 7 个问题。从外面看,这就是个假功能。现在这一步由「数据库修复」接手:它会扫、会说出来、也能直接清掉。
- 命令行那条
ipod verify保留 —— 它是排查设备用的诊断工具
(查签名、封面、播放列表、备份),跟界面上的按钮不是一回事。 - 设备验收脚本(
tools/verify_device_flow.py)里那一步也换成了
数据库修复扫描。
- 命令行那条
修复
-
★ 「下载好了无法同步」——确认对话框上的按钮写着「开始同步 0 首」。
先下载到本地、再点同步,
需要下载必然是 0(都已经下好了)。而那个按钮
显示的是"需要下载几首",于是恒显示 「开始同步 0 首」——看起来像没东西
可同步,或者像坏了,用户就不会点它。同步作业因此从来没提交过。按钮现在显示"要同步几首",并且把两个数字分开写清楚:
要同步 147 首/本地已有(不用再下)147 首/ 有需要下载时才写
其中需要先下载 N 首。 -
★ 写数据库失败时不再在设备上留垃圾文件。
同步是"先拷文件、再写数据库"两步。以前第二步失败(异常,或者进程被关掉),
已经拷进去的文件就留在设备上了——而 iPod 的界面只认数据库,于是这些文件
既看不见、又白占空间,下次同步还会重新分配文件名再拷一遍,失败一次多
一份。实测一台机器上就这样堆到 294 个孤儿文件、6.4 GB。现在写库失败会把这次拷进去的文件撤掉。已经堆出来的可以用新加的
tools/find_orphans.py清理(默认只列不删):uv run python tools/find_orphans.py --ipod D:\ # 只看 uv run python tools/find_orphans.py --ipod D:\ --delete # 真删
-
★ 网络请求没有"总时长"上限,能把同步拖死(这就是"同步 147 首时应用
卡到未响应"的原因)。urllib.request.urlopen(url, timeout=N)里的timeout是每次 recv 的超时,
不是"这个请求总共最多花多久"。服务器只要慢慢吐数据(响应头分几次发、
或者每几十秒给一点),每次 recv 都算"没超时",于是这个 timeout
永远不会触发。实测抓到的调用栈(同步 147 首时):
ssl.py in read ← 一直在等网络 http/client.py in _read_status ncm/client.py in cover_bytes ncm/downloader.py in download_song它就在等一个迟迟不来的响应,而 socket 超时救不了它。表现是整个应用
无响应(界面每个请求都跟着排队),Windows 最后判定"未响应"。现在读响应时自己掐墙钟:音频下载 5 分钟、封面 1 分钟、接口 1 分钟。
超时就报错跳过,不会无限等。补充说明:这一次同步最终是成功的(147 首全部写入、封面齐全、
播放列表也建好了),只是它爬了 9 分半钟,期间界面完全没反应——
所以看起来像"卡死了"。现在这种长时间静默会变成明确的超时错误。 -
作业卡住时会自动把现场写进日志(应用不再"无声无息地卡死")。
以前作业一旦卡在某个阻塞调用里,日志就停在那儿,完全看不出卡在哪一行。
现在有看门狗盯着:60 秒没有任何进展就把所有线程的调用栈打进日志
文件(并在界面上提示"把日志发给开发者")。这条是给"同步大量无损文件时应用卡到未响应"那次加的——当时翻遍日志只知道
它停在某一步之前,具体位置查不出来。下次再出现,日志里会直接有答案。