feat(short-drama-agent-front): 接入审核人工确认与延期验证

This commit is contained in:
GJ committed 2026-10-28 16:32:47 +08:00
1 parent 5836b90934
commit c6ef595a8e
23 files changed
+3923 -67

No files matched your search

+200
View File
@@ -0,0 +1,200 @@
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<LatestDramaReview>(`/projects/${encodeURIComponent(id)}/reviews/latest`, { signal })),
/**
* 读取人工确认来源、稳定索引、当前剩余项与正式正文。
* @param id 正式项目编号
* @param signal 取消旧查询
* @returns 只读确认预检
*/
preview: (id: string, signal?: AbortSignal) =>
request<DramaReviewPreview>(`/projects/${encodeURIComponent(id)}/reviews/confirm-issues/preview`, { signal }),
/**
* 保存明确确认的人工裁决,不能以请求成功代替审核通过。
* @param id 正式项目编号
* @param input 用户核对的裁决
* @returns 本次裁决回执
*/
confirm: (id: string, input: ConfirmDramaIssuesInput) =>
request<ConfirmDramaIssuesResult>(`/projects/${encodeURIComponent(id)}/reviews/confirm-issues`, {
method: 'POST',
body: input
}),
/**
* 只读查询当前改写范围,不创建任务。
* @param id 正式项目编号
* @param signal 取消旧查询
* @returns 真实改写预检
*/
rewritePreview: (id: string, signal?: AbortSignal) =>
request<DramaRewritePreview>(`/projects/${encodeURIComponent(id)}/resume-rewrite/preview`, { signal })
}
/**
* 读取并校验真实改写预检,角色、世界观和剧集范围均由服务端提供。
* @param id 正式项目编号
* @param signal 取消旧读取
* @returns 已核对归属与结构的改写预检
*/
export async function loadDramaRewritePreview(id: string, signal?: AbortSignal): Promise<DramaRewritePreview> {
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<DramaReviewSnapshot> {
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) }
}
}