import type { DramaReviewIssue, DramaReviewPreview, DramaReviewSnapshot, DramaRewritePreview, ManualReviewDraft, DeferredUncertaintyDraft, ReviewResolutionSuggestion, ManualReviewDecision } from './types' /** * 读取当前预检绑定保存记录中的裁决,兼容人工处理尚未生成新 Review 的情况。 * @param review 保存记录中的原始审核字段 * @param reviewId 本次预检对应的正式审核编号 * @returns 结构完整且属于本次审核的裁决,字段缺失时回退正式审核记录 */ export function savedReviewDecisions(review: unknown, reviewId: string): ManualReviewDecision[] | null { if (!review || typeof review !== 'object' || !('manualUncertaintyDecisions' in review)) return null const decisions = review.manualUncertaintyDecisions if (!Array.isArray(decisions)) return null return decisions.filter( (item): item is ManualReviewDecision => !!item && typeof item === 'object' && item.reviewId === reviewId && Number.isSafeInteger(item.originalIndex) && typeof item.description === 'string' && ['accepted', 'deferred', 'verified'].includes(item.disposition) && (item.episode === undefined || (Number.isSafeInteger(item.episode) && item.episode > 0)) && (item.verificationTarget === undefined || ['breakdown', 'storyboard'].includes(item.verificationTarget)) && (item.verificationCriteria === undefined || typeof item.verificationCriteria === 'string') ) } /** 原始审核中的问题位置,不能用排序后的页面位置替代。 */ export interface IndexedReviewIssue { /** 原始待确认数组索引。 */ originalIndex: number /** 真实问题内容。 */ issue: DramaReviewIssue } /** 原始审核中的不确定项位置。 */ export interface IndexedReviewUncertainty { /** 原始不确定项数组索引。 */ originalIndex: number /** 原始文字。 */ text: string } /** 质量维度只翻译展示名称,提交仍使用原始枚举。 */ export const reviewCategoryOptions = [ { label: '动作衔接', value: 'action_continuity' }, { label: '手部占用', value: 'hand_occupancy' }, { label: '姿态', value: 'pose' }, { label: '视线', value: 'gaze' }, { label: '道具交互', value: 'prop_interaction' }, { label: '时长', value: 'duration' }, { label: '主体一致性', value: 'subject_consistency' }, { label: '空间衔接', value: 'spatial_continuity' } ] /** * 沿用服务端识别当前待处理问题的字段,不把同集不同问题合并。 * @param left 原始问题 * @param right 当前问题 * @returns 是否为同一原始条目 */ function sameIssue(left: DramaReviewIssue, right: DramaReviewIssue) { return left.episode === right.episode && left.code === right.code && left.sourceQuote === right.sourceQuote } /** * 展示当前剩余问题,始终保留原数组索引。 * @param preview 当前预检 * @returns 可按剧集展示的原始条目 */ export function indexedPendingIssues(preview: DramaReviewPreview | null): IndexedReviewIssue[] { if (!preview) return [] return preview.pendingQualityIssues .map((issue, originalIndex) => ({ issue, originalIndex })) .filter( row => !preview.remainingPendingQualityIssues || preview.remainingPendingQualityIssues.some(issue => sameIssue(row.issue, issue)) ) .toSorted((left, right) => left.issue.episode - right.issue.episode || left.originalIndex - right.originalIndex) } /** * 原始索引独立于页面过滤,并与后端的文字匹配规则保持一致。 * @param preview 当前预检 * @returns 尚未裁决的不确定项 */ export function indexedUncertainties(preview: DramaReviewPreview | null): IndexedReviewUncertainty[] { if (!preview) return [] return preview.uncertainty .map((text, originalIndex) => ({ text, originalIndex })) .filter(row => !preview.remainingUncertainty || preview.remainingUncertainty.includes(row.text)) } /** * 只比较用户已核对的服务端来源,任何变更都要求重新选择。 * @param previous 用户已核对的版本 * @param current 提交前重新读取的版本 * @returns 审核、保存记录与正文是否完全相同 */ export function sameReviewSource(previous: DramaReviewPreview, current: DramaReviewPreview): boolean { return ( previous.projectId === current.projectId && previous.reviewId === current.reviewId && previous.checkpointId === current.checkpointId && JSON.stringify(previous.episodes) === JSON.stringify(current.episodes) && JSON.stringify(previous.pendingQualityIssues) === JSON.stringify(current.pendingQualityIssues) && JSON.stringify(previous.uncertainty) === JSON.stringify(current.uncertainty) && JSON.stringify(previous.remainingPendingQualityIssues) === JSON.stringify(current.remainingPendingQualityIssues) && JSON.stringify(previous.remainingUncertainty) === JSON.stringify(current.remainingUncertainty) && JSON.stringify(previous.resolutionSuggestions) === JSON.stringify(current.resolutionSuggestions) ) } /** * 改写范围或来源变化后撤销旧费用确认。 * @param previous 已展示的改写预检 * @param current 提交前的新预检 * @returns 是否仍是用户核对的同一范围 */ export function sameRewriteScope(previous: DramaRewritePreview, current: DramaRewritePreview): boolean { return ( previous.projectId === current.projectId && previous.checkpointId === current.checkpointId && previous.rewriteCharacters === current.rewriteCharacters && previous.rewriteWorld === current.rewriteWorld && previous.rewriteEpisodes === current.rewriteEpisodes && JSON.stringify(previous.episodeNumbers.toSorted((a, b) => a - b)) === JSON.stringify(current.episodeNumbers.toSorted((a, b) => a - b)) ) } /** * 只有正式预检明确允许,且当前剩余数据完整时,才开放人工确认。 * @param snapshot 已读取的审核及预检 * @returns 不可提交的可读原因,空字符串表示可继续核对 */ export function reviewBlockReason(snapshot: DramaReviewSnapshot | null): string { if (!snapshot?.latest) return '当前尚无审核记录。' if (snapshot.latest.passed) return '当前审核已通过,无需再次确认。' if (snapshot.previewError) return snapshot.previewError const preview = snapshot.preview if (!preview) return '尚未取得问题处理预检,请重新读取。' if (preview.hasActiveExecution) return '剧本任务仍在运行,请结束后再处理审核问题。' if (!preview.sourceValid || !preview.reviewSourceValid || preview.reviewId !== snapshot.latest.id) return '审核与当前剧本来源不一致,请刷新并核对保存记录。' if ( !preview.ready || preview.readOnly !== true || !Array.isArray(preview.remainingPendingQualityIssues) || !Array.isArray(preview.remainingUncertainty) ) return '当前预检尚不允许确认,请刷新后核对。' return '' } /** * 表单提交前检查必填项与逐字引用;最终事实仍由服务端核验。 * @param draft 人工补充的草稿 * @param episodes 当前预检返回的正式正文 * @returns 可读字段问题,空字符串表示表单完整 */ export function manualIssueError(draft: ManualReviewDraft, episodes: DramaReviewPreview['episodes']): string { const episode = episodes.find(item => item.episode === draft.episode) if (!episode) return '请选择当前正式剧集。' if (![draft.code, draft.sourceQuote, draft.message, draft.suggestion].every(value => value.trim())) return '请填写问题名称、原文片段、问题说明和修改建议。' if (!episode.content.includes(draft.sourceQuote.trim())) return '引用片段必须逐字出现在所选剧集原文中。' if (draft.subjectRef.trim() && !episode.content.includes(draft.subjectRef.trim())) return '所选角色必须出现在引用所属的剧集原文中。' return '' } /** * 无效模型结构或无法核实的证据不能通过接受不确定项绕过。 * @param text 原始不确定项 * @returns 是否允许请求人工接受 */ export function uncertaintyAcceptable(text: string): boolean { return !/引用原文或主体无法核实|模型返回不符合审核结构/.test(text) } /** * 建议位置可能来自剩余项列表;按完整原文对应,提交仍使用原始审核索引。 * @param preview 当前预检 * @param originalIndex 原始不确定项索引 * @returns 唯一对应的建议,无法对应时为空 */ export function suggestionForUncertainty( preview: DramaReviewPreview | null, originalIndex: number ): ReviewResolutionSuggestion | null { const text = preview?.uncertainty[originalIndex] if ( !preview || typeof text !== 'string' || (preview.remainingUncertainty && !preview.remainingUncertainty.includes(text)) ) return null const matches = preview.resolutionSuggestions?.filter(item => item.description === text) ?? [] return matches.length === 1 ? matches[0]! : null } /** * 只有用户主动选择延期时创建草稿;低置信度或要求选集的建议不绑定默认集号。 * @param index 原始不确定项索引 * @param suggestion 当前原文对应的建议 * @param episodes 正式剧集列表 * @returns 尚未确认的延期表单 */ export function newDeferredDraft( index: number, suggestion: ReviewResolutionSuggestion | null, episodes: DramaReviewPreview['episodes'] ): DeferredUncertaintyDraft { const episode = suggestion?.confidence === 'high' && !suggestion.requiresEpisodeSelection && episodes.some(item => item.episode === suggestion.episode) ? suggestion.episode : null return { index, episode, verificationTarget: suggestion?.verificationTarget ?? null, verificationCriteria: suggestion?.verificationCriteria ?? '' } } /** * 校验用户编辑后的延期要求,不限制为候选集,也不把建议当作已确认。 * @param draft 当前延期草稿 * @param episodes 当前正式剧集 * @returns 需要用户修正的字段问题 */ export function deferredDraftError(draft: DeferredUncertaintyDraft, episodes: DramaReviewPreview['episodes']): string { if (!Number.isSafeInteger(draft.episode) || !episodes.some(item => item.episode === draft.episode)) return '请明确选择负责核验的正式剧集。' if (!['breakdown', 'storyboard'].includes(draft.verificationTarget ?? '')) return '请选择核验阶段。' if (!draft.verificationCriteria.trim()) return '请填写核验标准。' if (draft.verificationCriteria.trim().length > 2000) return '核验标准不能超过 2000 个字符。' return '' }