Skip to content

v0.3.2 — 进度页 + 数据库修复

Choose a tag to compare

@Cle2333 Cle2333 released this 21 Sep 11:33
· 7 commits to main since this release

新增

  • ★ 「进度」页:同步/下载全程看得见在干什么**。

    以前同步 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 秒没有任何进展就把所有线程的调用栈打进日志
    文件(并在界面上提示"把日志发给开发者")。

    这条是给"同步大量无损文件时应用卡到未响应"那次加的——当时翻遍日志只知道
    它停在某一步之前,具体位置查不出来。下次再出现,日志里会直接有答案。