diff --git a/src/__tests__/components/Welcome.spec.ts b/src/__tests__/components/Welcome.spec.ts index e3eadd6..5472a6d 100644 --- a/src/__tests__/components/Welcome.spec.ts +++ b/src/__tests__/components/Welcome.spec.ts @@ -2,9 +2,11 @@ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest' import { flushPromises, mount } from '@vue/test-utils' import ElementPlus from 'element-plus' import { createMemoryHistory, createRouter } from 'vue-router' +import { nextTick } from 'vue' import Welcome from '@/components/Welcome.vue' -import { resetGuidanceAvailability } from '@/components/composables/useGuidance' import { getReviewFeed, getReviewTaskStats, submitReviewFeedback, touchReviewFragment } from '@/api/review' +import { getAiTask } from '@/api/aiTasks' +import { startGuidance } from '@/api/guidance' import { filterByMarker, getMarkersBatch } from '@/api/markers' import { updateFragmentOwnership } from '@/api/reportFragments' import appRouter from '@/router' @@ -31,6 +33,19 @@ vi.mock('@/api/reportFragments', () => ({ updateFragmentOwnership: vi.fn(), })) +vi.mock('@/api/guidance', () => ({ + startGuidance: vi.fn(), + submitGuidanceTurn: vi.fn(), + getGuidanceSession: vi.fn(), + createGuidanceFragment: vi.fn(), + abandonGuidance: vi.fn(), +})) + +vi.mock('@/api/aiTasks', async (importOriginal) => { + const actual = await importOriginal() + return { ...actual, submitAiTask: vi.fn(), getAiTask: vi.fn(), getLatestAiTask: vi.fn() } +}) + const makeFragment = (id: number) => ({ id, contextNum: `SESSION_${id}`, @@ -117,7 +132,6 @@ beforeEach(() => { return anim as unknown as Animation }) Element.prototype.animate = animateSpy as unknown as Element['animate'] - resetGuidanceAvailability() vi.mocked(getMarkersBatch).mockResolvedValue({ code: 200, data: {} } as never) vi.mocked(touchReviewFragment).mockResolvedValue({ code: 200, data: null } as never) vi.mocked(getReviewFeed).mockResolvedValue({ code: 200, data: [makeFragment(1), makeFragment(2)] }) @@ -438,3 +452,47 @@ describe('Welcome Feed 标记、反馈与摘要', () => { expect(wrapper.text()).toContain('全文 380 字') }) }) + +/** + * 学习引导入口(复习-06):入口只依赖是否归属任务,不因 AI 失败被停用。 + */ +describe('Welcome 学习引导入口', () => { + beforeEach(() => { + vi.clearAllMocks() + stubLayout(4000, 1000) + vi.mocked(getReviewFeed).mockResolvedValue({ code: 200, data: [makeFragment(1)] } as never) + vi.mocked(startGuidance).mockResolvedValue({ + code: 200, + data: { guidanceNum: 'G1', taskNum: 'T001', concept: '残片内容1', aiTaskNum: 'AI1' }, + } as never) + vi.mocked(getAiTask).mockResolvedValue({ + code: 200, + data: { + taskNum: 'AI1', + type: 'GUIDANCE', + targetNum: 'G1', + status: 'SUCCEEDED', + result: { reply: '第一个问题' }, + }, + } as never) + }) + + it('残片有归属任务时「学习引导」入口不禁用,点击后打开引导弹窗', async () => { + const wrapper = await mountWelcome() + + const guidanceButton = wrapper.findAll('button').find((b) => b.text().trim() === '学习引导') + expect(guidanceButton).toBeDefined() + expect(guidanceButton!.attributes('disabled')).toBeUndefined() + expect(guidanceButton!.attributes('title')).toBe('和 AI 一起把这个概念聊透') + + await guidanceButton!.trigger('click') + await flushPromises() + await nextTick() + + expect(startGuidance).toHaveBeenCalledWith('T1', '残片内容1') + expect(wrapper.find('.guidance-dialog').exists()).toBe(true) + expect(wrapper.text()).toContain('正在引导的概念') + + wrapper.unmount() + }) +}) diff --git a/src/__tests__/integration/guidance-flow.spec.ts b/src/__tests__/integration/guidance-flow.spec.ts index d6b1742..905114e 100644 --- a/src/__tests__/integration/guidance-flow.spec.ts +++ b/src/__tests__/integration/guidance-flow.spec.ts @@ -11,10 +11,6 @@ import { submitGuidanceTurn, } from '@/api/guidance' import { getAiTask, type AiTask } from '@/api/aiTasks' -import { - guidanceUnavailable, - resetGuidanceAvailability, -} from '@/components/composables/useGuidance' vi.mock('@/api/guidance', () => ({ startGuidance: vi.fn(), @@ -62,12 +58,11 @@ const mountDialog = async () => { } /** - * 学习引导主流程(复习-06):开对话 → 多轮 → 确认产出碎片 / 放弃 / AI 失败置不可用。 + * 学习引导主流程(复习-06):开对话 → 多轮 → 确认产出碎片 / 放弃 / AI 失败只提示不停用入口。 */ describe('学习引导(集成)', () => { beforeEach(() => { vi.clearAllMocks() - resetGuidanceAvailability() localStorage.clear() vi.mocked(startGuidance).mockResolvedValue( ok({ guidanceNum: 'G1', taskNum: 'T001', concept: '组合式 API', aiTaskNum: 'AI1' }), @@ -129,18 +124,65 @@ describe('学习引导(集成)', () => { expect(createGuidanceFragment).not.toHaveBeenCalled() }) - it('AI 失败时给出可读提示并把入口置为不可用', async () => { - vi.mocked(getAiTask).mockResolvedValue( + it('AI 失败时给出可读提示,但入口仍可用并能重试成功', async () => { + vi.mocked(getAiTask).mockResolvedValueOnce( ok(aiTask({ status: 'FAILED', errorMessage: 'AI 暂时用不了' })), ) const wrapper = await mountDialog() expect(wrapper.text()).toContain('AI 暂时用不了') - expect(guidanceUnavailable.value).toBe(true) - // 入口整体停用:输入与「记成知识碎片」不再可用 - expect(findButton(wrapper, '发送')).toBeUndefined() - expect(findButton(wrapper, '记成知识碎片')).toBeUndefined() + // 失败只提示,不改变入口可用性 + expect(findButton(wrapper, '发送')).toBeDefined() + expect(findButton(wrapper, '记成知识碎片')).toBeDefined() + + // 重新打开即可再次发起引导,并拿到 AI 回复 + vi.mocked(getAiTask).mockResolvedValue(ok(aiTask({ result: { reply: '重试后的第一个问题' } }))) + await wrapper.setProps({ modelValue: false }) + await flushPromises() + await wrapper.setProps({ modelValue: true }) + await flushPromises() + await nextTick() + await flushPromises() + + expect(startGuidance).toHaveBeenCalledTimes(2) + expect(wrapper.text()).toContain('重试后的第一个问题') + }) + + it('关闭弹窗后到达的 AI 失败不影响入口,重新打开仍能发起引导', async () => { + // AI 任务迟迟不返回:让 getAiTask 挂住,模拟 LLM 未响应 + let resolveTask: (value: unknown) => void = () => {} + vi.mocked(getAiTask).mockReturnValue( + new Promise((resolve) => { + resolveTask = resolve as (value: unknown) => void + }) as ReturnType, + ) + + const wrapper = await mountDialog() + expect(startGuidance).toHaveBeenCalledTimes(1) + + // 用户等不到回应,关闭弹窗 + await wrapper.setProps({ modelValue: false }) + await nextTick() + await flushPromises() + + // 关闭之后后端才把这次任务标为 FAILED + resolveTask(ok(aiTask({ status: 'FAILED', errorMessage: 'AI 没有回应' }))) + await flushPromises() + await nextTick() + await flushPromises() + + // 重新打开:照常发起新的引导,且不带任何“停用”类错误或上一轮的残留失败 + vi.mocked(getAiTask).mockResolvedValue(ok(aiTask({ result: { reply: '重新开始的问题' } }))) + await wrapper.setProps({ modelValue: true }) + await flushPromises() + await nextTick() + await flushPromises() + + expect(startGuidance).toHaveBeenCalledTimes(2) + expect(wrapper.text()).toContain('重新开始的问题') + expect(wrapper.text()).not.toContain('停用') + expect(wrapper.text()).not.toContain('AI 没有回应') }) it('离开页面再回来用 GET 恢复同一段对话,不重新开启', async () => { diff --git a/src/components/GuidanceDialog.vue b/src/components/GuidanceDialog.vue index 75697ec..e0fc5aa 100644 --- a/src/components/GuidanceDialog.vue +++ b/src/components/GuidanceDialog.vue @@ -5,7 +5,7 @@ import { useGuidanceSession } from "@/components/composables/useGuidance"; /** * 学习引导对话框:围绕一个概念和 AI 多轮对话,随时可以把收获记成知识碎片或放弃。 - * 不判分、不设轮数上限;AI 不可用时整体停用(入口由 guidanceUnavailable 控制)。 + * 不判分、不设轮数上限;AI 失败只提示,入口随时可重试。 */ const props = defineProps<{ modelValue: boolean; @@ -26,12 +26,12 @@ const { waiting, waitingSeconds, error, - unavailable, open, send, confirmFragment, abandon, markInteraction, + reset, } = useGuidanceSession(); const draft = ref(""); @@ -48,7 +48,10 @@ watch( fragmentVisible.value = false; fragmentContent.value = ""; void open(props.taskNum, props.concept); + return; } + // 关闭弹窗即取消在途轮询(含本组件未被销毁的情况) + reset(); }, ); @@ -65,7 +68,6 @@ const sendTurn = async () => { }; const openFragmentForm = () => { - if (unavailable.value) return; fragmentVisible.value = true; }; @@ -147,7 +149,7 @@ const giveUp = async () => { :title="error" /> -
+
{ >发送
-
+
把这次引导的收获记成知识碎片 {