import { effectScope, ref, type EffectScope } from 'vue' import { afterEach, describe, expect, it, vi } from 'vitest' import { projectsApi } from '@/features/projects/api' import type { ProjectQualityPolicy, ProjectQualityPolicyResult } from '@/features/projects/types' import { policyDraft } from '@/features/projects/quality-policy' import { useBreakdownStartPolicy } from '@/features/breakdown/useBreakdownStartPolicy' import { invalidateQualityPolicyConfirmation, qualityPolicySignature, readQualityPolicyConfirmation, rememberQualityPolicyConfirmation } from '@/features/projects/quality-policy-confirmation' /** * 使用真实接口形状的独立规则,不连接服务或调用模型。 * @returns 独立项目规则回执 */ function receipt(): ProjectQualityPolicyResult { return { projectId: 'policy-project', policy: { version: 1, physicsMode: 'realistic', allowExaggeratedMotion: false, allowNonPhysicalActions: false, allowSupernaturalAbilities: false, customRules: [] } } } /** 每个测试释放组合函数观察器。 */ let scope: EffectScope | undefined /** * 创建可切换项目、预览和活动锁的测试观察器。 * @returns 流程及其响应式输入 */ function setup() { const id = ref('policy-project') const input = ref('preview-1') const allowed = ref(true) scope = effectScope() const flow = scope.run(() => useBreakdownStartPolicy(id, input, allowed))! return { id, input, allowed, flow } } afterEach(() => { scope?.stop() vi.unstubAllGlobals() localStorage.clear() vi.restoreAllMocks() }) describe('拆解质量规则内容与当前浏览器确认', () => { it('忽略属性顺序、首尾空格和空例外表示,但识别许可、规则和例外的实际变化', () => { const base = receipt().policy expect(qualityPolicySignature({ ...base, actionExceptions: [] })).toBe(qualityPolicySignature(base)) const reversed = Object.fromEntries(Object.entries({ ...base, customRules: ['规则'] }).toReversed()) as unknown as ProjectQualityPolicy expect(qualityPolicySignature({ ...base, customRules: [' 规则 '] })).toBe(qualityPolicySignature(reversed)) for (const changed of [ { ...base, physicsMode: 'fantasy' as const }, { ...base, allowExaggeratedMotion: true }, { ...base, allowNonPhysicalActions: true }, { ...base, allowSupernaturalAbilities: true }, { ...base, customRules: ['新规则'] }, { ...base, actionExceptions: [{ code: 'action_resource_conflict' as const, ownerRef: '@CH1', resource: 'left_hand' as const, reason: '剧本许可' }] } ]) expect(qualityPolicySignature(changed)).not.toBe(qualityPolicySignature(base)) expect(() => qualityPolicySignature({ ...base, customRules: null } as unknown as ProjectQualityPolicy)).toThrow('质量规则响应不完整') }) it('确认按项目隔离,损坏存储或存储权限失败不会被当作已确认', () => { expect(readQualityPolicyConfirmation('policy-project')).toBeNull() rememberQualityPolicyConfirmation('policy-project', 'signature') expect(readQualityPolicyConfirmation('other')).toBeNull() localStorage.setItem('short-drama:breakdown-quality-confirmation:v1:policy-project', '{') expect(readQualityPolicyConfirmation('policy-project')).toBeNull() vi.stubGlobal('localStorage', { getItem: () => null, setItem: () => { throw new Error('storage blocked') } }) expect(rememberQualityPolicyConfirmation('policy-project', 'new')).toBe(false) }) }) describe('拆解前规则确认流程', () => { it('首次读取失败不展示默认规则,重试后才能进入确认', async () => { const read = vi.spyOn(projectsApi, 'qualityPolicy').mockRejectedValueOnce(new Error('读取不可用')).mockResolvedValue(receipt()) const { flow } = setup() await flow.prepare() expect(flow.policy.value).toBeNull() expect(flow.reviewOpen.value).toBe(false) expect(flow.startOpen.value).toBe(false) expect(flow.error.value).toBe('读取不可用') expect(flow.consumePermit()).toBe(false) await flow.prepare() expect(read).toHaveBeenCalledTimes(2) expect(flow.reviewOpen.value).toBe(true) expect(flow.error.value).toBe('') }) it('首次读取真实规则,取消不记录确认,也不允许绕过确认直接启动', async () => { const read = vi.spyOn(projectsApi, 'qualityPolicy').mockResolvedValue(receipt()) const save = vi.spyOn(projectsApi, 'saveQualityPolicy') const { flow } = setup() expect(read).not.toHaveBeenCalled() await flow.prepare() expect(flow.reviewOpen.value).toBe(true) expect(flow.startOpen.value).toBe(false) expect(await flow.verifyStart()).toBe(false) expect(flow.consumePermit()).toBe(false) flow.cancel() expect(readQualityPolicyConfirmation('policy-project')).toBeNull() expect(save).not.toHaveBeenCalled() }) it('明确确认未改规则不重复保存,刷新会话后直接进入普通启动确认', async () => { vi.spyOn(projectsApi, 'qualityPolicy').mockResolvedValue(receipt()) const save = vi.spyOn(projectsApi, 'saveQualityPolicy') const { flow } = setup() await flow.prepare() expect(await flow.confirmRules(receipt().policy)).toBe(true) expect(flow.startOpen.value).toBe(true) expect(save).not.toHaveBeenCalled() expect(flow.consumePermit()).toBe(false) flow.cancel() scope!.stop() const next = setup().flow await next.prepare() expect(next.reviewOpen.value).toBe(false) expect(next.startOpen.value).toBe(true) expect(await next.verifyStart()).toBe(true) expect(next.consumePermit()).toBe(true) expect(next.consumePermit()).toBe(false) }) it('编辑的完整草稿先保存并重读,保存后的内容才记作已确认', async () => { const saved = receipt() const draft = { ...saved.policy, allowExaggeratedMotion: true } const read = vi.spyOn(projectsApi, 'qualityPolicy').mockImplementation(async () => structuredClone(saved)) const save = vi.spyOn(projectsApi, 'saveQualityPolicy').mockImplementation(async (id, policy) => { saved.policy = policyDraft(policy) return { projectId: id, policy: policyDraft(policy) } }) const { flow } = setup() await flow.prepare() expect(await flow.confirmRules(draft)).toBe(true) expect(save).toHaveBeenCalledWith('policy-project', draft) expect(read).toHaveBeenCalledTimes(3) expect(readQualityPolicyConfirmation('policy-project')).toBe(qualityPolicySignature(draft)) }) it('规则在其他位置更新后重新确认,不覆盖服务端较新规则', async () => { let saved = receipt() vi.spyOn(projectsApi, 'qualityPolicy').mockImplementation(async () => structuredClone(saved)) const save = vi.spyOn(projectsApi, 'saveQualityPolicy') const { flow } = setup() await flow.prepare() saved = { ...saved, policy: { ...saved.policy, allowNonPhysicalActions: true } } expect(await flow.confirmRules(receipt().policy)).toBe(false) expect(flow.policy.value?.policy.allowNonPhysicalActions).toBe(true) expect(flow.reviewOpen.value).toBe(true) expect(flow.startOpen.value).toBe(false) expect(save).not.toHaveBeenCalled() expect(readQualityPolicyConfirmation('policy-project')).toBeNull() }) it('真实保存期间锁定取消,保存后的只读回查可取消,迟到回查不记录确认', async () => { const initial = receipt() const draft = { ...initial.policy, allowNonPhysicalActions: true } let finishSave!: (value: ProjectQualityPolicyResult) => void let finishRead!: (value: ProjectQualityPolicyResult) => void const read = vi.spyOn(projectsApi, 'qualityPolicy').mockResolvedValue(initial) const save = vi.spyOn(projectsApi, 'saveQualityPolicy').mockImplementation(() => new Promise(resolve => { finishSave = resolve })) const { flow } = setup() await flow.prepare() const pending = flow.confirmRules(draft) await Promise.resolve() await Promise.resolve() expect(save).toHaveBeenCalledOnce() expect(flow.saving.value).toBe(true) flow.cancel() expect(flow.reviewOpen.value).toBe(true) read.mockImplementationOnce(() => new Promise(resolve => { finishRead = resolve })) finishSave({ ...initial, policy: draft }) await Promise.resolve() await Promise.resolve() expect(flow.saving.value).toBe(false) expect(flow.reading.value).toBe(true) flow.cancel() finishRead({ ...initial, policy: draft }) expect(await pending).toBe(false) expect(flow.reviewOpen.value).toBe(false) expect(flow.startOpen.value).toBe(false) expect(readQualityPolicyConfirmation(initial.projectId)).toBeNull() }) it('最终启动确认期间规则变化,返回规则界面并撤销启动许可', async () => { const saved = receipt() vi.spyOn(projectsApi, 'qualityPolicy').mockImplementation(async () => structuredClone(saved)) rememberQualityPolicyConfirmation(saved.projectId, qualityPolicySignature(saved.policy)) const { flow } = setup() await flow.prepare() saved.policy.customRules = ['新规则'] expect(await flow.verifyStart()).toBe(false) expect(flow.reviewOpen.value).toBe(true) expect(flow.startOpen.value).toBe(false) expect(flow.consumePermit()).toBe(false) }) it.each(['读取失败', '项目不符', '保存失败', '回执不符', '保存后变化'])('安全拦截%s,不记住确认', async kind => { const initial = receipt() const changed = { ...initial.policy, allowNonPhysicalActions: true } const read = vi.spyOn(projectsApi, 'qualityPolicy').mockResolvedValue(initial) const save = vi.spyOn(projectsApi, 'saveQualityPolicy').mockResolvedValue({ ...initial, policy: changed }) const { flow } = setup() await flow.prepare() if (kind === '读取失败') read.mockRejectedValueOnce(new Error('读取失败')) if (kind === '项目不符') read.mockResolvedValueOnce({ ...initial, projectId: 'other' }) if (kind === '保存失败') save.mockRejectedValueOnce(new Error('保存失败')) if (kind === '回执不符') save.mockResolvedValueOnce(initial) expect(await flow.confirmRules(changed)).toBe(false) expect(flow.reviewOpen.value).toBe(true) expect(flow.startOpen.value).toBe(false) expect(flow.consumePermit()).toBe(false) expect(readQualityPolicyConfirmation(initial.projectId)).toBeNull() }) it.each(['cancel', 'project', 'scope', 'locked'])('重复点击只读一次,%s 后丢弃迟到读取', async cause => { let finish!: (value: ProjectQualityPolicyResult) => void const read = vi.spyOn(projectsApi, 'qualityPolicy').mockImplementation(() => new Promise(resolve => { finish = resolve })) const { flow, id, input, allowed } = setup() const pending = flow.prepare() await flow.prepare() expect(read).toHaveBeenCalledTimes(1) if (cause === 'cancel') flow.cancel() if (cause === 'project') id.value = 'other' if (cause === 'scope') input.value = 'preview-2' if (cause === 'locked') allowed.value = false finish(receipt()) await pending expect(flow.reviewOpen.value).toBe(false) expect(flow.startOpen.value).toBe(false) expect(flow.consumePermit()).toBe(false) }) it('最终重读失败不能启动,取消后迟到成功也不能启动', async () => { const read = vi.spyOn(projectsApi, 'qualityPolicy').mockResolvedValue(receipt()) rememberQualityPolicyConfirmation('policy-project', qualityPolicySignature(receipt().policy)) const { flow } = setup() await flow.prepare() read.mockRejectedValueOnce(new Error('重读失败')) expect(await flow.verifyStart()).toBe(false) expect(flow.consumePermit()).toBe(false) let finish!: (value: ProjectQualityPolicyResult) => void read.mockImplementationOnce(() => new Promise(resolve => { finish = resolve })) const pending = flow.verifyStart() flow.cancel() finish(receipt()) expect(await pending).toBe(false) expect(flow.consumePermit()).toBe(false) }) it('存储受限时仅在本次会话跳过确认,实际规则保存会撤销临时确认', async () => { vi.stubGlobal('localStorage', { getItem: () => null, removeItem: () => {}, setItem: () => { throw new Error('blocked') } }) vi.spyOn(projectsApi, 'qualityPolicy').mockResolvedValue(receipt()) const { flow } = setup() await flow.prepare() expect(await flow.confirmRules(receipt().policy)).toBe(true) flow.cancel() await flow.prepare() expect(flow.startOpen.value).toBe(true) invalidateQualityPolicyConfirmation('policy-project') expect(await flow.verifyStart()).toBe(false) expect(flow.reviewOpen.value).toBe(true) }) })