import { request } from '../../lib/http' import type { ContinuityDiagnosis, ContinuityInput, ContinuityObservation, ContinuityReview } from './continuity.types' /** * 校验选择属于同集正式顺序的相邻两到三镜。 * @param selected 已选顺序 * @param ordered 当前集完整顺序 * @returns 是否可以提交诊断 */ export function continuitySelectionValid(selected: string[], ordered: string[]) { const start = ordered.indexOf(selected[0] ?? '') return ( selected.length >= 2 && selected.length <= 3 && start >= 0 && selected.every((id, i) => ordered[start + i] === id) && new Set(selected).size === selected.length ) } /** * 提交时校验逐镜观察,无法判断使用真实 unknown/null,不猜测证据。 * @param observation 人工观察 * @param shotIds 正式镜头顺序 * @returns 是否满足正式 Schema */ export function validObservation(observation: ContinuityObservation | null, shotIds: string[]) { return ( !!observation && /^[a-f0-9]{64}$/.test(observation.expectedFingerprint) && observation.landmarks.every(item => !!item.trim() && item.trim().length <= 120) && observation.landmarks[0].trim() !== observation.landmarks[1].trim() && observation.frames.length === shotIds.length && observation.frames.every( (frame, i) => frame.shotId === shotIds[i] && !!frame.evidence.trim() && frame.evidence.trim().length <= 500 && frame.features.length > 0 && frame.features.length <= 24 && new Set(frame.features.map(item => item.key.trim())).size === frame.features.length && frame.features.every( item => !!item.key.trim() && item.key.trim().length <= 120 && !!item.evidence.trim() && item.evidence.trim().length <= 500 && (item.side !== undefined) !== (item.count !== undefined) && (item.count === undefined || item.count === null || (Number.isInteger(item.count) && item.count >= 0 && item.count <= 100)) ) ) ) } /** 公共诊断状态中文,不将证据不足表现为通过。 */ export const continuityStatusLabels: Record = { passed: '通过', failed: '未通过', needs_review: '待人工复核', insufficient_evidence: '证据不足', stale: '已失效' } /** 历史失效原因只在展示层转为中文。 */ export const continuityInvalidationLabels: Record = { primary_changed: '主首帧已变化', evidence_changed: '正式来源、布局或审核证据已变化', current_evidence_unavailable: '当前证据不足', group_scope_changed: '镜头或场景范围已变化' } /** * 项目连续性接口路径。 * @param projectId 正式项目 * @returns 同项目路径 */ function path(projectId: string) { return `/projects/${encodeURIComponent(projectId)}/storyboard-keyframes/continuity` } /** 连续性只读诊断与独立审核记录,不修改 Primary。 */ export const continuityApi = { /** * 免费读取诊断或消费人工观察。 * @param projectId 项目范围 * @param input 正式镜头和本次指纹 * @param signal 取消失效查询 * @returns 诊断结果 */ diagnose: (projectId: string, input: ContinuityInput, signal?: AbortSignal) => request(`${path(projectId)}/diagnosis`, { method: 'POST', body: input, signal, timeoutMs: 0 }), /** * 保存本次明确审核,重复参数由服务端幂等复用。 * @param projectId 项目范围 * @param input 本次观察指纹和真实审核人 * @returns 不可变审核记录 */ save: (projectId: string, input: ContinuityInput & { reviewer: string }) => request(`${path(projectId)}/reviews`, { method: 'POST', body: input, timeoutMs: 0 }), /** * 回读原始结论及当前失效原因。 * @param projectId 项目范围 * @param reviewId 正式审核编号 * @param signal 取消过期读取 * @returns 历史审核与当前性 */ review: (projectId: string, reviewId: string, signal?: AbortSignal) => request(`${path(projectId)}/reviews/${encodeURIComponent(reviewId)}`, { signal, timeoutMs: 0 }) }