本地期望、云端对象与相册关系分别核对
现在
在用
截至 11 月 6 日 · 云端本地记录和维护回执

个人媒体整理与恢复 · 功能说明

本地整理不被云故障打断。整理后的照片和视频以 Google Photos 恢复集加“其他归档”覆盖本地保留集,PSD 明确排除;音乐和铃声进入 Drive 已有“音乐”根,录音平铺“音乐/录音”;不另建录音根,不把照片视频复制到 Drive。每天热备结束后自动跑一轮接口维护;电脑上删掉的原件,Drive 经接口进回收站,Photos 攒够一批后走正规网页删除。需要云端恢复时,分清计划内容、已传字节、缺失关系和当前不能继续的步骤。

当前情况:本地记录应上云 4,677 件(Photos 3,869、Drive 808),已同步记录 4,365 件,另 312 件在 30 天稳定期里等待(11 月 6 日 14:26 只读本地记录)。稳定期里 Photos 266、Drive 46,4,365 + 312 正好是 4,677。现在没有待本人决定的上传项。失败、未知、暂停都是 0,也没有等网页删除或等进 Drive 回收站的。稳定期最早 11 月 12 日 22:33 到期,最晚 12 月 6 日 04:42;到期只是有资格上传,不保证那一刻传完。最近一次接口维护 11 月 6 日 08:45—08:47 完成:Drive 传了 2 件、Photos 传了 1 件,和 Google 通信成功;这是维护程序当时留下的回执。Photos 网页删除不装定时任务:待删攒够 30 张,看板提醒,当时在干活的 AI 取精确链接用我的 Chrome 删,删完结算;登录或工具出问题就留待办给后面的对话。本次没有访问云账号,不能说今天 4,677 件都已在云端,也不能说 312 件都会在同一天自动传完。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

本地期望、云端对象与相册关系分别核对
现在
在用
截至 11 月 6 日 · 云端本地记录和维护回执

个人媒体整理与恢复 · 功能说明

本地整理不被云故障打断。整理后的照片和视频以 Google Photos 恢复集加“其他归档”覆盖本地保留集,PSD 明确排除;音乐和铃声进入 Drive 已有“音乐”根,录音平铺“音乐/录音”;不另建录音根,不把照片视频复制到 Drive。每天热备结束后自动跑一轮接口维护;电脑上删掉的原件,Drive 经接口进回收站,Photos 攒够一批后走正规网页删除。需要云端恢复时,分清计划内容、已传字节、缺失关系和当前不能继续的步骤。

当前情况:本地记录应上云 4,677 件(Photos 3,869、Drive 808),已同步记录 4,365 件,另 312 件在 30 天稳定期里等待(11 月 6 日 14:26 只读本地记录)。稳定期里 Photos 266、Drive 46,4,365 + 312 正好是 4,677。现在没有待本人决定的上传项。失败、未知、暂停都是 0,也没有等网页删除或等进 Drive 回收站的。稳定期最早 11 月 12 日 22:33 到期,最晚 12 月 6 日 04:42;到期只是有资格上传,不保证那一刻传完。最近一次接口维护 11 月 6 日 08:45—08:47 完成:Drive 传了 2 件、Photos 传了 1 件,和 Google 通信成功;这是维护程序当时留下的回执。Photos 网页删除不装定时任务:待删攒够 30 张,看板提醒,当时在干活的 AI 取精确链接用我的 Chrome 删,删完结算;登录或工具出问题就留待办给后面的对话。本次没有访问云账号,不能说今天 4,677 件都已在云端,也不能说 312 件都会在同一天自动传完。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

这项功能怎样使用

用途与实际影响

为什么需要它

本地候选不是账号侧备份,上传了字节也不等于已经进入正确相册。网络中断后若把未知对象当作没上传,或在旧相册消失时直接重建,容易产生重复和错误外部状态。电脑这边换了盘或数据库坏了,如果云端对象编号也跟着丢,就只能全部重传。

举个实际例子

我说“先看看这批整理后的照片和录音上云还差什么”。系统预览 Photos 与 Drive 各自工作,不调用上传;平时每天的接口维护会自动跑一轮,新文件过了 30 天稳定期才上传。遇到已建相册消失就明确暂停相关部分,不擅自重建补传。我在电脑上删掉的照片,攒到 30 张以上才去 Photos 网页精确删除;我点名要立刻删的可以单独先删。

最后我会得到什么

得到本地期望集合、云对象、相册关系与实际执行结果的分层说明,以及每件还要等多久才进入上传。云端对象编号和相册关系随文本快照保存,新建数据库时可以导回来,不必全部重传。云端全量、真删除和手机回写是否完成分别以对应实测为准。

这项功能怎样使用

用途与实际影响

为什么需要它

本地候选不是账号侧备份,上传了字节也不等于已经进入正确相册。网络中断后若把未知对象当作没上传,或在旧相册消失时直接重建,容易产生重复和错误外部状态。电脑这边换了盘或数据库坏了,如果云端对象编号也跟着丢,就只能全部重传。

举个实际例子

我说“先看看这批整理后的照片和录音上云还差什么”。系统预览 Photos 与 Drive 各自工作,不调用上传;平时每天的接口维护会自动跑一轮,新文件过了 30 天稳定期才上传。遇到已建相册消失就明确暂停相关部分,不擅自重建补传。我在电脑上删掉的照片,攒到 30 张以上才去 Photos 网页精确删除;我点名要立刻删的可以单独先删。

最后我会得到什么

得到本地期望集合、云对象、相册关系与实际执行结果的分层说明,以及每件还要等多久才进入上传。云端对象编号和相册关系随文本快照保存,新建数据库时可以导回来,不必全部重传。云端全量、真删除和手机回写是否完成分别以对应实测为准。

结果怎么看
成功时

预览返回选定范围与待办而不调用提供者;执行时分别记录对象和相册关系结果,已上传对象先补关系,再处理新字节;接口维护有待办时两边各有回读记录;没有待办的一轮不调用 Google 接口,只算本地对账。

发现问题时

部分成功、配额暂停、对象身份未知或已建相册异常消失时保存精确缺口,不把整批当成功,也不盲目重传;还在稳定期的项目明确标为等待,不算失败。

入口不可用时

本地期望不完整、来源不可读或现有 PCConfig 提供者不可用时,只停止受影响步骤;不猜账号、不另建云入口,不让云故障改动本机原件。

结果怎么看
成功时

预览返回选定范围与待办而不调用提供者;执行时分别记录对象和相册关系结果,已上传对象先补关系,再处理新字节;接口维护有待办时两边各有回读记录;没有待办的一轮不调用 Google 接口,只算本地对账。

发现问题时

部分成功、配额暂停、对象身份未知或已建相册异常消失时保存精确缺口,不把整批当成功,也不盲目重传;还在稳定期的项目明确标为等待,不算失败。

入口不可用时

本地期望不完整、来源不可读或现有 PCConfig 提供者不可用时,只停止受影响步骤;不猜账号、不另建云入口,不让云故障改动本机原件。

从哪里开始

说明要预览或同步哪类媒体到既有 Google Photos 或 Drive;平时不用说,每天热备后会自动维护一轮。

需要准备什么
  • 要同步到 Photos、Drive 或两者的选择
  • 需要的相册关系和超出现有授权的范围(如有)
从开始到拿到结果
1系统核对并处理
先形成本地期望;预览只计算差异,执行入口或每天的接口维护才逐项处理云对象、相册关系和退出,Drive 先于 Photos。
2交付与接续
按真实远端回读说明对象、关系和稳定期;本地“已同步”只代表本地记录,失败先核对已有对象再续作。
从哪里开始

说明要预览或同步哪类媒体到既有 Google Photos 或 Drive;平时不用说,每天热备后会自动维护一轮。

需要准备什么
  • 要同步到 Photos、Drive 或两者的选择
  • 需要的相册关系和超出现有授权的范围(如有)
从开始到拿到结果
1系统核对并处理
先形成本地期望;预览只计算差异,执行入口或每天的接口维护才逐项处理云对象、相册关系和退出,Drive 先于 Photos。
2交付与接续
按真实远端回读说明对象、关系和稳定期;本地“已同步”只代表本地记录,失败先核对已有对象再续作。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
11 月 6 日 14:26 只读本地记录
cloud-status、cloud_upload.py --status 都退出 0,状态 LOCAL_STATE_ONLY_NOT_LIVE_E2E。应上云 4,677 件:Photos 3,869(已同步 3,603)、Drive 808(已同步 762);已同步合计 4,365 件,稳定期合计 312 件(settle_total,cloud-status 的 upload_holds:按当前应上云清单逐项算,settle_period 312、waiting_for_owner_decision 0),当前没有待本人决定的上传项。cloud_upload.py --status 的稳定期分项是 Photos 266、Drive 46,共 312,和上面相符。未同步 312 件(pending:Photos 266、Drive 46)全部在稳定期里;4,365 + 312 = 4,677。这些都是本地记录,不证明云端对象状态。两端 unknown、failed、paused 都是 0,待网页删除、待 Drive 回收都是 0;两端上传进程都没在跑(upload_run=finished),“本目标已完成”来自已结束的旧进程,不代表当前期望都已上传。稳定期最早 11 月 12 日 22:33:51 到期,最晚 12 月 6 日 04:42:15;到期只是有资格上传,不保证那一刻就自动传完。本地记录里的已上传字节 Photos 78,456,215,601(约 78.5 GB)、Drive 20,132,976,476(约 20.1 GB),不证明账号此刻的真实对象状态。接口维护配置已启用(E:\Data\PCConfig\PersonalMediaCloud\config.json,enabled=true);最近一次 11 月 6 日 08:45:02—08:47:41 完成、顶层 COMPLETE:Drive 处理 2 件、provider_calls=14,08:46:00 DriveUpload 记 completed;Photos 处理 1 件、provider_calls=76,08:47:36 BatchAddMediaItems 记 completed;这是维护程序当时的回执,本次没有回读账号。历史:11 月 3 日 17:37:02 那次顶层 COMPLETE,Drive 和 Photos 都是 NO_WORK、provider_calls=0、live_provider_checked=false,只是本地对账;再往前两端保存的接口成功是 10 月 27 日(Drive 17:26:55、Photos 17:28:14)。10 月 10 日 17:27:56 那次 Drive 调用 2 次、Photos 调用 73 次,远端写入都是 0(历史)。9 月 28 日 Drive 那条旧错误记录不是现在的阻断。Google 视频现在能否播放,本次没有进入账号查看,不知道。
关键规则与设计选择
1
9 月 13 日首轮 4,230 项云上传有完整回读,作为首轮历史保留;之后的新增按本地映射和每天维护推进。本网页不重新上传或删除。
2
已获准范围内的正常云增量不逐批重复索要批准;扩大来源、账号或公开面仍按真实授权处理。
3
照片/视频走 Photos 恢复集与其他归档,PSD 排除且不另投 Drive 或自动转码;两类特殊保留内容归云端恢复集的同名相册,不按季度拆。“其他归档”是普通相册,不是 Photos 原生归档;原生归档由我操作,AI 不自动取消,也不因检索遗漏重传。录音走 Drive 音乐/录音(10 月 22 日目录 772 件),音乐和铃声走已有音乐根(3 件);音频不进手机包或 Photos,文档不在媒体上云范围。
4
新文件入库后 30 天才有上云资格;手机包不受这 30 天限制。
5
本地保留、手机资格与云端资格分别判断,不能用一个 keeper 标记自动填满所有集合。
6
电脑上删掉原件后:本地维护收敛候选与待退;Drive 精确对象经接口进回收站并回读结算;Photos 真删走正规已登录 Chrome 的精确编号链接,攒到 30 张以上才做,达到门槛后的尾批继续做完;我点名立即删除的精确集合例外。移出相册不等于删除,永不清空回收站。
7
旧 upload=0 字段只说明对应本地候选观察,不证明后续账号侧从未发生上传。
当前怎样实现
  • cloud-candidates.ndjson 保存本地逐项候选与相册计划;cloud-status 与 cloud_upload.py --status 只读,不启动同步。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
11 月 6 日 14:26 只读本地记录
cloud-status、cloud_upload.py --status 都退出 0,状态 LOCAL_STATE_ONLY_NOT_LIVE_E2E。应上云 4,677 件:Photos 3,869(已同步 3,603)、Drive 808(已同步 762);已同步合计 4,365 件,稳定期合计 312 件(settle_total,cloud-status 的 upload_holds:按当前应上云清单逐项算,settle_period 312、waiting_for_owner_decision 0),当前没有待本人决定的上传项。cloud_upload.py --status 的稳定期分项是 Photos 266、Drive 46,共 312,和上面相符。未同步 312 件(pending:Photos 266、Drive 46)全部在稳定期里;4,365 + 312 = 4,677。这些都是本地记录,不证明云端对象状态。两端 unknown、failed、paused 都是 0,待网页删除、待 Drive 回收都是 0;两端上传进程都没在跑(upload_run=finished),“本目标已完成”来自已结束的旧进程,不代表当前期望都已上传。稳定期最早 11 月 12 日 22:33:51 到期,最晚 12 月 6 日 04:42:15;到期只是有资格上传,不保证那一刻就自动传完。本地记录里的已上传字节 Photos 78,456,215,601(约 78.5 GB)、Drive 20,132,976,476(约 20.1 GB),不证明账号此刻的真实对象状态。接口维护配置已启用(E:\Data\PCConfig\PersonalMediaCloud\config.json,enabled=true);最近一次 11 月 6 日 08:45:02—08:47:41 完成、顶层 COMPLETE:Drive 处理 2 件、provider_calls=14,08:46:00 DriveUpload 记 completed;Photos 处理 1 件、provider_calls=76,08:47:36 BatchAddMediaItems 记 completed;这是维护程序当时的回执,本次没有回读账号。历史:11 月 3 日 17:37:02 那次顶层 COMPLETE,Drive 和 Photos 都是 NO_WORK、provider_calls=0、live_provider_checked=false,只是本地对账;再往前两端保存的接口成功是 10 月 27 日(Drive 17:26:55、Photos 17:28:14)。10 月 10 日 17:27:56 那次 Drive 调用 2 次、Photos 调用 73 次,远端写入都是 0(历史)。9 月 28 日 Drive 那条旧错误记录不是现在的阻断。Google 视频现在能否播放,本次没有进入账号查看,不知道。
关键规则与设计选择
1
9 月 13 日首轮 4,230 项云上传有完整回读,作为首轮历史保留;之后的新增按本地映射和每天维护推进。本网页不重新上传或删除。
2
已获准范围内的正常云增量不逐批重复索要批准;扩大来源、账号或公开面仍按真实授权处理。
3
照片/视频走 Photos 恢复集与其他归档,PSD 排除且不另投 Drive 或自动转码;两类特殊保留内容归云端恢复集的同名相册,不按季度拆。“其他归档”是普通相册,不是 Photos 原生归档;原生归档由我操作,AI 不自动取消,也不因检索遗漏重传。录音走 Drive 音乐/录音(10 月 22 日目录 772 件),音乐和铃声走已有音乐根(3 件);音频不进手机包或 Photos,文档不在媒体上云范围。
4
新文件入库后 30 天才有上云资格;手机包不受这 30 天限制。
5
本地保留、手机资格与云端资格分别判断,不能用一个 keeper 标记自动填满所有集合。
6
电脑上删掉原件后:本地维护收敛候选与待退;Drive 精确对象经接口进回收站并回读结算;Photos 真删走正规已登录 Chrome 的精确编号链接,攒到 30 张以上才做,达到门槛后的尾批继续做完;我点名立即删除的精确集合例外。移出相册不等于删除,永不清空回收站。
7
旧 upload=0 字段只说明对应本地候选观察,不证明后续账号侧从未发生上传。
当前怎样实现
  • cloud-candidates.ndjson 保存本地逐项候选与相册计划;cloud-status 与 cloud_upload.py --status 只读,不启动同步。
技术实现与依据(二)
  • cloud-reconcile 根据当前目录和选定范围建立本地期望对象与关系;--execute 也只写本地 SQLite,不调用提供者。
  • cloud-sync 默认返回 DRY_RUN_PROVIDER_NOT_CALLED;显式 --execute 才经现有 PCConfig 提供者工作,并先拒绝缺失或不完整的本地期望状态。
  • cloud-maintain 不加 execute 时只读计划、零写入;cloud_upload.py --maintain --execute --no-window 是独立无窗口的一轮,复用 sync-current、cloud-reconcile 和同一把全局目录锁,Drive 先于 Photos。它接在每天 17:10 热备完成、释放锁之后触发,不另注册第二个接口任务。
  • 同一 SQLite 内的 cloud_object 与 cloud_membership 分别保存内容对象和集合关系,不新建第二媒体库。已有上传身份不因相册消失而清零。
  • Photos 先核对远端对象与已存相册 ID,先补已上传对象的相册关系,再按相册分组处理小文件(默认 ≤8 MiB),批次大小 1 至 50;持续限流或日配额只停受影响的目标。
  • 已建相册 ID 不存在或歧义时记 unknown 并阻塞该集合,不自行重建补传;上传身份不明时先回读而非猜未上传;Drive 可用 ResumeOnly 接续。
  • cloud-delete-plan 只读生成已确认退出对象的精确 Photos 链接,正规网页真删后 cloud-settle-retired 定向结算。明确不安装 Photos 网页删除定时任务:待删满 30 张时看板提示,当时会话的 AI 取精确链接,用本人已登录的 Chrome 真删再结算;不足 30 张继续攒,点名立即删的精确集合例外;登录或工具故障留待办给后续会话。
  • 私有仓库用 metadata/current/ 保存无损文本快照(不再用压缩包),含 seed、清单、手机计划、云候选和 cloud-state.json。catalog-build --seed --db --cloud-state 可把云对象编号、相册关系、待退和云元数据导入一个全新数据库;已有数据库直接拒绝,避免旧快照覆盖当前。没有 cloud-state 的旧版本仍明确报映射缺口。
技术实现与依据(二)
  • cloud-reconcile 根据当前目录和选定范围建立本地期望对象与关系;--execute 也只写本地 SQLite,不调用提供者。
  • cloud-sync 默认返回 DRY_RUN_PROVIDER_NOT_CALLED;显式 --execute 才经现有 PCConfig 提供者工作,并先拒绝缺失或不完整的本地期望状态。
  • cloud-maintain 不加 execute 时只读计划、零写入;cloud_upload.py --maintain --execute --no-window 是独立无窗口的一轮,复用 sync-current、cloud-reconcile 和同一把全局目录锁,Drive 先于 Photos。它接在每天 17:10 热备完成、释放锁之后触发,不另注册第二个接口任务。
  • 同一 SQLite 内的 cloud_object 与 cloud_membership 分别保存内容对象和集合关系,不新建第二媒体库。已有上传身份不因相册消失而清零。
  • Photos 先核对远端对象与已存相册 ID,先补已上传对象的相册关系,再按相册分组处理小文件(默认 ≤8 MiB),批次大小 1 至 50;持续限流或日配额只停受影响的目标。
  • 已建相册 ID 不存在或歧义时记 unknown 并阻塞该集合,不自行重建补传;上传身份不明时先回读而非猜未上传;Drive 可用 ResumeOnly 接续。
  • cloud-delete-plan 只读生成已确认退出对象的精确 Photos 链接,正规网页真删后 cloud-settle-retired 定向结算。明确不安装 Photos 网页删除定时任务:待删满 30 张时看板提示,当时会话的 AI 取精确链接,用本人已登录的 Chrome 真删再结算;不足 30 张继续攒,点名立即删的精确集合例外;登录或工具故障留待办给后续会话。
  • 私有仓库用 metadata/current/ 保存无损文本快照(不再用压缩包),含 seed、清单、手机计划、云候选和 cloud-state.json。catalog-build --seed --db --cloud-state 可把云对象编号、相册关系、待退和云元数据导入一个全新数据库;已有数据库直接拒绝,避免旧快照覆盖当前。没有 cloud-state 的旧版本仍明确报映射缺口。
技术实现与依据(三)
1
完成本地分类与去重
2
按真实范围预览期望集合
  • 上传进度可只读查看;一个目标同时只有一个后台传输进程,关窗口不等于停止;速度按确认成功的字节算。完成后可经 PCConfig 排一次性唤醒,排上不等于模型已收到或已完成。
  • 云操作使用可复用的提供者会话并在结束关闭,不把网络调用包在 SQLite 写事务里;具名照片相册参与期望集合,更新本地相册名不等于外部相册已更新。
执行流程
技术实现与依据(三)
1
完成本地分类与去重
2
按真实范围预览期望集合
  • 上传进度可只读查看;一个目标同时只有一个后台传输进程,关窗口不等于停止;速度按确认成功的字节算。完成后可经 PCConfig 排一次性唤醒,排上不等于模型已收到或已完成。
  • 云操作使用可复用的提供者会话并在结束关闭,不把网络调用包在 SQLite 写事务里;具名照片相册参与期望集合,更新本地相册名不等于外部相册已更新。
执行流程
技术实现与依据(四)
3
写本地期望(cloud-reconcile)
4
预览云工作且不调用提供者
5
执行或每天接口维护时回读远端身份
6
先补已有对象的集合关系,再有界处理过了稳定期的新字节
7
删除按 Drive 接口、Photos 攒批网页两条路分别结算
8
分别报告完成、部分、等待、暂停与未知
技术实现与依据(四)
3
写本地期望(cloud-reconcile)
4
预览云工作且不调用提供者
5
执行或每天接口维护时回读远端身份
6
先补已有对象的集合关系,再有界处理过了稳定期的新字节
7
删除按 Drive 接口、Photos 攒批网页两条路分别结算
8
分别报告完成、部分、等待、暂停与未知
名词和入口
本模块用到的名词
名词意思
Cloud candidate(云端候选)本地计划,不等于目标账号已有字节。
Desired state(期望状态)本次范围内应存在的内容对象及集合关系,先在本地表达。
Membership(集合关系)已上传对象与相册的关联,和对象字节分别维护。
External read-back(外部回读)从现有目标提供者核对真实对象与相册身份;本地清单和命令成功不能代替。
稳定期新文件入库后等 30 天才上云,避免刚整理完又改的东西被反复上传删除。
云状态快照cloud-state.json,保存云对象编号、相册关系和待退状态;只能导入全新数据库。
专业定义

照片视频到 Photos、录音到 Drive;先预览选定工作,再按当前授权阶段执行,每天自动维护一轮;部分成功和未知远端身份各自保留;云端编号随文本快照可恢复。

名词和入口
本模块用到的名词
名词意思
Cloud candidate(云端候选)
意思:
本地计划,不等于目标账号已有字节。
Desired state(期望状态)
意思:
本次范围内应存在的内容对象及集合关系,先在本地表达。
Membership(集合关系)
意思:
已上传对象与相册的关联,和对象字节分别维护。
External read-back(外部回读)
意思:
从现有目标提供者核对真实对象与相册身份;本地清单和命令成功不能代替。
稳定期
意思:
新文件入库后等 30 天才上云,避免刚整理完又改的东西被反复上传删除。
云状态快照
意思:
cloud-state.json,保存云对象编号、相册关系和待退状态;只能导入全新数据库。
专业定义

照片视频到 Photos、录音到 Drive;先预览选定工作,再按当前授权阶段执行,每天自动维护一轮;部分成功和未知远端身份各自保留;云端编号随文本快照可恢复。

出问题时(一)
解决什么
解决候选冒充备份、对象与相册混为一谈、部分上传中断后重复传输、旧相册身份丢失、云故障拖住本地整理,以及电脑侧重建后云端映射丢失只能全量重传。
边界
  • 预览不上传。
  • 本次网页核对不连接账号或执行云动作。
  • 不把旧零上传记录写成永久产品限制。
  • 不让云故障改变本机原件。
  • 不在网页复制候选原始清单。
  • 文本快照能恢复工具、登记和云映射,但照片本身仍要靠 E/G 原件,哈希还原不出照片;从 Google Takeout 从零恢复还没实测过。
失败与恢复
  • 本地期望缺失或不完整: cloud-sync 执行前拒绝,先通过现有 cloud-reconcile 核对该范围。
  • 已建相册 ID 消失或存在多个身份: 保留 unknown 与现有上传身份,暂停相关集合,不盲目重建或补传。
出问题时(一)
解决什么
解决候选冒充备份、对象与相册混为一谈、部分上传中断后重复传输、旧相册身份丢失、云故障拖住本地整理,以及电脑侧重建后云端映射丢失只能全量重传。
边界
  • 预览不上传。
  • 本次网页核对不连接账号或执行云动作。
  • 不把旧零上传记录写成永久产品限制。
  • 不让云故障改变本机原件。
  • 不在网页复制候选原始清单。
  • 文本快照能恢复工具、登记和云映射,但照片本身仍要靠 E/G 原件,哈希还原不出照片;从 Google Takeout 从零恢复还没实测过。
失败与恢复
  • 本地期望缺失或不完整: cloud-sync 执行前拒绝,先通过现有 cloud-reconcile 核对该范围。
  • 已建相册 ID 消失或存在多个身份: 保留 unknown 与现有上传身份,暂停相关集合,不盲目重建或补传。
出问题时(二)
  • 配额、网络或部分对象失败: 保留逐项结果和暂停原因;已上传对象先核对关系,不把整个批次重传或报告全部完成。
  • 候选与原件漂移: 本地维护先收敛清单;真实云删除/重传按独立阶段处理。
  • 数据库要重建: 用快照导入全新库,逐文件核对哈希和大小,必要时只在恢复副本里改 seed 路径,验证新库后再切换;旧的手机清空计划不能授权今天执行。快照换代失败保留旧代。
出问题时(二)
  • 配额、网络或部分对象失败: 保留逐项结果和暂停原因;已上传对象先核对关系,不把整个批次重传或报告全部完成。
  • 候选与原件漂移: 本地维护先收敛清单;真实云删除/重传按独立阶段处理。
  • 数据库要重建: 用快照导入全新库,逐文件核对哈希和大小,必要时只在恢复副本里改 seed 路径,验证新库后再切换;旧的手机清空计划不能授权今天执行。快照换代失败保留旧代。
依据与来源(一)
真实入口
  • AGENTS.md / USER_REQUIREMENTS.md 当前用户阶段、集合用途、删除规则与实际授权边界
  • personal_media.py 候选、cloud-reconcile、cloud-sync、cloud-maintain、catalog-build 云状态导入与同库状态
  • cloud_upload.py 上传进度、独立无窗口接口维护
  • docs/cloud-maintenance.md 接口维护与删除链
  • cloud-candidates.ndjson 本地外部计划,非账号侧回读
  • CLOUD_UPLOAD_RESULT.md 9 月 13 日首轮云对象、分类、重入零写与播放缺口(历史)
如何验证
  • 9 月 13 日首轮:4,230 项、96,179,188,822 字节;Photos 全部 3,473 个 ID 可读、9 个相册关系一致,Drive 757 个 ID/SHA-256/大小/父目录一致,最后全量 COMPLETE 且两端零远端写。这是首轮历史,当时的 102 项本地测试和 115 个视频可播放、1 个处理中也只是当时记录。
  • 11 月 3 日 17:37 接口维护完成、两端 NO_WORK、没有调用接口;两端最近一次接口成功是 10 月 27 日;11 月 4 日本地记录失败、未知、暂停均为 0。本次没有实时访问账号。
依据与来源(一)
真实入口
  • AGENTS.md / USER_REQUIREMENTS.md 当前用户阶段、集合用途、删除规则与实际授权边界
  • personal_media.py 候选、cloud-reconcile、cloud-sync、cloud-maintain、catalog-build 云状态导入与同库状态
  • cloud_upload.py 上传进度、独立无窗口接口维护
  • docs/cloud-maintenance.md 接口维护与删除链
  • cloud-candidates.ndjson 本地外部计划,非账号侧回读
  • CLOUD_UPLOAD_RESULT.md 9 月 13 日首轮云对象、分类、重入零写与播放缺口(历史)
如何验证
  • 9 月 13 日首轮:4,230 项、96,179,188,822 字节;Photos 全部 3,473 个 ID 可读、9 个相册关系一致,Drive 757 个 ID/SHA-256/大小/父目录一致,最后全量 COMPLETE 且两端零远端写。这是首轮历史,当时的 102 项本地测试和 115 个视频可播放、1 个处理中也只是当时记录。
  • 11 月 3 日 17:37 接口维护完成、两端 NO_WORK、没有调用接口;两端最近一次接口成功是 10 月 27 日;11 月 4 日本地记录失败、未知、暂停均为 0。本次没有实时访问账号。
依据与来源(二)
  • 源码现有 524 个测试函数(11 月 6 日静态计数,本次没有运行);云状态导入有测试定义,未在本次运行。
  • 旧候选 header 的 upload=0 只约束本地生成命令;不会覆盖当前 cloud_object/cloud_membership 的真实云端状态。
与其他模块的关系

它消费媒体整理后的集合,与本地原件和手机恢复分开;手机回写由手机恢复模块负责,最近一轮在 10 月 29 日完成,本模块不拥有它。Google 播放处理与 Takeout 从零恢复继续按真实来源验收。

依据与来源(二)
  • 源码现有 524 个测试函数(11 月 6 日静态计数,本次没有运行);云状态导入有测试定义,未在本次运行。
  • 旧候选 header 的 upload=0 只约束本地生成命令;不会覆盖当前 cloud_object/cloud_membership 的真实云端状态。
与其他模块的关系

它消费媒体整理后的集合,与本地原件和手机恢复分开;手机回写由手机恢复模块负责,最近一轮在 10 月 29 日完成,本模块不拥有它。Google 播放处理与 Takeout 从零恢复继续按真实来源验收。

复制 AI 续作说明

项目:本地期望、云端对象与相册关系分别核对;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。