

个人媒体整理与恢复 · 功能说明
本地整理不被云故障打断。整理后的照片和视频以 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 件都会在同一天自动传完。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

个人媒体整理与恢复 · 功能说明
本地整理不被云故障打断。整理后的照片和视频以 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 或两者的选择
- 需要的相册关系和超出现有授权的范围(如有)


说明要预览或同步哪类媒体到既有 Google Photos 或 Drive;平时不用说,每天热备后会自动维护一轮。
- 要同步到 Photos、Drive 或两者的选择
- 需要的相册关系和超出现有授权的范围(如有)



- cloud-candidates.ndjson 保存本地逐项候选与相册计划;cloud-status 与 cloud_upload.py --status 只读,不启动同步。


- 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 的旧版本仍明确报映射缺口。

- 上传进度可只读查看;一个目标同时只有一个后台传输进程,关窗口不等于停止;速度按确认成功的字节算。完成后可经 PCConfig 排一次性唤醒,排上不等于模型已收到或已完成。
- 云操作使用可复用的提供者会话并在结束关闭,不把网络调用包在 SQLite 写事务里;具名照片相册参与期望集合,更新本地相册名不等于外部相册已更新。


- 上传进度可只读查看;一个目标同时只有一个后台传输进程,关窗口不等于停止;速度按确认成功的字节算。完成后可经 PCConfig 排一次性唤醒,排上不等于模型已收到或已完成。
- 云操作使用可复用的提供者会话并在结束关闭,不把网络调用包在 SQLite 写事务里;具名照片相册参与期望集合,更新本地相册名不等于外部相册已更新。





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

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



照片视频到 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。







