feat: 接入标记、复习反馈、排序档位与学习引导
This commit is contained in:
@@ -0,0 +1,70 @@
|
||||
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 {
|
||||
abandonGuidance,
|
||||
createGuidanceFragment,
|
||||
getGuidanceSession,
|
||||
startGuidance,
|
||||
submitGuidanceTurn,
|
||||
} from '@/api/guidance'
|
||||
|
||||
const mockedRequest = vi.mocked(request)
|
||||
|
||||
describe('guidance API', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
})
|
||||
|
||||
it('startGuidance 提交任务与概念', async () => {
|
||||
mockedRequest.post.mockResolvedValue({ code: 200, data: { guidanceNum: 'G1' } })
|
||||
await startGuidance('T001', '组合式 API')
|
||||
expect(mockedRequest.post).toHaveBeenCalledWith('/review/guidance', {
|
||||
taskNum: 'T001',
|
||||
concept: '组合式 API',
|
||||
})
|
||||
})
|
||||
|
||||
it('submitGuidanceTurn 提交本轮消息', async () => {
|
||||
mockedRequest.post.mockResolvedValue({ code: 200, data: { taskNum: 'AI2' } })
|
||||
await submitGuidanceTurn('G1', '我的理解是')
|
||||
expect(mockedRequest.post).toHaveBeenCalledWith('/review/guidance/G1/turns', { message: '我的理解是' })
|
||||
})
|
||||
|
||||
it('getGuidanceSession 读取会话用于恢复对话', async () => {
|
||||
mockedRequest.get.mockResolvedValue({ code: 200, data: { guidanceNum: 'G1' } })
|
||||
await getGuidanceSession('G1')
|
||||
expect(mockedRequest.get).toHaveBeenCalledWith('/review/guidance/G1')
|
||||
})
|
||||
|
||||
it('createGuidanceFragment 提交内容与耗时快照', async () => {
|
||||
mockedRequest.post.mockResolvedValue({ code: 200, data: { id: 5 } })
|
||||
await createGuidanceFragment('G1', {
|
||||
content: '收获',
|
||||
reviewStartedAt: '2026-01-01T10:00:00',
|
||||
reviewLastInteractionAt: '2026-01-01T10:01:00',
|
||||
reviewDurationSeconds: 60,
|
||||
})
|
||||
expect(mockedRequest.post).toHaveBeenCalledWith('/review/guidance/G1/fragments', {
|
||||
content: '收获',
|
||||
reviewStartedAt: '2026-01-01T10:00:00',
|
||||
reviewLastInteractionAt: '2026-01-01T10:01:00',
|
||||
reviewDurationSeconds: 60,
|
||||
})
|
||||
})
|
||||
|
||||
it('abandonGuidance 放弃这次引导', async () => {
|
||||
mockedRequest.del.mockResolvedValue({ code: 200, data: null })
|
||||
await abandonGuidance('G1')
|
||||
expect(mockedRequest.del).toHaveBeenCalledWith('/review/guidance/G1')
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,82 @@
|
||||
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 {
|
||||
addUserTag,
|
||||
deleteMarker,
|
||||
filterByMarker,
|
||||
getMarkers,
|
||||
getMarkersBatch,
|
||||
getUserTagUsage,
|
||||
renameUserTag,
|
||||
} from '@/api/markers'
|
||||
|
||||
const mockedRequest = vi.mocked(request)
|
||||
|
||||
describe('markers API', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
})
|
||||
|
||||
it('getMarkers 按对象查询标记', async () => {
|
||||
mockedRequest.get.mockResolvedValue({ code: 200, data: [] })
|
||||
await getMarkers('FRAGMENT', '12')
|
||||
expect(mockedRequest.get).toHaveBeenCalledWith('/markers', { objectType: 'FRAGMENT', objectNum: '12' })
|
||||
})
|
||||
|
||||
it('getMarkersBatch 用 body 传对象标识、用 query 传对象类型', async () => {
|
||||
mockedRequest.post.mockResolvedValue({ code: 200, data: {} })
|
||||
await getMarkersBatch('FRAGMENT', ['1', '2'])
|
||||
expect(mockedRequest.post).toHaveBeenCalledWith('/markers/batch', ['1', '2'], {
|
||||
params: { objectType: 'FRAGMENT' },
|
||||
})
|
||||
})
|
||||
|
||||
it('addUserTag 提交对象与标签名', async () => {
|
||||
mockedRequest.post.mockResolvedValue({ code: 200, data: { id: 1 } })
|
||||
await addUserTag('TASK', 'T001', '英语')
|
||||
expect(mockedRequest.post).toHaveBeenCalledWith('/markers', {
|
||||
objectType: 'TASK',
|
||||
objectNum: 'T001',
|
||||
markerName: '英语',
|
||||
})
|
||||
})
|
||||
|
||||
it('deleteMarker 删除指定标记', async () => {
|
||||
mockedRequest.del.mockResolvedValue({ code: 200, data: null })
|
||||
await deleteMarker(9)
|
||||
expect(mockedRequest.del).toHaveBeenCalledWith('/markers/9')
|
||||
})
|
||||
|
||||
it('renameUserTag 传旧名与新名', async () => {
|
||||
mockedRequest.put.mockResolvedValue({ code: 200, data: 2 })
|
||||
const result = await renameUserTag('英语', '英文')
|
||||
expect(mockedRequest.put).toHaveBeenCalledWith('/markers/rename', { oldName: '英语', newName: '英文' })
|
||||
expect(result).toEqual({ code: 200, data: 2 })
|
||||
})
|
||||
|
||||
it('filterByMarker 按单一标记筛选对象', async () => {
|
||||
mockedRequest.get.mockResolvedValue({ code: 200, data: ['1', '2'] })
|
||||
await filterByMarker({ objectType: 'FRAGMENT', markerName: '英语', kind: 'USER' })
|
||||
expect(mockedRequest.get).toHaveBeenCalledWith('/markers/filter', {
|
||||
objectType: 'FRAGMENT',
|
||||
markerName: '英语',
|
||||
kind: 'USER',
|
||||
})
|
||||
})
|
||||
|
||||
it('getUserTagUsage 拉取标签与用量', async () => {
|
||||
mockedRequest.get.mockResolvedValue({ code: 200, data: [] })
|
||||
await getUserTagUsage()
|
||||
expect(mockedRequest.get).toHaveBeenCalledWith('/markers/tags')
|
||||
})
|
||||
})
|
||||
@@ -17,7 +17,11 @@ import {
|
||||
getReviewFeed,
|
||||
getReviewTaskStats,
|
||||
getReviewTaskStatsByTask,
|
||||
getSortPreference,
|
||||
getTaskReview,
|
||||
saveSortPreference,
|
||||
submitReviewFeedback,
|
||||
touchReviewFragment,
|
||||
updateReport,
|
||||
} from '@/api/review'
|
||||
|
||||
@@ -89,4 +93,29 @@ describe('review API', () => {
|
||||
await getTaskReview('T001')
|
||||
expect(mockedRequest.get).toHaveBeenCalledWith('/review/task/T001')
|
||||
})
|
||||
|
||||
it('submitReviewFeedback sends only the toggled action', async () => {
|
||||
mockedRequest.put.mockResolvedValue({ code: 200, data: { mastered: true, revisit: false } })
|
||||
const result = await submitReviewFeedback(7, { mastered: true })
|
||||
expect(mockedRequest.put).toHaveBeenCalledWith('/review/feed/7/feedback', { mastered: true })
|
||||
expect(result).toEqual({ code: 200, data: { mastered: true, revisit: false } })
|
||||
})
|
||||
|
||||
it('touchReviewFragment posts to the touched endpoint', async () => {
|
||||
mockedRequest.post.mockResolvedValue({ code: 200, data: null })
|
||||
await touchReviewFragment(7)
|
||||
expect(mockedRequest.post).toHaveBeenCalledWith('/review/feed/7/touched')
|
||||
})
|
||||
|
||||
it('getSortPreference calls GET /review/sort-preference', async () => {
|
||||
mockedRequest.get.mockResolvedValue({ code: 200, data: { preset: 'TIME_FIRST', description: '久未接触' } })
|
||||
await getSortPreference()
|
||||
expect(mockedRequest.get).toHaveBeenCalledWith('/review/sort-preference')
|
||||
})
|
||||
|
||||
it('saveSortPreference sends the preset', async () => {
|
||||
mockedRequest.put.mockResolvedValue({ code: 200, data: { preset: 'BALANCED', description: '均衡' } })
|
||||
await saveSortPreference('BALANCED')
|
||||
expect(mockedRequest.put).toHaveBeenCalledWith('/review/sort-preference', { preset: 'BALANCED' })
|
||||
})
|
||||
})
|
||||
|
||||
@@ -3,7 +3,9 @@ import { flushPromises, mount } from '@vue/test-utils'
|
||||
import ElementPlus from 'element-plus'
|
||||
import { createMemoryHistory, createRouter } from 'vue-router'
|
||||
import Welcome from '@/components/Welcome.vue'
|
||||
import { getReviewFeed, getReviewTaskStats } from '@/api/review'
|
||||
import { resetGuidanceAvailability } from '@/components/composables/useGuidance'
|
||||
import { getReviewFeed, getReviewTaskStats, submitReviewFeedback, touchReviewFragment } from '@/api/review'
|
||||
import { filterByMarker, getMarkersBatch } from '@/api/markers'
|
||||
import { updateFragmentOwnership } from '@/api/reportFragments'
|
||||
import appRouter from '@/router'
|
||||
import { BASE_SPEED_PX_PER_SEC, NARROW_SPEED_FACTOR } from '@/utils/autoScroll'
|
||||
@@ -12,6 +14,17 @@ vi.mock('@/api/review', () => ({
|
||||
getReviewFeed: vi.fn(),
|
||||
getReviewTaskStats: vi.fn(),
|
||||
getTaskReview: vi.fn(),
|
||||
submitReviewFeedback: vi.fn(),
|
||||
touchReviewFragment: vi.fn(),
|
||||
}))
|
||||
|
||||
vi.mock('@/api/markers', () => ({
|
||||
getMarkersBatch: vi.fn(),
|
||||
addUserTag: vi.fn(),
|
||||
deleteMarker: vi.fn(),
|
||||
filterByMarker: vi.fn(),
|
||||
getUserTagUsage: vi.fn(),
|
||||
renameUserTag: vi.fn(),
|
||||
}))
|
||||
|
||||
vi.mock('@/api/reportFragments', () => ({
|
||||
@@ -104,6 +117,9 @@ 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)] })
|
||||
})
|
||||
|
||||
@@ -316,3 +332,109 @@ describe('Welcome Feed 待归类内容', () => {
|
||||
wrapper.unmount()
|
||||
})
|
||||
})
|
||||
|
||||
/**
|
||||
* 标记(标记-01)与复习反馈动作(复习-02)、Feed 摘要(复习-05)在 Feed 卡片上的行为。
|
||||
*/
|
||||
describe('Welcome Feed 标记、反馈与摘要', () => {
|
||||
const systemMarker = {
|
||||
id: 11,
|
||||
objectType: 'FRAGMENT',
|
||||
objectNum: '1',
|
||||
kind: 'SYSTEM',
|
||||
markerName: '来源',
|
||||
markerValue: '学习引导',
|
||||
}
|
||||
const userTag = {
|
||||
id: 12,
|
||||
objectType: 'FRAGMENT',
|
||||
objectNum: '1',
|
||||
kind: 'USER',
|
||||
markerName: '英语',
|
||||
markerValue: null,
|
||||
}
|
||||
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
stubLayout(4000, 1000)
|
||||
})
|
||||
|
||||
it('系统标记成对只读展示,用户标签可点', async () => {
|
||||
vi.mocked(getReviewFeed).mockResolvedValue({ code: 200, data: [makeFragment(1)] } as never)
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue({
|
||||
code: 200,
|
||||
data: { '1': [systemMarker, userTag] },
|
||||
} as never)
|
||||
const wrapper = await mountWelcome()
|
||||
|
||||
expect(wrapper.find('.marker-system').text()).toContain('来源=学习引导')
|
||||
expect(wrapper.find('.marker-user').text()).toContain('英语')
|
||||
})
|
||||
|
||||
it('点用户标签按单一标记筛选,显示当前条件并可清除', async () => {
|
||||
vi.mocked(getReviewFeed).mockResolvedValue({ code: 200, data: [makeFragment(1), makeFragment(2)] } as never)
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue({ code: 200, data: { '1': [userTag] } } as never)
|
||||
vi.mocked(filterByMarker).mockResolvedValue({ code: 200, data: ['1'] } as never)
|
||||
const wrapper = await mountWelcome()
|
||||
|
||||
await wrapper.find('.marker-user').trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(filterByMarker).toHaveBeenCalledWith({ objectType: 'FRAGMENT', markerName: '英语', kind: 'USER' })
|
||||
expect(wrapper.text()).toContain('正在按标签「英语」筛选')
|
||||
expect(wrapper.text()).not.toContain('残片内容2')
|
||||
|
||||
const clear = wrapper.findAll('button').find((b) => b.text().includes('清除筛选'))
|
||||
await clear!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(wrapper.text()).not.toContain('正在按标签')
|
||||
expect(wrapper.text()).toContain('残片内容2')
|
||||
})
|
||||
|
||||
it('反馈动作调用接口并按回显切换,再次点击可取消,不产生状态徽标', async () => {
|
||||
vi.mocked(getReviewFeed).mockResolvedValue({ code: 200, data: [makeFragment(1)] } as never)
|
||||
vi.mocked(submitReviewFeedback)
|
||||
.mockResolvedValueOnce({ code: 200, data: { mastered: true, revisit: false } } as never)
|
||||
.mockResolvedValueOnce({ code: 200, data: { mastered: false, revisit: false } } as never)
|
||||
const wrapper = await mountWelcome()
|
||||
|
||||
const mastered = wrapper.findAll('button').find((b) => b.text().trim() === '已掌握')
|
||||
await mastered!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(submitReviewFeedback).toHaveBeenCalledWith(1, { mastered: true })
|
||||
expect(mastered!.classes()).toContain('is-active')
|
||||
// 反馈只影响出现概率,不做徽标、统计或待复习列表
|
||||
expect(wrapper.find('.el-badge').exists()).toBe(false)
|
||||
expect(wrapper.text()).not.toContain('待复习')
|
||||
|
||||
await mastered!.trigger('click')
|
||||
await flushPromises()
|
||||
expect(submitReviewFeedback).toHaveBeenLastCalledWith(1, { mastered: false })
|
||||
expect(mastered!.classes()).not.toContain('is-active')
|
||||
})
|
||||
|
||||
it('展开查看残片时会记录一次接触', async () => {
|
||||
vi.mocked(getReviewFeed).mockResolvedValue({ code: 200, data: [makeFragment(1)] } as never)
|
||||
const wrapper = await mountWelcome()
|
||||
|
||||
await wrapper.find('.review-chip').trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(touchReviewFragment).toHaveBeenCalledWith(1)
|
||||
})
|
||||
|
||||
it('摘要被截断时在回忆卡片说明全文长度', async () => {
|
||||
vi.mocked(getReviewFeed).mockResolvedValue({
|
||||
code: 200,
|
||||
data: [{ ...makeFragment(1), content: '这是摘要', contentLength: 380, contentTruncated: true }],
|
||||
} as never)
|
||||
const wrapper = await mountWelcome()
|
||||
|
||||
await wrapper.find('.review-chip').trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(wrapper.text()).toContain('全文 380 字')
|
||||
})
|
||||
})
|
||||
|
||||
@@ -143,4 +143,16 @@ describe('useAiTask', () => {
|
||||
expect(getAiTask).not.toHaveBeenCalled()
|
||||
expect(running.value).toBe(false)
|
||||
})
|
||||
|
||||
it('poll 直接轮询已提交的任务并返回结果', async () => {
|
||||
vi.mocked(getAiTask).mockResolvedValue(ok(task({ status: 'SUCCEEDED', result: { reply: 'AI 的回复' } })))
|
||||
|
||||
const { poll, running } = useAiTask()
|
||||
const result = await poll('AI002')
|
||||
|
||||
expect(getAiTask).toHaveBeenCalledWith('AI002')
|
||||
expect(submitAiTask).not.toHaveBeenCalled()
|
||||
expect(result).toEqual({ reply: 'AI 的回复' })
|
||||
expect(running.value).toBe(false)
|
||||
})
|
||||
})
|
||||
|
||||
@@ -0,0 +1,105 @@
|
||||
import { describe, it, expect, vi, beforeEach } from 'vitest'
|
||||
|
||||
vi.mock('@/api/markers', () => ({
|
||||
getMarkersBatch: vi.fn(),
|
||||
addUserTag: vi.fn(),
|
||||
deleteMarker: vi.fn(),
|
||||
filterByMarker: vi.fn(),
|
||||
}))
|
||||
|
||||
import { addUserTag, deleteMarker, filterByMarker, getMarkersBatch, type Marker } from '@/api/markers'
|
||||
import { deleteUserTagEverywhere, useMarkers } from '@/components/composables/useMarkers'
|
||||
|
||||
const ok = <T,>(data: T) => ({ code: 200, message: '请求成功', data })
|
||||
|
||||
const userMarker = (overrides: Partial<Marker> = {}): Marker => ({
|
||||
id: 1,
|
||||
objectType: 'FRAGMENT',
|
||||
objectNum: '1',
|
||||
kind: 'USER',
|
||||
markerName: '英语',
|
||||
markerValue: null,
|
||||
...overrides,
|
||||
})
|
||||
|
||||
describe('useMarkers', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
})
|
||||
|
||||
it('load 批量取回一页对象的标记,markersOf 按对象返回', async () => {
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue(ok({ '1': [userMarker()] }))
|
||||
const board = useMarkers('FRAGMENT')
|
||||
|
||||
await board.load(['1', '2', '1'])
|
||||
|
||||
expect(getMarkersBatch).toHaveBeenCalledWith('FRAGMENT', ['1', '2'])
|
||||
expect(board.markersOf('1')).toHaveLength(1)
|
||||
expect(board.markersOf('2')).toEqual([])
|
||||
})
|
||||
|
||||
it('addTag 幂等追加用户标签', async () => {
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue(ok({}))
|
||||
vi.mocked(addUserTag).mockResolvedValue(ok(userMarker({ id: 9, markerName: '重点' })))
|
||||
const board = useMarkers('TASK')
|
||||
|
||||
const added = await board.addTag('T001', ' 重点 ')
|
||||
|
||||
expect(added).toBe(true)
|
||||
expect(addUserTag).toHaveBeenCalledWith('TASK', 'T001', '重点')
|
||||
expect(board.markersOf('T001')[0].markerName).toBe('重点')
|
||||
})
|
||||
|
||||
it('removeTag 删除后从本地列表移除', async () => {
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue(ok({ '1': [userMarker({ id: 5 })] }))
|
||||
vi.mocked(deleteMarker).mockResolvedValue(ok(null))
|
||||
const board = useMarkers('FRAGMENT')
|
||||
|
||||
await board.load(['1'])
|
||||
await board.removeTag('1', board.markersOf('1')[0])
|
||||
|
||||
expect(deleteMarker).toHaveBeenCalledWith(5)
|
||||
expect(board.markersOf('1')).toEqual([])
|
||||
})
|
||||
|
||||
it('filterByTag 用用户标签筛选并返回对象标识集合', async () => {
|
||||
vi.mocked(filterByMarker).mockResolvedValue(ok(['1', '2']))
|
||||
const board = useMarkers('FRAGMENT')
|
||||
|
||||
const ids = await board.filterByTag(userMarker())
|
||||
|
||||
expect(filterByMarker).toHaveBeenCalledWith({
|
||||
objectType: 'FRAGMENT',
|
||||
markerName: '英语',
|
||||
kind: 'USER',
|
||||
})
|
||||
expect(ids.has('2')).toBe(true)
|
||||
})
|
||||
})
|
||||
|
||||
describe('deleteUserTagEverywhere', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
})
|
||||
|
||||
it('跨碎片与任务收集同名用户标签并逐条删除', async () => {
|
||||
vi.mocked(filterByMarker).mockImplementation(async (params) =>
|
||||
ok(params.objectType === 'FRAGMENT' ? ['1'] : ['T1']),
|
||||
)
|
||||
vi.mocked(getMarkersBatch).mockImplementation(async (objectType) =>
|
||||
ok(
|
||||
objectType === 'FRAGMENT'
|
||||
? { '1': [userMarker({ id: 5 }), userMarker({ id: 6, kind: 'SYSTEM', markerName: '来源', markerValue: '学习引导' })] }
|
||||
: { T1: [userMarker({ id: 7, objectType: 'TASK', objectNum: 'T1' }), userMarker({ id: 8, objectType: 'TASK', objectNum: 'T1', markerName: '其他' })] },
|
||||
),
|
||||
)
|
||||
vi.mocked(deleteMarker).mockResolvedValue(ok(null))
|
||||
|
||||
const removed = await deleteUserTagEverywhere('英语')
|
||||
|
||||
expect(removed).toBe(2)
|
||||
expect(deleteMarker).toHaveBeenCalledTimes(2)
|
||||
expect(deleteMarker).toHaveBeenCalledWith(5)
|
||||
expect(deleteMarker).toHaveBeenCalledWith(7)
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,169 @@
|
||||
import { describe, it, expect, vi, beforeEach } from 'vitest'
|
||||
import { flushPromises, mount } from '@vue/test-utils'
|
||||
import { nextTick } from 'vue'
|
||||
import ElementPlus, { ElMessage } from 'element-plus'
|
||||
import GuidanceDialog from '@/components/GuidanceDialog.vue'
|
||||
import {
|
||||
abandonGuidance,
|
||||
createGuidanceFragment,
|
||||
getGuidanceSession,
|
||||
startGuidance,
|
||||
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(),
|
||||
submitGuidanceTurn: vi.fn(),
|
||||
getGuidanceSession: vi.fn(),
|
||||
createGuidanceFragment: vi.fn(),
|
||||
abandonGuidance: 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 = <T,>(data: T) => ({ code: 200, message: '请求成功', data })
|
||||
|
||||
const aiTask = (overrides: Partial<AiTask> = {}): AiTask => ({
|
||||
taskNum: 'AI1',
|
||||
type: 'MIND_MAP',
|
||||
targetNum: 'G1',
|
||||
status: 'SUCCEEDED',
|
||||
...overrides,
|
||||
})
|
||||
|
||||
const STORAGE_KEY = 'lpt-guidance:T001:组合式 API'
|
||||
|
||||
const findButton = (wrapper: ReturnType<typeof mount>, text: string) =>
|
||||
wrapper.findAll('button').find((b) => b.text().trim() === text)
|
||||
|
||||
const mountDialog = async () => {
|
||||
const wrapper = mount(GuidanceDialog, {
|
||||
props: { modelValue: false, taskNum: 'T001', concept: '组合式 API' },
|
||||
global: { plugins: [ElementPlus] },
|
||||
})
|
||||
await wrapper.setProps({ modelValue: true })
|
||||
await flushPromises()
|
||||
await nextTick()
|
||||
await flushPromises()
|
||||
return wrapper
|
||||
}
|
||||
|
||||
/**
|
||||
* 学习引导主流程(复习-06):开对话 → 多轮 → 确认产出碎片 / 放弃 / AI 失败置不可用。
|
||||
*/
|
||||
describe('学习引导(集成)', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
resetGuidanceAvailability()
|
||||
localStorage.clear()
|
||||
vi.mocked(startGuidance).mockResolvedValue(
|
||||
ok({ guidanceNum: 'G1', taskNum: 'T001', concept: '组合式 API', aiTaskNum: 'AI1' }),
|
||||
)
|
||||
vi.mocked(getAiTask).mockResolvedValue(ok(aiTask({ result: { reply: '第一个问题' } })))
|
||||
})
|
||||
|
||||
it('开启引导后展示 AI 提出的第一个问题(不判分、不设轮数上限)', async () => {
|
||||
const wrapper = await mountDialog()
|
||||
|
||||
expect(startGuidance).toHaveBeenCalledWith('T001', '组合式 API')
|
||||
expect(wrapper.text()).toContain('正在引导的概念')
|
||||
expect(wrapper.text()).toContain('第一个问题')
|
||||
})
|
||||
|
||||
it('多轮对话:发送后回显用户输入并展示 AI 回复', async () => {
|
||||
vi.mocked(getAiTask)
|
||||
.mockResolvedValueOnce(ok(aiTask({ result: { reply: '第一个问题' } })))
|
||||
.mockResolvedValueOnce(ok(aiTask({ taskNum: 'AI2', result: { reply: 'AI 的回复' } })))
|
||||
vi.mocked(submitGuidanceTurn).mockResolvedValue(ok({ taskNum: 'AI2' }))
|
||||
|
||||
const wrapper = await mountDialog()
|
||||
await wrapper.find('textarea').setValue('我认为 ref 是响应式容器')
|
||||
await findButton(wrapper, '发送')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(submitGuidanceTurn).toHaveBeenCalledWith('G1', '我认为 ref 是响应式容器')
|
||||
expect(wrapper.text()).toContain('我认为 ref 是响应式容器')
|
||||
expect(wrapper.text()).toContain('AI 的回复')
|
||||
})
|
||||
|
||||
it('确认后把收获记成知识碎片,带上本次耗时快照', async () => {
|
||||
vi.mocked(createGuidanceFragment).mockResolvedValue(ok({ id: 5 }))
|
||||
|
||||
const wrapper = await mountDialog()
|
||||
await findButton(wrapper, '记成知识碎片')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
const textareas = wrapper.findAll('textarea')
|
||||
await textareas[textareas.length - 1].setValue('这次搞懂了 ref 和 reactive 的区别')
|
||||
await findButton(wrapper, '确认记成碎片')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(createGuidanceFragment).toHaveBeenCalledWith(
|
||||
'G1',
|
||||
expect.objectContaining({ content: '这次搞懂了 ref 和 reactive 的区别' }),
|
||||
)
|
||||
expect(vi.mocked(ElMessage.success)).toHaveBeenCalled()
|
||||
})
|
||||
|
||||
it('放弃引导不产出任何数据', async () => {
|
||||
vi.mocked(abandonGuidance).mockResolvedValue(ok(null))
|
||||
|
||||
const wrapper = await mountDialog()
|
||||
await findButton(wrapper, '放弃这次引导')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(abandonGuidance).toHaveBeenCalledWith('G1')
|
||||
expect(createGuidanceFragment).not.toHaveBeenCalled()
|
||||
})
|
||||
|
||||
it('AI 失败时给出可读提示并把入口置为不可用', async () => {
|
||||
vi.mocked(getAiTask).mockResolvedValue(
|
||||
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()
|
||||
})
|
||||
|
||||
it('离开页面再回来用 GET 恢复同一段对话,不重新开启', async () => {
|
||||
localStorage.setItem(STORAGE_KEY, 'G9')
|
||||
vi.mocked(getGuidanceSession).mockResolvedValue(
|
||||
ok({
|
||||
guidanceNum: 'G9',
|
||||
taskNum: 'T001',
|
||||
concept: '组合式 API',
|
||||
turnsPayload: JSON.stringify([
|
||||
{ role: 'assistant', content: '上次聊到哪了' },
|
||||
{ role: 'user', content: '聊到 ref' },
|
||||
]),
|
||||
reviewDurationSeconds: 30,
|
||||
finished: false,
|
||||
}),
|
||||
)
|
||||
|
||||
const wrapper = await mountDialog()
|
||||
|
||||
expect(getGuidanceSession).toHaveBeenCalledWith('G9')
|
||||
expect(startGuidance).not.toHaveBeenCalled()
|
||||
expect(wrapper.text()).toContain('上次聊到哪了')
|
||||
expect(wrapper.text()).toContain('聊到 ref')
|
||||
})
|
||||
})
|
||||
@@ -4,6 +4,7 @@ import ElementPlus, { ElDatePicker, ElDialog, ElMessage } from 'element-plus'
|
||||
import { createMemoryHistory, createRouter } from 'vue-router'
|
||||
import Review from '@/components/Review.vue'
|
||||
import { getReviewTaskStats } from '@/api/review'
|
||||
import { getMarkersBatch } from '@/api/markers'
|
||||
import { getPendingOwnershipFragments } from '@/api/reportFragments'
|
||||
import { exportRange } from '@/api/export'
|
||||
import { downloadTextFile } from '@/utils/download'
|
||||
@@ -12,6 +13,17 @@ vi.mock('@/api/review', () => ({
|
||||
getReviewTaskStats: vi.fn(),
|
||||
getReviewFeed: vi.fn(),
|
||||
getTaskReview: vi.fn(),
|
||||
getSortPreference: vi.fn(),
|
||||
saveSortPreference: vi.fn(),
|
||||
}))
|
||||
|
||||
vi.mock('@/api/markers', () => ({
|
||||
getMarkersBatch: vi.fn(),
|
||||
addUserTag: vi.fn(),
|
||||
deleteMarker: vi.fn(),
|
||||
filterByMarker: vi.fn(),
|
||||
getUserTagUsage: vi.fn(),
|
||||
renameUserTag: vi.fn(),
|
||||
}))
|
||||
|
||||
vi.mock('@/api/reportFragments', () => ({
|
||||
@@ -53,6 +65,7 @@ describe('Review 导出流程(集成)', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue({ code: 200, data: {} } as never)
|
||||
vi.mocked(exportRange).mockResolvedValue({ code: 200, data: exportResult })
|
||||
vi.mocked(getPendingOwnershipFragments).mockResolvedValue({ code: 200, data: [] } as never)
|
||||
})
|
||||
|
||||
@@ -3,13 +3,25 @@ import { flushPromises, mount } from '@vue/test-utils'
|
||||
import ElementPlus from 'element-plus'
|
||||
import { createMemoryHistory, createRouter } from 'vue-router'
|
||||
import Review from '@/components/Review.vue'
|
||||
import { getReviewTaskStats } from '@/api/review'
|
||||
import { getReviewTaskStats, getSortPreference, saveSortPreference } from '@/api/review'
|
||||
import { filterByMarker, getMarkersBatch, getUserTagUsage, renameUserTag } from '@/api/markers'
|
||||
import { getPendingOwnershipFragments, updateFragmentOwnership } from '@/api/reportFragments'
|
||||
|
||||
vi.mock('@/api/review', () => ({
|
||||
getReviewTaskStats: vi.fn(),
|
||||
getReviewFeed: vi.fn(),
|
||||
getTaskReview: vi.fn(),
|
||||
getSortPreference: vi.fn(),
|
||||
saveSortPreference: vi.fn(),
|
||||
}))
|
||||
|
||||
vi.mock('@/api/markers', () => ({
|
||||
getMarkersBatch: vi.fn(),
|
||||
addUserTag: vi.fn(),
|
||||
deleteMarker: vi.fn(),
|
||||
filterByMarker: vi.fn(),
|
||||
getUserTagUsage: vi.fn(),
|
||||
renameUserTag: vi.fn(),
|
||||
}))
|
||||
|
||||
vi.mock('@/api/reportFragments', () => ({
|
||||
@@ -44,6 +56,11 @@ describe('Review 交互流程(集成)', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
vi.mocked(getPendingOwnershipFragments).mockResolvedValue({ code: 200, data: [] } as never)
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue({ code: 200, data: {} } as never)
|
||||
vi.mocked(getSortPreference).mockResolvedValue({
|
||||
code: 200,
|
||||
data: { preset: 'TIME_FIRST', description: '久未接触的更容易出现' },
|
||||
} as never)
|
||||
})
|
||||
|
||||
const mountReview = async () => {
|
||||
@@ -223,4 +240,82 @@ describe('Review 交互流程(集成)', () => {
|
||||
expect(pushSpy).toHaveBeenCalledWith({ name: 'add-task', query: { promoteFragment: '11' } })
|
||||
pushSpy.mockRestore()
|
||||
})
|
||||
|
||||
it('任务卡片展示标记,点用户标签按单一标记筛选并可清除', async () => {
|
||||
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
|
||||
vi.mocked(getMarkersBatch).mockResolvedValue({
|
||||
code: 200,
|
||||
data: { T001: [{ id: 21, objectType: 'TASK', objectNum: 'T001', kind: 'USER', markerName: '重点', markerValue: null }] },
|
||||
} as never)
|
||||
vi.mocked(filterByMarker).mockResolvedValue({ code: 200, data: ['T001'] } as never)
|
||||
const { wrapper } = await mountReview()
|
||||
|
||||
expect(wrapper.find('.marker-user').text()).toContain('重点')
|
||||
await wrapper.find('.marker-user').trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(filterByMarker).toHaveBeenCalledWith({ objectType: 'TASK', markerName: '重点', kind: 'USER' })
|
||||
expect(wrapper.text()).toContain('正在按标签「重点」筛选任务')
|
||||
expect(wrapper.text()).not.toContain('TypeScript 类型体操')
|
||||
})
|
||||
|
||||
it('打开智能排序偏好,展示三档语义选项与当前档位说明', async () => {
|
||||
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
|
||||
const { wrapper } = await mountReview()
|
||||
|
||||
expect(getSortPreference).toHaveBeenCalled()
|
||||
const open = wrapper.findAll('button').find((b) => b.text().trim() === '智能排序偏好')
|
||||
await open!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(wrapper.text()).toContain('时间为主')
|
||||
expect(wrapper.text()).toContain('均衡')
|
||||
expect(wrapper.text()).toContain('掌握度为主')
|
||||
expect(wrapper.text()).toContain('久未接触的更容易出现')
|
||||
})
|
||||
|
||||
it('选择档位并保存时调用保存接口', async () => {
|
||||
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
|
||||
vi.mocked(saveSortPreference).mockResolvedValue({
|
||||
code: 200,
|
||||
data: { preset: 'MASTERY_FIRST', description: '回忆覆盖率低的更容易出现' },
|
||||
} as never)
|
||||
const { wrapper } = await mountReview()
|
||||
|
||||
await wrapper.findAll('button').find((b) => b.text().trim() === '智能排序偏好')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
const radioGroup = wrapper.findAllComponents({ name: 'ElRadioGroup' })[0]
|
||||
radioGroup.vm.$emit('update:modelValue', 'MASTERY_FIRST')
|
||||
await flushPromises()
|
||||
|
||||
await wrapper.findAll('button').find((b) => b.text().trim() === '保存')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(saveSortPreference).toHaveBeenCalledWith('MASTERY_FIRST')
|
||||
})
|
||||
|
||||
it('标签管理列出标签与用量,并支持重命名', async () => {
|
||||
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
|
||||
vi.mocked(getUserTagUsage).mockResolvedValue({
|
||||
code: 200,
|
||||
data: [{ markerName: '英语', markerCount: 3, objectCount: 2 }],
|
||||
} as never)
|
||||
vi.mocked(renameUserTag).mockResolvedValue({ code: 200, data: 2 } as never)
|
||||
const { wrapper } = await mountReview()
|
||||
|
||||
await wrapper.findAll('button').find((b) => b.text().trim() === '标签管理')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(wrapper.text()).toContain('英语')
|
||||
expect(wrapper.text()).toContain('2 个内容 · 3 次使用')
|
||||
|
||||
await wrapper.findAll('button').find((b) => b.text().trim() === '重命名')!.trigger('click')
|
||||
await flushPromises()
|
||||
await wrapper.find('.tag-rename-input').setValue('英文')
|
||||
await wrapper.findAll('button').find((b) => b.text().trim() === '保存')!.trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(renameUserTag).toHaveBeenCalledWith('英语', '英文')
|
||||
})
|
||||
})
|
||||
|
||||
@@ -0,0 +1,61 @@
|
||||
// src/api/guidance.ts
|
||||
import request from "@/utils/request";
|
||||
import type { ReportFragment } from "./reportFragments";
|
||||
|
||||
/** 学习引导的一轮对话:role 由后端给出 */
|
||||
export interface GuidanceTurn {
|
||||
role: "user" | "assistant";
|
||||
content: string;
|
||||
}
|
||||
|
||||
/** 开启引导的返回:已同时提交了第一个 AI 任务 */
|
||||
export interface GuidanceStart {
|
||||
guidanceNum: string;
|
||||
taskNum: string;
|
||||
concept: string;
|
||||
aiTaskNum: string;
|
||||
}
|
||||
|
||||
/** 一次学习引导会话(离开页面后可凭 guidanceNum 恢复) */
|
||||
export interface GuidanceSession {
|
||||
guidanceNum: string;
|
||||
taskNum: string;
|
||||
concept: string;
|
||||
/** 对话轮次 JSON 字符串:[{role, content}] */
|
||||
turnsPayload: string;
|
||||
reviewDurationSeconds: number;
|
||||
finished: boolean;
|
||||
}
|
||||
|
||||
/** 确认产出碎片时上报的复习耗时快照(与回忆对比同一口径) */
|
||||
export interface GuidanceFragmentPayload {
|
||||
content: string;
|
||||
reviewStartedAt?: string;
|
||||
reviewLastInteractionAt?: string;
|
||||
reviewDurationSeconds?: number;
|
||||
}
|
||||
|
||||
/** 开启一次学习引导并提交第一个问题 */
|
||||
export const startGuidance = (taskNum: string, concept: string) => {
|
||||
return request.post<GuidanceStart>("/review/guidance", { taskNum, concept });
|
||||
};
|
||||
|
||||
/** 继续一轮:提交用户的回答/追问,返回本轮 AI 任务 */
|
||||
export const submitGuidanceTurn = (guidanceNum: string, message: string) => {
|
||||
return request.post<{ taskNum: string }>(`/review/guidance/${guidanceNum}/turns`, { message });
|
||||
};
|
||||
|
||||
/** 读取引导会话当前状态(含对话轮次),用于离开页面后回来继续 */
|
||||
export const getGuidanceSession = (guidanceNum: string) => {
|
||||
return request.get<GuidanceSession>(`/review/guidance/${guidanceNum}`);
|
||||
};
|
||||
|
||||
/** 用户确认产出:把这次引导的收获记成一条知识碎片 */
|
||||
export const createGuidanceFragment = (guidanceNum: string, payload: GuidanceFragmentPayload) => {
|
||||
return request.post<ReportFragment>(`/review/guidance/${guidanceNum}/fragments`, payload);
|
||||
};
|
||||
|
||||
/** 放弃这次引导:不产出任何数据 */
|
||||
export const abandonGuidance = (guidanceNum: string) => {
|
||||
return request.del(`/review/guidance/${guidanceNum}`);
|
||||
};
|
||||
@@ -0,0 +1,72 @@
|
||||
// src/api/markers.ts
|
||||
import request from "@/utils/request";
|
||||
|
||||
/** 标记对象类型:知识碎片用数字 id 字符串,学习任务用任务编号 */
|
||||
export type MarkerObjectType = "FRAGMENT" | "TASK";
|
||||
|
||||
/** 标记类别:系统标记只读,用户标签可增删改 */
|
||||
export type MarkerKind = "SYSTEM" | "USER";
|
||||
|
||||
/**
|
||||
* 统一标记(标记-01):附加在对象上的一段轻量元信息,不是状态、不参与聚合。
|
||||
* 系统标记成对表达(如 markerName=来源 / markerValue=学习引导),用户标签只有名字。
|
||||
*/
|
||||
export interface Marker {
|
||||
id: number;
|
||||
objectType: MarkerObjectType;
|
||||
objectNum: string;
|
||||
kind: MarkerKind;
|
||||
markerName: string;
|
||||
markerValue: string | null;
|
||||
}
|
||||
|
||||
/** 用户标签的使用情况(标签管理入口) */
|
||||
export interface MarkerUsage {
|
||||
markerName: string;
|
||||
markerCount: number;
|
||||
objectCount: number;
|
||||
}
|
||||
|
||||
export interface MarkerFilterParams {
|
||||
objectType: MarkerObjectType;
|
||||
markerName: string;
|
||||
markerValue?: string;
|
||||
kind?: MarkerKind;
|
||||
}
|
||||
|
||||
/** 列出某个对象上的全部标记 */
|
||||
export const getMarkers = (objectType: MarkerObjectType, objectNum: string) => {
|
||||
return request.get<Marker[]>("/markers", { objectType, objectNum });
|
||||
};
|
||||
|
||||
/** 批量列出多个对象的标记:列表页一次取回,避免逐个请求 */
|
||||
export const getMarkersBatch = (objectType: MarkerObjectType, objectNums: string[]) => {
|
||||
return request.post<Record<string, Marker[]>>("/markers/batch", objectNums, {
|
||||
params: { objectType },
|
||||
});
|
||||
};
|
||||
|
||||
/** 给对象打一个用户标签(幂等) */
|
||||
export const addUserTag = (objectType: MarkerObjectType, objectNum: string, markerName: string) => {
|
||||
return request.post<Marker>("/markers", { objectType, objectNum, markerName });
|
||||
};
|
||||
|
||||
/** 删除一条用户标签;系统标记不可删除(后端返回业务错误) */
|
||||
export const deleteMarker = (id: number) => {
|
||||
return request.del(`/markers/${id}`);
|
||||
};
|
||||
|
||||
/** 重命名用户标签,返回被改写的条数(影响所有带该标签的对象) */
|
||||
export const renameUserTag = (oldName: string, newName: string) => {
|
||||
return request.put<number>("/markers/rename", { oldName, newName });
|
||||
};
|
||||
|
||||
/** 按单一标记筛选对象,返回对象标识列表(点标签即筛选) */
|
||||
export const filterByMarker = (params: MarkerFilterParams) => {
|
||||
return request.get<string[]>("/markers/filter", params);
|
||||
};
|
||||
|
||||
/** 当前用户用过的标签与用量 */
|
||||
export const getUserTagUsage = () => {
|
||||
return request.get<MarkerUsage[]>("/markers/tags");
|
||||
};
|
||||
@@ -12,7 +12,12 @@ export interface ReviewFeedItem {
|
||||
/** 内容归属的任务编号;碎片待归类时为 null */
|
||||
taskNum: string | null;
|
||||
taskName: string | null;
|
||||
/** 内容摘要(复习-05):Feed 只回摘要,全文由详情接口按需拉取 */
|
||||
content: string;
|
||||
/** 原文总长度(字符数),供界面标注「全文 N 字」 */
|
||||
contentLength: number;
|
||||
/** content 是否为截断后的摘要 */
|
||||
contentTruncated: boolean;
|
||||
createdTime: string;
|
||||
/** 仅碎片有意义:内容归属为空,等待归类 */
|
||||
pendingOwnership: boolean;
|
||||
@@ -77,6 +82,51 @@ export const getReviewFeed = (limit: number = 30, mode: "recent" | "random" | "s
|
||||
return request.get<ReviewFeedItem[]>("/review/feed", { limit, mode });
|
||||
};
|
||||
|
||||
// ============ 复习反馈动作(复习-02) ============
|
||||
|
||||
/** 反馈动作本身只影响出现概率,不产生状态展示 */
|
||||
export interface ReviewFeedbackPayload {
|
||||
mastered?: boolean;
|
||||
revisit?: boolean;
|
||||
}
|
||||
|
||||
/** 回显动作后的状态,供本次浏览内切换按钮 */
|
||||
export interface ReviewFeedbackState {
|
||||
mastered: boolean;
|
||||
revisit: boolean;
|
||||
}
|
||||
|
||||
/** 标记或取消「已掌握」「稍后再看」,返回动作后的状态 */
|
||||
export const submitReviewFeedback = (fragmentId: number, payload: ReviewFeedbackPayload) => {
|
||||
return request.put<ReviewFeedbackState>(`/review/feed/${fragmentId}/feedback`, payload);
|
||||
};
|
||||
|
||||
/** 记录一次「接触」(展开查看时调用):刷新最近接触时间,参与智能排序 */
|
||||
export const touchReviewFragment = (fragmentId: number) => {
|
||||
return request.post<void>(`/review/feed/${fragmentId}/touched`);
|
||||
};
|
||||
|
||||
// ============ 复习排序偏好(复习-01) ============
|
||||
|
||||
/** 智能排序档位:时间为主 / 均衡 / 掌握度为主 */
|
||||
export type ReviewSortPreset = "TIME_FIRST" | "BALANCED" | "MASTERY_FIRST";
|
||||
|
||||
export interface ReviewSortPreference {
|
||||
preset: ReviewSortPreset;
|
||||
/** 档位的中文说明(由后端给出) */
|
||||
description: string;
|
||||
}
|
||||
|
||||
/** 读取当前排序偏好 */
|
||||
export const getSortPreference = () => {
|
||||
return request.get<ReviewSortPreference>("/review/sort-preference");
|
||||
};
|
||||
|
||||
/** 保存排序偏好:三档预设,不做精确权重 */
|
||||
export const saveSortPreference = (preset: ReviewSortPreset) => {
|
||||
return request.put<ReviewSortPreference>("/review/sort-preference", { preset });
|
||||
};
|
||||
|
||||
export const getReviewTaskStats = () => {
|
||||
return request.get<ReviewTaskStats[]>("/review/tasks");
|
||||
};
|
||||
|
||||
@@ -0,0 +1,322 @@
|
||||
<script setup lang="ts">
|
||||
import { ref, watch } from "vue";
|
||||
import { ElMessage } from "element-plus";
|
||||
import { useGuidanceSession } from "@/components/composables/useGuidance";
|
||||
|
||||
/**
|
||||
* 学习引导对话框:围绕一个概念和 AI 多轮对话,随时可以把收获记成知识碎片或放弃。
|
||||
* 不判分、不设轮数上限;AI 不可用时整体停用(入口由 guidanceUnavailable 控制)。
|
||||
*/
|
||||
const props = defineProps<{
|
||||
modelValue: boolean;
|
||||
taskNum: string;
|
||||
concept: string;
|
||||
}>();
|
||||
|
||||
const emit = defineEmits<{
|
||||
(e: "update:modelValue", value: boolean): void;
|
||||
(e: "created"): void;
|
||||
}>();
|
||||
|
||||
const {
|
||||
session,
|
||||
turns,
|
||||
starting,
|
||||
sending,
|
||||
waiting,
|
||||
waitingSeconds,
|
||||
error,
|
||||
unavailable,
|
||||
open,
|
||||
send,
|
||||
confirmFragment,
|
||||
abandon,
|
||||
markInteraction,
|
||||
} = useGuidanceSession();
|
||||
|
||||
const draft = ref("");
|
||||
const fragmentVisible = ref(false);
|
||||
const fragmentContent = ref("");
|
||||
const saving = ref(false);
|
||||
const ending = ref(false);
|
||||
|
||||
watch(
|
||||
() => props.modelValue,
|
||||
(visible) => {
|
||||
if (visible) {
|
||||
draft.value = "";
|
||||
fragmentVisible.value = false;
|
||||
fragmentContent.value = "";
|
||||
void open(props.taskNum, props.concept);
|
||||
}
|
||||
},
|
||||
);
|
||||
|
||||
const close = () => {
|
||||
emit("update:modelValue", false);
|
||||
};
|
||||
|
||||
const sendTurn = async () => {
|
||||
if (sending.value || waiting.value) return;
|
||||
const text = draft.value.trim();
|
||||
if (!text) return;
|
||||
draft.value = "";
|
||||
await send(text);
|
||||
};
|
||||
|
||||
const openFragmentForm = () => {
|
||||
if (unavailable.value) return;
|
||||
fragmentVisible.value = true;
|
||||
};
|
||||
|
||||
const saveFragment = async () => {
|
||||
if (saving.value) return;
|
||||
const content = fragmentContent.value.trim();
|
||||
if (!content) {
|
||||
ElMessage.warning("先写下这次引导的收获吧");
|
||||
return;
|
||||
}
|
||||
saving.value = true;
|
||||
try {
|
||||
const ok = await confirmFragment(content);
|
||||
if (ok) {
|
||||
ElMessage.success("已经记成一条知识碎片");
|
||||
fragmentVisible.value = false;
|
||||
emit("created");
|
||||
close();
|
||||
}
|
||||
} finally {
|
||||
saving.value = false;
|
||||
}
|
||||
};
|
||||
|
||||
const giveUp = async () => {
|
||||
if (ending.value) return;
|
||||
ending.value = true;
|
||||
try {
|
||||
await abandon();
|
||||
ElMessage.info("这次学习引导已放弃,没有留下任何内容");
|
||||
close();
|
||||
} finally {
|
||||
ending.value = false;
|
||||
}
|
||||
};
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<el-dialog
|
||||
:model-value="modelValue"
|
||||
class="guidance-dialog"
|
||||
width="620px"
|
||||
title="学习引导"
|
||||
@update:model-value="emit('update:modelValue', $event)"
|
||||
>
|
||||
<div class="guidance-body" @click="markInteraction" @keydown="markInteraction">
|
||||
<div class="guidance-concept">
|
||||
<span class="concept-label">正在引导的概念</span>
|
||||
<span class="concept-name">{{ concept }}</span>
|
||||
</div>
|
||||
|
||||
<p class="guidance-hint">
|
||||
跟着 AI 一起把这个概念聊透。没有对错,也没有轮数限制,想清楚后可以把收获记成一条知识碎片。
|
||||
</p>
|
||||
|
||||
<div class="guidance-turns">
|
||||
<div
|
||||
v-for="(turn, index) in turns"
|
||||
:key="index"
|
||||
class="guidance-turn"
|
||||
:class="turn.role === 'user' ? 'is-user' : 'is-ai'"
|
||||
>
|
||||
<span class="turn-role">{{ turn.role === "user" ? "我" : "AI" }}</span>
|
||||
<div class="turn-content">{{ turn.content }}</div>
|
||||
</div>
|
||||
|
||||
<p v-if="starting || waiting" class="guidance-waiting">
|
||||
<template v-if="starting">正在准备这段引导…</template>
|
||||
<template v-else>AI 正在思考,已等待 {{ waitingSeconds }} 秒…</template>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<el-alert
|
||||
v-if="error"
|
||||
class="guidance-error"
|
||||
type="warning"
|
||||
:closable="false"
|
||||
show-icon
|
||||
:title="error"
|
||||
/>
|
||||
|
||||
<div v-if="!unavailable && !session?.finished" class="guidance-input">
|
||||
<el-input
|
||||
v-model="draft"
|
||||
type="textarea"
|
||||
:rows="2"
|
||||
resize="none"
|
||||
placeholder="写下你的想法或追问…"
|
||||
:disabled="sending || waiting || starting"
|
||||
@keydown.enter.exact.prevent="sendTurn"
|
||||
/>
|
||||
<el-button
|
||||
type="success"
|
||||
class="guidance-send"
|
||||
:loading="sending || waiting"
|
||||
:disabled="!draft.trim() || starting"
|
||||
@click="sendTurn"
|
||||
>发送</el-button>
|
||||
</div>
|
||||
|
||||
<div v-if="fragmentVisible && !unavailable" class="guidance-fragment-form">
|
||||
<span class="fragment-label">把这次引导的收获记成知识碎片</span>
|
||||
<el-input
|
||||
v-model="fragmentContent"
|
||||
type="textarea"
|
||||
:rows="3"
|
||||
placeholder="写清楚这次想留下的内容,之后可以随时修改归属"
|
||||
/>
|
||||
<div class="fragment-actions">
|
||||
<el-button size="small" @click="fragmentVisible = false">先不记了</el-button>
|
||||
<el-button type="success" size="small" :loading="saving" @click="saveFragment">
|
||||
确认记成碎片
|
||||
</el-button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<template #footer>
|
||||
<el-button :disabled="ending" @click="giveUp">放弃这次引导</el-button>
|
||||
<el-button
|
||||
v-if="!unavailable && !session?.finished"
|
||||
type="success"
|
||||
:disabled="fragmentVisible || starting"
|
||||
@click="openFragmentForm"
|
||||
>记成知识碎片</el-button>
|
||||
<el-button type="primary" @click="close">关闭</el-button>
|
||||
</template>
|
||||
</el-dialog>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.guidance-body {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 12px;
|
||||
}
|
||||
|
||||
.guidance-concept {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.concept-label {
|
||||
font-size: 13px;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.concept-name {
|
||||
font-weight: 600;
|
||||
color: var(--green-800);
|
||||
word-break: break-word;
|
||||
}
|
||||
|
||||
.guidance-hint {
|
||||
margin: 0;
|
||||
font-size: 13px;
|
||||
color: var(--text-secondary);
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
.guidance-turns {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 8px;
|
||||
max-height: 46vh;
|
||||
overflow-y: auto;
|
||||
padding-right: 2px;
|
||||
}
|
||||
|
||||
.guidance-turn {
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
padding: 8px 10px;
|
||||
border-radius: 8px;
|
||||
border: 1px solid var(--border-soft);
|
||||
background: var(--surface-strong);
|
||||
}
|
||||
|
||||
.guidance-turn.is-user {
|
||||
background: var(--accent-success-softer);
|
||||
}
|
||||
|
||||
.turn-role {
|
||||
flex-shrink: 0;
|
||||
font-size: 12px;
|
||||
font-weight: 700;
|
||||
color: var(--green-700);
|
||||
}
|
||||
|
||||
.turn-content {
|
||||
flex: 1;
|
||||
font-size: 14px;
|
||||
line-height: 1.7;
|
||||
color: var(--text-primary);
|
||||
white-space: pre-wrap;
|
||||
word-break: break-word;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.guidance-waiting {
|
||||
margin: 0;
|
||||
padding: 8px 10px;
|
||||
font-size: 13px;
|
||||
color: var(--accent-warning-strong);
|
||||
background: var(--accent-warning-soft);
|
||||
border-radius: 8px;
|
||||
}
|
||||
|
||||
.guidance-error {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.guidance-input {
|
||||
display: flex;
|
||||
align-items: flex-end;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.guidance-input :deep(.el-textarea) {
|
||||
flex: 1;
|
||||
}
|
||||
|
||||
.guidance-send {
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.guidance-fragment-form {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 8px;
|
||||
padding-top: 10px;
|
||||
border-top: 1px solid var(--border-soft);
|
||||
}
|
||||
|
||||
.fragment-label {
|
||||
font-size: 13px;
|
||||
font-weight: 600;
|
||||
color: var(--green-800);
|
||||
}
|
||||
|
||||
.fragment-actions {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
@media (max-width: 768px) {
|
||||
.guidance-input {
|
||||
flex-direction: column;
|
||||
align-items: stretch;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
@@ -0,0 +1,209 @@
|
||||
<script setup lang="ts">
|
||||
import { ref } from "vue";
|
||||
import type { Marker } from "@/api/markers";
|
||||
|
||||
/**
|
||||
* 标记展示:系统标记灰底只读(成对显示为「名=值」),用户标签可点击筛选、可删除。
|
||||
* 编辑态下可自由输入新标签;父组件负责真正调接口。
|
||||
*/
|
||||
const props = withDefaults(
|
||||
defineProps<{
|
||||
markers: Marker[];
|
||||
/** 是否允许加/删用户标签(列表卡片默认可编辑) */
|
||||
editable?: boolean;
|
||||
}>(),
|
||||
{ editable: true },
|
||||
);
|
||||
|
||||
const emit = defineEmits<{
|
||||
(e: "filter", marker: Marker): void;
|
||||
(e: "add", markerName: string): void;
|
||||
(e: "remove", marker: Marker): void;
|
||||
}>();
|
||||
|
||||
const adding = ref(false);
|
||||
const draft = ref("");
|
||||
|
||||
const startAdding = () => {
|
||||
draft.value = "";
|
||||
adding.value = true;
|
||||
};
|
||||
|
||||
const submitAdd = () => {
|
||||
const name = draft.value.trim();
|
||||
if (!name) {
|
||||
adding.value = false;
|
||||
return;
|
||||
}
|
||||
emit("add", name);
|
||||
draft.value = "";
|
||||
adding.value = false;
|
||||
};
|
||||
|
||||
const cancelAdd = () => {
|
||||
draft.value = "";
|
||||
adding.value = false;
|
||||
};
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<span class="marker-chips">
|
||||
<template v-for="marker in props.markers" :key="marker.id">
|
||||
<span v-if="marker.kind === 'SYSTEM'" class="marker marker-system">
|
||||
{{ marker.markerName }}<template v-if="marker.markerValue">={{ marker.markerValue }}</template>
|
||||
</span>
|
||||
<span
|
||||
v-else
|
||||
class="marker marker-user"
|
||||
role="button"
|
||||
tabindex="0"
|
||||
:aria-label="`按标签 ${marker.markerName} 筛选`"
|
||||
@click.stop="emit('filter', marker)"
|
||||
@keydown.enter.stop.prevent="emit('filter', marker)"
|
||||
@keydown.space.stop.prevent="emit('filter', marker)"
|
||||
>
|
||||
<span class="marker-user-name">{{ marker.markerName }}</span>
|
||||
<button
|
||||
v-if="props.editable"
|
||||
type="button"
|
||||
class="marker-remove"
|
||||
:aria-label="`删除标签 ${marker.markerName}`"
|
||||
@click.stop="emit('remove', marker)"
|
||||
>×</button>
|
||||
</span>
|
||||
</template>
|
||||
|
||||
<span v-if="props.editable" class="marker-add" @click.stop>
|
||||
<button
|
||||
v-if="!adding"
|
||||
type="button"
|
||||
class="marker-add-toggle"
|
||||
@click.stop="startAdding"
|
||||
>+ 标签</button>
|
||||
<span v-else class="marker-add-form">
|
||||
<input
|
||||
v-model="draft"
|
||||
class="marker-add-input"
|
||||
placeholder="标签名"
|
||||
aria-label="新标签名"
|
||||
@keydown.enter.prevent="submitAdd"
|
||||
@keydown.esc.prevent="cancelAdd"
|
||||
/>
|
||||
<button type="button" class="marker-add-confirm" @click.stop="submitAdd">确定</button>
|
||||
</span>
|
||||
</span>
|
||||
</span>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.marker-chips {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
flex-wrap: wrap;
|
||||
gap: 6px;
|
||||
}
|
||||
|
||||
.marker {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 4px;
|
||||
font-size: 12px;
|
||||
line-height: 1.4;
|
||||
padding: 1px 7px;
|
||||
border-radius: 10px;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
/* 系统标记:灰底只读,不能点 */
|
||||
.marker-system {
|
||||
background: var(--surface);
|
||||
border: 1px solid var(--border-soft);
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
/* 用户标签:绿色可点,点一下按它筛选 */
|
||||
.marker-user {
|
||||
background: var(--accent-success-soft);
|
||||
border: 1px solid var(--accent-success-soft);
|
||||
color: var(--green-700);
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.marker-user:hover {
|
||||
border-color: var(--green-600);
|
||||
}
|
||||
|
||||
.marker-user:focus-visible {
|
||||
outline: 2px solid var(--green-700);
|
||||
outline-offset: 1px;
|
||||
}
|
||||
|
||||
.marker-user-name {
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.marker-remove {
|
||||
border: none;
|
||||
background: transparent;
|
||||
color: var(--green-700);
|
||||
font-size: 13px;
|
||||
line-height: 1;
|
||||
padding: 0 0 0 2px;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.marker-remove:hover {
|
||||
color: var(--accent-warning-strong);
|
||||
}
|
||||
|
||||
.marker-add {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
.marker-add-toggle {
|
||||
border: 1px dashed var(--border-soft);
|
||||
background: transparent;
|
||||
color: var(--text-secondary);
|
||||
font-size: 12px;
|
||||
border-radius: 10px;
|
||||
padding: 1px 8px;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.marker-add-toggle:hover {
|
||||
color: var(--green-700);
|
||||
border-color: var(--green-600);
|
||||
}
|
||||
|
||||
.marker-add-form {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 4px;
|
||||
}
|
||||
|
||||
.marker-add-input {
|
||||
width: 90px;
|
||||
font-size: 12px;
|
||||
padding: 1px 6px;
|
||||
border: 1px solid var(--border-soft);
|
||||
border-radius: 6px;
|
||||
color: var(--text-primary);
|
||||
background: var(--surface-strong);
|
||||
}
|
||||
|
||||
.marker-add-input:focus {
|
||||
outline: none;
|
||||
border-color: var(--green-600);
|
||||
}
|
||||
|
||||
.marker-add-confirm {
|
||||
border: none;
|
||||
background: var(--green-700);
|
||||
color: #fff;
|
||||
font-size: 12px;
|
||||
border-radius: 6px;
|
||||
padding: 2px 8px;
|
||||
cursor: pointer;
|
||||
}
|
||||
</style>
|
||||
+387
-3
@@ -1,9 +1,13 @@
|
||||
<script setup lang="ts">
|
||||
import { computed, onMounted, ref } from "vue";
|
||||
import { useRouter } from "vue-router";
|
||||
import { ElMessage } from "element-plus";
|
||||
import { ElMessage, ElMessageBox } from "element-plus";
|
||||
import {
|
||||
getReviewTaskStats,
|
||||
getSortPreference,
|
||||
saveSortPreference,
|
||||
type ReviewSortPreset,
|
||||
type ReviewSortPreference,
|
||||
type ReviewTaskStats,
|
||||
} from "@/api/review";
|
||||
import {
|
||||
@@ -11,6 +15,9 @@ import {
|
||||
updateFragmentOwnership,
|
||||
type ReportFragment,
|
||||
} from "@/api/reportFragments";
|
||||
import { getUserTagUsage, renameUserTag, type Marker, type MarkerUsage } from "@/api/markers";
|
||||
import { deleteUserTagEverywhere, useMarkers } from "@/components/composables/useMarkers";
|
||||
import MarkerChips from "@/components/MarkerChips.vue";
|
||||
import { exportRange, type ExportFormat } from "@/api/export";
|
||||
import { downloadTextFile } from "@/utils/download";
|
||||
|
||||
@@ -31,6 +38,34 @@ const exportDateRange = ref<[string, string] | null>(null);
|
||||
const exportFormat = ref<ExportFormat>("markdown");
|
||||
const exporting = ref(false);
|
||||
|
||||
// 任务卡片标记:一页任务一次取回;点用户标签做单一标记筛选
|
||||
const taskMarkers = useMarkers("TASK");
|
||||
const markerFilter = ref<{ markerName: string } | null>(null);
|
||||
const filteredTaskNums = ref<Set<string> | null>(null);
|
||||
|
||||
// 智能排序偏好(复习-01):语义档位,不是权重滑块
|
||||
const sortDialogVisible = ref(false);
|
||||
const sortPreference = ref<ReviewSortPreference | null>(null);
|
||||
const sortPreset = ref<ReviewSortPreset>("TIME_FIRST");
|
||||
const savingSort = ref(false);
|
||||
const sortPresetOptions: { value: ReviewSortPreset; label: string; hint: string }[] = [
|
||||
{ value: "TIME_FIRST", label: "时间为主", hint: "久没接触的更容易出现(默认)" },
|
||||
{ value: "BALANCED", label: "均衡", hint: "时间和掌握度各占一部分" },
|
||||
{ value: "MASTERY_FIRST", label: "掌握度为主", hint: "回忆覆盖率低的更容易出现" },
|
||||
];
|
||||
|
||||
// 标签管理入口:列出标签与用量,支持重命名与删除
|
||||
const tagDialogVisible = ref(false);
|
||||
const tagUsages = ref<MarkerUsage[]>([]);
|
||||
const tagsLoading = ref(false);
|
||||
const renamingTag = ref<string | null>(null);
|
||||
const renameDraft = ref("");
|
||||
const tagBusy = ref(false);
|
||||
|
||||
const visibleTasks = computed(() =>
|
||||
tasks.value.filter((task) => !filteredTaskNums.value || filteredTaskNums.value.has(task.taskNum)),
|
||||
);
|
||||
|
||||
const summary = computed(() => ({
|
||||
totalTasks: tasks.value.length,
|
||||
totalReports: tasks.value.reduce((acc, item) => acc + Number(item.reportCount || 0), 0),
|
||||
@@ -52,6 +87,7 @@ const loadTasks = async () => {
|
||||
try {
|
||||
const res = await getReviewTaskStats();
|
||||
tasks.value = res?.data || [];
|
||||
await taskMarkers.load(tasks.value.map((task) => task.taskNum));
|
||||
} catch {
|
||||
// 请求层已提示具体错误,这里只保证不把失败当作空列表展示
|
||||
loadFailed.value = true;
|
||||
@@ -109,6 +145,142 @@ const openExportDialog = () => {
|
||||
exportDialogVisible.value = true;
|
||||
};
|
||||
|
||||
// ============ 标记:筛选与卡片上直接加标签 ============
|
||||
|
||||
/** 点标签即筛选(单一标记,不做组合) */
|
||||
const applyMarkerFilter = async (marker: Marker) => {
|
||||
const nums = await taskMarkers.filterByTag(marker);
|
||||
filteredTaskNums.value = nums;
|
||||
markerFilter.value = { markerName: marker.markerName };
|
||||
};
|
||||
|
||||
const clearMarkerFilter = () => {
|
||||
markerFilter.value = null;
|
||||
filteredTaskNums.value = null;
|
||||
};
|
||||
|
||||
const addTaskTag = async (task: ReviewTaskStats, markerName: string) => {
|
||||
await taskMarkers.addTag(task.taskNum, markerName);
|
||||
};
|
||||
|
||||
const removeTaskTag = async (task: ReviewTaskStats, marker: Marker) => {
|
||||
await taskMarkers.removeTag(task.taskNum, marker);
|
||||
};
|
||||
|
||||
// ============ 智能排序偏好(复习-01) ============
|
||||
|
||||
const loadSortPreference = async () => {
|
||||
try {
|
||||
const res = await getSortPreference();
|
||||
const data = res?.data;
|
||||
if (data) {
|
||||
sortPreference.value = data;
|
||||
sortPreset.value = data.preset;
|
||||
}
|
||||
} catch {
|
||||
// 非关键数据,失败就保留默认档位
|
||||
}
|
||||
};
|
||||
|
||||
const openSortDialog = () => {
|
||||
sortDialogVisible.value = true;
|
||||
};
|
||||
|
||||
const confirmSort = async () => {
|
||||
if (savingSort.value) return;
|
||||
savingSort.value = true;
|
||||
try {
|
||||
const res = await saveSortPreference(sortPreset.value);
|
||||
if (res?.data) {
|
||||
sortPreference.value = res.data;
|
||||
sortPreset.value = res.data.preset;
|
||||
}
|
||||
sortDialogVisible.value = false;
|
||||
ElMessage.success("智能排序偏好已保存");
|
||||
} catch {
|
||||
// 请求层已提示具体错误
|
||||
} finally {
|
||||
savingSort.value = false;
|
||||
}
|
||||
};
|
||||
|
||||
// ============ 标签管理(标记-01) ============
|
||||
|
||||
const openTagDialog = () => {
|
||||
renamingTag.value = null;
|
||||
tagDialogVisible.value = true;
|
||||
void loadTags();
|
||||
};
|
||||
|
||||
const loadTags = async () => {
|
||||
tagsLoading.value = true;
|
||||
try {
|
||||
const res = await getUserTagUsage();
|
||||
tagUsages.value = res?.data || [];
|
||||
} catch {
|
||||
tagUsages.value = [];
|
||||
} finally {
|
||||
tagsLoading.value = false;
|
||||
}
|
||||
};
|
||||
|
||||
const startRenameTag = (usage: MarkerUsage) => {
|
||||
renamingTag.value = usage.markerName;
|
||||
renameDraft.value = usage.markerName;
|
||||
};
|
||||
|
||||
const cancelRenameTag = () => {
|
||||
renamingTag.value = null;
|
||||
renameDraft.value = "";
|
||||
};
|
||||
|
||||
const confirmRenameTag = async () => {
|
||||
const oldName = renamingTag.value;
|
||||
const newName = renameDraft.value.trim();
|
||||
if (!oldName || tagBusy.value) return;
|
||||
if (!newName || newName === oldName) {
|
||||
cancelRenameTag();
|
||||
return;
|
||||
}
|
||||
tagBusy.value = true;
|
||||
try {
|
||||
await renameUserTag(oldName, newName);
|
||||
ElMessage.success("标签已重命名");
|
||||
cancelRenameTag();
|
||||
await loadTags();
|
||||
await taskMarkers.load(tasks.value.map((task) => task.taskNum));
|
||||
} catch {
|
||||
// 请求层已提示具体错误
|
||||
} finally {
|
||||
tagBusy.value = false;
|
||||
}
|
||||
};
|
||||
|
||||
const removeTag = async (usage: MarkerUsage) => {
|
||||
try {
|
||||
await ElMessageBox.confirm(
|
||||
`删除标签「${usage.markerName}」后,所有打上它的内容都会去掉这个标签。`,
|
||||
"确认删除",
|
||||
{ confirmButtonText: "确定删除", cancelButtonText: "取消", type: "warning" },
|
||||
);
|
||||
} catch {
|
||||
return;
|
||||
}
|
||||
if (tagBusy.value) return;
|
||||
tagBusy.value = true;
|
||||
try {
|
||||
await deleteUserTagEverywhere(usage.markerName);
|
||||
ElMessage.success("标签已删除");
|
||||
await loadTags();
|
||||
await taskMarkers.load(tasks.value.map((task) => task.taskNum));
|
||||
if (markerFilter.value?.markerName === usage.markerName) clearMarkerFilter();
|
||||
} catch {
|
||||
// 请求层已提示具体错误
|
||||
} finally {
|
||||
tagBusy.value = false;
|
||||
}
|
||||
};
|
||||
|
||||
const confirmExport = async () => {
|
||||
let startDate: string | undefined;
|
||||
let endDate: string | undefined;
|
||||
@@ -141,6 +313,7 @@ const confirmExport = async () => {
|
||||
onMounted(() => {
|
||||
loadTasks();
|
||||
loadPendingOwnership();
|
||||
loadSortPreference();
|
||||
});
|
||||
</script>
|
||||
|
||||
@@ -148,6 +321,8 @@ onMounted(() => {
|
||||
<section class="review-page">
|
||||
<div class="page-toolbar">
|
||||
<el-button :loading="loading" @click="loadTasks">刷新</el-button>
|
||||
<el-button plain @click="openSortDialog">智能排序偏好</el-button>
|
||||
<el-button plain @click="openTagDialog">标签管理</el-button>
|
||||
<el-button type="success" plain @click="openExportDialog">导出数据</el-button>
|
||||
</div>
|
||||
|
||||
@@ -201,9 +376,14 @@ onMounted(() => {
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div v-if="tasks.length > 0" v-loading="loading" class="task-list">
|
||||
<div v-if="markerFilter" class="marker-filter-bar">
|
||||
<span>正在按标签「{{ markerFilter.markerName }}」筛选任务</span>
|
||||
<el-button size="small" text type="success" @click="clearMarkerFilter">清除筛选</el-button>
|
||||
</div>
|
||||
|
||||
<div v-if="visibleTasks.length > 0" v-loading="loading" class="task-list">
|
||||
<article
|
||||
v-for="row in tasks"
|
||||
v-for="row in visibleTasks"
|
||||
:key="row.taskNum"
|
||||
class="surface-card task-card"
|
||||
role="link"
|
||||
@@ -224,6 +404,14 @@ onMounted(() => {
|
||||
<span>学习报告数量:{{ row.reportCount || 0 }}</span>
|
||||
<span>学习残片数量:{{ row.fragmentCount || 0 }}</span>
|
||||
</div>
|
||||
<div class="task-card-markers" @click.stop>
|
||||
<MarkerChips
|
||||
:markers="taskMarkers.markersOf(row.taskNum)"
|
||||
@add="name => addTaskTag(row, name)"
|
||||
@remove="marker => removeTaskTag(row, marker)"
|
||||
@filter="marker => applyMarkerFilter(marker)"
|
||||
/>
|
||||
</div>
|
||||
<!-- 卡片整体已可进详情,这里只保留「回忆复习」作为明确的主操作 -->
|
||||
<div class="task-actions">
|
||||
<span class="detail-hint">查看详情 →</span>
|
||||
@@ -238,6 +426,12 @@ onMounted(() => {
|
||||
</div>
|
||||
</article>
|
||||
</div>
|
||||
<el-empty
|
||||
v-if="!loading && markerFilter && visibleTasks.length === 0"
|
||||
description="没有带这个标签的任务"
|
||||
>
|
||||
<el-button type="success" plain @click="clearMarkerFilter">清除筛选</el-button>
|
||||
</el-empty>
|
||||
<el-empty
|
||||
v-if="!loading && loadFailed"
|
||||
description="复习数据加载失败,请稍后重试"
|
||||
@@ -287,6 +481,68 @@ onMounted(() => {
|
||||
</el-button>
|
||||
</template>
|
||||
</el-dialog>
|
||||
|
||||
<el-dialog v-model="sortDialogVisible" title="智能排序偏好" width="460px">
|
||||
<p class="sort-hint">
|
||||
决定复习内容出现的优先顺序。这是三档语义偏好,不是精确权重。
|
||||
</p>
|
||||
<el-radio-group v-model="sortPreset" class="sort-options">
|
||||
<el-radio
|
||||
v-for="option in sortPresetOptions"
|
||||
:key="option.value"
|
||||
:value="option.value"
|
||||
class="sort-option"
|
||||
>
|
||||
<span class="sort-option-label">{{ option.label }}</span>
|
||||
<span class="sort-option-hint">{{ option.hint }}</span>
|
||||
</el-radio>
|
||||
</el-radio-group>
|
||||
<p v-if="sortPreference?.description" class="sort-current">
|
||||
当前档位说明:{{ sortPreference.description }}
|
||||
</p>
|
||||
<template #footer>
|
||||
<el-button @click="sortDialogVisible = false">取消</el-button>
|
||||
<el-button type="success" :loading="savingSort" @click="confirmSort">保存</el-button>
|
||||
</template>
|
||||
</el-dialog>
|
||||
|
||||
<el-dialog v-model="tagDialogVisible" title="标签管理" width="520px">
|
||||
<p class="tag-hint">这些是你给学习内容打的标签。重命名会影响所有带该标签的内容。</p>
|
||||
<div v-loading="tagsLoading" class="tag-list">
|
||||
<div v-for="usage in tagUsages" :key="usage.markerName" class="tag-item">
|
||||
<template v-if="renamingTag === usage.markerName">
|
||||
<input
|
||||
v-model="renameDraft"
|
||||
class="tag-rename-input"
|
||||
aria-label="新标签名"
|
||||
@keydown.enter.prevent="confirmRenameTag"
|
||||
/>
|
||||
<div class="tag-actions">
|
||||
<el-button size="small" :disabled="tagBusy" @click="cancelRenameTag">取消</el-button>
|
||||
<el-button type="success" size="small" :loading="tagBusy" @click="confirmRenameTag">保存</el-button>
|
||||
</div>
|
||||
</template>
|
||||
<template v-else>
|
||||
<div class="tag-info">
|
||||
<span class="tag-name">{{ usage.markerName }}</span>
|
||||
<span class="tag-usage">{{ usage.objectCount }} 个内容 · {{ usage.markerCount }} 次使用</span>
|
||||
</div>
|
||||
<div class="tag-actions">
|
||||
<el-button size="small" @click="startRenameTag(usage)">重命名</el-button>
|
||||
<el-button type="danger" plain size="small" :disabled="tagBusy" @click="removeTag(usage)">删除</el-button>
|
||||
</div>
|
||||
</template>
|
||||
</div>
|
||||
<el-empty
|
||||
v-if="!tagsLoading && tagUsages.length === 0"
|
||||
description="还没有用过标签"
|
||||
:image-size="48"
|
||||
/>
|
||||
</div>
|
||||
<template #footer>
|
||||
<el-button type="primary" @click="tagDialogVisible = false">关闭</el-button>
|
||||
</template>
|
||||
</el-dialog>
|
||||
</section>
|
||||
</template>
|
||||
|
||||
@@ -470,6 +726,134 @@ onMounted(() => {
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.page-toolbar {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
flex-wrap: wrap;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.marker-filter-bar {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
font-size: 13px;
|
||||
color: var(--green-800);
|
||||
background: var(--accent-success-softer);
|
||||
border: 1px solid var(--accent-success-soft);
|
||||
border-radius: 8px;
|
||||
padding: 6px 12px;
|
||||
}
|
||||
|
||||
.task-card-markers {
|
||||
display: flex;
|
||||
}
|
||||
|
||||
.sort-hint {
|
||||
margin: 0 0 14px;
|
||||
font-size: 13px;
|
||||
color: var(--text-secondary);
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
.sort-options {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: stretch;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.sort-option {
|
||||
display: flex;
|
||||
align-items: flex-start;
|
||||
height: auto;
|
||||
padding: 8px 10px;
|
||||
border: 1px solid var(--border-soft);
|
||||
border-radius: 8px;
|
||||
margin-right: 0;
|
||||
}
|
||||
|
||||
.sort-option-label {
|
||||
font-weight: 600;
|
||||
color: var(--green-800);
|
||||
}
|
||||
|
||||
.sort-option-hint {
|
||||
margin-left: 8px;
|
||||
font-size: 12px;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.sort-current {
|
||||
margin: 14px 0 0;
|
||||
font-size: 12px;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.tag-hint {
|
||||
margin: 0 0 12px;
|
||||
font-size: 13px;
|
||||
color: var(--text-secondary);
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
.tag-list {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 8px;
|
||||
min-height: 60px;
|
||||
}
|
||||
|
||||
.tag-item {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
flex-wrap: wrap;
|
||||
gap: 8px;
|
||||
padding: 8px 12px;
|
||||
border: 1px solid var(--border-soft);
|
||||
border-radius: 8px;
|
||||
background: var(--surface-strong);
|
||||
}
|
||||
|
||||
.tag-info {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 2px;
|
||||
}
|
||||
|
||||
.tag-name {
|
||||
font-weight: 600;
|
||||
color: var(--green-800);
|
||||
}
|
||||
|
||||
.tag-usage {
|
||||
font-size: 12px;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.tag-actions {
|
||||
display: flex;
|
||||
gap: 6px;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.tag-rename-input {
|
||||
flex: 1;
|
||||
min-width: 120px;
|
||||
font-size: 13px;
|
||||
padding: 5px 8px;
|
||||
border: 1px solid var(--border-soft);
|
||||
border-radius: 6px;
|
||||
color: var(--text-primary);
|
||||
background: var(--surface-strong);
|
||||
}
|
||||
|
||||
.tag-rename-input:focus {
|
||||
outline: none;
|
||||
border-color: var(--green-600);
|
||||
}
|
||||
|
||||
@media (max-width: 900px) {
|
||||
.summary-grid {
|
||||
grid-template-columns: 1fr;
|
||||
|
||||
@@ -12,6 +12,8 @@ import {
|
||||
import type { RecallCompareParams } from "@/api/aiTasks";
|
||||
import { ElMessage, ElMessageBox } from "element-plus";
|
||||
import MindMapViewer, { type MindMapTreeNode } from "@/components/MindMapViewer.vue";
|
||||
import GuidanceDialog from "@/components/GuidanceDialog.vue";
|
||||
import { guidanceUnavailable } from "@/components/composables/useGuidance";
|
||||
import {
|
||||
isAiTaskCancelled,
|
||||
useAiTask,
|
||||
@@ -459,6 +461,15 @@ const handleNodeSelect = (node: { title: string; path: string; childCount: numbe
|
||||
focusConfirmVisible.value = true;
|
||||
};
|
||||
|
||||
// 学习引导入口:对选中的概忾与 AI 多轮对话
|
||||
const guidance = ref<{ visible: boolean; concept: string }>({ visible: false, concept: "" });
|
||||
|
||||
const openGuidanceForNode = () => {
|
||||
if (!selectedNodeInfo.value || guidanceUnavailable.value) return;
|
||||
focusConfirmVisible.value = false;
|
||||
guidance.value = { visible: true, concept: selectedNodeInfo.value.title };
|
||||
};
|
||||
|
||||
// 确认以选中节点为起点
|
||||
const confirmFocus = () => {
|
||||
if (selectedNodeInfo.value) {
|
||||
@@ -501,6 +512,11 @@ onMounted(() => {
|
||||
</p>
|
||||
<template #footer>
|
||||
<el-button @click="focusConfirmVisible = false">取消</el-button>
|
||||
<el-button
|
||||
:disabled="guidanceUnavailable"
|
||||
:title="guidanceUnavailable ? 'AI 暂时用不了,学习引导已停用' : '和 AI 一起把这个概念聊透'"
|
||||
@click="openGuidanceForNode"
|
||||
>学习引导</el-button>
|
||||
<el-button type="success" @click="confirmFocus">确定</el-button>
|
||||
</template>
|
||||
</el-dialog>
|
||||
@@ -711,6 +727,12 @@ onMounted(() => {
|
||||
</div>
|
||||
</article>
|
||||
</div>
|
||||
|
||||
<GuidanceDialog
|
||||
v-model="guidance.visible"
|
||||
:task-num="taskNum"
|
||||
:concept="guidance.concept"
|
||||
/>
|
||||
</section>
|
||||
</template>
|
||||
|
||||
|
||||
+238
-7
@@ -2,8 +2,20 @@
|
||||
import { computed, nextTick, onBeforeUnmount, onMounted, ref } from "vue";
|
||||
import { ElMessage } from "element-plus";
|
||||
import router from "@/router";
|
||||
import { getReviewFeed, getReviewTaskStats, getTaskReview, type ReviewFeedItem } from "@/api/review";
|
||||
import {
|
||||
getReviewFeed,
|
||||
getReviewTaskStats,
|
||||
getTaskReview,
|
||||
submitReviewFeedback,
|
||||
touchReviewFragment,
|
||||
type ReviewFeedItem,
|
||||
} from "@/api/review";
|
||||
import { updateFragmentOwnership } from "@/api/reportFragments";
|
||||
import type { Marker } from "@/api/markers";
|
||||
import { useMarkers } from "@/components/composables/useMarkers";
|
||||
import { guidanceUnavailable } from "@/components/composables/useGuidance";
|
||||
import MarkerChips from "@/components/MarkerChips.vue";
|
||||
import GuidanceDialog from "@/components/GuidanceDialog.vue";
|
||||
import {
|
||||
clampAutoScrollTime,
|
||||
measureAutoScroll,
|
||||
@@ -24,7 +36,13 @@ interface FragmentChip {
|
||||
contextNum: string | null;
|
||||
taskName: string | null;
|
||||
taskNum: string | null;
|
||||
/** 截断后的展示文本 */
|
||||
content: string;
|
||||
/** 摘要原文(≤200 字),学习引导的概念取它 */
|
||||
rawContent: string;
|
||||
/** 原文总长度与是否截断(复习-05) */
|
||||
contentLength: number;
|
||||
contentTruncated: boolean;
|
||||
/** 内容归属为空:需要在 Feed 卡片上就地归类 */
|
||||
pendingOwnership: boolean;
|
||||
}
|
||||
@@ -32,16 +50,36 @@ interface FragmentChip {
|
||||
const truncateContent = (content: string, maxLength = 120) =>
|
||||
content.length > maxLength ? content.substring(0, maxLength) + "..." : content;
|
||||
|
||||
// 标记:一页对象的标记一次取回;点用户标签做单一标记筛选
|
||||
const fragmentMarkers = useMarkers("FRAGMENT");
|
||||
const markerFilter = ref<{ markerName: string } | null>(null);
|
||||
const filteredFragmentIds = ref<Set<string> | null>(null);
|
||||
|
||||
// 反馈动作的本地回显:刷新后回到未选中,这是有意行为,不做任何状态展示
|
||||
const feedbackState = ref<Record<number, { mastered: boolean; revisit: boolean }>>({});
|
||||
const feedbackBusy = ref<Record<number, boolean>>({});
|
||||
|
||||
// 学习引导入口
|
||||
const guidance = ref<{ visible: boolean; taskNum: string; concept: string }>({
|
||||
visible: false,
|
||||
taskNum: "",
|
||||
concept: "",
|
||||
});
|
||||
|
||||
// 滚动条只展示学习残片,每条残片单独作为 chip
|
||||
const fragmentChips = computed<FragmentChip[]>(() =>
|
||||
reviewItems.value
|
||||
.filter(item => item.sourceType === "FRAGMENT")
|
||||
.filter(item => !filteredFragmentIds.value || filteredFragmentIds.value.has(String(item.id)))
|
||||
.map(item => ({
|
||||
id: item.id,
|
||||
contextNum: item.contextNum,
|
||||
taskName: item.taskName,
|
||||
taskNum: item.taskNum,
|
||||
content: truncateContent(item.content),
|
||||
rawContent: item.content,
|
||||
contentLength: item.contentLength,
|
||||
contentTruncated: item.contentTruncated,
|
||||
pendingOwnership: item.pendingOwnership,
|
||||
})),
|
||||
);
|
||||
@@ -101,6 +139,64 @@ const promoteToNewTask = () => {
|
||||
router.push({ name: "add-task", query: { promoteFragment: String(fragment.id) } });
|
||||
};
|
||||
|
||||
const refreshAutoScroll = async () => {
|
||||
await nextTick();
|
||||
startAutoScroll();
|
||||
};
|
||||
|
||||
/** 点标签即筛选(单一标记,不做多标记组合) */
|
||||
const applyMarkerFilter = async (marker: Marker) => {
|
||||
const ids = await fragmentMarkers.filterByTag(marker);
|
||||
filteredFragmentIds.value = ids;
|
||||
markerFilter.value = { markerName: marker.markerName };
|
||||
await refreshAutoScroll();
|
||||
};
|
||||
|
||||
const clearMarkerFilter = async () => {
|
||||
markerFilter.value = null;
|
||||
filteredFragmentIds.value = null;
|
||||
await refreshAutoScroll();
|
||||
};
|
||||
|
||||
const addChipTag = async (chip: FragmentChip, markerName: string) => {
|
||||
await fragmentMarkers.addTag(String(chip.id), markerName);
|
||||
};
|
||||
|
||||
const removeChipTag = async (chip: FragmentChip, marker: Marker) => {
|
||||
await fragmentMarkers.removeTag(String(chip.id), marker);
|
||||
};
|
||||
|
||||
/** 反馈动作的按钮态来自接口回显;不展示徽标、不统计、不做待复习列表 */
|
||||
const feedbackOf = (chip: FragmentChip) =>
|
||||
feedbackState.value[chip.id] || { mastered: false, revisit: false };
|
||||
|
||||
const toggleFeedback = async (chip: FragmentChip, action: "mastered" | "revisit") => {
|
||||
if (feedbackBusy.value[chip.id]) return;
|
||||
const current = feedbackOf(chip);
|
||||
const payload =
|
||||
action === "mastered" ? { mastered: !current.mastered } : { revisit: !current.revisit };
|
||||
feedbackBusy.value = { ...feedbackBusy.value, [chip.id]: true };
|
||||
try {
|
||||
const res = await submitReviewFeedback(chip.id, payload);
|
||||
const echoed = res?.data;
|
||||
if (echoed) {
|
||||
feedbackState.value = {
|
||||
...feedbackState.value,
|
||||
[chip.id]: { mastered: !!echoed.mastered, revisit: !!echoed.revisit },
|
||||
};
|
||||
}
|
||||
} catch {
|
||||
// 请求层已提示具体错误,这里不改变按钮态
|
||||
} finally {
|
||||
feedbackBusy.value = { ...feedbackBusy.value, [chip.id]: false };
|
||||
}
|
||||
};
|
||||
|
||||
const openGuidance = (chip: FragmentChip) => {
|
||||
if (!chip.taskNum || guidanceUnavailable.value) return;
|
||||
guidance.value = { visible: true, taskNum: chip.taskNum, concept: chip.rawContent || chip.content };
|
||||
};
|
||||
|
||||
// 复制多份实现无缝循环,份数按轨道宽度动态补足
|
||||
const duplicatedChips = computed(() =>
|
||||
Array.from({ length: repeatCount.value }, () => fragmentChips.value).flat(),
|
||||
@@ -110,6 +206,12 @@ const loadReviewFeed = async () => {
|
||||
try {
|
||||
const res = await getReviewFeed(100, "smart");
|
||||
reviewItems.value = res?.data || [];
|
||||
// 标记一次取回一页:与 Feed 同一批碎片
|
||||
await fragmentMarkers.load(
|
||||
reviewItems.value
|
||||
.filter(item => item.sourceType === "FRAGMENT")
|
||||
.map(item => String(item.id)),
|
||||
);
|
||||
} catch {
|
||||
// feed 加载失败不影响页面主体功能
|
||||
} finally {
|
||||
@@ -139,6 +241,10 @@ const recallCard = ref<{
|
||||
});
|
||||
|
||||
const openRecallCard = (fragment: FragmentChip) => {
|
||||
// 展开查看即记录一次「接触」,刷新最近接触时间(参与智能排序)
|
||||
touchReviewFragment(fragment.id).catch(() => {
|
||||
// 接触时间记录失败不影响查看
|
||||
});
|
||||
recallCard.value = {
|
||||
visible: true,
|
||||
fragment,
|
||||
@@ -347,6 +453,10 @@ onBeforeUnmount(() => {
|
||||
<section class="welcome-page">
|
||||
<div class="review-scroll-section surface-card">
|
||||
<div class="review-scroll-header">
|
||||
<div v-if="markerFilter" class="marker-filter-bar">
|
||||
<span>正在按标签「{{ markerFilter.markerName }}」筛选</span>
|
||||
<el-button size="small" text type="success" @click="clearMarkerFilter">清除筛选</el-button>
|
||||
</div>
|
||||
<el-tooltip
|
||||
effect="dark"
|
||||
placement="left"
|
||||
@@ -379,9 +489,43 @@ onBeforeUnmount(() => {
|
||||
class="review-chip fragment-chip"
|
||||
@click="handleChipClick(chip, $event)"
|
||||
>
|
||||
<strong v-if="chip.taskName" class="chip-task">{{ chip.taskName }}</strong>
|
||||
<span v-if="chip.pendingOwnership" class="chip-pending">待归类</span>
|
||||
<span class="chip-content">{{ chip.content }}</span>
|
||||
<span class="chip-main">
|
||||
<strong v-if="chip.taskName" class="chip-task">{{ chip.taskName }}</strong>
|
||||
<span v-if="chip.pendingOwnership" class="chip-pending">待归类</span>
|
||||
<span class="chip-content">{{ chip.content }}</span>
|
||||
</span>
|
||||
<span class="chip-markers" @click.stop>
|
||||
<MarkerChips
|
||||
:markers="fragmentMarkers.markersOf(String(chip.id))"
|
||||
@add="name => addChipTag(chip, name)"
|
||||
@remove="marker => removeChipTag(chip, marker)"
|
||||
@filter="marker => applyMarkerFilter(marker)"
|
||||
/>
|
||||
</span>
|
||||
<span class="chip-actions" @click.stop>
|
||||
<button
|
||||
type="button"
|
||||
class="chip-action"
|
||||
:class="{ 'is-active': feedbackOf(chip).mastered }"
|
||||
:disabled="feedbackBusy[chip.id]"
|
||||
@click="toggleFeedback(chip, 'mastered')"
|
||||
>已掌握</button>
|
||||
<button
|
||||
type="button"
|
||||
class="chip-action"
|
||||
:class="{ 'is-active': feedbackOf(chip).revisit }"
|
||||
:disabled="feedbackBusy[chip.id]"
|
||||
@click="toggleFeedback(chip, 'revisit')"
|
||||
>稍后再看</button>
|
||||
<button
|
||||
v-if="chip.taskNum"
|
||||
type="button"
|
||||
class="chip-action chip-action-guidance"
|
||||
:disabled="guidanceUnavailable"
|
||||
:title="guidanceUnavailable ? 'AI 暂时用不了,学习引导已停用' : '和 AI 一起把这个概念聊透'"
|
||||
@click="openGuidance(chip)"
|
||||
>学习引导</button>
|
||||
</span>
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
@@ -415,6 +559,9 @@ onBeforeUnmount(() => {
|
||||
<el-dialog v-model="classify.visible" title="归类这条学习残片" width="520px">
|
||||
<template v-if="classify.fragment">
|
||||
<blockquote class="classify-snippet">{{ classify.fragment.content }}</blockquote>
|
||||
<p v-if="classify.fragment.contentTruncated" class="classify-full-hint">
|
||||
这里只是摘要,全文 {{ classify.fragment.contentLength }} 字,展开详情可看全文。
|
||||
</p>
|
||||
<p class="classify-hint">
|
||||
这条内容还没有归属任务。选它属于哪个学习任务,或把它升格成一个新任务。
|
||||
</p>
|
||||
@@ -463,6 +610,9 @@ onBeforeUnmount(() => {
|
||||
看着下面这个残片,先试着回忆:当时还学了什么?
|
||||
</p>
|
||||
<blockquote class="recall-snippet">{{ recallCard.fragment.content }}</blockquote>
|
||||
<p v-if="recallCard.fragment.contentTruncated" class="recall-full-hint">
|
||||
这里只是摘要,全文 {{ recallCard.fragment.contentLength }} 字,展开详情可看全文。
|
||||
</p>
|
||||
<p v-if="recallCard.loadError" class="recall-error">{{ recallCard.loadError }}</p>
|
||||
|
||||
<div v-if="recallCard.revealed" class="recall-full-list">
|
||||
@@ -503,6 +653,13 @@ onBeforeUnmount(() => {
|
||||
</template>
|
||||
</template>
|
||||
</el-dialog>
|
||||
|
||||
<GuidanceDialog
|
||||
v-model="guidance.visible"
|
||||
:task-num="guidance.taskNum"
|
||||
:concept="guidance.concept"
|
||||
@created="loadReviewFeed"
|
||||
/>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
@@ -557,10 +714,25 @@ onBeforeUnmount(() => {
|
||||
|
||||
.review-scroll-header {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
flex-wrap: wrap;
|
||||
gap: 8px 12px;
|
||||
margin-bottom: 10px;
|
||||
}
|
||||
|
||||
.marker-filter-bar {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
font-size: 13px;
|
||||
color: var(--green-800);
|
||||
background: var(--accent-success-softer);
|
||||
border: 1px solid var(--accent-success-soft);
|
||||
border-radius: 8px;
|
||||
padding: 2px 8px;
|
||||
}
|
||||
|
||||
.color-legend {
|
||||
font-size: 12px;
|
||||
color: var(--text-secondary);
|
||||
@@ -599,8 +771,9 @@ onBeforeUnmount(() => {
|
||||
|
||||
.review-chip {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
flex-direction: column;
|
||||
align-items: flex-start;
|
||||
gap: 6px;
|
||||
padding: 8px 16px;
|
||||
background: var(--surface-strong);
|
||||
border: 1px solid var(--border-soft);
|
||||
@@ -611,6 +784,52 @@ onBeforeUnmount(() => {
|
||||
user-select: none;
|
||||
}
|
||||
|
||||
.chip-main {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
.chip-markers,
|
||||
.chip-actions {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.chip-action {
|
||||
border: 1px solid var(--border-soft);
|
||||
background: transparent;
|
||||
color: var(--text-secondary);
|
||||
font-size: 12px;
|
||||
border-radius: 10px;
|
||||
padding: 1px 9px;
|
||||
cursor: pointer;
|
||||
transition: background 0.15s, color 0.15s, border-color 0.15s;
|
||||
}
|
||||
|
||||
.chip-action:hover:not(:disabled) {
|
||||
border-color: var(--green-600);
|
||||
color: var(--green-700);
|
||||
}
|
||||
|
||||
.chip-action.is-active {
|
||||
background: var(--accent-success-soft);
|
||||
border-color: var(--green-600);
|
||||
color: var(--green-700);
|
||||
}
|
||||
|
||||
.chip-action:disabled {
|
||||
cursor: not-allowed;
|
||||
opacity: 0.55;
|
||||
}
|
||||
|
||||
.chip-action-guidance {
|
||||
color: var(--green-700);
|
||||
border-color: var(--green-600);
|
||||
}
|
||||
|
||||
.review-chip:hover {
|
||||
box-shadow: var(--shadow-soft);
|
||||
background: var(--accent-success-softer);
|
||||
@@ -653,6 +872,12 @@ onBeforeUnmount(() => {
|
||||
white-space: normal;
|
||||
}
|
||||
|
||||
.classify-full-hint {
|
||||
margin: -6px 0 12px;
|
||||
font-size: 12px;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.classify-hint {
|
||||
margin: 0 0 12px;
|
||||
font-size: 13px;
|
||||
@@ -696,6 +921,12 @@ onBeforeUnmount(() => {
|
||||
white-space: normal;
|
||||
}
|
||||
|
||||
.recall-full-hint {
|
||||
margin: -6px 0 12px;
|
||||
font-size: 12px;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.recall-error {
|
||||
margin: 0 0 10px;
|
||||
color: var(--el-color-danger, #f56c6c);
|
||||
|
||||
@@ -123,6 +123,16 @@ export function useAiTask() {
|
||||
}
|
||||
};
|
||||
|
||||
/** 轮询一个已经提交的任务(如学习引导每轮对话),返回 SUCCEEDED 的 result */
|
||||
const poll = async (aiTaskNum: string): Promise<AiTaskResult> => {
|
||||
const token = startTracking();
|
||||
try {
|
||||
return await pollUntilDone(aiTaskNum);
|
||||
} finally {
|
||||
stopTracking(token);
|
||||
}
|
||||
};
|
||||
|
||||
/** 恢复进行中的任务:找到就继续轮询,没找到返回 found=false */
|
||||
const resume = async (type: AiTaskType, targetNum: string): Promise<AiTaskRestore> => {
|
||||
const res = await getLatestAiTask(type, targetNum);
|
||||
@@ -133,5 +143,5 @@ export function useAiTask() {
|
||||
return { found: true, done };
|
||||
};
|
||||
|
||||
return { seconds, running, run, resume, stop };
|
||||
return { seconds, running, run, resume, poll, stop };
|
||||
}
|
||||
|
||||
@@ -0,0 +1,237 @@
|
||||
// src/components/composables/useGuidance.ts
|
||||
import { ref } from "vue";
|
||||
import {
|
||||
abandonGuidance,
|
||||
createGuidanceFragment,
|
||||
getGuidanceSession,
|
||||
startGuidance,
|
||||
submitGuidanceTurn,
|
||||
type GuidanceSession,
|
||||
type GuidanceTurn,
|
||||
} from "@/api/guidance";
|
||||
import { useAiTask } from "./useAiTask";
|
||||
import { useReviewDuration } from "./useReviewDuration";
|
||||
|
||||
/**
|
||||
* 学习引导可用性:没有探测接口,一旦「首次提交失败 / AI 任务失败」就把入口整体置为不可用。
|
||||
* 这是模块级状态,只影响引导本身,不牵连复习其他部分;刷新页面即复位。
|
||||
*/
|
||||
export const guidanceUnavailable = ref(false);
|
||||
|
||||
export const markGuidanceUnavailable = () => {
|
||||
guidanceUnavailable.value = true;
|
||||
};
|
||||
|
||||
/** 供测试复位模块级状态 */
|
||||
export const resetGuidanceAvailability = () => {
|
||||
guidanceUnavailable.value = false;
|
||||
};
|
||||
|
||||
/** 从异常里取用户可见文案 */
|
||||
const errorMessageOf = (error: unknown, fallback: string): string => {
|
||||
if (error instanceof Error && error.message) return error.message;
|
||||
if (error && typeof error === "object" && "message" in error) {
|
||||
const message = (error as { message?: unknown }).message;
|
||||
if (typeof message === "string" && message.trim()) return message;
|
||||
}
|
||||
return fallback;
|
||||
};
|
||||
|
||||
const parseTurns = (payload: string): GuidanceTurn[] => {
|
||||
try {
|
||||
const parsed = JSON.parse(payload);
|
||||
if (!Array.isArray(parsed)) return [];
|
||||
return parsed
|
||||
.filter((item): item is GuidanceTurn =>
|
||||
!!item && typeof item === "object" &&
|
||||
(item.role === "user" || item.role === "assistant") &&
|
||||
typeof item.content === "string",
|
||||
)
|
||||
.map((item) => ({ role: item.role, content: item.content }));
|
||||
} catch {
|
||||
return [];
|
||||
}
|
||||
};
|
||||
|
||||
const storageKey = (taskNum: string, concept: string) => `lpt-guidance:${taskNum}:${concept}`;
|
||||
|
||||
/**
|
||||
* 一次学习引导会话的状态机:开启/恢复对话、多轮问答、确认产出碎片、放弃。
|
||||
* 对话上下文一律以后端会话为准;AI 每轮的回复通过轮询 AI 任务获取。
|
||||
*/
|
||||
export function useGuidanceSession() {
|
||||
const session = ref<GuidanceSession | null>(null);
|
||||
const turns = ref<GuidanceTurn[]>([]);
|
||||
const starting = ref(false);
|
||||
const sending = ref(false);
|
||||
const error = ref("");
|
||||
const aiTask = useAiTask();
|
||||
const { seconds: waitingSeconds, running: waiting } = aiTask;
|
||||
const { start: startDuration, markInteraction, snapshot, stop: stopDuration } = useReviewDuration();
|
||||
|
||||
const unavailable = guidanceUnavailable;
|
||||
|
||||
/** 轮询本轮 AI 任务,取出回复文本 */
|
||||
const pollReply = async (aiTaskNum: string): Promise<string> => {
|
||||
const result = await aiTask.poll(aiTaskNum);
|
||||
const reply = result?.reply;
|
||||
if (typeof reply !== "string" || !reply.trim()) {
|
||||
throw new Error("AI 这次没有给出回应,请稍后再试");
|
||||
}
|
||||
return reply;
|
||||
};
|
||||
|
||||
const clearStorage = (taskNum: string, concept: string) => {
|
||||
localStorage.removeItem(storageKey(taskNum, concept));
|
||||
};
|
||||
|
||||
const reset = () => {
|
||||
session.value = null;
|
||||
turns.value = [];
|
||||
starting.value = false;
|
||||
sending.value = false;
|
||||
error.value = "";
|
||||
};
|
||||
|
||||
/** 打开引导:优先恢复未结束的会话,否则新开一次 */
|
||||
const open = async (taskNum: string, concept: string) => {
|
||||
reset();
|
||||
if (!taskNum || !concept) {
|
||||
error.value = "这条内容还没有归属任务,暂时不能做学习引导";
|
||||
return;
|
||||
}
|
||||
|
||||
// 离开页面再回来:用本地记下的编号恢复同一段对话
|
||||
const stored = localStorage.getItem(storageKey(taskNum, concept));
|
||||
if (stored) {
|
||||
try {
|
||||
const res = await getGuidanceSession(stored);
|
||||
const restored = res?.data;
|
||||
if (restored && !restored.finished) {
|
||||
session.value = restored;
|
||||
turns.value = parseTurns(restored.turnsPayload);
|
||||
startDuration();
|
||||
return;
|
||||
}
|
||||
clearStorage(taskNum, concept);
|
||||
} catch {
|
||||
clearStorage(taskNum, concept);
|
||||
}
|
||||
}
|
||||
|
||||
if (unavailable.value) {
|
||||
error.value = "学习引导暂时用不了,可以先继续复习,等 AI 恢复后再来。";
|
||||
return;
|
||||
}
|
||||
|
||||
starting.value = true;
|
||||
try {
|
||||
const res = await startGuidance(taskNum, concept);
|
||||
const data = res?.data;
|
||||
if (!data?.guidanceNum || !data.aiTaskNum) {
|
||||
throw new Error("学习引导没开起来,请稍后再试");
|
||||
}
|
||||
session.value = {
|
||||
guidanceNum: data.guidanceNum,
|
||||
taskNum: data.taskNum,
|
||||
concept: data.concept,
|
||||
turnsPayload: "[]",
|
||||
reviewDurationSeconds: 0,
|
||||
finished: false,
|
||||
};
|
||||
localStorage.setItem(storageKey(taskNum, concept), data.guidanceNum);
|
||||
startDuration();
|
||||
const reply = await pollReply(data.aiTaskNum);
|
||||
turns.value = [{ role: "assistant", content: reply }];
|
||||
} catch (e) {
|
||||
markGuidanceUnavailable();
|
||||
error.value = errorMessageOf(e, "学习引导暂时用不了,可以先继续复习,等 AI 恢复后再来。");
|
||||
} finally {
|
||||
starting.value = false;
|
||||
}
|
||||
};
|
||||
|
||||
/** 发送一轮:先回显用户输入,再轮询 AI 回复 */
|
||||
const send = async (message: string): Promise<boolean> => {
|
||||
const text = message.trim();
|
||||
if (!session.value || !text || sending.value || waiting.value || unavailable.value) return false;
|
||||
sending.value = true;
|
||||
error.value = "";
|
||||
markInteraction();
|
||||
turns.value = [...turns.value, { role: "user", content: text }];
|
||||
try {
|
||||
const res = await submitGuidanceTurn(session.value.guidanceNum, text);
|
||||
const aiTaskNum = res?.data?.taskNum;
|
||||
if (!aiTaskNum) throw new Error("这一轮没有提交成功,请稍后再试");
|
||||
const reply = await pollReply(aiTaskNum);
|
||||
turns.value = [...turns.value, { role: "assistant", content: reply }];
|
||||
return true;
|
||||
} catch (e) {
|
||||
markGuidanceUnavailable();
|
||||
error.value = errorMessageOf(e, "AI 暂时没有回应,学习引导已停用,可以先继续复习。");
|
||||
return false;
|
||||
} finally {
|
||||
sending.value = false;
|
||||
}
|
||||
};
|
||||
|
||||
/** 确认产出碎片;耗时快照与回忆对比同一口径 */
|
||||
const confirmFragment = async (content: string): Promise<boolean> => {
|
||||
const text = content.trim();
|
||||
if (!session.value || session.value.finished || !text) return false;
|
||||
const timing = snapshot();
|
||||
markInteraction();
|
||||
try {
|
||||
const res = await createGuidanceFragment(session.value.guidanceNum, {
|
||||
content: text,
|
||||
reviewStartedAt: timing.startedAt,
|
||||
reviewLastInteractionAt: timing.lastInteractionAt,
|
||||
reviewDurationSeconds: timing.durationSeconds,
|
||||
});
|
||||
if (res?.code === 200) {
|
||||
session.value = { ...session.value, finished: true };
|
||||
clearStorage(session.value.taskNum, session.value.concept);
|
||||
stopDuration();
|
||||
return true;
|
||||
}
|
||||
error.value = "这条收获没能记下来,请稍后再试";
|
||||
return false;
|
||||
} catch (e) {
|
||||
error.value = errorMessageOf(e, "这条收获没能记下来,请稍后再试");
|
||||
return false;
|
||||
}
|
||||
};
|
||||
|
||||
/** 放弃这次引导:不产出任何数据 */
|
||||
const abandon = async (): Promise<void> => {
|
||||
const current = session.value;
|
||||
if (!current) return;
|
||||
if (!current.finished) {
|
||||
try {
|
||||
await abandonGuidance(current.guidanceNum);
|
||||
} catch {
|
||||
// 放弃失败也不该拦住用户,本地照常收尾
|
||||
}
|
||||
}
|
||||
clearStorage(current.taskNum, current.concept);
|
||||
stopDuration();
|
||||
session.value = { ...current, finished: true };
|
||||
};
|
||||
|
||||
return {
|
||||
session,
|
||||
turns,
|
||||
starting,
|
||||
sending,
|
||||
waiting,
|
||||
waitingSeconds,
|
||||
error,
|
||||
unavailable,
|
||||
open,
|
||||
send,
|
||||
confirmFragment,
|
||||
abandon,
|
||||
markInteraction,
|
||||
reset,
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,125 @@
|
||||
// src/components/composables/useMarkers.ts
|
||||
import { ref } from "vue";
|
||||
import {
|
||||
addUserTag,
|
||||
deleteMarker,
|
||||
filterByMarker,
|
||||
getMarkersBatch,
|
||||
type Marker,
|
||||
type MarkerObjectType,
|
||||
} from "@/api/markers";
|
||||
|
||||
/**
|
||||
* 某个对象类型下的标记板:批量取回一页对象的标记,并就地增删用户标签。
|
||||
* 系统标记只读,弹筛选用的是用户标签。
|
||||
*/
|
||||
export function useMarkers(objectType: MarkerObjectType) {
|
||||
const markersByObject = ref<Record<string, Marker[]>>({});
|
||||
|
||||
/** 批量取回;失败时按「没有标记」处理,不阻塞列表主体 */
|
||||
const load = async (objectNums: string[]) => {
|
||||
const unique = [...new Set(objectNums.filter(Boolean))];
|
||||
if (unique.length === 0) {
|
||||
markersByObject.value = {};
|
||||
return;
|
||||
}
|
||||
try {
|
||||
const res = await getMarkersBatch(objectType, unique);
|
||||
markersByObject.value = res?.data || {};
|
||||
} catch {
|
||||
markersByObject.value = {};
|
||||
}
|
||||
};
|
||||
|
||||
const markersOf = (objectNum: string): Marker[] => markersByObject.value[objectNum] || [];
|
||||
|
||||
const addTag = async (objectNum: string, markerName: string): Promise<boolean> => {
|
||||
const name = markerName.trim();
|
||||
if (!name) return false;
|
||||
try {
|
||||
const res = await addUserTag(objectType, objectNum, name);
|
||||
const created = res?.data;
|
||||
if (res?.code === 200 && created) {
|
||||
const existing = markersByObject.value[objectNum] || [];
|
||||
if (!existing.some((marker) => marker.kind === "USER" && marker.markerName === created.markerName)) {
|
||||
markersByObject.value = { ...markersByObject.value, [objectNum]: [...existing, created] };
|
||||
}
|
||||
return true;
|
||||
}
|
||||
} catch {
|
||||
// 请求层已提示具体错误
|
||||
}
|
||||
return false;
|
||||
};
|
||||
|
||||
const removeTag = async (objectNum: string, marker: Marker): Promise<boolean> => {
|
||||
try {
|
||||
const res = await deleteMarker(marker.id);
|
||||
if (res?.code === 200) {
|
||||
markersByObject.value = {
|
||||
...markersByObject.value,
|
||||
[objectNum]: (markersByObject.value[objectNum] || []).filter((item) => item.id !== marker.id),
|
||||
};
|
||||
return true;
|
||||
}
|
||||
} catch {
|
||||
// 请求层已提示具体错误
|
||||
}
|
||||
return false;
|
||||
};
|
||||
|
||||
/** 点标签即筛选:返回带该用户标签的对象标识集合 */
|
||||
const filterByTag = async (marker: Marker): Promise<Set<string>> => {
|
||||
const res = await filterByMarker({
|
||||
objectType,
|
||||
markerName: marker.markerName,
|
||||
kind: "USER",
|
||||
});
|
||||
return new Set(res?.data || []);
|
||||
};
|
||||
|
||||
return { markersByObject, load, markersOf, addTag, removeTag, filterByTag };
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除一个用户标签(影响所有带该标签的对象)。
|
||||
* 后端只提供按标记 id 删除,因此先按标签名筛出对象,再逐条取回 id 删除。
|
||||
*/
|
||||
export const deleteUserTagEverywhere = async (markerName: string): Promise<number> => {
|
||||
const objectTypes: MarkerObjectType[] = ["FRAGMENT", "TASK"];
|
||||
const markerIds: number[] = [];
|
||||
|
||||
for (const objectType of objectTypes) {
|
||||
let objectNums: string[] = [];
|
||||
try {
|
||||
const res = await filterByMarker({ objectType, markerName, kind: "USER" });
|
||||
objectNums = res?.data || [];
|
||||
} catch {
|
||||
continue;
|
||||
}
|
||||
if (objectNums.length === 0) continue;
|
||||
try {
|
||||
const batch = await getMarkersBatch(objectType, objectNums);
|
||||
for (const list of Object.values(batch?.data || {})) {
|
||||
for (const marker of list) {
|
||||
if (marker.kind === "USER" && marker.markerName === markerName) {
|
||||
markerIds.push(marker.id);
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// 跳过该对象类型,尽量删掉其余
|
||||
}
|
||||
}
|
||||
|
||||
let removed = 0;
|
||||
for (const id of markerIds) {
|
||||
try {
|
||||
await deleteMarker(id);
|
||||
removed += 1;
|
||||
} catch {
|
||||
// 单条失败不影响其余
|
||||
}
|
||||
}
|
||||
return removed;
|
||||
};
|
||||
Reference in New Issue
Block a user