docs: clarify identity reparse idempotency boundary

This commit is contained in:
root committed 2026-10-13 20:54:55 +08:00
1 parent 1cc830e1af
commit 864856c9bb
2 files changed
+3 -1

No files matched your search

+1 -1
View File
@@ -7,7 +7,7 @@
- 整理默认展示作品与执行摘要,可直接开始,预览仍可单独打开;手动设置收进高级选项,去掉空来源选择步骤和重复处理入口,部分整理不再显示为完整成功。 - 整理默认展示作品与执行摘要,可直接开始,预览仍可单独打开;手动设置收进高级选项,去掉空来源选择步骤和重复处理入口,部分整理不再显示为完整成功。
- 旧整理记录优先恢复可信原请求,冻结计划提供已知预填,缺失设置明确确认;保留下载关联、洗版与文件覆写,支持缺失来源补选及部分移动后的恢复。 - 旧整理记录优先恢复可信原请求,冻结计划提供已知预填,缺失设置明确确认;保留下载关联、洗版与文件覆写,支持缺失来源补选及部分移动后的恢复。
- 持久复用经 TMDB 校验的 Bangumi/豆瓣映射,同一剧集支持多个分季来源身份;复杂标题带 ID 时先走身份链路,补充动漫合集解析,保留资源原季集。 - 持久复用经 TMDB 校验的 Bangumi/豆瓣映射,同一剧集支持多个分季来源身份;复杂标题带 ID 时先走身份链路,补充动漫合集解析,保留资源原季集。
- 季集问题展示真实待确认文件与校验样本,问题处理优先、长期规则按需展开;开发指南记录恢复与来源映射的复用边界。数据库迁移 0095 调整辅助身份唯一约束。 - 季集问题展示真实待确认文件与校验样本,问题处理优先、长期规则按需展开;修复作品身份未变时忽略新识别词季集结果的问题。开发指南记录恢复与来源映射的复用边界;数据库迁移 0095 调整辅助身份唯一约束。
## [0.3.46] - 2026-10-13 ## [0.3.46] - 2026-10-13
+2
View File
@@ -103,6 +103,8 @@ curl -H "Authorization: Bearer umt-dev-admin-key" "localhost:4390/api/v1/events?
历史记录恢复仍走现有整理入口:从原请求、可信旧任务输入到冻结计划依次提取事实,区分可直接重试与需要补齐的预填。文件管理通过 `recoveryRecordId` 交给业务层恢复下载关联、洗版与未编辑覆写,表单只覆盖明确支持的本次选项;来源范围和隐含参数共同参与预览校验。前端共用恢复选项的纯转换,不另造恢复向导或第二套请求模型;默认开始整理和手动预览共用冻结计划与入队函数。 历史记录恢复仍走现有整理入口:从原请求、可信旧任务输入到冻结计划依次提取事实,区分可直接重试与需要补齐的预填。文件管理通过 `recoveryRecordId` 交给业务层恢复下载关联、洗版与未编辑覆写,表单只覆盖明确支持的本次选项;来源范围和隐含参数共同参与预览校验。前端共用恢复选项的纯转换,不另造恢复向导或第二套请求模型;默认开始整理和手动预览共用冻结计划与入队函数。
身份重识别的幂等判断同时覆盖季集、日期、发布组和识别词命中;作品候选相同不代表解析事实相同,不能跳过事实变更后的季集重算。
季集计算和识别词归 sources-identity,整理请求、文件操作与入库状态归 acquisition-organize。整理把真实失败文件和同批正常文件样本交给映射事项,模拟与写入共用同一判断;映射重算后以 `media.episode_mapping_changed` 通知整理模块,只有季集已经确定的未完成记录重新规划。恢复预检与规划复用 `planFileEpisodes`,保留原资源的发布时间等解析上下文。Agent 的调查运行、预算和授权沿用现有机制,不另外创建恢复框架;身份补齐、重新排队和实际入库完成分别按业务事实核实。 季集计算和识别词归 sources-identity,整理请求、文件操作与入库状态归 acquisition-organize。整理把真实失败文件和同批正常文件样本交给映射事项,模拟与写入共用同一判断;映射重算后以 `media.episode_mapping_changed` 通知整理模块,只有季集已经确定的未完成记录重新规划。恢复预检与规划复用 `planFileEpisodes`,保留原资源的发布时间等解析上下文。Agent 的调查运行、预算和授权沿用现有机制,不另外创建恢复框架;身份补齐、重新排队和实际入库完成分别按业务事实核实。
维护时先验证真实的成功、失败和恢复路径,尤其是授权、文件替换、取消与外部副作用;删除空壳或无使用者的机制时同步删除其专属测试与文档。不要为了目录对称增加转发层,也不要把不同阶段的状态合并成一个枚举。 维护时先验证真实的成功、失败和恢复路径,尤其是授权、文件替换、取消与外部副作用;删除空壳或无使用者的机制时同步删除其专属测试与文档。不要为了目录对称增加转发层,也不要把不同阶段的状态合并成一个枚举。