
个人媒体整理与恢复 · 功能说明
把已经核对并决定保留的一份本地图片、视频或录音,接入现有媒体库,同时保存恢复副本并更新查找记录,不需要把它混进一批手机文件。暂存文件只要放在 E 盘路径下就行:和原件目录在同一块真实磁盘时直接建链接,不在同一块时先复制、核对一致后再落位。
当前情况:单文件接入、登记已在媒体库里的原件、复用已有的同内容原件都可用;E 盘路径内跨真实磁盘的复制核对已经实现并有测试定义(11 月 4 日核对源码,没变)。本次没有接入真实新文件。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


个人媒体整理与恢复 · 功能说明
把已经核对并决定保留的一份本地图片、视频或录音,接入现有媒体库,同时保存恢复副本并更新查找记录,不需要把它混进一批手机文件。暂存文件只要放在 E 盘路径下就行:和原件目录在同一块真实磁盘时直接建链接,不在同一块时先复制、核对一致后再落位。
当前情况:单文件接入、登记已在媒体库里的原件、复用已有的同内容原件都可用;E 盘路径内跨真实磁盘的复制核对已经实现并有测试定义(11 月 4 日核对源码,没变)。本次没有接入真实新文件。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


用途与实际影响
一份文件可能来自电脑,也可能是同一段画面的另一种文件封装,或者和库里已有的某份内容完全一样。全部当新作品会重复保留;还没核对就删除,又可能丢掉唯一的完整版本。
我可以说:“这个本地 MP4 看起来只是现有视频的另一种封装,核对后再接入,别重复保存两份正式原件。”系统会比较两份文件里的首路视频流;一致就只把变体留作恢复材料并记录关系,无法确认就不动来源文件。如果这份文件和库里已有的内容字节完全相同,就直接复用现有原件,不新增条目。
新的保留内容在媒体原件目录落位,并在 G 盘留下恢复副本,查找目录和后续手机、云端计划随之更新;回执写明这次是同盘链接还是跨盘复制核对。确证重复的视频变体会保留恢复副本和与主版本的对应关系,再退出原暂存位置。失败时说明已保存了哪些文件、哪一步还没完成。

用途与实际影响
一份文件可能来自电脑,也可能是同一段画面的另一种文件封装,或者和库里已有的某份内容完全一样。全部当新作品会重复保留;还没核对就删除,又可能丢掉唯一的完整版本。
我可以说:“这个本地 MP4 看起来只是现有视频的另一种封装,核对后再接入,别重复保存两份正式原件。”系统会比较两份文件里的首路视频流;一致就只把变体留作恢复材料并记录关系,无法确认就不动来源文件。如果这份文件和库里已有的内容字节完全相同,就直接复用现有原件,不新增条目。
新的保留内容在媒体原件目录落位,并在 G 盘留下恢复副本,查找目录和后续手机、云端计划随之更新;回执写明这次是同盘链接还是跨盘复制核对。确证重复的视频变体会保留恢复副本和与主版本的对应关系,再退出原暂存位置。失败时说明已保存了哪些文件、哪一步还没完成。

原文件仍是之前确认的那一份、目标也没有冲突;媒体原件与 G 盘副本检查一致,查找记录和后续恢复计划已更新,再说明原暂存文件的处理结果。
分类、时间、主版本或视频重复关系还不能确认时,先保留文件,指出需要补看的画面或信息,不猜一个归属后直接接入。
文件直接放在 C、D 或 G 盘时拒绝,需要先经授权复制到 E 盘暂存,再只处理那份副本,原始文件不删。视频检查工具、原件目录、G 盘、目标位置或计划更新不可用时,停止对应步骤并报告已有副本;跨盘复制失败保留来源、不覆盖目标。不会临时改成手机批次处理或自动上传。

原文件仍是之前确认的那一份、目标也没有冲突;媒体原件与 G 盘副本检查一致,查找记录和后续恢复计划已更新,再说明原暂存文件的处理结果。
分类、时间、主版本或视频重复关系还不能确认时,先保留文件,指出需要补看的画面或信息,不猜一个归属后直接接入。
文件直接放在 C、D 或 G 盘时拒绝,需要先经授权复制到 E 盘暂存,再只处理那份副本,原始文件不删。视频检查工具、原件目录、G 盘、目标位置或计划更新不可用时,停止对应步骤并报告已有副本;跨盘复制失败保留来源、不覆盖目标。不会临时改成手机批次处理或自动上传。

点名一个已人工复核、放在 E 盘路径下的本地照片、视频或录音,请 AI 接入媒体中心。
- 明确源文件与预期内容
- 类别和说明
- 视频容器变体才需指明既有主版本


点名一个已人工复核、放在 E 盘路径下的本地照片、视频或录音,请 AI 接入媒体中心。
- 明确源文件与预期内容
- 类别和说明
- 视频容器变体才需指明既有主版本





- 解析 source 并确认是 E 盘路径;普通路线拒绝原件根内文件,--register-existing 则要求原件已在媒体根内。计算大小和 SHA-256,给了 expected_sha256 时必须匹配。
- ffprobe 判断视频或音频;新 keeper 用 category、secondary 和可选 formation-date 选择正式目录。
- 新 keeper 与目标同一真实磁盘时用 os.link 建硬链接;不同真实磁盘时复制到目标目录的临时文件、fsync、核对大小与 SHA-256,再无覆盖改名落位。随后向 G 精确复制并回读,事务写入目录后退休 E 暂存名。
- 等价变体先核对 keeper 当前存在、keeper E/G SHA-256 与两边首路视频流;再把变体精确复制到 G 的变体区、记录关系、退休 source 并更新退休状态。
- 各条路线都刷新当前 seed 与产品候选,写最小接入回执(含 canonical_placement 和 storage_layout);cloud_upload 固定为 0。
- update-entry 按单一 SHA-256 与 --execute 定位已登记 keeper,可更新具名相册(1–120 字符,只用于图片,固定的证件和私人图片相册不能换名)、本人确认的地点和日期以及既有恢复资格;只先推进本地 seed 和候选,返回 external_provider_calls=0。云端、手机写回及新增原件保全分别处理。


- 解析 source 并确认是 E 盘路径;普通路线拒绝原件根内文件,--register-existing 则要求原件已在媒体根内。计算大小和 SHA-256,给了 expected_sha256 时必须匹配。
- ffprobe 判断视频或音频;新 keeper 用 category、secondary 和可选 formation-date 选择正式目录。
- 新 keeper 与目标同一真实磁盘时用 os.link 建硬链接;不同真实磁盘时复制到目标目录的临时文件、fsync、核对大小与 SHA-256,再无覆盖改名落位。随后向 G 精确复制并回读,事务写入目录后退休 E 暂存名。
- 等价变体先核对 keeper 当前存在、keeper E/G SHA-256 与两边首路视频流;再把变体精确复制到 G 的变体区、记录关系、退休 source 并更新退休状态。
- 各条路线都刷新当前 seed 与产品候选,写最小接入回执(含 canonical_placement 和 storage_layout);cloud_upload 固定为 0。
- update-entry 按单一 SHA-256 与 --execute 定位已登记 keeper,可更新具名相册(1–120 字符,只用于图片,固定的证件和私人图片相册不能换名)、本人确认的地点和日期以及既有恢复资格;只先推进本地 seed 和候选,返回 external_provider_calls=0。云端、手机写回及新增原件保全分别处理。






| 名词 | 意思 |
|---|---|
| Independent local increment(独立本地增量) | 不属于手机 capture、但已经明确选择的单个媒体文件。 |
| Demuxed video stream(解复用视频流) | 从容器中抽出的实际视频流哈希;首路视频流相同才支持“只是容器不同”的判断。 |
| Content-equivalent variant(内容等价变体) | 字节和容器不同,但已证明视频流与现役 keeper 相同;保留恢复副本和关系,不再作为第二个 keeper 浏览。 |
| 落位方式 | same_volume_hardlink 是同一真实磁盘上的硬链接;cross_volume_copy_readback 是跨真实磁盘复制并核对后落位。 |

手机不是唯一入口。一个已经人工看过、放在 E 盘路径下的本地照片、视频或录音,可以单独接入;同一视频流的另一种容器也能保留恢复副本后退出浏览库;已有同内容的直接复用。



手机不是唯一入口。一个已经人工看过、放在 E 盘路径下的本地照片、视频或录音,可以单独接入;同一视频流的另一种容器也能保留恢复副本后退出浏览库;已有同内容的直接复用。

- 不批量扫描目录。
- 普通暂存接入不接受原件根内文件;已在媒体中心的明确原件可以 --register-existing 就地登记,不移动原件。
- 不直接接入 C、D、G 盘文件;跨盘只在 E 盘路径之内做复制核对。
- 不靠文件名宣布视频等价。
- 不把 --execute 扩张成云上传或手机删除授权。
- 不声称跨 E/G/SQLite 的绝对原子回滚。
- 输入 SHA-256 与预期不同: 在创建正式原件、G 副本或目录状态前失败,要求重新确认当前字节。
- 源文件在 C、D 或 G 盘: 拒绝;先经授权复制到 E 盘暂存,只处理那份副本,原始文件不删。

- 不批量扫描目录。
- 普通暂存接入不接受原件根内文件;已在媒体中心的明确原件可以 --register-existing 就地登记,不移动原件。
- 不直接接入 C、D、G 盘文件;跨盘只在 E 盘路径之内做复制核对。
- 不靠文件名宣布视频等价。
- 不把 --execute 扩张成云上传或手机删除授权。
- 不声称跨 E/G/SQLite 的绝对原子回滚。
- 输入 SHA-256 与预期不同: 在创建正式原件、G 副本或目录状态前失败,要求重新确认当前字节。
- 源文件在 C、D 或 G 盘: 拒绝;先经授权复制到 E 盘暂存,只处理那份副本,原始文件不删。

- 跨盘复制或核对失败: 保留来源,不覆盖目标,不退休暂存文件。
- 新 keeper 没有 category 或目标已有不同字节: 拒绝接入,不覆盖目标,也不退休 source。
- 登记已有原件时相同哈希在别的位置: 拒绝覆盖。
- 等价 keeper 不存在、E/G 回读失败或视频流不同: 不建立等价关系,不复制/退休变体。
- 目录提交后 seed/候选刷新失败: 保留已经读回的正式原件与 G 字节和具名失败位置;按当前目录与回执恢复,不把部分状态冒充完整收口。

- 跨盘复制或核对失败: 保留来源,不覆盖目标,不退休暂存文件。
- 新 keeper 没有 category 或目标已有不同字节: 拒绝接入,不覆盖目标,也不退休 source。
- 登记已有原件时相同哈希在别的位置: 拒绝覆盖。
- 等价 keeper 不存在、E/G 回读失败或视频流不同: 不建立等价关系,不复制/退休变体。
- 目录提交后 seed/候选刷新失败: 保留已经读回的正式原件与 G 字节和具名失败位置;按当前目录与回执恢复,不把部分状态冒充完整收口。

- personal_media.py ingest-file、同内容复用、新 keeper、跨盘复制核对、等价容器变体、seed 与候选刷新
- test_personal_media.py 隔离临时根中的新 keeper、E/G、目录、来源退休、候选刷新与等价视频容器专项回归
- test_storage_compatibility.py 跨真实磁盘复制核对的测试定义
- README.md 精确命令、输入、回读、半状态恢复与依赖说明
- 源码和 README 均要求 --execute、一个 source、description 与可选 expected SHA-256。
- 专项回归证明新 keeper 的正式原件、G 副本、目录、source 退休、当前 seed、手机计划和云计划同次刷新。
- 专项回归证明等价视频的 E/G keeper、相同首路视频流、G 原始容器变体、关系写回和 source 退休。
- 2026-09-05 的验收运行 55 项测试、0 失败/错误(历史记录);最近一份本地验收回执是 9 月 24 日:186 项运行、2 项跳过、0 失败;源码现有 524 个测试函数(11 月 6 日静态计数)。跨盘复制核对有测试定义,但本次没有运行,不等于生产接入已经成功过。
它是手机之外的单文件入口;完成后仍回到同一个当前目录、手机恢复候选和云端期望集合;实际云同步仍由同项目的 cloud-sync 完成,不建立第二套媒体库。

- personal_media.py ingest-file、同内容复用、新 keeper、跨盘复制核对、等价容器变体、seed 与候选刷新
- test_personal_media.py 隔离临时根中的新 keeper、E/G、目录、来源退休、候选刷新与等价视频容器专项回归
- test_storage_compatibility.py 跨真实磁盘复制核对的测试定义
- README.md 精确命令、输入、回读、半状态恢复与依赖说明
- 源码和 README 均要求 --execute、一个 source、description 与可选 expected SHA-256。
- 专项回归证明新 keeper 的正式原件、G 副本、目录、source 退休、当前 seed、手机计划和云计划同次刷新。
- 专项回归证明等价视频的 E/G keeper、相同首路视频流、G 原始容器变体、关系写回和 source 退休。
- 2026-09-05 的验收运行 55 项测试、0 失败/错误(历史记录);最近一份本地验收回执是 9 月 24 日:186 项运行、2 项跳过、0 失败;源码现有 524 个测试函数(11 月 6 日静态计数)。跨盘复制核对有测试定义,但本次没有运行,不等于生产接入已经成功过。
它是手机之外的单文件入口;完成后仍回到同一个当前目录、手机恢复候选和云端期望集合;实际云同步仍由同项目的 cloud-sync 完成,不建立第二套媒体库。
复制 AI 续作说明
项目:一个已复核文件,精确进入原件中心与两套恢复计划;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。







