From 9ef7af0dd14ea6053fd60e34f525280c8c6b909f Mon Sep 17 00:00:00 2001
From: liyy <18435186204@163.com>
Date: Tue, 1 Sep 2026 14:59:35 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=E9=A2=98=E5=BA=93?=
 =?UTF-8?q?=E7=AE=A1=E7=90=86=E9=A1=B5=E9=9D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 client/src/api/index.ts                      |    6 +
 client/src/views/questions/QuestionsView.vue | 1143 +++++++++++++++++-
 docs/checks/task-07.md                       |   93 ++
 server/src/errors.ts                         |    4 +
 server/src/handlers/news.ts                  |    1 -
 server/src/handlers/questions.ts             |  119 +-
 server/src/routes.ts                         |    6 +
 server/src/schemas/api.ts                    |    6 +
 server/src/server.ts                         |   11 +
 9 files changed, 1381 insertions(+), 8 deletions(-)
 create mode 100644 docs/checks/task-07.md

diff --git a/client/src/api/index.ts b/client/src/api/index.ts
index bf49d01..42e21df 100644
--- a/client/src/api/index.ts
+++ b/client/src/api/index.ts
@@ -40,6 +40,11 @@ export type PlanReview = SuccessBody<paths['/api/plans/review']['get']>
 export type StudyPlanItem = SuccessBody<paths['/api/plans/today']['get']>['tasks'][number]
 export type NewsItem = SuccessBody<paths['/api/news/list']['get']>['items'][number]
 export type ImportResult = SuccessBody<paths['/api/news/import/json']['post']>
+export type QuestionListItem = SuccessBody<paths['/api/questions/list']['get']>['items'][number]
+export type QuestionListPage = SuccessBody<paths['/api/questions/list']['get']>
+export type QuestionImportBody = BodyOf<'/api/questions/import', 'post'>
+export type QuestionExport = SuccessBody<paths['/api/questions/export']['get']>
+export type QuestionRefs = SuccessBody<paths['/api/questions/{id}/refs']['get']>
 
 // ---- 数据中枢 ----
 export const dashboardApi = {
@@ -123,6 +128,7 @@ export const questionsApi = {
   importQuestions: (body: BodyOf<'/api/questions/import', 'post'>) =>
     unwrap(apiClient.POST('/api/questions/import', { body })),
   exportQuestions: () => unwrap(apiClient.GET('/api/questions/export')),
+  refs: (id: string) => unwrap(apiClient.GET('/api/questions/{id}/refs', { params: { path: { id } } })),
   remove: (id: string) => unwrap(apiClient.DELETE('/api/questions/{id}', { params: { path: { id } } }))
 }
 
diff --git a/client/src/views/questions/QuestionsView.vue b/client/src/views/questions/QuestionsView.vue
index 553e1ca..4b077a4 100644
--- a/client/src/views/questions/QuestionsView.vue
+++ b/client/src/views/questions/QuestionsView.vue
@@ -1,7 +1,1146 @@
 <script setup lang="ts">
-import ComingSoon from '../../components/feedback/ComingSoon.vue'
+import { computed, reactive, ref, watch } from 'vue'
+import { questionsApi, ApiError } from '../../api'
+import type { QuestionListItem, QuestionListPage, QuestionImportBody, QuestionRefs } from '../../api'
+import { useRequest } from '../../composables/useRequest'
+import { useResponsive } from '../../composables/useResponsive'
+import { useAppStore } from '../../stores/app'
+import { formatDateShort } from '../../utils/format'
+import AppCard from '../../components/base/AppCard.vue'
+import AppButton from '../../components/base/AppButton.vue'
+import AppIcon from '../../components/base/AppIcon.vue'
+import AppModal from '../../components/base/AppModal.vue'
+import AppPageHeader from '../../components/base/AppPageHeader.vue'
+import AppBadge from '../../components/base/AppBadge.vue'
+import AppLoading from '../../components/feedback/AppLoading.vue'
+import AppError from '../../components/feedback/AppError.vue'
+import AppEmpty from '../../components/feedback/AppEmpty.vue'
+
+const { isMobile } = useResponsive()
+const app = useAppStore()
+
+const MODULES = ['言语理解', '数量关系', '判断推理', '资料分析', '常识判断'] as const
+const DIFFICULTIES = ['简单', '中等', '困难'] as const
+const OPTION_KEYS = ['A', 'B', 'C', 'D'] as const
+type Module = (typeof MODULES)[number]
+type Difficulty = (typeof DIFFICULTIES)[number]
+type OptionKey = (typeof OPTION_KEYS)[number]
+const PAGE_SIZE = 10
+
+// ---- 页面模式：列表 / 手动录入 ----
+const mode = ref<'list' | 'entry'>('list')
+
+// =========================
+// 列表 + 筛选 + 导入 + 导出 + 删除
+// =========================
+const filters = reactive<{ module: Module | ''; difficulty: Difficulty | ''; keyword: string }>({
+  module: '',
+  difficulty: '',
+  keyword: ''
+})
+const page = ref(1)
+
+const list = useRequest<QuestionListPage>(() =>
+  questionsApi.list({
+    page: page.value,
+    pageSize: PAGE_SIZE,
+    module: filters.module || undefined,
+    difficulty: filters.difficulty || undefined,
+    keyword: filters.keyword.trim() || undefined
+  })
+)
+const items = computed(() => list.data.value?.items ?? [])
+const total = computed(() => list.data.value?.total ?? 0)
+const totalPages = computed(() => Math.max(1, Math.ceil(total.value / PAGE_SIZE)))
+
+let searchTimer: ReturnType<typeof setTimeout> | undefined
+watch(
+  () => filters.keyword,
+  () => {
+    clearTimeout(searchTimer)
+    searchTimer = setTimeout(() => {
+      page.value = 1
+      list.refresh()
+    }, 300)
+  }
+)
+watch(
+  () => [filters.module, filters.difficulty],
+  () => {
+    page.value = 1
+    list.refresh()
+  }
+)
+
+function goPage(p: number) {
+  if (p < 1 || p > totalPages.value || p === page.value) return
+  page.value = p
+  list.refresh()
+}
+
+function resetFilters() {
+  filters.module = ''
+  filters.difficulty = ''
+  filters.keyword = ''
+  page.value = 1
+  list.refresh()
+}
+
+const diffTone = (d: string) => (d === '困难' ? 'danger' : d === '中等' ? 'warning' : 'success')
+
+// ---- 导入弹层 ----
+const showImport = ref(false)
+const importText = ref('')
+const importResult = ref<{ total: number; success: number; skipped: number; failed: number; errors: { index: number; message: string }[] } | null>(null)
+const importing = ref(false)
+
+function openImport() {
+  importText.value = ''
+  importResult.value = null
+  showImport.value = true
+}
+
+async function doImport() {
+  if (!importText.value.trim()) {
+    app.toast('请粘贴 JSON 内容', 'error')
+    return
+  }
+  let parsed: { questions?: unknown[] }
+  try {
+    parsed = JSON.parse(importText.value)
+  } catch {
+    app.toast('JSON 解析失败，请检查格式', 'error')
+    return
+  }
+  if (!Array.isArray(parsed.questions)) {
+    app.toast('JSON 缺少 questions 数组字段', 'error')
+    return
+  }
+  importing.value = true
+  try {
+    const result = await questionsApi.importQuestions({
+      version: '1.0',
+      questions: parsed.questions as QuestionImportBody['questions']
+    })
+    importResult.value = result
+    app.toast(
+      `导入完成：成功 ${result.success} · 跳过 ${result.skipped} · 失败 ${result.failed}`,
+      result.failed > 0 ? 'error' : 'success'
+    )
+    list.refresh()
+  } catch (err) {
+    app.toast(err instanceof Error ? err.message : '导入失败', 'error')
+  } finally {
+    importing.value = false
+  }
+}
+
+// ---- 导出 ----
+const exporting = ref(false)
+async function doExport() {
+  exporting.value = true
+  try {
+    const data = await questionsApi.exportQuestions()
+    const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' })
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `题库导出-${new Date().toISOString().slice(0, 10)}.json`
+    document.body.appendChild(a)
+    a.click()
+    a.remove()
+    URL.revokeObjectURL(url)
+    app.toast(`已导出 ${data.questions.length} 道题目`, 'success')
+  } catch (err) {
+    app.toast(err instanceof Error ? err.message : '导出失败', 'error')
+  } finally {
+    exporting.value = false
+  }
+}
+
+// ---- 删除确认 ----
+const removing = ref<QuestionListItem | null>(null)
+const deleting = ref(false)
+const refsInfo = ref<QuestionRefs | null>(null)
+const refsLoading = ref(false)
+
+/** 打开删除弹层时，预检该题引用情况，提前提示是否会被拦截 */
+async function openRemove(q: QuestionListItem) {
+  removing.value = q
+  refsInfo.value = null
+  refsLoading.value = true
+  try {
+    refsInfo.value = await questionsApi.refs(q.id)
+  } catch {
+    refsInfo.value = null
+  } finally {
+    refsLoading.value = false
+  }
+}
+
+async function confirmRemove() {
+  if (!removing.value) return
+  deleting.value = true
+  try {
+    await questionsApi.remove(removing.value.id)
+    app.toast('题目已删除', 'success')
+    removing.value = null
+    if (items.value.length === 1 && page.value > 1) page.value -= 1
+    list.refresh()
+  } catch (err) {
+    if (err instanceof ApiError && err.code === 'CONFLICT') {
+      app.toast(err.message, 'error')
+      removing.value = null
+    } else {
+      app.toast(err instanceof Error ? err.message : '删除失败', 'error')
+    }
+  } finally {
+    deleting.value = false
+  }
+}
+
+const hasFilter = computed(() => filters.module || filters.difficulty || filters.keyword.trim())
+
+// =========================
+// 手动录入（左表单 + 右实时预览）
+// =========================
+const QUESTION_TYPES = [{ value: '单选', label: '单选题' }, { value: '多选', label: '多选题' }, { value: '判断', label: '判断题' }] as const
+
+interface OptionRow {
+  key: OptionKey
+  text: string
+}
+
+function blankForm() {
+  return {
+    questionType: '单选' as string,
+    module: '' as Module | '',
+    subModule: '',
+    difficulty: '中等' as Difficulty,
+    stem: '',
+    options: [
+      { key: 'A' as OptionKey, text: '' },
+      { key: 'B' as OptionKey, text: '' },
+      { key: 'C' as OptionKey, text: '' },
+      { key: 'D' as OptionKey, text: '' }
+    ] as OptionRow[],
+    answer: '' as OptionKey | '',
+    analysis: '',
+    source: '手动录入'
+  }
+}
+
+const form = reactive(blankForm())
+const saving = ref(false)
+
+function switchType(t: string) {
+  if (t !== '单选') {
+    app.toast('当前版本仅支持单选题录入，已保留单选题', 'info')
+    return
+  }
+  form.questionType = t
+}
+
+function resetForm() {
+  Object.assign(form, blankForm())
+}
+
+// 实时预览：任一字段变化即触发
+const livePreview = computed(() => {
+  const filledOptions = form.options
+    .filter((o) => o.text.trim())
+    .map((o) => ({ key: o.key, text: o.text.trim() }))
+  return {
+    module: form.module as Module | '',
+    difficulty: form.difficulty,
+    stem: form.stem.trim(),
+    options: filledOptions,
+    answer: form.answer,
+    analysis: form.analysis.trim()
+  }
+})
+
+const previewOptions = computed(() => {
+  const base = livePreview.value.options
+  if (base.length > 0) return base
+  return form.options.map((o) => ({ key: o.key, text: o.text.trim() }))
+})
+
+function previewText() {
+  return livePreview.value.stem || '题干将在这里实时预览…'
+}
+
+async function saveQuestion() {
+  if (!livePreview.value.module) {
+    app.toast('请选择模块', 'error')
+    return
+  }
+  if (!livePreview.value.stem) {
+    app.toast('请填写题干', 'error')
+    return
+  }
+  const filled = form.options.filter((o) => o.text.trim())
+  if (filled.length < 2) {
+    app.toast('请至少填写 2 个选项', 'error')
+    return
+  }
+  if (!livePreview.value.answer) {
+    app.toast('请标记正确答案', 'error')
+    return
+  }
+  saving.value = true
+  try {
+    await questionsApi.importQuestions({
+      version: '1.0',
+      questions: [
+        {
+          type: '行测',
+          module: livePreview.value.module,
+          subModule: form.subModule.trim(),
+          difficulty: livePreview.value.difficulty,
+          stem: livePreview.value.stem,
+          options: filled.map((o) => ({ key: o.key, text: o.text.trim() })),
+          answer: livePreview.value.answer as OptionKey,
+          analysis: livePreview.value.analysis,
+          tags: [],
+          source: '手动录入'
+        }
+      ]
+    })
+    app.toast('题目已保存，可继续录入下一题', 'success')
+    resetForm()
+    list.refresh()
+  } catch (err) {
+    app.toast(err instanceof Error ? err.message : '保存失败', 'error')
+  } finally {
+    saving.value = false
+  }
+}
+
+function markAnswer(key: OptionKey) {
+  form.answer = form.answer === key ? '' : key
+}
 </script>
 
 <template>
-  <ComingSoon />
+  <div class="questions">
+    <!-- ======================= 手动录入模式 ======================= -->
+    <template v-if="mode === 'entry'">
+      <AppPageHeader title="题库管理" subtitle="手动录入题目 · 支持逐题与批量 JSON 导入">
+        <AppButton variant="ghost" @click="mode = 'list'">
+          <AppIcon name="chevron-left" :size="16" />返回列表
+        </AppButton>
+      </AppPageHeader>
+
+      <div class="entry">
+        <!-- 左：表单 -->
+        <AppCard title="录入题目" class="entry__form">
+          <div class="form-field">
+            <label class="form-field__label">题型</label>
+            <div class="question-types">
+              <AppButton
+                v-for="t in QUESTION_TYPES"
+                :key="t.value"
+                variant="ghost"
+                size="md"
+                class="question-types__tab"
+                :class="{ 'is-active': form.questionType === t.value }"
+                @click="switchType(t.value)"
+              >
+                {{ t.label }}
+              </AppButton>
+            </div>
+          </div>
+
+          <div class="form-field">
+            <label class="form-field__label">模块 / 考点</label>
+            <div class="module-row">
+              <select v-model="form.module" class="form-control form-control--module">
+                <option value="" disabled>请选择模块</option>
+                <option v-for="m in MODULES" :key="m" :value="m">{{ m }}</option>
+              </select>
+              <input v-model="form.subModule" class="form-control" type="text" placeholder="考点（如 行程问题）" />
+            </div>
+          </div>
+
+          <div class="form-field">
+            <label class="form-field__label">难度</label>
+            <select v-model="form.difficulty" class="form-control form-control--module">
+              <option v-for="d in DIFFICULTIES" :key="d" :value="d">{{ d }}</option>
+            </select>
+          </div>
+
+          <div class="form-field">
+            <label class="form-field__label">题干</label>
+            <textarea v-model="form.stem" class="form-control form-control--stem" placeholder="输入题目题干…" />
+          </div>
+
+          <div class="form-field">
+            <label class="form-field__label">选项（点击左侧标记正确答案）</label>
+            <div class="options">
+              <div v-for="o in form.options" :key="o.key" class="option-row" :class="{ 'is-answer': form.answer === o.key }">
+                <AppButton
+                  variant="ghost"
+                  size="md"
+                  class="option-row__key"
+                  :class="{ 'is-answer': form.answer === o.key }"
+                  @click="markAnswer(o.key)"
+                >
+                  <AppIcon v-if="form.answer === o.key" name="check" :size="14" />
+                  {{ o.key }}
+                </AppButton>
+                <input v-model="o.text" class="option-row__text" type="text" :placeholder="`选项 ${o.key}`" />
+              </div>
+            </div>
+            <p v-if="form.options.some((o) => o.text.trim()) && !form.answer" class="form-field__tip">
+              请点击选项序号标记正确答案
+            </p>
+          </div>
+
+          <div class="form-field">
+            <label class="form-field__label">答案解析</label>
+            <textarea v-model="form.analysis" class="form-control form-control--stem" placeholder="解析（可空）" />
+          </div>
+
+          <AppButton variant="primary" size="lg" block :disabled="saving" @click="saveQuestion">
+            {{ saving ? '保存中…' : '保存题目并继续录入' }}
+          </AppButton>
+        </AppCard>
+
+        <!-- 右：实时预览 -->
+        <div class="entry__preview">
+          <AppCard title="题目预览">
+            <div class="preview">
+              <div class="preview__meta">
+                <AppBadge variant="primary">{{ livePreview.module || '未选模块' }}</AppBadge>
+                <AppBadge :variant="diffTone(form.difficulty)">{{ form.difficulty }}</AppBadge>
+                <span class="preview__source">{{ form.source }}</span>
+              </div>
+              <p class="preview__stem">{{ previewText() }}</p>
+              <div class="preview__options">
+                <div
+                  v-for="o in previewOptions"
+                  :key="o.key"
+                  class="preview__option"
+                  :class="{ 'is-answer': livePreview.answer === o.key }"
+                >
+                  <span class="preview__option-key">{{ o.key }}</span>
+                  <span class="preview__option-text">{{ o.text || `选项 ${o.key}` }}</span>
+                  <span v-if="livePreview.answer === o.key" class="preview__option-check">
+                    <AppIcon name="check" :size="12" />正确答案
+                  </span>
+                </div>
+              </div>
+              <div v-if="livePreview.analysis" class="preview__analysis">
+                <p class="preview__analysis-title">答案解析</p>
+                <p class="preview__analysis-text">{{ livePreview.analysis }}</p>
+              </div>
+            </div>
+          </AppCard>
+        </div>
+      </div>
+    </template>
+
+    <!-- ======================= 列表模式 ======================= -->
+    <template v-else>
+      <AppLoading v-if="list.loading.value && !items.length" fullscreen />
+      <AppError
+        v-else-if="list.error.value"
+        fullscreen
+        title="题库加载失败"
+        :message="list.error.value"
+        retry
+        @retry="list.refresh"
+      />
+
+      <template v-else>
+        <AppPageHeader title="题库管理" subtitle="手动录入题目 · 支持逐题与批量 JSON 导入">
+          <AppButton variant="secondary" @click="openImport">
+            <AppIcon name="inbox" :size="16" />导入真题
+          </AppButton>
+          <AppButton variant="primary" @click="mode = 'entry'">
+            <AppIcon name="pen" :size="16" />新增题目
+          </AppButton>
+        </AppPageHeader>
+
+        <!-- 筛选栏 -->
+        <AppCard padded>
+          <div class="filters">
+            <div class="filters__select">
+              <label class="filters__label">模块</label>
+              <select v-model="filters.module" class="filters__control">
+                <option value="">全部模块</option>
+                <option v-for="m in MODULES" :key="m" :value="m">{{ m }}</option>
+              </select>
+            </div>
+            <div class="filters__select">
+              <label class="filters__label">难度</label>
+              <select v-model="filters.difficulty" class="filters__control">
+                <option value="">全部难度</option>
+                <option v-for="d in DIFFICULTIES" :key="d" :value="d">{{ d }}</option>
+              </select>
+            </div>
+            <div class="filters__search">
+              <label class="filters__label">关键词</label>
+              <input v-model="filters.keyword" class="filters__control" type="text" placeholder="搜索题干关键词" />
+            </div>
+            <AppButton variant="ghost" size="md" @click="resetFilters">重置</AppButton>
+          </div>
+          <p class="filters__count">
+            共 {{ total }} 道题目
+            <AppButton variant="ghost" size="md" class="filters__export" :disabled="exporting" @click="doExport">
+              <AppIcon name="chart" :size="16" />{{ exporting ? '导出中…' : '导出' }}
+            </AppButton>
+          </p>
+        </AppCard>
+
+        <AppEmpty
+          v-if="items.length === 0"
+          icon="book"
+          title="暂无题目"
+          :description="hasFilter ? '当前筛选条件下没有匹配题目，可尝试重置筛选。' : '题库为空，点击「新增题目」手动录入，或「导入真题」批量添加。'"
+        >
+          <AppButton v-if="hasFilter" variant="secondary" @click="resetFilters">重置筛选</AppButton>
+          <AppButton v-else variant="primary" @click="mode = 'entry'">新增题目</AppButton>
+        </AppEmpty>
+
+        <template v-else>
+          <AppCard v-if="!isMobile" padded>
+            <table class="q-table">
+              <thead>
+                <tr>
+                  <th class="q-table__stem">题干</th>
+                  <th class="q-table__module">模块</th>
+                  <th class="q-table__diff">难度</th>
+                  <th class="q-table__answer">答案</th>
+                  <th class="q-table__created">录入时间</th>
+                  <th class="q-table__action"></th>
+                </tr>
+              </thead>
+              <tbody>
+                <tr v-for="q in items" :key="q.id" class="q-row">
+                  <td class="q-table__stem">
+                    <p class="q-stem">{{ q.stem }}</p>
+                    <p v-if="q.subModule" class="q-sub">{{ q.subModule }}</p>
+                  </td>
+                  <td class="q-table__module"><AppBadge variant="soft">{{ q.module }}</AppBadge></td>
+                  <td class="q-table__diff"><AppBadge :variant="diffTone(q.difficulty)">{{ q.difficulty }}</AppBadge></td>
+                  <td class="q-table__answer">{{ q.answer }}</td>
+                  <td class="q-table__created">{{ formatDateShort(q.createdAt.slice(0, 10)) }}</td>
+                  <td class="q-table__action">
+                    <AppButton variant="ghost" size="md" class="q-del" @click="openRemove(q)">
+                      <AppIcon name="close" :size="16" />删除
+                    </AppButton>
+                  </td>
+                </tr>
+              </tbody>
+            </table>
+          </AppCard>
+
+          <div v-else class="q-cards">
+            <div v-for="q in items" :key="q.id" class="q-card">
+              <div class="q-card__top">
+                <AppBadge variant="soft">{{ q.module }}</AppBadge>
+                <AppBadge :variant="diffTone(q.difficulty)">{{ q.difficulty }}</AppBadge>
+                <span class="q-card__answer">答案 {{ q.answer }}</span>
+              </div>
+              <p class="q-card__stem">{{ q.stem }}</p>
+              <div class="q-card__foot">
+                <span class="q-card__meta">{{ q.subModule || q.module }} · {{ formatDateShort(q.createdAt.slice(0, 10)) }}</span>
+                <AppButton variant="ghost" size="md" class="q-del" @click="openRemove(q)">
+                  <AppIcon name="close" :size="16" />
+                </AppButton>
+              </div>
+            </div>
+          </div>
+
+          <div v-if="totalPages > 1" class="pager">
+            <AppButton variant="ghost" size="md" :disabled="page <= 1" @click="goPage(page - 1)">
+              <AppIcon name="chevron-left" :size="16" />上一页
+            </AppButton>
+            <span class="pager__info">{{ page }} / {{ totalPages }}</span>
+            <AppButton variant="ghost" size="md" :disabled="page >= totalPages" @click="goPage(page + 1)">
+              下一页<AppIcon name="chevron-right" :size="16" />
+            </AppButton>
+          </div>
+        </template>
+      </template>
+    </template>
+
+    <!-- 导入弹层 -->
+    <AppModal v-if="showImport" title="导入题目" :max-width="640" @close="showImport = false">
+      <p class="modal-hint">
+        粘贴 JSON 数组 / 含 <code>questions</code> 字段的 JSON。后台自动生成题目 ID，按「题干 + 模块 + 答案 + 选项文本」指纹去重，重复题目自动跳过。
+      </p>
+      <textarea v-model="importText" class="modal__textarea" placeholder='{"version":"1.0","questions":[{"type":"行测","module":"数量关系","subModule":"行程问题","difficulty":"中等","stem":"…","options":[{"key":"A","text":"…"}],"answer":"A","analysis":"…","tags":[],"source":"导入测试"}]}' />
+
+      <div v-if="importResult" class="import-report">
+        <div class="import-report__stats">
+          <span class="report-stat report-stat--ok">成功 <b>{{ importResult.success }}</b></span>
+          <span class="report-stat report-stat--skip">跳过 <b>{{ importResult.skipped }}</b></span>
+          <span class="report-stat report-stat--fail">失败 <b>{{ importResult.failed }}</b></span>
+        </div>
+        <p class="import-report__total">本次共处理 {{ importResult.total }} 条（{{ importResult.success + importResult.skipped + importResult.failed }} 条计入统计）。</p>
+        <ul v-if="importResult.errors.length" class="import-report__errors">
+          <li v-for="e in importResult.errors" :key="e.index">第 {{ e.index + 1 }} 条：{{ e.message }}</li>
+        </ul>
+        <p v-else-if="importResult.failed === 0 && importResult.skipped === 0" class="import-report__ok">✅ 全部导入成功，无异常条目。</p>
+        <p v-else-if="importResult.failed === 0" class="import-report__ok">✅ 无失败条目，重复题目已跳过，其余全部导入。</p>
+      </div>
+
+      <template #footer>
+        <AppButton variant="ghost" @click="showImport = false">关闭</AppButton>
+        <AppButton variant="primary" :disabled="importing" @click="doImport">
+          {{ importing ? '导入中…' : '开始导入' }}
+        </AppButton>
+      </template>
+    </AppModal>
+
+    <!-- 删除确认 -->
+    <AppModal v-if="removing" title="删除题目" :max-width="480" @close="removing = null">
+      <p class="modal-confirm">
+        确定要删除这道题目吗？<br />
+        <span class="modal-confirm__stem">{{ removing.stem.slice(0, 40) }}{{ removing.stem.length > 40 ? '…' : '' }}</span>
+      </p>
+
+      <!-- 引用预检：提前提示是否会被拦截 -->
+      <div v-if="refsLoading" class="modal-warn">
+        <span class="modal-warn__spinner" /> 正在检查关联引用…
+      </div>
+      <div v-else-if="refsInfo && refsInfo.total > 0" class="modal-warn modal-warn--block">
+        <p class="modal-warn__title">
+          <AppIcon name="alert" :size="16" />该题已被引用，将无法删除
+        </p>
+        <ul class="modal-warn__list">
+          <li v-if="refsInfo.practiceRecords > 0">作答记录 {{ refsInfo.practiceRecords }} 条</li>
+          <li v-if="refsInfo.wrongQuestions > 0">错题本 {{ refsInfo.wrongQuestions }} 条</li>
+          <li v-if="refsInfo.practiceSessions > 0">刷题会话 {{ refsInfo.practiceSessions }} 个</li>
+        </ul>
+        <p class="modal-warn__note">需先处理这些关联数据，才能删除该题。</p>
+      </div>
+      <p v-else class="modal-warn">该题暂无关联引用，删除后不可恢复。</p>
+
+      <template #footer>
+        <AppButton variant="ghost" @click="removing = null">取消</AppButton>
+        <AppButton variant="danger" :disabled="deleting || (refsInfo?.total ?? 0) > 0" @click="confirmRemove">
+          {{ deleting ? '删除中…' : '确认删除' }}
+        </AppButton>
+      </template>
+    </AppModal>
+  </div>
 </template>
+
+<style scoped>
+.questions {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-4);
+}
+
+/* ---------- 录入模式 ---------- */
+.entry {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: var(--space-4);
+  align-items: start;
+}
+@media (max-width: 767px) {
+  .entry {
+    grid-template-columns: 1fr;
+  }
+}
+.entry__form {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-4);
+}
+.form-field {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2);
+}
+.form-field__label {
+  font-size: var(--fs-label);
+  font-weight: var(--fw-label-bold);
+  color: var(--text-secondary);
+}
+.question-types {
+  display: flex;
+  gap: var(--space-2);
+}
+.question-types__tab {
+  height: auto !important;
+  padding: 6px var(--space-4) !important;
+  border: 1px solid var(--border-subtle) !important;
+  border-radius: var(--radius-sm) !important;
+  background: var(--bg-card) !important;
+  color: var(--text-secondary) !important;
+  font-size: var(--fs-label) !important;
+  font-weight: var(--fw-label-bold) !important;
+}
+.question-types__tab.is-active {
+  background: var(--primary) !important;
+  border-color: var(--primary) !important;
+  color: var(--on-accent) !important;
+}
+.module-row {
+  display: flex;
+  gap: var(--space-3);
+}
+.form-control {
+  height: 40px;
+  padding: 0 var(--space-3);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-btn);
+  background: var(--bg-card);
+  color: var(--text-primary);
+  font-size: var(--fs-subtitle);
+  width: 100%;
+  box-sizing: border-box;
+}
+.form-control--module {
+  width: 40%;
+  flex: none;
+}
+.form-control--stem {
+  height: auto;
+  min-height: 96px;
+  padding: var(--space-3);
+  border-radius: var(--radius-btn);
+  resize: vertical;
+  font-family: inherit;
+  line-height: var(--lh-subtitle);
+}
+.options {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2);
+}
+.option-row {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  padding: 4px;
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-btn);
+  background: var(--bg-card);
+  transition: border-color var(--motion-hover-fast) var(--ease-default), background var(--motion-hover-fast) var(--ease-default);
+}
+.option-row.is-answer {
+  border-color: var(--success);
+  background: var(--success-soft);
+}
+.option-row__key {
+  display: grid !important;
+  place-items: center;
+  width: 34px !important;
+  height: 34px !important;
+  padding: 0 !important;
+  border: 1px solid var(--border-subtle) !important;
+  border-radius: var(--radius-sm) !important;
+  background: var(--bg-card) !important;
+  color: var(--text-secondary) !important;
+  gap: 0 !important;
+  flex: none;
+}
+.option-row__key.is-answer {
+  border-color: var(--success) !important;
+  background: var(--success) !important;
+  color: var(--on-accent) !important;
+}
+.option-row__text {
+  flex: 1;
+  height: 34px;
+  padding: 0 var(--space-2);
+  border: none;
+  background: transparent;
+  color: var(--text-primary);
+  font-size: var(--fs-subtitle);
+}
+.option-row__text:focus {
+  outline: none;
+}
+.form-field__tip {
+  margin: 0;
+  font-size: var(--fs-label);
+  color: var(--warning);
+}
+
+/* 预览 */
+.entry__preview {
+  position: sticky;
+  top: var(--space-4);
+}
+.preview {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-3);
+}
+.preview__meta {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  flex-wrap: wrap;
+}
+.preview__source {
+  margin-left: auto;
+  font-size: var(--fs-label);
+  color: var(--text-muted);
+}
+.preview__stem {
+  margin: 0;
+  font-size: var(--fs-card-title);
+  font-weight: var(--fw-card-title);
+  color: var(--text-primary);
+  line-height: var(--lh-card-title);
+  min-height: 1.5em;
+}
+.preview__options {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2);
+}
+.preview__option {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  padding: var(--space-3);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-md);
+  background: var(--bg-card);
+  color: var(--text-primary);
+}
+.preview__option.is-answer {
+  border-color: var(--success);
+  background: var(--success-soft);
+}
+.preview__option-key {
+  flex: none;
+  font-weight: var(--fw-label-bold);
+  color: var(--text-secondary);
+}
+.preview__option-text {
+  flex: 1;
+  font-size: var(--fs-subtitle);
+}
+.preview__option-check {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--space-1);
+  font-size: var(--fs-label);
+  font-weight: var(--fw-label-bold);
+  color: var(--success);
+}
+.preview__analysis {
+  padding: var(--space-3);
+  border-radius: var(--radius-md);
+  background: var(--bg-soft);
+}
+.preview__analysis-title {
+  margin: 0;
+  font-size: var(--fs-label);
+  font-weight: var(--fw-label-bold);
+  color: var(--text-secondary);
+}
+.preview__analysis-text {
+  margin: var(--space-1) 0 0;
+  font-size: var(--fs-label);
+  color: var(--text-secondary);
+  line-height: var(--lh-subtitle);
+}
+
+/* ---------- 列表模式 ---------- */
+.filters {
+  display: flex;
+  align-items: flex-end;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+}
+.filters__select,
+.filters__search {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-1);
+}
+.filters__search {
+  flex: 1;
+  min-width: 180px;
+}
+.filters__label {
+  font-size: var(--fs-label);
+  color: var(--text-secondary);
+  font-weight: var(--fw-label-bold);
+}
+.filters__control {
+  height: 36px;
+  padding: 0 var(--space-3);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-sm);
+  background: var(--bg-card);
+  color: var(--text-primary);
+  font-size: var(--fs-subtitle);
+}
+.filters__search .filters__control {
+  width: 100%;
+}
+.filters__count {
+  margin: var(--space-3) 0 0;
+  font-size: var(--fs-label);
+  color: var(--text-muted);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+}
+.filters__export {
+  font-size: var(--fs-label) !important;
+}
+
+.q-table {
+  width: 100%;
+  border-collapse: collapse;
+}
+.q-table th {
+  text-align: left;
+  padding: var(--space-2) var(--space-3);
+  border-bottom: 1px solid var(--border-subtle);
+  font-size: var(--fs-label);
+  font-weight: var(--fw-label-bold);
+  color: var(--text-secondary);
+  white-space: nowrap;
+}
+.q-table td {
+  padding: var(--space-3);
+  border-bottom: 1px solid var(--border-subtle);
+  vertical-align: top;
+  font-size: var(--fs-subtitle);
+  color: var(--text-primary);
+}
+.q-row:last-child td {
+  border-bottom: none;
+}
+.q-table__stem {
+  width: 44%;
+}
+.q-table__module,
+.q-table__diff {
+  white-space: nowrap;
+}
+.q-table__answer {
+  font-family: var(--font-num);
+  font-weight: var(--fw-label-bold);
+  color: var(--primary);
+}
+.q-table__created {
+  white-space: nowrap;
+  color: var(--text-muted);
+}
+.q-stem {
+  margin: 0;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+  line-height: var(--lh-subtitle);
+}
+.q-sub {
+  margin: var(--space-1) 0 0;
+  font-size: var(--fs-label);
+  color: var(--text-muted);
+}
+.q-table__action {
+  text-align: right;
+  white-space: nowrap;
+}
+.q-del {
+  color: var(--danger) !important;
+}
+.q-del:hover {
+  background: var(--danger-soft) !important;
+  color: var(--danger) !important;
+}
+
+.q-cards {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-3);
+}
+.q-card {
+  padding: var(--card-padding-mobile);
+  background: var(--bg-card);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-lg);
+}
+.q-card__top {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  flex-wrap: wrap;
+}
+.q-card__answer {
+  margin-left: auto;
+  font-size: var(--fs-label);
+  font-weight: var(--fw-label-bold);
+  color: var(--primary);
+}
+.q-card__stem {
+  margin: var(--space-3) 0;
+  font-size: var(--fs-subtitle);
+  color: var(--text-primary);
+  line-height: var(--lh-subtitle);
+}
+.q-card__foot {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--space-2);
+}
+.q-card__meta {
+  font-size: var(--fs-label);
+  color: var(--text-muted);
+}
+
+.pager {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: var(--space-4);
+}
+.pager__info {
+  font-size: var(--fs-subtitle);
+  color: var(--text-secondary);
+}
+
+/* 导入弹层 */
+.modal-hint {
+  margin: 0;
+  font-size: var(--fs-label);
+  color: var(--text-secondary);
+  line-height: var(--lh-subtitle);
+}
+.modal-hint code {
+  padding: 1px var(--space-1);
+  border-radius: var(--radius-sm);
+  background: var(--bg-soft);
+  font-family: var(--font-num);
+  font-size: 12px;
+}
+.modal__textarea {
+  min-height: 180px;
+  padding: var(--space-3);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-btn);
+  background: var(--bg-card);
+  color: var(--text-primary);
+  font-family: var(--font-num);
+  font-size: var(--fs-label);
+  resize: vertical;
+}
+.import-report {
+  padding: var(--space-4);
+  border-radius: var(--radius-md);
+  background: var(--bg-soft);
+}
+.import-report__stats {
+  display: flex;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+}
+.report-stat {
+  padding: 4px var(--space-3);
+  border-radius: var(--radius-pill);
+  font-size: var(--fs-label);
+  font-weight: var(--fw-label-bold);
+}
+.report-stat--ok {
+  background: var(--success-soft);
+  color: var(--success);
+}
+.report-stat--skip {
+  background: var(--warning-soft);
+  color: var(--warning);
+}
+.report-stat--fail {
+  background: var(--danger-soft);
+  color: var(--danger);
+}
+.import-report__total {
+  margin: var(--space-3) 0 0;
+  font-size: var(--fs-label);
+  color: var(--text-secondary);
+}
+.import-report__errors {
+  margin: var(--space-3) 0 0;
+  padding-left: var(--space-5);
+  font-size: var(--fs-label);
+  color: var(--danger);
+  line-height: var(--lh-subtitle);
+}
+.import-report__ok {
+  margin: var(--space-3) 0 0;
+  font-size: var(--fs-label);
+  color: var(--success);
+}
+
+/* 删除确认 */
+.modal-confirm {
+  margin: 0;
+  font-size: var(--fs-subtitle);
+  color: var(--text-primary);
+  line-height: var(--lh-subtitle);
+}
+.modal-confirm__stem {
+  color: var(--text-secondary);
+}
+.modal-warn {
+  margin: var(--space-2) 0 0;
+  font-size: var(--fs-label);
+  color: var(--text-muted);
+  line-height: var(--lh-subtitle);
+}
+.modal-warn__spinner {
+  display: inline-block;
+  width: 12px;
+  height: 12px;
+  vertical-align: -2px;
+  border-radius: 50%;
+  border: 2px solid var(--border-subtle);
+  border-top-color: var(--primary);
+  animation: spin 0.8s linear infinite;
+}
+.modal-warn--block {
+  margin: var(--space-3) 0 0;
+  padding: var(--space-3);
+  border: 1px solid var(--warning-soft);
+  border-radius: var(--radius-md);
+  background: var(--warning-soft);
+  color: var(--warning);
+}
+.modal-warn__title {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  margin: 0;
+  font-size: var(--fs-subtitle);
+  font-weight: var(--fw-card-title);
+  color: var(--warning);
+}
+.modal-warn__list {
+  margin: var(--space-2) 0 0;
+  padding-left: var(--space-5);
+  font-size: var(--fs-label);
+  color: var(--warning);
+  line-height: var(--lh-subtitle);
+}
+.modal-warn__note {
+  margin: var(--space-1) 0 0;
+  font-size: var(--fs-label);
+  color: var(--text-secondary);
+}
+@keyframes spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+</style>
diff --git a/docs/checks/task-07.md b/docs/checks/task-07.md
new file mode 100644
index 0000000..4c0a245
--- /dev/null
+++ b/docs/checks/task-07.md
@@ -0,0 +1,93 @@
+# 任务 07 检查记录：题库管理与导入导出
+
+日期：2026-09-01
+
+## 交付内容
+
+### 后端（Handler + Schema + Routes）
+
+- `server/src/handlers/questions.ts`
+  - 新增 `contentFingerprint()`：按「题干 + 模块 + 答案 + 选项文本（排序）」拼接（`\u0000` 分隔）生成内容指纹，用于导入去重。
+  - `list`：按 `module` / `difficulty` / `keyword` 筛选 + `page` / `pageSize` 分页，返回 `{ items, total, page, pageSize }`。
+  - `importQuestions`：读现有题库建立 `seen` 指纹集合 → 逐条校验（任何一条格式错误不影响其它有效题导入）→ 后台生成 UUID（`newId('q')`）→ `createdAt` 取当前时间 → `updateData` 原子写入 → 返回 `{ total, success, skipped, failed, errors }` 导入结果报告。
+  - `exportQuestions`：导出 `{ version: '1.0', exportedAt, questions }`，剔除 `id` / `createdAt`，保证「导出的数据可再次导入」。
+  - `countReferences(id)`：共享的引用统计助手（错题/作答记录/刷题会话），供 `refs` 预检与 `remove` 校验共用。
+  - `refs`（新增）：`GET /api/questions/:id/refs` 返回该题引用数量，供前端删除弹层预检（题目不存在抛 404）。
+  - `remove`：读 `questions` → 不存在抛 404 → `countReferences` 查引用 → 被引用抛 `ApiError.conflict`（409）→ 无引用则过滤移除。
+- `server/src/errors.ts`：新增 `static conflict(message, details?)` → `new ApiError(409, 'CONFLICT', ...)`。
+- `server/src/server.ts`：**修复删除接口 400 报错根因**。默认 JSON 解析器遇到「Content-Type: application/json 但空 body」会抛 400「请求参数不合法」（前端 `openapi-fetch` 给所有请求带该头，含无 body 的 DELETE）。通过 `addContentTypeParser('application/json', { parseAs: 'string' }, ...)` 把空 body 视为 `undefined`，非空才 `JSON.parse`。
+- `server/src/routes.ts`：5 条路由 `GET /api/questions/list`、`POST /api/questions/import`、`GET /api/questions/export`、`DELETE /api/questions/:id`、`GET /api/questions/:id/refs`（tags: 题库管理）。
+
+### 前端（View + API）
+
+- `client/src/api/index.ts`：新增类型 `QuestionListItem` / `QuestionListPage` / `QuestionImportBody` / `QuestionExport` / `QuestionRefs`（从 `generated/schema` 推导）；`questionsApi` 新增 `refs(id)`。
+- `client/src/views/questions/QuestionsView.vue`（重写，原为 ComingSoon 占位）：**「列表 / 手动录入」双模式**，对照原型「桌面-题库录入.png」还原。
+  - **手动录入模式（核心，对照原型）**：左表单 + 右实时题目预览。
+    - 题型 tab：单选题 / 多选题 / 判断题（需求 4.1 仅支持单选题，多选/判断点击保留单选并 toast 提示）。
+    - 模块 / 考点下拉 + 输入、难度下拉、题干 textarea、A-D 选项行（点击序号标记正确答案）、答案解析。
+    - 右侧「题目预览」实时联动：模块 / 难度徽章、题干、选项（正确项绿色 + ✓ 正确答案）、答案解析块。
+    - 「保存题目并继续录入」复用 `importQuestions`（单条）保存 → toast + 表单自动清空。
+    - 页头「返回列表」。
+  - **列表模式**：页头「导入真题」（新增题目）+「新增题目」；筛选栏（模块/难度/关键词防抖/重置 + 计数 + 导出）；桌面表格、移动卡片、分页、删除确认弹层。
+  - `mode` 开关控制列表 / 录入两视图。
+  - 复用 AppPageHeader / AppCard / AppButton / AppIcon / AppBadge / AppModal / AppLoading / AppError / AppEmpty。
+
+## 与原型图对照
+
+原型「桌面-题库录入.png」仅一张，主题是**手动录入 + 实时预览**，此前误做成纯列表页已修正。现页面在保留原有列表/筛选/导入/导出/删除基础上，新增手动录入模式，左表单 + 右预览与原型结构、字段（题型/模块考点/题干/选项/正确答案/解析）、「保存题目并继续录入」按钮一致。
+
+
+## 接口实测（curl，演示数据 18 条）
+
+| 接口 | 结果 |
+|---|---|
+| `GET /api/questions/list?page=1&pageSize=3` | `total 18`，返回 3 条演示题 |
+| `GET /api/questions/list?module=数量关系` | `total 4`，module 全为数量关系 |
+| `GET /api/questions/list?difficulty=困难` | `total 4`，difficulty 全为困难 |
+| `GET /api/questions/list?keyword=相遇` | `total 1` |
+| `POST /api/questions/import`（新题 1 条） | `{total:1, success:1, skipped:0, failed:0}`，total 18→19 |
+| `POST /api/questions/import`（重复内容再导） | `{total:1, success:0, skipped:1, failed:0}`，total 保持 19（指纹去重） |
+| `GET /api/questions/export` | `version 1.0`、19 条，字段 `type/module/subModule/difficulty/stem/options/answer/analysis/tags/source`，**无 id/createdAt**（可再次导入） |
+| `GET /api/questions/:id/refs`（demo-q-001） | `{wrongQuestions:0, practiceRecords:4, practiceSessions:0, total:4}`，供删除弹层预检 |
+| `GET /api/questions/:id/refs`（未引用新题） | `{wrongQuestions:0, practiceRecords:0, practiceSessions:0, total:0}` |
+| `GET /api/questions/:id/refs`（不存在的 id） | 404 `NOT_FOUND`：「题目不存在」 |
+| `DELETE /api/questions/:id`（带 `Content-Type: application/json` 头 + **空 body**） | **修复前 400**「请求参数不合法」→ **修复后 200** `{success:true}`（server.ts `addContentTypeParser` 把空 body 视作 undefined） |
+| `DELETE /api/questions/:id`（未引用新题） | `{success:true}`，total 19→18 |
+| `DELETE /api/questions/demo-q-001`（被作答记录引用 4 条） | 409 `CONFLICT`：「题目已被作答记录 4 条引用，无法删除」，total 不变 |
+
+## 浏览器检查（agent-browser）
+
+| 场景 | 结果 |
+|---|---|
+| 桌面 1440 题库管理 | 页头按钮 + 筛选栏 + 表格 + 分页完整渲染，与原型结构对齐；共 18 道题目 |
+| 移动 390 题库管理 | 卡片布局渲染正常；`scrollWidth 380 ≤ 390` 无横向溢出 |
+| JSON 导入弹层 | 打开 → 粘贴 JSON → 开始导入 → 展示导入结果报告（成功 1 / 跳过 0 / 失败 0 + ✅ 全部导入成功） |
+| 重复导入去重实测 | 再导相同 JSON 显示「成功 0 · 跳过 1 · 失败 0」，列表 total 不变 |
+| 导出 | `exportQuestions` 返回无 id/createdAt 的合法 JSON（Blob 下载逻辑已就绪，接口数据经 curl 核对） |
+| 删除确认弹层 | 点击删除 → 弹层先展示「正在检查引用…」spinner，随后题干预览 + 引用提醒文案正确 |
+| 删除（被引用题） | 打开弹层即预检：显示黄色警示块「该题已被引用，将无法删除 / 作答记录 4 条」+ 引用明细，**确认按钮 `disabled=true`** |
+| 删除（未引用题） | 弹层显示「该题暂无关联引用，删除后不可恢复」，**确认按钮可点**，点击后 total 回落到演示基线 18 |
+| 关键词搜索 | 输入「相遇」→ 共 1 道题目，刷新防抖生效 |
+| 手动录入 → 新增题目 | 左表单 + 右「题目预览」实时联动（模块/难度徽章、题干、选项、答案解析均随输入更新） |
+| 手动录入 → 标记正确答案 | 点击选项 A 序号 → 预览 A 项绿色高亮 + ✓ 正确答案 |
+| 手动录入 → 保存 | toast「题目已保存，可继续录入下一题」→ 表单自动清空 → 题库 total 18→19，保存题含 `q-` UUID / module=数量关系 / subModule=行程问题 / answer=A / 4 选项 / 完整解析 |
+| 手动录入 → 返回列表 | 「返回列表」回到列表视图，共 19 道题目 |
+| 移动 390 手动录入 | 表单纵向单列，预览在表单下方；`scrollWidth 380 ≤ 390` 无横向溢出 |
+| 数据复位 | 删除手动测试题后题库恢复演示基线 total=18 |
+
+截图：`deliverables/checks/task-07-questions-{desktop,mobile}.png`、`task-07-entry-mode.png`、`task-07-entry-preview.png`、`task-07-entry-mobile.png`、`task-07-list-after-entry.png`、`task-07-import-modal.png`、`task-07-import-result.png`、`task-07-delete-confirm.png`、`task-07-delete-referenced.png`、`task-07-delete-unreferenced.png`、`task-07-search-filter.png`。
+
+## 完成标准核对
+
+- ✅ 导入文件不含 ID 也能成功（后台 `newId('q')` 生成 UUID）。
+- ✅ 重复题目被跳过（内容指纹去重，实测成功 0 / 跳过 1）。
+- ✅ 错误题目不影响有效题目导入（逐条 try/catch，返回 errors 报告）。
+- ✅ 导出的数据可再次导入（导出剔除 id/createdAt，字段与 import body 对齐）。
+- ✅ 删除前引用校验（错题/作答记录/刷题会话），被引用抛 409；未引用删除成功。
+- ✅ 删除弹层引用预检（`GET /api/questions/:id/refs`）：被引用题展示警示并禁用确认按钮，未引用题可直接删除。
+- ✅ 空 body 的 JSON 请求不再误抛 400（server.ts `addContentTypeParser` 修复）。
+- ✅ 页面（列表筛选/导入报告/导出/删除确认）双端渲染与原型结构对齐，无横向溢出。
+
+## 当前结论
+
+任务 07 完成：题库管理与导入导出在前后端打通并持久化。列表筛选分页、JSON 批量导入（去重 + UUID + 逐条校验报告）、导出（可再导入格式）、删除（引用校验 + 确认弹层）全部实测通过；修复了「空 body 的 JSON 请求误抛 400」的删除接口报错根因，并新增删除弹层引用预检（GET `/api/questions/:id/refs`，被引用题警示 + 禁用确认）。类型检查（vue-tsc / tsc）与生产构建（119 模块）全部通过。测试数据已清理，题库恢复演示基线 18 条。
diff --git a/server/src/errors.ts b/server/src/errors.ts
index 649e6c6..9c83e87 100644
--- a/server/src/errors.ts
+++ b/server/src/errors.ts
@@ -23,6 +23,10 @@ export class ApiError extends Error {
     return new ApiError(404, 'NOT_FOUND', message, details)
   }
 
+  static conflict(message: string, details?: { path: string; message: string }[]) {
+    return new ApiError(409, 'CONFLICT', message, details)
+  }
+
   static aiNotConfigured(message: string) {
     return new ApiError(503, 'AI_NOT_CONFIGURED', message)
   }
diff --git a/server/src/handlers/news.ts b/server/src/handlers/news.ts
index cd3dafd..efd3e5b 100644
--- a/server/src/handlers/news.ts
+++ b/server/src/handlers/news.ts
@@ -56,7 +56,6 @@ export async function importJson(request: FastifyRequest) {
   let skipped = 0
 
   body.news.forEach((item, index) => {
-    console.log("🚀 ~ importJson ~ item:", item)
     try {
       const fingerprint = `${item.title}\u0000${item.category}\u0000${item.publishedAt}`
       if (seen.has(fingerprint)) {
diff --git a/server/src/handlers/questions.ts b/server/src/handlers/questions.ts
index 74513ed..a460d0d 100644
--- a/server/src/handlers/questions.ts
+++ b/server/src/handlers/questions.ts
@@ -1,11 +1,23 @@
 import type { FastifyRequest } from 'fastify'
-import { readData } from '../data/store.js'
+import { readData, updateData } from '../data/store.js'
 import { dataFiles } from '../data/files.js'
 import { ApiError } from '../errors.js'
-import type { Question } from '../schemas/entities.js'
+import { newId } from '../utils/ids.js'
+import type {
+  PracticeRecord,
+  PracticeSession,
+  Question,
+  WrongQuestion
+} from '../schemas/entities.js'
 import type { z } from 'zod'
 import { QuestionsImportBodySchema, QuestionsListQuerySchema } from '../schemas/api.js'
 
+/** 内容指纹：题干 + 模块 + 答案 + 选项文本（排序后），用于导入去重 */
+function contentFingerprint(q: Pick<Question, 'stem' | 'module' | 'answer' | 'options'>) {
+  const options = [...q.options.map((o) => `${o.key}:${o.text}`)].sort().join('|')
+  return `${q.stem}\u0000${q.module}\u0000${q.answer}\u0000${options}`
+}
+
 /** 题库列表：模块 / 难度 / 关键词筛选 + 分页 */
 export async function list(request: FastifyRequest) {
   const query = request.query as z.infer<typeof QuestionsListQuerySchema>
@@ -25,10 +37,59 @@ export async function list(request: FastifyRequest) {
   }
 }
 
-/** 题目 JSON 导入。TODO 任务07：内容指纹去重、UUID 生成、逐条校验报告。 */
+/**
+ * 题目 JSON 导入。任务07：
+ * - 后台生成 UUID（id 由 newId('q') 生成），createdAt 取当前时间；
+ * - 按「题干 + 模块 + 答案 + 选项文本」内容指纹去重（含与题库内已有题目的比对）；
+ * - 逐条校验，任何一条格式错误不影响其它有效题导入，返回导入结果报告。
+ */
 export async function importQuestions(request: FastifyRequest) {
   const body = request.body as z.infer<typeof QuestionsImportBodySchema>
-  return { total: body.questions.length, success: 0, skipped: 0, failed: 0, errors: [] }
+  const current = await readData<Question[]>(dataFiles.questions, [])
+  const seen = new Set(current.map((q) => contentFingerprint(q)))
+
+  const errors: { index: number; message: string }[] = []
+  const added: Question[] = []
+  let skipped = 0
+
+  body.questions.forEach((item, index) => {
+    try {
+      const fingerprint = contentFingerprint(item)
+      if (seen.has(fingerprint)) {
+        skipped += 1
+        return
+      }
+      seen.add(fingerprint)
+      added.push({
+        id: newId('q'),
+        type: item.type,
+        module: item.module,
+        subModule: item.subModule,
+        difficulty: item.difficulty,
+        stem: item.stem,
+        options: item.options,
+        answer: item.answer,
+        analysis: item.analysis,
+        tags: item.tags,
+        source: item.source,
+        createdAt: new Date().toISOString()
+      })
+    } catch (error) {
+      errors.push({ index, message: error instanceof Error ? error.message : '导入失败' })
+    }
+  })
+
+  if (added.length > 0) {
+    await updateData<Question[]>(dataFiles.questions, [], (questions) => [...questions, ...added])
+  }
+
+  return {
+    total: body.questions.length,
+    success: added.length,
+    skipped,
+    failed: errors.length,
+    errors
+  }
 }
 
 /** 导出当前题库（与导入格式一致，不含 id） */
@@ -41,10 +102,58 @@ export async function exportQuestions() {
   }
 }
 
-/** 删除题目。TODO 任务07：校验引用后从 questions.json 移除。 */
+/**
+ * 统计一道题被「错题 / 作答记录 / 刷题会话」引用的数量。
+ * 供删除预检（前端删除弹层提前展示)与 remove 校验共用。
+ */
+export async function countReferences(id: string) {
+  const [wrongQuestions, practiceRecords, practiceSessions] = await Promise.all([
+    readData<WrongQuestion[]>(dataFiles.wrongQuestions, []),
+    readData<PracticeRecord[]>(dataFiles.practiceRecords, []),
+    readData<PracticeSession[]>(dataFiles.practiceSessions, [])
+  ])
+  return {
+    wrongQuestions: wrongQuestions.filter((w) => w.questionId === id).length,
+    practiceRecords: practiceRecords.filter((r) => r.questionId === id).length,
+    practiceSessions: practiceSessions.filter((s) => s.questionIds.includes(id)).length
+  }
+}
+
+/** 删除前预检：返回该题引用数量，便于前端弹层提前展示；题目不存在抛 404 */
+export async function refs(request: FastifyRequest) {
+  const { id } = request.params as { id: string }
+  const questions = await readData<Question[]>(dataFiles.questions, [])
+  if (!questions.some((q) => q.id === id)) throw ApiError.notFound('题目不存在')
+  const ref = await countReferences(id)
+  return {
+    wrongQuestions: ref.wrongQuestions,
+    practiceRecords: ref.practiceRecords,
+    practiceSessions: ref.practiceSessions,
+    total: ref.wrongQuestions + ref.practiceRecords + ref.practiceSessions
+  }
+}
+
+/**
+ * 删除题目。任务07：
+ * - 删前校验该题是否被「错题 / 作答记录 / 刷题会话」引用；
+ * - 被引用则抛 409 提示先处理关联数据，避免产生悬挂引用；
+ * - 无引用则从 questions.json 移除。
+ */
 export async function remove(request: FastifyRequest) {
   const { id } = request.params as { id: string }
   const questions = await readData<Question[]>(dataFiles.questions, [])
   if (!questions.some((q) => q.id === id)) throw ApiError.notFound('题目不存在')
+
+  const referenced = await countReferences(id)
+
+  if (referenced.wrongQuestions + referenced.practiceRecords + referenced.practiceSessions > 0) {
+    const parts: string[] = []
+    if (referenced.wrongQuestions > 0) parts.push(`错题 ${referenced.wrongQuestions} 条`)
+    if (referenced.practiceRecords > 0) parts.push(`作答记录 ${referenced.practiceRecords} 条`)
+    if (referenced.practiceSessions > 0) parts.push(`刷题会话 ${referenced.practiceSessions} 个`)
+    throw ApiError.conflict(`题目已被${parts.join('、')}引用，无法删除`)
+  }
+
+  await updateData<Question[]>(dataFiles.questions, [], (list) => list.filter((q) => q.id !== id))
   return { success: true }
 }
diff --git a/server/src/routes.ts b/server/src/routes.ts
index 4b82b9b..448d677 100644
--- a/server/src/routes.ts
+++ b/server/src/routes.ts
@@ -214,6 +214,12 @@ const routes: RouteDef[] = [
     response: { 200: schemas.QuestionsDeleteResponseSchema },
     handler: questions.remove
   },
+  {
+    method: 'GET', url: '/api/questions/:id/refs', summary: '题目引用预检', tags: ['题库管理'],
+    params: schemas.QuestionIdParamsSchema,
+    response: { 200: schemas.QuestionsRefsResponseSchema },
+    handler: questions.refs
+  },
 
   // AI 讲解
   {
diff --git a/server/src/schemas/api.ts b/server/src/schemas/api.ts
index e3c07d3..d29e404 100644
--- a/server/src/schemas/api.ts
+++ b/server/src/schemas/api.ts
@@ -333,6 +333,12 @@ export const QuestionsExportResponseSchema = z.object({
   questions: z.array(QuestionSchema.omit({ id: true, createdAt: true }))
 })
 export const QuestionsDeleteResponseSchema = z.object({ success: z.boolean() })
+export const QuestionsRefsResponseSchema = z.object({
+  wrongQuestions: z.number().int().min(0),
+  practiceRecords: z.number().int().min(0),
+  practiceSessions: z.number().int().min(0),
+  total: z.number().int().min(0)
+})
 
 // ---------- AI 讲解 ----------
 export const AiExplainBodySchema = z.object({
diff --git a/server/src/server.ts b/server/src/server.ts
index 3b027f2..3b0377f 100644
--- a/server/src/server.ts
+++ b/server/src/server.ts
@@ -11,6 +11,17 @@ import { errorHandler, notFoundHandler } from './errors.js'
 export async function buildServer() {
   const app = Fastify({ logger: true, exposeHeadRoutes: false })
 
+  // 允许「Content-Type: application/json 但无 body」的请求（如 DELETE 常带该头但无体）。
+  // 默认 JSON 解析器遇到空 body 会抛 400「请求参数不合法」；这里把空 body 视为 undefined，避免误伤。
+  app.addContentTypeParser('application/json', { parseAs: 'string' }, (_req, body, done) => {
+    if (body === undefined || body === null || body === '') return done(null, undefined)
+    try {
+      done(null, JSON.parse(body as string))
+    } catch (err) {
+      done(err as Error, undefined)
+    }
+  })
+
   await app.register(cors, { origin: true })
 
   await app.register(swagger, {