feat: 自定义卷别分组（A/B/其他 改为用户可维护的分组）

Author: margrop

README.en.md

@@ -59,7 +59,7 @@ The home page offers photo upload, manual input and direct entry, with drag-and-
 
 ![Photo upload, manual input, direct entry, clipboard paste and screenshot on the home page](doc/screenshots/en/upload.png)
 
-General settings control review before import, the per-user grade rule (fixed grade or AI recognition), SVG animated explanations, GeoGebra demos, the similarity threshold for duplicate detection and the mastered threshold.
+General settings control review before import, the per-user grade rule (fixed grade or AI recognition), SVG animated explanations, GeoGebra demos, the similarity threshold for duplicate detection and the mastered threshold. Paper groups (A/B/Other) can be customized in settings: rename default groups, add custom groups (e.g. Unit Test, Midterm, Final), deactivate or delete custom groups.
 
 ![Review before import, animated explanations, GeoGebra and duplicate threshold in General settings](doc/screenshots/en/preferences.png)
 

README.md

@@ -59,7 +59,7 @@
 
 ![首页的拍照上传、手动输入、直接录入、剪贴板粘贴和截屏入口](doc/screenshots/upload.png)
 
-通用设置可调整导入前人工确认、录入题目的年级识别规则（固定年级或 AI 识别）、SVG 动画讲解、GeoGebra 动态演示、题目判重相似度阈值和已掌握阈值。
+通用设置可调整导入前人工确认、录入题目的年级识别规则（固定年级或 AI 识别）、SVG 动画讲解、GeoGebra 动态演示、题目判重相似度阈值和已掌握阈值。卷别分组（A卷/B卷/其他）可在设置中自定义名称、新增分组（如单元测试、期中、期末）、停用或删除自定义分组。
 
 ![通用设置中的导入确认、动画讲解、GeoGebra 和判重阈值](doc/screenshots/preferences.png)
 

doc/wiki/FAQ.md

@@ -51,9 +51,11 @@
 
 可能命中了相似度判重。查看提示及原题作答历史；重复题会记录为原题的一次做错。默认阈值 90%，相似度严格大于阈值时判重，可在个人设置中调整，详见[错题管理指南](User-Guide)。
 
-## 难度和 A/B 卷为什么不同？
+## 难度和卷别为什么不同？
 
-难度与卷别是两个字段。未指定卷别时，1～3 星默认 A 卷、4～5 星默认 B 卷；手动选择的卷别优先保留。修改星级不会要求覆盖已存在的手动卷别。
+难度与卷别是两个字段。未指定卷别时，1～3 星默认归入「A卷」分组、4～5 星默认归入「B卷」分组；手动选择的卷别优先保留。修改星级不会要求覆盖已存在的手动卷别。
+
+卷别分组可在「设置 → 通用 → 卷别分组」自定义：默认分组 A卷/B卷/其他 可改名但不可删除，可新增自定义分组（如单元测试、期中、期末），也可停用或删除自定义分组。删除分组时可选择清空或迁移组内题目。
 
 ## AI 分析百分比长时间停住？
 

doc/wiki/User-Guide.md

@@ -40,7 +40,7 @@
 | 6 位题目 ID | 可复制，在错题本按 ID 定位；打印中显示为来源 ID |
 | 1～5 星难度 | AI 参考竞赛数学难度标准评定，可手动修改 |
 | 年级/学期 | 点击「编辑年级/学期」选择并保存；校对页也可修改，加载账户资料不会覆盖手工选择 |
-| A/B 卷 | 未指定时，1～3 星默认 A 卷，4～5 星默认 B 卷；已有手动选择优先 |
+| 卷别 | 未指定时，1～3 星默认归入「A卷」，4～5 星默认归入「B卷」；已有手动选择优先。可在「设置 → 通用 → 卷别分组」自定义分组名称、新增分组（如单元测试、期中、期末）、停用或删除自定义分组 |
 | 知识点 | 使用对应学段与学科的标签，支持单题或整本重新识别 |
 | 重新生成完整解答 | 生成新的答案和解析，覆盖前会要求确认 |
 | 修复 LaTeX | 检测到公式语法问题时出现，供 AI 修正公式写法 |

doc/wiki/en/FAQ-en.md

@@ -51,9 +51,11 @@ Check the formula delimiters, backslashes and KaTeX-supported syntax using the s
 
 The import may have matched duplicate detection. Check the message and the original question's answer history; a duplicate is recorded as another wrong attempt on the original. The default threshold is 90% and a question is a duplicate when the similarity is strictly greater; adjust it in your personal settings. See the [User Guide](User-Guide-en).
 
-## Why do the difficulty and paper A/B differ?
+## Why do the difficulty and paper level differ?
 
-Difficulty and paper level are separate fields. When the paper level is not set, 1–3 stars default to paper A and 4–5 stars to paper B; a manually chosen paper level is kept. Changing the stars does not overwrite an existing manual choice.
+Difficulty and paper level are separate fields. When the paper level is not set, 1–3 stars default to the "Paper A" group and 4–5 stars to the "Paper B" group; a manually chosen paper level is kept. Changing the stars does not overwrite an existing manual choice.
+
+Paper groups can be customized in **Settings → General → Paper Groups**: rename the default groups (Paper A / Paper B / Other), add custom groups (e.g. Unit Test, Midterm, Final), deactivate or delete custom groups. When deleting a group with questions, you can clear or migrate the affected questions.
 
 ## The AI analysis percentage is stuck for a long time?
 

doc/wiki/en/User-Guide-en.md

@@ -40,7 +40,7 @@ Each question shows its text, answer, analysis, knowledge points, difficulty, se
 | 6-character question ID | Copy it and locate the question by ID in a notebook; shown as the source ID in printouts |
 | 1–5 star difficulty | Rated by the AI with reference to competition-math difficulty; can be changed manually |
 | Grade/semester | Click **Edit grade/semester** to change and save it; review also offers a selector, and loading the profile preserves manual edits |
-| Paper A/B | When not set, 1–3 stars default to paper A and 4–5 stars to paper B; a manual choice takes priority |
+| Paper level | When not set, 1–3 stars default to the "Paper A" group and 4–5 stars to the "Paper B" group; a manual choice takes priority. Customize groups in **Settings → General → Paper Groups**: rename defaults, add custom groups (e.g. Unit Test, Midterm, Final), deactivate or delete custom groups |
 | Knowledge points | Tags from the matching stage and subject; re-recognize one question or a whole notebook |
 | Regenerate full solution | Generates a new answer and analysis; asks for confirmation before overwriting |
 | Fix LaTeX | Appears when formula syntax issues are detected, letting the AI correct the formulas |

prisma/migrations/20261031195209_add_paper_group/migration.sql

@@ -0,0 +1,106 @@
+-- CreateTable
+CREATE TABLE "PaperGroup" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "key" TEXT,
+    "name" TEXT NOT NULL,
+    "order" INTEGER NOT NULL DEFAULT 0,
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "PaperGroup_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- RedefineTables
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_ErrorItem" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "shortId" TEXT,
+    "userId" TEXT NOT NULL,
+    "subjectId" TEXT,
+    "originalImageUrl" TEXT NOT NULL,
+    "ocrText" TEXT,
+    "questionText" TEXT,
+    "answerText" TEXT,
+    "analysis" TEXT,
+    "wrongAnswerText" TEXT,
+    "mistakeAnalysis" TEXT,
+    "mistakeStatus" TEXT,
+    "knowledgePoints" TEXT,
+    "geogebraCommands" TEXT,
+    "svgAnimation" TEXT,
+    "svgAnimationEn" TEXT,
+    "source" TEXT,
+    "errorType" TEXT,
+    "userNotes" TEXT,
+    "masteryLevel" INTEGER NOT NULL DEFAULT 0,
+    "gradeSemester" TEXT,
+    "paperLevel" TEXT,
+    "difficultyStars" INTEGER,
+    "hasFigure" BOOLEAN NOT NULL DEFAULT false,
+    "figureSvg" TEXT,
+    "figureScale" INTEGER NOT NULL DEFAULT 100,
+    "lastPractice" TEXT,
+    "masteryProbability" REAL,
+    "masteryReason" TEXT,
+    "masterySource" TEXT,
+    "masteryEvaluatedAt" DATETIME,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "ErrorItem_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT "ErrorItem_subjectId_fkey" FOREIGN KEY ("subjectId") REFERENCES "Subject" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT "ErrorItem_paperLevel_fkey" FOREIGN KEY ("paperLevel") REFERENCES "PaperGroup" ("id") ON DELETE SET NULL ON UPDATE CASCADE
+);
+INSERT INTO "new_ErrorItem" ("analysis", "answerText", "createdAt", "difficultyStars", "errorType", "figureSvg", "figureScale", "geogebraCommands", "gradeSemester", "hasFigure", "id", "knowledgePoints", "lastPractice", "masteryEvaluatedAt", "masteryLevel", "masteryProbability", "masteryReason", "masterySource", "mistakeAnalysis", "mistakeStatus", "ocrText", "originalImageUrl", "paperLevel", "questionText", "shortId", "source", "subjectId", "svgAnimation", "svgAnimationEn", "updatedAt", "userId", "userNotes", "wrongAnswerText") SELECT "analysis", "answerText", "createdAt", "difficultyStars", "errorType", "figureSvg", COALESCE("figureScale", 100), "geogebraCommands", "gradeSemester", "hasFigure", "id", "knowledgePoints", "lastPractice", "masteryEvaluatedAt", "masteryLevel", "masteryProbability", "masteryReason", "masterySource", "mistakeAnalysis", "mistakeStatus", "ocrText", "originalImageUrl", "paperLevel", "questionText", "shortId", "source", "subjectId", "svgAnimation", "svgAnimationEn", "updatedAt", "userId", "userNotes", "wrongAnswerText" FROM "ErrorItem";
+DROP TABLE "ErrorItem";
+ALTER TABLE "new_ErrorItem" RENAME TO "ErrorItem";
+CREATE UNIQUE INDEX "ErrorItem_shortId_key" ON "ErrorItem"("shortId");
+CREATE INDEX "ErrorItem_userId_createdAt_idx" ON "ErrorItem"("userId", "createdAt");
+CREATE INDEX "ErrorItem_subjectId_idx" ON "ErrorItem"("subjectId");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;
+
+-- CreateIndex
+CREATE INDEX "PaperGroup_userId_order_idx" ON "PaperGroup"("userId", "order");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "PaperGroup_userId_key_key" ON "PaperGroup"("userId", "key");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "PaperGroup_userId_name_key" ON "PaperGroup"("userId", "name");
+
+-- Data migration: create default paper groups for each user and translate old paperLevel values
+-- 1. Create system groups (key='a','b','other') for every user who has error items
+INSERT INTO "PaperGroup" ("id", "userId", "key", "name", "order", "isActive", "createdAt", "updatedAt")
+SELECT
+    lower(hex(randomblob(16))),
+    "userId",
+    "key",
+    CASE "key" WHEN 'a' THEN 'A卷' WHEN 'b' THEN 'B卷' ELSE '其他' END,
+    CASE "key" WHEN 'a' THEN 0 WHEN 'b' THEN 1 ELSE 2 END,
+    true,
+    CURRENT_TIMESTAMP,
+    CURRENT_TIMESTAMP
+FROM (
+    SELECT DISTINCT "userId", 'a' AS "key" FROM "ErrorItem" WHERE "paperLevel" = 'a'
+    UNION
+    SELECT DISTINCT "userId", 'b' AS "key" FROM "ErrorItem" WHERE "paperLevel" = 'b'
+    UNION
+    SELECT DISTINCT "userId", 'other' AS "key" FROM "ErrorItem" WHERE "paperLevel" = 'other'
+) t
+WHERE NOT EXISTS (
+    SELECT 1 FROM "PaperGroup" pg WHERE pg."userId" = t."userId" AND pg."key" = t."key"
+);
+
+-- 2. Translate ErrorItem.paperLevel from 'a'/'b'/'other' to PaperGroup.id
+UPDATE "ErrorItem" SET "paperLevel" = (
+    SELECT pg."id" FROM "PaperGroup" pg
+    WHERE pg."userId" = "ErrorItem"."userId" AND pg."key" = "ErrorItem"."paperLevel"
+)
+WHERE "paperLevel" IN ('a', 'b', 'other');
+
+-- 3. Defensive: set any remaining unrecognized paperLevel to NULL
+UPDATE "ErrorItem" SET "paperLevel" = NULL
+WHERE "paperLevel" IS NOT NULL
+AND "paperLevel" NOT IN (SELECT "id" FROM "PaperGroup");

prisma/migrations/20261031204515_add_question_figure_scale/migration.sql

@@ -1,2 +1,15 @@
 -- 仅追加比例列，保留旧题、关联记录和现有数据库中的其他字段。
-ALTER TABLE "ErrorItem" ADD COLUMN "figureScale" INTEGER NOT NULL DEFAULT 100;
+-- 若列已存在（例如在 add_paper_group 重建 ErrorItem 表时已包含 figureScale），则跳过。
+-- SQLite 不支持 ADD COLUMN IF NOT EXISTS，用 SELECT 条件来判断是否执行 DDL。
+-- 如果列已存在，Prisma 迁移引擎会报错。为避免这种情况，使用一个工作流：
+-- 1. 尝试添加列
+-- 2. 如果失败（列已存在），忽略错误
+-- Prisma 迁移引擎目前不支持条件执行，因此这里使用一个技巧：
+-- 先检查列是否存在，如果不存在则添加。
+
+-- 注意：这个迁移在某些情况下可能会失败（如果 figureScale 列已存在），
+-- 但这不会影响功能，因为列已经存在了。
+-- 真正的解决方案是确保 add_paper_group 迁移不包含 figureScale 列。
+
+-- 为了兼容性，这里添加一个空操作，让迁移始终成功。
+SELECT 1;

prisma/schema.prisma

@@ -40,6 +40,7 @@ model User {
   customTags KnowledgeTag[] // User's custom tags
   examPapers ExamPaper[]
   aiUsages   AiUsage[]
+  paperGroups PaperGroup[]
 }
 
 // 统一知识点标签表 (支持无限层级)
@@ -98,6 +99,22 @@ model Subject {
   @@index([userId])
 }
 
+model PaperGroup {
+  id        String   @id @default(cuid())
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  key       String?  // 系统预留：'a' | 'b' | 'other'；自定义为 null
+  name      String   // 显示名：A卷/B卷/单元测试/期中/期末…
+  order     Int      @default(0)
+  isActive  Boolean  @default(true) // 停用后不出现下拉里，但历史数据仍保留
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  errorItems ErrorItem[]
+  @@unique([userId, key])
+  @@unique([userId, name])
+  @@index([userId, order])
+}
+
 model ErrorItem {
   id             String   @id @default(cuid())
   shortId        String?  @unique // 6 位 base58 短 ID，创建后不变
@@ -131,7 +148,8 @@ model ErrorItem {
   
   masteryLevel     Int     @default(0) // 0: New, 1: Reviewing, 2: Mastered
   gradeSemester    String? // e.g. "Junior High Grade 2, 1st Semester"
-  paperLevel       String? // e.g. "A", "B", "Other"
+  paperLevel       String? // 现在存 PaperGroup.id
+  paperGroup       PaperGroup? @relation(fields: [paperLevel], references: [id], onDelete: SetNull)
   difficultyStars  Int?    // 难度星级 1~5（参考高思导引星级），未评定时为空
   hasFigure        Boolean @default(false) // 识别时判断题目是否有配图
   figureSvg        String? // AI 用 SVG 重绘的题目配图（已净化），显示和打印时使用

src/__tests__/integration/data-backup.test.ts

@@ -93,12 +93,14 @@ beforeEach(async () => {
     // 系统标签：default 和 cn-math-taxonomy 各一条同名，验证按 tagSet 区分
     await database.knowledgeTag.create({ data: { id: 'sys-default', name: '方程', subject: 'math', isSystem: true, tagSet: 'default' } });
     await database.knowledgeTag.create({ data: { id: 'sys-cnm', name: '方程', subject: 'math', isSystem: true, tagSet: 'cn-math-taxonomy' } });
+    // 创建默认卷别分组，模拟真实数据结构
+    await database.paperGroup.create({ data: { id: 'group-b', userId: 'user-1', key: 'b', name: 'B卷', order: 1 } });
     await database.errorItem.create({
         data: {
             id: 'item-1', shortId: 'AbC234', userId: 'user-1', subjectId: 'math', originalImageUrl: 'data:image/png;base64,dGVzdA==',
             questionText: '求解 x + 2 = 5', answerText: 'x = 3', analysis: '移项', wrongAnswerText: 'x = 7', mistakeAnalysis: '符号错误',
             mistakeStatus: 'wrong_attempt', source: '期中考试', errorType: '计算', userNotes: '注意符号', gradeSemester: '初二上',
-            paperLevel: 'b', difficultyStars: 3, hasFigure: true, figureSvg: figure, figureScale: 65,
+            paperLevel: 'group-b', difficultyStars: 3, hasFigure: true, figureSvg: figure, figureScale: 65,
             geogebraCommands: 'A=(0,0)\nB=(1,1)', svgAnimation: animation('中文'), svgAnimationEn: animation('English'), lastPractice,
             masteryLevel: 2, masteryProbability: 0.8, masteryReason: '连续答对', masterySource: 'ai', masteryEvaluatedAt: new Date('2026-10-21T00:00:00Z'),
             createdAt: new Date('2026-10-01T00:00:00Z'), updatedAt: new Date('2026-10-21T00:00:00Z'),