import { errorMessage, optionalResource, request } from '../../../lib/http' import type { ConfirmDramaIssuesInput, ConfirmDramaIssuesResult, DramaReviewPreview, DramaReviewSnapshot, DramaRewritePreview, LatestDramaReview } from './types' /** * 校验需要展示和定位的最小问题结构,不在页面重新判断业务质量。 * @param value 接口原始问题列表 * @returns 是否具备完整可展示字段 */ function validIssues(value: unknown): boolean { return ( Array.isArray(value) && value.every( item => item && typeof item === 'object' && Number.isSafeInteger(item.episode) && item.episode > 0 && ['warning', 'error'].includes(item.severity) && ['category', 'code', 'sourceQuote', 'message', 'suggestion'].every( key => typeof item[key] === 'string' ) && (item.subjectRef === undefined || typeof item.subjectRef === 'string') && (item.policyException === undefined || typeof item.policyException === 'boolean') && (item.evidenceConfidence === undefined || ['explicit', 'inferred', 'unknown'].includes(item.evidenceConfidence)) ) ) } /** * 历史回执或格式异常只能只读提示,不伪造成空问题列表并开放提交。 * @param preview 原始确认预检 * @returns 是否具备完整的来源与正文结构 */ function validPreview(preview: DramaReviewPreview): boolean { return ( preview.readOnly === true && !!preview.checkpointId && [preview.ready, preview.sourceValid, preview.reviewSourceValid, preview.hasActiveExecution].every( value => typeof value === 'boolean' ) && validIssues(preview.pendingQualityIssues) && validTextList(preview.uncertainty) && (preview.remainingPendingQualityIssues === undefined || validIssues(preview.remainingPendingQualityIssues)) && (preview.remainingUncertainty === undefined || validTextList(preview.remainingUncertainty)) && (preview.resolutionSuggestions === undefined || validSuggestions(preview.resolutionSuggestions)) && Array.isArray(preview.episodes) && preview.episodes.every( item => item && Number.isSafeInteger(item.episode) && item.episode > 0 && typeof item.content === 'string' ) ) } /** * 校验原始不确定项列表。 * @param value 原始字段 * @returns 是否为完整的文字数组 */ function validTextList(value: unknown): boolean { return Array.isArray(value) && value.every(item => typeof item === 'string') } /** * 校验建议的展示字段,不据建议置信度推导审核是否通过。 * @param value 原始建议列表 * @returns 是否具备完整的建议结构 */ function validSuggestions(value: unknown): boolean { return ( Array.isArray(value) && value.every( item => item && typeof item === 'object' && Number.isSafeInteger(item.index) && item.index >= 0 && typeof item.description === 'string' && ['defer', 'manual_review'].includes(item.suggestedAction) && typeof item.requiresEpisodeSelection === 'boolean' && typeof item.requiresManualConfirmation === 'boolean' && (item.episode === null || (Number.isSafeInteger(item.episode) && item.episode > 0)) && Array.isArray(item.episodeCandidates) && item.episodeCandidates.every( (episode: unknown) => typeof episode === 'number' && Number.isSafeInteger(episode) && episode > 0 ) && ['high', 'low', 'none'].includes(item.confidence) && [null, 'breakdown', 'storyboard'].includes(item.verificationTarget) && (item.verificationCriteria === null || typeof item.verificationCriteria === 'string') && typeof item.reason === 'string' ) ) } /** 真实剧本审核接口;只读预检和人工确认均不调用模型。 */ export const dramaReviewApi = { /** * 读取最新正式审核,尚无审核时返回空值。 * @param id 正式项目编号 * @param signal 取消旧查询 * @returns 最新审核或空值 */ latest: (id: string, signal?: AbortSignal) => optionalResource(request(`/projects/${encodeURIComponent(id)}/reviews/latest`, { signal })), /** * 读取人工确认来源、稳定索引、当前剩余项与正式正文。 * @param id 正式项目编号 * @param signal 取消旧查询 * @returns 只读确认预检 */ preview: (id: string, signal?: AbortSignal) => request(`/projects/${encodeURIComponent(id)}/reviews/confirm-issues/preview`, { signal }), /** * 保存明确确认的人工裁决,不能以请求成功代替审核通过。 * @param id 正式项目编号 * @param input 用户核对的裁决 * @returns 本次裁决回执 */ confirm: (id: string, input: ConfirmDramaIssuesInput) => request(`/projects/${encodeURIComponent(id)}/reviews/confirm-issues`, { method: 'POST', body: input }), /** * 只读查询当前改写范围,不创建任务。 * @param id 正式项目编号 * @param signal 取消旧查询 * @returns 真实改写预检 */ rewritePreview: (id: string, signal?: AbortSignal) => request(`/projects/${encodeURIComponent(id)}/resume-rewrite/preview`, { signal }) } /** * 读取并校验真实改写预检,角色、世界观和剧集范围均由服务端提供。 * @param id 正式项目编号 * @param signal 取消旧读取 * @returns 已核对归属与结构的改写预检 */ export async function loadDramaRewritePreview(id: string, signal?: AbortSignal): Promise { const preview = await dramaReviewApi.rewritePreview(id, signal) if ( preview.projectId !== id || !preview.checkpointId || preview.readOnly !== true || preview.requiresConfirmation !== true || typeof preview.ready !== 'boolean' || !['stale', 'blocked', 'needs_review', 'ready'].includes(preview.status) || !Array.isArray(preview.episodeNumbers) || !preview.episodeNumbers.every(number => Number.isSafeInteger(number) && number > 0) || ![preview.rewriteCharacters, preview.rewriteWorld, preview.rewriteEpisodes].every( value => typeof value === 'boolean' ) ) throw new Error('改写预检返回的数据不完整或不属于当前项目,请重新读取。') return preview } /** * 最新审核与处理预检分别核对身份,预检失败仍保留正式审核供只读查看。 * @param id 正式项目编号 * @param signal 取消旧查询 * @returns 当前审核及其对应预检 */ export async function loadDramaReview(id: string, signal?: AbortSignal): Promise { if (!id) return { latest: null, preview: null } const latest = await dramaReviewApi.latest(id, signal) if (!latest) return { latest: null, preview: null } if (latest.projectId !== id || !latest.id || typeof latest.passed !== 'boolean') throw new Error('审核记录与当前项目不一致,请重新读取。') if ( !validIssues(latest.pendingQualityIssues) || !Array.isArray(latest.affectedEpisodes) || !validTextList(latest.hitWords) || !Array.isArray(latest.manualUncertaintyDecisions) || latest.manualUncertaintyDecisions.some(item => !item || typeof item.description !== 'string') || (latest.qualityReview !== null && (!latest.qualityReview || !validIssues(latest.qualityReview.issues) || !validTextList(latest.qualityReview.uncertainty))) ) throw new Error('正式审核数据不完整,请重新读取后核对。') if (latest.passed) return { latest, preview: null } try { const preview = await dramaReviewApi.preview(id, signal) if (preview.projectId !== id || preview.reviewId !== latest.id) throw new Error('审核版本已变化,请重新读取后核对。') if (!validPreview(preview)) throw new Error('审核预检的数据不完整,请重新读取后核对。') return { latest, preview } } catch (cause) { if (signal?.aborted) throw cause return { latest, preview: null, previewError: errorMessage(cause) } } }