201 lines
8.6 KiB
TypeScript
201 lines
8.6 KiB
TypeScript
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) }
|
|
}
|
|
}
|