fix: 补齐过期首帧素材定位与图库影响提示

docs/backend-coverage.md

@@ -42,6 +42,14 @@
 
 时间线分组是节点阶段，不是独立 executionId。未识别的节点被后端归为“其它”；前端用共享 checkpoint 的 workflowName 进一步筛选。两个观测接口独立报错，关闭弹窗不继续发起 API 查询，旧项目迟到响应不会覆盖新项目。
 
+## 过期首帧与素材定位
+
+- 生产页将结构化 `stale_keyframe.missingSubjects` 映射到当前镜头 `/references` 返回的正式 `subjectFormId`，点击可定位图库中实际使用的形态；不按主体名称猜默认形态。缺少关联时退回主体引用检索并明确提示待核对。
+- 图库始终读取 keyframes 与 videos 的 readiness，显示下游过期镜头数量；选择来源镜头后才查询其参考图，避免遍历全部镜头的 N+1 请求。只允许定位当前项目列表中的镜头。
+- 图库深链接支持 `sourceShotId`、`subjectFormId` 和 `subjectRef`；精确形态优先，切换定位清除旧筛选，丢失的形态不自动回退其他形态。返回生产页携带 `episodeNo` 与正式 `shotId`。
+- “身份主图过期”与“下游首帧过期”独立展示。素材有效而首帧过期时，只需核对后重建首帧；定位、刷新、筛选不触发生成或切换主资产。
+- 当前后端基线存在检查口径不一致风险：`video-readiness.service.ts` 与 `video-generation-compiler.service.ts` 调用 `shotKeyframeCurrentnessService.check` 时仅传形态引用，遗漏第三个当前身份母版参数。默认空列表会将快照里的身份母版视为已移除；而 `shot-keyframe-readiness.service.ts` 会正确传入当前母版。前端因此合并两种检查，并将“首帧未标过期、视频报告过期”单列为“状态待核对”，不据此判定素材失效或建议直接重复生图。本次仅修改前端，不绕过视频阻塞；后端调用链需另行修复与联调。
+
 ## 不添加无效或重复入口
 
 | 后端路由／能力 | 处理方式与理由 |
@@ -57,5 +65,5 @@
 ## 回归验证
 
 - 自动测试全部模拟 API，覆盖正式 ID／参数、提示词与图片职责分离、批量部分失败、数量和尺寸校验、候选不覆盖、未完成剧本禁用、费用确认、预检后条件变化、项目切换与旧响应隔离。
-- 已通过 lint、格式、TypeScript、Vitest（22 个文件、220 项测试）和生产构建。不触发真实文本／图片／视频模型，不提交真实生产任务。
+- 已通过 lint、格式、TypeScript、Vitest（23 个文件、233 项测试）和生产构建；定位回归见 `src/features/subject-images/asset-impact.test.ts`。测试不触发真实模型或生产任务。
 - 当前环境无法打开应用预览，未进行浏览器视觉验收；需在可访问的开发环境检查浅／暗主题和窄屏布局，并由用户明确批准后进行真实小批量模型联调。