feat(short-drama-agent-front): 接入审核人工确认与延期验证
This commit is contained in:
1 parent
5836b90934
commit
c6ef595a8e
23 files changed
+3923
-67
No files matched your search
@@ -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) }
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user