import { policyIssue } from './quality-policy' import type { ProjectQualityPolicy, ProjectQualityPolicyResult } from './types' /** * 只比较质量规则的规范化内容,不把模型参数或对象属性顺序作为变更。 * @param policy 后端读取或用户编辑的完整规则 * @returns 可精确比较的内容签名,不是后端授权令牌 */ export function qualityPolicySignature(policy: ProjectQualityPolicy): string { if ( !policy || !Array.isArray(policy.customRules) || (policy.actionExceptions !== undefined && !Array.isArray(policy.actionExceptions)) ) throw new Error('质量规则响应不完整,请重新读取。') const issue = policyIssue(policy) if (issue) throw new Error(issue) return JSON.stringify({ version: policy.version, physicsMode: policy.physicsMode, allowExaggeratedMotion: policy.allowExaggeratedMotion, allowNonPhysicalActions: policy.allowNonPhysicalActions, allowSupernaturalAbilities: policy.allowSupernaturalAbilities, customRules: policy.customRules.map(rule => rule.trim()), actionExceptions: (policy.actionExceptions ?? []).map(item => ({ code: item.code, ownerRef: item.ownerRef.trim(), resource: item.resource, reason: item.reason.trim() })) }) } /** * 核对服务回执的项目、内容与修订字段;缺失时不能使用默认版本补齐。 * @param result 规则接口原始回执 * @param projectId 当前项目 * @returns 已核对的完整回执 */ export function validateQualityPolicyReceipt( result: ProjectQualityPolicyResult, projectId: string ): ProjectQualityPolicyResult { if (!result || result.projectId !== projectId) throw new Error('质量规则所属项目不一致,请重新读取。') qualityPolicySignature(result.policy) if ( !Number.isSafeInteger(result.revision) || result.revision < 0 || !/^[a-f\d]{64}$/.test(result.fingerprint) || typeof result.confirmed !== 'boolean' || !( result.confirmedRevision === null || (Number.isSafeInteger(result.confirmedRevision) && result.confirmedRevision >= 0) ) || !( result.confirmedAt === null || (typeof result.confirmedAt === 'string' && Number.isFinite(Date.parse(result.confirmedAt))) ) ) throw new Error('质量规则确认信息不完整,请重新读取。') if (result.confirmed && !qualityPolicyConfirmed(result)) throw new Error('质量规则确认版本不一致,请重新读取。') return result } /** * 仅认可服务保存的同修订明确确认,浏览器本地记录不构成确认。 * @param result 已读取的规则回执 * @returns 当前修订是否已经明确确认 */ export function qualityPolicyConfirmed(result: ProjectQualityPolicyResult): boolean { return ( result.confirmed === true && result.confirmedRevision === result.revision && typeof result.confirmedAt === 'string' && Number.isFinite(Date.parse(result.confirmedAt)) ) }