feat: AI 生成改为异步任务轮询

This commit is contained in:
2026-10-09 15:22:00 +08:00
parent 25fbc67ad2
commit e52682c352
13 changed files with 686 additions and 159 deletions
+61
View File
@@ -0,0 +1,61 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
vi.mock('@/utils/request', () => ({
default: {
get: vi.fn(),
post: vi.fn(),
put: vi.fn(),
del: vi.fn(),
},
}))
import request from '@/utils/request'
import { submitAiTask, getAiTask, getLatestAiTask } from '@/api/aiTasks'
const mockedRequest = vi.mocked(request)
describe('aiTasks API', () => {
beforeEach(() => {
vi.clearAllMocks()
mockedRequest.post.mockResolvedValue({ code: 200, data: null })
mockedRequest.get.mockResolvedValue({ code: 200, data: null })
})
it('submitAiTask 提交 type / targetNum / params', async () => {
await submitAiTask({
type: 'RECALL_COMPARE',
targetNum: 'T001',
params: { recallOutline: '根主题\n- 子节点' },
})
expect(mockedRequest.post).toHaveBeenCalledWith('/ai/tasks', {
type: 'RECALL_COMPARE',
targetNum: 'T001',
params: { recallOutline: '根主题\n- 子节点' },
})
})
it('submitAiTask 未传 params 时不发送 params 字段', async () => {
await submitAiTask({ type: 'REPORT_DRAFT', targetNum: 'S001' })
expect(mockedRequest.post).toHaveBeenCalledWith('/ai/tasks', {
type: 'REPORT_DRAFT',
targetNum: 'S001',
})
})
it('getAiTask 按任务编号查询状态', async () => {
await getAiTask('AI001')
expect(mockedRequest.get).toHaveBeenCalledWith('/ai/tasks/AI001')
})
it('getLatestAiTask 带 type 与 targetNum 查询最新任务', async () => {
await getLatestAiTask('MIND_MAP', 'T001')
expect(mockedRequest.get).toHaveBeenCalledWith('/ai/tasks/latest', {
type: 'MIND_MAP',
targetNum: 'T001',
})
})
})
+21 -25
View File
@@ -10,43 +10,39 @@ vi.mock('@/utils/request', () => ({
}))
import request from '@/utils/request'
import { recallCompare } from '@/api/standardMindMap'
import {
getStandardMindMap,
listRecallRecords,
updateStandardMindMap,
} from '@/api/standardMindMap'
const mockedRequest = vi.mocked(request)
describe('standardMindMap API', () => {
beforeEach(() => {
vi.clearAllMocks()
mockedRequest.post.mockResolvedValue({ code: 200, data: {} })
mockedRequest.get.mockResolvedValue({ code: 200, data: null })
mockedRequest.put.mockResolvedValue({ code: 200, data: {} })
})
it('recallCompare 不带 timing 时不发送三个耗时字段', async () => {
await recallCompare('T001', '根主题\n- 子节点')
it('getStandardMindMap 只读取导图,未生成时 data 为 null(不再自动生成)', async () => {
const res = await getStandardMindMap('T001')
expect(mockedRequest.post).toHaveBeenCalledWith(
'/review/standard-mind-map/T001/recall',
{ recallOutline: '根主题\n- 子节点' },
{ timeout: 300_000 },
)
expect(mockedRequest.get).toHaveBeenCalledWith('/review/standard-mind-map/T001')
expect(res.data).toBeNull()
})
it('recallCompare 带 timing 时映射为后端字段', async () => {
await recallCompare('T001', '根主题', '根主题 / 子节点', {
startedAt: '2026-01-15T09:00:00',
lastInteractionAt: '2026-01-15T09:00:30',
durationSeconds: 30,
it('updateStandardMindMap 提交大纲文本', async () => {
await updateStandardMindMap('T001', '根主题\n- 子节点')
expect(mockedRequest.put).toHaveBeenCalledWith('/review/standard-mind-map/T001', {
outline: '根主题\n- 子节点',
})
})
expect(mockedRequest.post).toHaveBeenCalledWith(
'/review/standard-mind-map/T001/recall',
{
recallOutline: '根主题',
focusPath: '根主题 / 子节点',
reviewStartedAt: '2026-01-15T09:00:00',
reviewLastInteractionAt: '2026-01-15T09:00:30',
reviewDurationSeconds: 30,
},
{ timeout: 300_000 },
)
it('listRecallRecords 拉取回忆对比记录', async () => {
await listRecallRecords('T001')
expect(mockedRequest.get).toHaveBeenCalledWith('/review/standard-mind-map/T001/recall-records')
})
})
+10 -1
View File
@@ -23,7 +23,6 @@ vi.mock('@/api/studySessions', () => ({
endSession: vi.fn(),
getActiveSession: vi.fn(),
getExpectation: vi.fn(),
getReportDraft: vi.fn(),
getSessionDetail: vi.fn(),
getTaskFragments: vi.fn(),
getTaskReports: vi.fn(),
@@ -32,6 +31,16 @@ vi.mock('@/api/studySessions', () => ({
upsertExpectation: vi.fn(),
}))
vi.mock('@/api/aiTasks', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/api/aiTasks')>()
return {
...actual,
submitAiTask: vi.fn(),
getAiTask: vi.fn(),
getLatestAiTask: vi.fn(),
}
})
vi.mock('@/api/reportFragments', () => ({
createFragments: vi.fn(),
getFragmentsBySession: vi.fn(),
+146
View File
@@ -0,0 +1,146 @@
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { defineComponent, h } from 'vue'
import { mount } from '@vue/test-utils'
import { useAiTask } from '@/components/composables/useAiTask'
import type { AiTask } from '@/api/aiTasks'
vi.mock('@/api/aiTasks', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/api/aiTasks')>()
return {
...actual,
submitAiTask: vi.fn(),
getAiTask: vi.fn(),
getLatestAiTask: vi.fn(),
}
})
import {
AI_TASK_POLL_INTERVAL_MS,
getAiTask,
getLatestAiTask,
submitAiTask,
} from '@/api/aiTasks'
const ok = <T,>(data: T) => ({ code: 200, message: '请求成功', data })
const task = (overrides: Partial<AiTask> = {}): AiTask => ({
taskNum: 'AI001',
type: 'MIND_MAP',
targetNum: 'T001',
status: 'RUNNING',
...overrides,
})
/** 假定时器下推进时间并刷新微任务:单次推进不足以跑完“提交 → 轮询”的链式 promise */
const advancePolls = async (times = 3) => {
for (let i = 0; i < times; i++) {
await vi.advanceTimersByTimeAsync(AI_TASK_POLL_INTERVAL_MS)
}
}
describe('useAiTask', () => {
beforeEach(() => {
vi.useFakeTimers()
vi.clearAllMocks()
})
afterEach(() => {
vi.useRealTimers()
})
it('run 提交任务后轮询,SUCCEEDED 返回 result 并复位 running', async () => {
vi.mocked(submitAiTask).mockResolvedValue(ok(task({ status: 'PENDING' })))
vi.mocked(getAiTask).mockResolvedValue(ok(task({ status: 'SUCCEEDED', result: { standardMapId: 9 } })))
const { run, running } = useAiTask()
const promise = run('MIND_MAP', 'T001', { mode: 'full' })
await advancePolls()
await expect(promise).resolves.toEqual({ standardMapId: 9 })
expect(submitAiTask).toHaveBeenCalledWith({
type: 'MIND_MAP',
targetNum: 'T001',
params: { mode: 'full' },
})
expect(getAiTask).toHaveBeenCalledWith('AI001')
expect(running.value).toBe(false)
})
it('轮询期间保持 running 并暴露已等待秒数', async () => {
vi.mocked(submitAiTask).mockResolvedValue(ok(task({ status: 'PENDING' })))
vi.mocked(getAiTask).mockResolvedValue(ok(task({ status: 'RUNNING' })))
const { run, running, seconds, stop } = useAiTask()
const promise = run('MIND_MAP', 'T001')
promise.catch(() => {})
await vi.advanceTimersByTimeAsync(3000)
expect(running.value).toBe(true)
expect(seconds.value).toBe(3)
stop()
})
it('任务 FAILED 时抛出带 errorMessage 的错误', async () => {
vi.mocked(submitAiTask).mockResolvedValue(ok(task({ status: 'PENDING' })))
vi.mocked(getAiTask).mockResolvedValue(
ok(task({ status: 'FAILED', errorMessage: '思维导图生成失败' })),
)
const { run } = useAiTask()
await expect(run('MIND_MAP', 'T001')).rejects.toThrow('思维导图生成失败')
})
it('组件卸载时停止轮询', async () => {
vi.mocked(submitAiTask).mockResolvedValue(ok(task({ status: 'PENDING' })))
vi.mocked(getAiTask).mockResolvedValue(ok(task({ status: 'RUNNING' })))
let exposed!: ReturnType<typeof useAiTask>
const Host = defineComponent({
setup() {
exposed = useAiTask()
return () => h('div')
},
})
const wrapper = mount(Host)
const promise = exposed.run('MIND_MAP', 'T001')
promise.catch(() => {})
await advancePolls()
const callsBeforeUnmount = vi.mocked(getAiTask).mock.calls.length
expect(callsBeforeUnmount).toBeGreaterThan(0)
wrapper.unmount()
await advancePolls(5)
expect(vi.mocked(getAiTask).mock.calls.length).toBe(callsBeforeUnmount)
})
it('resume 找到进行中的任务时继续轮询并返回结果', async () => {
vi.mocked(getLatestAiTask).mockResolvedValue(ok(task({ type: 'REPORT_DRAFT', status: 'RUNNING' })))
vi.mocked(getAiTask).mockResolvedValue(ok(task({ status: 'SUCCEEDED', result: { draft: '草稿' } })))
const { resume, running } = useAiTask()
const restore = await resume('REPORT_DRAFT', 'S001')
expect(getLatestAiTask).toHaveBeenCalledWith('REPORT_DRAFT', 'S001')
expect(restore.found).toBe(true)
await expect(restore.done).resolves.toEqual({ draft: '草稿' })
expect(running.value).toBe(false)
})
it('resume 没有进行中的任务时 found=false 且不轮询', async () => {
vi.mocked(getLatestAiTask).mockResolvedValue(ok(task({ status: 'SUCCEEDED' })))
const { resume, running } = useAiTask()
const restore = await resume('MIND_MAP', 'T001')
expect(restore.found).toBe(false)
expect(restore.done).toBeNull()
expect(getAiTask).not.toHaveBeenCalled()
expect(running.value).toBe(false)
})
})
@@ -3,23 +3,36 @@ import { flushPromises, mount } from '@vue/test-utils'
import ElementPlus, { ElMessage } from 'element-plus'
import { createMemoryHistory, createRouter } from 'vue-router'
import ReviewRecall from '@/components/ReviewRecall.vue'
import {
getStandardMindMap,
listRecallRecords,
recallCompare,
} from '@/api/standardMindMap'
import { getStandardMindMap, listRecallRecords } from '@/api/standardMindMap'
import { getAiTask, getLatestAiTask, submitAiTask, type AiTask } from '@/api/aiTasks'
vi.mock('@/api/standardMindMap', () => ({
findNode: vi.fn(),
getStandardMindMap: vi.fn(),
listRecallRecords: vi.fn(),
recallCompare: vi.fn(),
regenerateStandardMindMap: vi.fn(),
updateStandardMindMap: vi.fn(),
}))
vi.mock('@/api/aiTasks', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/api/aiTasks')>()
return {
...actual,
submitAiTask: vi.fn(),
getAiTask: vi.fn(),
getLatestAiTask: vi.fn(),
}
})
const ok = (data: any = null) => ({ code: 200, message: '请求成功', data })
const aiTask = (overrides: Partial<AiTask> = {}): AiTask => ({
taskNum: 'AI001',
type: 'MIND_MAP',
targetNum: 'T001',
status: 'SUCCEEDED',
...overrides,
})
const standardMap = {
id: 1,
taskNum: 'T001',
@@ -42,7 +55,7 @@ const MindMapViewerStub = {
/**
* 交互式集成测试:真实挂载 ReviewRecall,
* 点击“提交对比”模拟回忆对比流,断言 API 参数与对比结果渲染。
* 点击“提交对比”模拟回忆对比流(提交 RECALL_COMPARE 任务 + 轮询),断言 API 参数与结果渲染。
*/
describe('ReviewRecall 交互流程(集成)', () => {
beforeEach(() => {
@@ -77,13 +90,19 @@ describe('ReviewRecall 交互流程(集成)', () => {
},
]),
)
vi.mocked(recallCompare).mockResolvedValue(ok(standardMap))
// 任务提交后立即成功:轮询本身由 useAiTask.spec.ts 覆盖
vi.mocked(submitAiTask).mockResolvedValue(ok(aiTask({ status: 'PENDING' })))
vi.mocked(getAiTask).mockResolvedValue(ok(aiTask({ result: { standardMapId: 1 } })))
vi.mocked(getLatestAiTask).mockResolvedValue(ok(null))
})
afterEach(() => {
vi.useRealTimers()
})
const findButton = (wrapper: ReturnType<typeof mount>, label: string) =>
wrapper.findAll('button').find((b) => b.text().trim() === label)!
const mountPage = async () => {
const router = createRouter({
history: createMemoryHistory(),
@@ -102,21 +121,27 @@ describe('ReviewRecall 交互流程(集成)', () => {
return { wrapper }
}
it('加载后展示标准导图标题,点击“提交对比”调用对比接口并渲染结果', async () => {
it('点击“提交对比”提交 RECALL_COMPARE 任务并轮询,渲染对比结果', async () => {
const { wrapper } = await mountPage()
// 默认折叠标准导图(防剧透),回忆面板可见
expect(wrapper.text()).toContain('你的回忆')
const submit = wrapper.findAll('button').find((b) => b.text().trim() === '提交对比')!
const submit = findButton(wrapper, '提交对比')
expect(submit).toBeTruthy()
await submit.trigger('click')
await flushPromises()
await flushPromises()
expect(recallCompare).toHaveBeenCalledWith('T001', '根主题\n- 子节点', undefined, {
startedAt: expect.stringMatching(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/),
lastInteractionAt: expect.stringMatching(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/),
durationSeconds: expect.any(Number),
expect(submitAiTask).toHaveBeenCalledWith({
type: 'RECALL_COMPARE',
targetNum: 'T001',
params: {
recallOutline: '根主题\n- 子节点',
reviewStartedAt: expect.stringMatching(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/),
reviewLastInteractionAt: expect.stringMatching(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/),
reviewDurationSeconds: expect.any(Number),
},
})
expect(getAiTask).toHaveBeenCalledWith('AI001')
expect(ElMessage.success).toHaveBeenCalledWith('回忆对比完成')
// 提交后统计卡片展示“本次耗时”
expect(wrapper.text()).toContain('本次耗时')
@@ -125,17 +150,17 @@ describe('ReviewRecall 交互流程(集成)', () => {
wrapper.unmount()
})
it('回忆导图内容为单行时点击“提交对比”,提示先添加节点且不调接口', async () => {
it('回忆导图内容为单行时点击“提交对比”,提示先添加节点且不提交任务', async () => {
const { wrapper } = await mountPage()
toOutline.mockReturnValue('只有一个根')
const submit = wrapper.findAll('button').find((b) => b.text().trim() === '提交对比')!
const submit = findButton(wrapper, '提交对比')
await submit.trigger('click')
await flushPromises()
const { ElMessage: Msg } = await import('element-plus')
expect(Msg.warning).toHaveBeenCalledWith('请先在回忆导图中添加节点(选中节点后按 Tab 加子节点)')
expect(recallCompare).not.toHaveBeenCalled()
expect(submitAiTask).not.toHaveBeenCalled()
wrapper.unmount()
})
@@ -149,17 +174,65 @@ describe('ReviewRecall 交互流程(集成)', () => {
// 之后 20 秒无交互,直接点提交按钮
vi.setSystemTime(new Date(2026, 0, 15, 9, 0, 30))
const submit = wrapper.findAll('button').find((b) => b.text().trim() === '提交对比')!
const submit = findButton(wrapper, '提交对比')
await submit.trigger('click')
await flushPromises()
await flushPromises()
expect(recallCompare).toHaveBeenCalledWith('T001', '根主题\n- 子节点', undefined, {
startedAt: '2026-01-15T09:00:00',
lastInteractionAt: '2026-01-15T09:00:10',
durationSeconds: 30,
expect(submitAiTask).toHaveBeenCalledWith({
type: 'RECALL_COMPARE',
targetNum: 'T001',
params: {
recallOutline: '根主题\n- 子节点',
reviewStartedAt: '2026-01-15T09:00:00',
reviewLastInteractionAt: '2026-01-15T09:00:10',
reviewDurationSeconds: 30,
},
})
expect(wrapper.text()).toContain('30秒')
wrapper.unmount()
})
it('标准导图不存在时自动提交 MIND_MAP(ensure) 任务并轮询补生成', async () => {
vi.mocked(getStandardMindMap)
.mockResolvedValueOnce(ok(null))
.mockResolvedValue(ok(standardMap))
const { wrapper } = await mountPage()
expect(submitAiTask).toHaveBeenCalledWith({
type: 'MIND_MAP',
targetNum: 'T001',
params: { mode: 'ensure' },
})
// 生成成功后重新拉取导图
expect(getStandardMindMap).toHaveBeenCalledTimes(2)
wrapper.unmount()
})
it('恢复查询失败时不阻塞页面,仍正常拉取标准导图', async () => {
vi.mocked(getLatestAiTask).mockRejectedValue(new Error('恢复查询失败'))
const { wrapper } = await mountPage()
expect(getStandardMindMap).toHaveBeenCalled()
expect(wrapper.text()).toContain('你的回忆')
wrapper.unmount()
})
it('重新进入页面时有进行中的对比任务,恢复结果展示且不重复提交', async () => {
vi.mocked(getLatestAiTask)
.mockResolvedValueOnce(ok(null))
.mockResolvedValueOnce(ok(aiTask({ type: 'RECALL_COMPARE', status: 'RUNNING' })))
const { wrapper } = await mountPage()
await flushPromises()
// 恢复而非重提
expect(submitAiTask).not.toHaveBeenCalled()
expect(getAiTask).toHaveBeenCalledWith('AI001')
expect(wrapper.text()).toContain('本次耗时')
expect(wrapper.findAll('button').some((b) => b.text().trim() === '清空重写')).toBe(true)
wrapper.unmount()
})
})
@@ -21,7 +21,6 @@ vi.mock('@/api/studySessions', () => ({
endSession: vi.fn(),
getActiveSession: vi.fn(),
getExpectation: vi.fn(),
getReportDraft: vi.fn(),
getSessionDetail: vi.fn(),
getTaskFragments: vi.fn(),
getTaskReports: vi.fn(),
@@ -30,6 +29,16 @@ vi.mock('@/api/studySessions', () => ({
upsertExpectation: vi.fn(),
}))
vi.mock('@/api/aiTasks', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/api/aiTasks')>()
return {
...actual,
submitAiTask: vi.fn(),
getAiTask: vi.fn(),
getLatestAiTask: vi.fn(),
}
})
vi.mock('@/api/reportFragments', () => ({
createFragments: vi.fn(),
getFragmentsBySession: vi.fn(),
@@ -8,7 +8,6 @@ import {
endSession,
getActiveSession,
getExpectation,
getReportDraft,
getSessionDetail,
pauseSession,
startOrContinueStudySession,
@@ -21,7 +20,6 @@ vi.mock('@/api/studySessions', () => ({
endSession: vi.fn(),
getActiveSession: vi.fn(),
getExpectation: vi.fn(),
getReportDraft: vi.fn(),
getSessionDetail: vi.fn(),
getTaskFragments: vi.fn(),
getTaskReports: vi.fn(),
@@ -30,12 +28,24 @@ vi.mock('@/api/studySessions', () => ({
upsertExpectation: vi.fn(),
}))
vi.mock('@/api/aiTasks', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/api/aiTasks')>()
return {
...actual,
submitAiTask: vi.fn(),
getAiTask: vi.fn(),
getLatestAiTask: vi.fn(),
}
})
vi.mock('@/api/reportFragments', () => ({
createFragments: vi.fn(),
getFragmentsBySession: vi.fn(),
updateFragments: vi.fn(),
}))
import { submitAiTask } from '@/api/aiTasks'
const sessionOngoing = {
sessionNum: 'SESSION_001',
sessionState: 'ONGOING',
@@ -133,9 +143,9 @@ describe('StartTask 交互流程(集成)', () => {
await endBtn.trigger('click')
await flushPromises()
// 总结弹窗出现(无残片 → 不触发 AI 草稿等待)
// 总结弹窗出现(无残片 → 不提交 AI 草稿任务)
expect(wrapper.text()).toContain('结束会话总结')
expect(getReportDraft).not.toHaveBeenCalled()
expect(submitAiTask).not.toHaveBeenCalled()
// 总结内容为空时点击确认结束:弹警示、不调接口
const confirmEnd = findButton(wrapper, '确认结束')
+70
View File
@@ -0,0 +1,70 @@
// src/api/aiTasks.ts
import request from "@/utils/request";
/** AI 异步任务类型 */
export type AiTaskType = "RECALL_COMPARE" | "MIND_MAP" | "REPORT_DRAFT";
export type AiTaskStatus = "PENDING" | "RUNNING" | "SUCCEEDED" | "FAILED";
/** AI 异步任务:提交秒级返回,之后由前端轮询状态 */
export interface AiTask {
taskNum: string;
type: AiTaskType;
targetNum: string;
status: AiTaskStatus;
errorMessage?: string | null;
createdTime?: string;
finishedTime?: string;
/** 仅 SUCCEEDED 时非空 */
result?: Record<string, unknown> | null;
}
/** 任务结果载荷(各 type 的字段见后端契约) */
export type AiTaskResult = Record<string, unknown>;
/** 提交任务时透传给后端的业务参数 */
export type AiTaskParams = Record<string, unknown>;
/** RECALL_COMPARE:targetNum 为任务编号,三个时间字段沿用复习耗时快照 */
export type RecallCompareParams = {
recallOutline: string;
focusPath?: string;
reviewStartedAt?: string;
reviewLastInteractionAt?: string;
reviewDurationSeconds?: number;
};
/** MIND_MAP:ensure 仅在不存在时生成,full 全量重新生成,incremental 增量合并 */
export type MindMapParams = {
mode: "full" | "incremental" | "ensure";
};
/** 轮询间隔(毫秒):提交本身秒级返回,后续进度靠轮询获取 */
export const AI_TASK_POLL_INTERVAL_MS = 2000;
export interface SubmitAiTaskPayload {
type: AiTaskType;
targetNum: string;
params?: AiTaskParams;
}
export const isAiTaskInProgress = (
task: AiTask | null | undefined,
): task is AiTask => !!task && (task.status === "PENDING" || task.status === "RUNNING");
/** 提交 AI 异步任务,返回任务快照 */
export const submitAiTask = (payload: SubmitAiTaskPayload) => {
const body: SubmitAiTaskPayload = { type: payload.type, targetNum: payload.targetNum };
if (payload.params) body.params = payload.params;
return request.post<AiTask>("/ai/tasks", body);
};
/** 按任务编号查询任务状态 */
export const getAiTask = (taskNum: string) => {
return request.get<AiTask>(`/ai/tasks/${taskNum}`);
};
/** 查询指定类型 + 目标下最新的任务(用于离开页面再回来时恢复生成状态) */
export const getLatestAiTask = (type: AiTaskType, targetNum: string) => {
return request.get<AiTask | null>("/ai/tasks/latest", { type, targetNum });
};
+2 -35
View File
@@ -1,5 +1,4 @@
import request from "@/utils/request";
import type { ApiResponse } from "@/utils/request";
// ============ 标准思维导图 ============
@@ -33,24 +32,9 @@ export interface RecallRecord {
reviewDurationSeconds?: number;
}
/** 回忆对比耗时口径:本地时间字符串(yyyy-MM-ddTHH:mm:ss,无时区)+ 秒数 */
export interface RecallTiming {
startedAt: string;
lastInteractionAt: string;
durationSeconds: number;
}
// AI 聚合类接口耗时较长,统一放宽到 5 分钟(默认全局 30s)
const AI_TIMEOUT = { timeout: 300_000 };
/** 获取/自动生成标准思维导图(首次访问会触发 AI 生成) */
/** 获取标准思维导图:不再自动生成,未生成时 data 为 null(生成走 MIND_MAP 异步任务) */
export const getStandardMindMap = (taskNum: string) => {
return request.get<StandardMindMap>(`/review/standard-mind-map/${taskNum}`, {}, AI_TIMEOUT);
};
/** 强制重新生成标准思维导图(全量或增量) */
export const regenerateStandardMindMap = (taskNum: string, mode: "full" | "incremental" = "full") => {
return request.post<StandardMindMap>(`/review/standard-mind-map/${taskNum}/regenerate?mode=${mode}`, null, AI_TIMEOUT);
return request.get<StandardMindMap | null>(`/review/standard-mind-map/${taskNum}`);
};
/** 用户编辑标准思维导图(大纲文本) */
@@ -58,23 +42,6 @@ export const updateStandardMindMap = (taskNum: string, outline: string) => {
return request.put(`/review/standard-mind-map/${taskNum}`, { outline });
};
/** 用户提交回忆大纲,与标准导图对比(可选指定起始节点路径与复习耗时口径) */
export const recallCompare = (
taskNum: string,
recallOutline: string,
focusPath?: string,
timing?: RecallTiming,
): Promise<ApiResponse<StandardMindMap>> => {
const body: Record<string, any> = { recallOutline };
if (focusPath) body.focusPath = focusPath;
if (timing) {
body.reviewStartedAt = timing.startedAt;
body.reviewLastInteractionAt = timing.lastInteractionAt;
body.reviewDurationSeconds = timing.durationSeconds;
}
return request.post(`/review/standard-mind-map/${taskNum}/recall`, body, AI_TIMEOUT);
};
/** 在标准导图中查找与内容最匹配的节点 */
export const findNode = (taskNum: string, content: string) => {
return request.post<{ path: string }>(`/review/standard-mind-map/${taskNum}/find-node`, { content });
-5
View File
@@ -77,11 +77,6 @@ export const upsertExpectation = (sessionNum: string, description: string) => {
return request.put(`/study-sessions/${sessionNum}/expectation`, { description });
};
/** 获取报告草稿(AI 聚合残片,不可用时为拼接),生成失败不阻塞手写总结 */
export const getReportDraft = (sessionNum: string) => {
return request.get<string>(`/study-sessions/${sessionNum}/report-draft`, {}, AI_TIMEOUT);
};
/** 查询当前是否有活跃会话 */
export const getActiveSession = (excludeTaskNum?: string) => {
const params: Record<string, any> = {};
+110 -54
View File
@@ -4,16 +4,19 @@ import { useRoute, useRouter } from "vue-router";
import {
findNode,
getStandardMindMap,
regenerateStandardMindMap,
recallCompare,
updateStandardMindMap,
listRecallRecords,
type StandardMindMap,
type RecallRecord,
} from "@/api/standardMindMap";
import type { RecallCompareParams } from "@/api/aiTasks";
import { ElMessage, ElMessageBox } from "element-plus";
import MindMapViewer, { type MindMapTreeNode } from "@/components/MindMapViewer.vue";
import { useElapsedSeconds } from "@/components/composables/useElapsedSeconds";
import {
isAiTaskCancelled,
useAiTask,
type AiTaskRestore,
} from "@/components/composables/useAiTask";
import { useReviewDuration } from "@/components/composables/useReviewDuration";
import { formatDurationSeconds } from "@/utils/format";
@@ -23,12 +26,16 @@ const taskNum = computed(() => route.params.taskNum as string);
const loading = ref(false);
const standard = ref<StandardMindMap | null>(null);
const comparing = ref(false);
const {
seconds: comparingSeconds,
start: startComparingTimer,
stop: stopComparingTimer,
} = useElapsedSeconds();
// AI 异步任务:提交后轮询到结束;已等待秒数与进行状态由 composable 提供
const mindMapTask = useAiTask();
const { running: regenerating, seconds: regeneratingSeconds } = mindMapTask;
const recallTask = useAiTask();
const { running: comparing, seconds: comparingSeconds } = recallTask;
/** 从异常里取用户可见文案 */
const errorMessageOf = (error: unknown, fallback: string): string =>
error instanceof Error && error.message ? error.message : fallback;
// 复习耗时:从标准导图加载完成开始,记录到提交对比结束(超 5 分钟无交互自动截断)
const {
@@ -39,14 +46,6 @@ const {
} = useReviewDuration();
const currentDurationSeconds = ref(0);
// 重新生成标准导图
const regenerating = ref(false);
const {
seconds: regeneratingSeconds,
start: startRegeneratingTimer,
stop: stopRegeneratingTimer,
} = useElapsedSeconds();
const lastResult = ref<any>(null);
const hasCompared = ref(false);
@@ -130,10 +129,76 @@ const parseOutlineToTree = (text: string): MindMapTreeNode | null => {
return root;
};
// 重新拉取标准导图(生成/对比完成后使用)
const refreshStandardMap = async () => {
const res = await getStandardMindMap(taskNum.value);
standard.value = res?.data || null;
};
// 拉取最新的回忆对比记录并展示结果
const loadComparisonResult = async () => {
const recordRes = await listRecallRecords(taskNum.value);
const records: RecallRecord[] = recordRes?.data || [];
historyRecords.value = records;
if (records.length === 0) return;
const latest = records[0];
try {
lastResult.value = JSON.parse(latest.compareResult);
} catch {
lastResult.value = null;
}
hasCompared.value = true;
currentDurationSeconds.value = latest.reviewDurationSeconds ?? currentDurationSeconds.value;
};
// 提交 MIND_MAP(ensure) 任务:接口不再自动生成,没有导图时由前端触发
const ensureStandardMindMap = async () => {
try {
await mindMapTask.run("MIND_MAP", taskNum.value, { mode: "ensure" });
await refreshStandardMap();
} catch (e) {
if (isAiTaskCancelled(e)) return;
ElMessage.error(errorMessageOf(e, "标准思维导图生成失败,请稍后重试"));
}
};
/** 重新进入页面时恢复仍在进行的任务,避免用户重复提交;返回是否有进行中的生成任务 */
const resumeInProgressTasks = async (): Promise<boolean> => {
let mindMap: AiTaskRestore;
let compare: AiTaskRestore;
try {
[mindMap, compare] = await Promise.all([
mindMapTask.resume("MIND_MAP", taskNum.value),
recallTask.resume("RECALL_COMPARE", taskNum.value),
]);
} catch {
// 恢复查询失败不阻塞页面加载,退化为正常拉取
return false;
}
if (mindMap.done) {
void mindMap.done
.then(() => refreshStandardMap())
.catch(() => {
// 恢复失败不打断当前页面,用户可手动重新生成
});
}
if (compare.done) {
void compare.done
.then(() => loadComparisonResult())
.then(() => resetReviewDuration())
.catch(() => {
// 恢复失败不打断当前页面
});
}
return mindMap.found;
};
// 加载数据
const loadData = async () => {
loading.value = true;
try {
const mindMapInProgress = await resumeInProgressTasks();
const res = await getStandardMindMap(taskNum.value);
standard.value = res?.data || null;
if (focusContent.value && standard.value) {
@@ -147,6 +212,11 @@ const loadData = async () => {
// 匹配失败时仍可进入回忆页
}
}
// 接口不再自动生成:无导图且没有进行中的生成任务时,提交 ensure 任务补齐
if (!standard.value && !mindMapInProgress) {
await ensureStandardMindMap();
}
} catch {
standard.value = null;
} finally {
@@ -201,8 +271,8 @@ const handleRegenerate = async () => {
}
);
// confirm → 全量(保持 mode = "full")
} catch (e: any) {
if (e === "cancel" || e?.toString()?.includes("cancel")) {
} catch (e) {
if (e === "cancel" || String(e).includes("cancel")) {
mode = "incremental";
} else {
return; // 点 X 关闭 → 不做操作
@@ -221,59 +291,45 @@ const handleRegenerate = async () => {
}
}
// 开始生成
regenerating.value = true;
startRegeneratingTimer();
// 提交 MIND_MAP 任务并轮询
try {
const res = await regenerateStandardMindMap(taskNum.value, mode);
standard.value = res?.data || null;
await mindMapTask.run("MIND_MAP", taskNum.value, { mode });
await refreshStandardMap();
ElMessage.success(mode === "incremental" ? "标准思维导图已增量更新" : "标准思维导图已重新生成");
} catch (e: any) {
ElMessage.error(e.message || "重新生成失败");
} finally {
regenerating.value = false;
stopRegeneratingTimer();
} catch (e) {
if (isAiTaskCancelled(e)) return;
ElMessage.error(errorMessageOf(e, "重新生成失败"));
}
};
// 提交回忆对比
// 提交回忆对比:提交 RECALL_COMPARE 任务并轮询
const handleRecallCompare = async () => {
const outline = recallViewer.value?.toOutline() || "";
if (outline.split(/\r?\n/).filter((l) => l.trim()).length <= 1) {
ElMessage.warning("请先在回忆导图中添加节点(选中节点后按 Tab 加子节点)");
return;
}
comparing.value = true;
startComparingTimer();
// 提交按钮本身不计入交互,这里取提交前的耗时快照
const timing = reviewDurationSnapshot();
const params: RecallCompareParams = {
recallOutline: outline,
reviewStartedAt: timing.startedAt,
reviewLastInteractionAt: timing.lastInteractionAt,
reviewDurationSeconds: timing.durationSeconds,
};
if (focusPath.value) params.focusPath = focusPath.value;
try {
const res = await recallCompare(taskNum.value, outline, focusPath.value || undefined, timing);
standard.value = res?.data || null;
hasCompared.value = true;
await recallTask.run("RECALL_COMPARE", taskNum.value, params);
currentDurationSeconds.value = timing.durationSeconds;
// 解析对比结果
if (standard.value) {
const recordRes = await listRecallRecords(taskNum.value);
const records: RecallRecord[] = recordRes?.data || [];
if (records.length > 0) {
const latest = records[0];
try {
lastResult.value = JSON.parse(latest.compareResult);
} catch {
lastResult.value = null;
}
historyRecords.value = records;
}
}
await refreshStandardMap();
await loadComparisonResult();
// 提交成功后开启新一轮计时
resetReviewDuration();
ElMessage.success("回忆对比完成");
} catch (e: any) {
ElMessage.error(e.message || "对比失败");
} finally {
comparing.value = false;
stopComparingTimer();
} catch (e) {
if (isAiTaskCancelled(e)) return;
ElMessage.error(errorMessageOf(e, "对比失败"));
}
};
+137
View File
@@ -0,0 +1,137 @@
// src/components/composables/useAiTask.ts
import { getCurrentInstance, onUnmounted, ref } from "vue";
import {
AI_TASK_POLL_INTERVAL_MS,
getAiTask,
getLatestAiTask,
isAiTaskInProgress,
submitAiTask,
type AiTaskParams,
type AiTaskResult,
type AiTaskType,
} from "@/api/aiTasks";
import { useElapsedSeconds } from "./useElapsedSeconds";
/** 轮询期间组件被卸载/主动停止时抛出,调用方应静默忽略,不再弹提示 */
export class AiTaskCancelledError extends Error {
constructor() {
super("AI 任务轮询已取消");
this.name = "AiTaskCancelledError";
}
}
export const isAiTaskCancelled = (error: unknown): boolean =>
error instanceof AiTaskCancelledError;
/** resume 的返回:found 表示存在进行中的任务,done 是它的轮询结果 */
export interface AiTaskRestore {
found: boolean;
done: Promise<AiTaskResult> | null;
}
/**
* AI 异步任务轮询:把「提交 → 轮询 → 返回 result」串成一次 await。
* - run():提交新任务并轮询到结束,SUCCEEDED 返回 result,FAILED 抛出带 errorMessage 的错误
* - resume():用 getLatestAiTask 判断是否有进行中的任务,有则继续轮询(刷新/重进页面恢复等待态)
* - seconds:已等待秒数,供“AI 正在生成,已等待 N 秒”文案使用
* 组件卸载时自动停止轮询,进行中的 run/resume 会以 AiTaskCancelledError 结束。
*/
export function useAiTask() {
const { seconds, start: startTimer, stop: stopTimer } = useElapsedSeconds();
const running = ref(false);
let cancelled = false;
/** 每次 run/resume 递增,避免旧调用的收尾影响新调用 */
let generation = 0;
let pollTimer: ReturnType<typeof setTimeout> | null = null;
let wakePoll: (() => void) | null = null;
const clearPendingPoll = () => {
if (pollTimer !== null) {
clearTimeout(pollTimer);
pollTimer = null;
}
if (wakePoll) {
const wake = wakePoll;
wakePoll = null;
wake();
}
};
const stop = () => {
cancelled = true;
generation += 1;
running.value = false;
clearPendingPoll();
stopTimer();
};
if (getCurrentInstance()) {
onUnmounted(stop);
}
/** 等待下一次轮询;stop() 会立即唤醒它以便轮询循环退出 */
const waitNextPoll = () =>
new Promise<void>((resolve) => {
wakePoll = resolve;
pollTimer = setTimeout(() => {
pollTimer = null;
wakePoll = null;
resolve();
}, AI_TASK_POLL_INTERVAL_MS);
});
const pollUntilDone = async (aiTaskNum: string): Promise<AiTaskResult> => {
for (;;) {
if (cancelled) throw new AiTaskCancelledError();
const res = await getAiTask(aiTaskNum);
const task = res?.data;
if (!task) throw new Error("AI 任务状态查询失败,请稍后重试");
if (task.status === "SUCCEEDED") return task.result ?? {};
if (task.status === "FAILED") throw new Error(task.errorMessage || "AI 处理失败,请稍后重试");
await waitNextPoll();
}
};
const startTracking = () => {
cancelled = false;
generation += 1;
running.value = true;
startTimer();
return generation;
};
const stopTracking = (token: number) => {
if (token !== generation) return;
running.value = false;
stopTimer();
};
/** 提交 AI 任务并轮询到结束,返回 SUCCEEDED 的 result */
const run = async (
type: AiTaskType,
targetNum: string,
params?: AiTaskParams,
): Promise<AiTaskResult> => {
const token = startTracking();
try {
const res = await submitAiTask(params ? { type, targetNum, params } : { type, targetNum });
const submitted = res?.data;
if (!submitted?.taskNum) throw new Error("AI 任务提交失败,请稍后重试");
return await pollUntilDone(submitted.taskNum);
} finally {
stopTracking(token);
}
};
/** 恢复进行中的任务:找到就继续轮询,没找到返回 found=false */
const resume = async (type: AiTaskType, targetNum: string): Promise<AiTaskRestore> => {
const res = await getLatestAiTask(type, targetNum);
const latest = res?.data;
if (!isAiTaskInProgress(latest)) return { found: false, done: null };
const token = startTracking();
const done = pollUntilDone(latest.taskNum).finally(() => stopTracking(token));
return { found: true, done };
};
return { seconds, running, run, resume, stop };
}
+9 -11
View File
@@ -1,10 +1,9 @@
import { ref } from 'vue';
import { getReportDraft } from '@/api/studySessions';
import { useElapsedSeconds } from './useElapsedSeconds';
import { useAiTask } from './useAiTask';
/**
* “结束会话总结”弹窗:编辑/预览总结内容。
* 有学习残片且尚未填写内容时,先取 AI 聚合草稿作为编辑起点(失败不阻塞手写),
* 有学习残片且尚未填写内容时,先提交 REPORT_DRAFT 任务并轮询取回草稿作为编辑起点(失败不阻塞手写),
* 等待期间展示“已等待 N 秒”提示。
*/
export function useSummaryReport(options: {
@@ -15,31 +14,30 @@ export function useSummaryReport(options: {
const summaryContent = ref("");
const summaryPreview = ref(false);
const summaryLoading = ref(false);
const { seconds: summaryLoadingSeconds, start: startLoadingTimer, stop: stopLoadingTimer } = useElapsedSeconds();
const reportTask = useAiTask();
const openSummaryDialog = async () => {
summaryDialogVisible.value = true;
// 有残片且未填写过总结时,用 AI 聚合草稿作为编辑起点
if (!summaryContent.value.trim() && options.hasFragments()) {
summaryLoading.value = true;
startLoadingTimer();
try {
const res = await getReportDraft(options.getSessionNum());
if (res?.code === 200 && res.data) {
summaryContent.value = res.data;
const result = await reportTask.run("REPORT_DRAFT", options.getSessionNum());
const draft = result?.draft;
if (typeof draft === "string" && draft) {
summaryContent.value = draft;
}
} catch {
// 草稿失败不阻塞手写
} finally {
summaryLoading.value = false;
stopLoadingTimer();
}
}
};
const closeSummaryDialog = () => {
summaryDialogVisible.value = false;
stopLoadingTimer();
reportTask.stop();
};
return {
@@ -47,7 +45,7 @@ export function useSummaryReport(options: {
summaryContent,
summaryPreview,
summaryLoading,
summaryLoadingSeconds,
summaryLoadingSeconds: reportTask.seconds,
openSummaryDialog,
closeSummaryDialog,
};