Files
short-drama-agent-front/src/features/create-drama/review/model.ts
T

249 lines
11 KiB
TypeScript

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 ''
}