wrong-notebook 0.0.0-stage → 2026.10.21

package/bin/wrong-notebook.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/**
+ * wrong-notebook 命令行入口（npm 全局安装）
+ *   wrong-notebook [start] [--port 3000] [--host 0.0.0.0] [--data-dir ~/.wrong-notebook]
+ *   wrong-notebook prepare-client   生成本机 Prisma Client（postinstall 自动执行）
+ *   wrong-notebook version | help
+ */
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const launcher = require('../launcher.js');
+const pkg = require('../package.json');
+
+const HELP = `错题本 wrong-notebook v${pkg.version}
+
+用法：
+  wrong-notebook [start] [选项]    启动服务（默认监听 0.0.0.0:3000）
+  wrong-notebook version           显示版本
+  wrong-notebook help              显示帮助
+
+选项：
+  -p, --port <端口>        监听端口，默认 3000（也可用环境变量 PORT）
+  -H, --host <地址>        监听地址，默认 0.0.0.0；仅本机访问可设为 127.0.0.1
+  -d, --data-dir <目录>    数据目录，默认 ~/.wrong-notebook（也可用环境变量 WRONG_NOTEBOOK_HOME）
+
+数据库、配置文件（config/app-config.json）和会话密钥都保存在数据目录中，升级不会丢失数据。
+首次启动的默认管理员：admin@localhost / 123456，登录后请立即修改密码。`;
+
+const ALIASES = { '-h': 'help', '--help': 'help', '-v': 'version', '--version': 'version' };
+const [first, ...rest] = process.argv.slice(2);
+const command = ALIASES[first] || (!first || first.startsWith('-') ? 'start' : first);
+const args = command === 'start' && first !== 'start' ? process.argv.slice(2) : rest;
+
+switch (command) {
+    case 'start':
+        try {
+            launcher.start(launcher.parseArgs(args));
+        } catch (error) {
+            console.error(`[wrong-notebook] 启动失败：${error.message}`);
+            process.exit(1);
+        }
+        break;
+    case 'prepare-client': {
+        // 安装时生成 Prisma Client；失败不阻断安装，首次启动时会再尝试
+        const cli = require.resolve('prisma/build/index.js', { paths: [path.join(__dirname, '..')] });
+        const schema = path.join(__dirname, '..', 'prisma', 'schema.prisma');
+        const result = spawnSync(process.execPath, [cli, 'generate', '--schema', schema], { stdio: 'inherit' });
+        if (result.status !== 0) console.warn('[wrong-notebook] Prisma Client 生成失败，首次启动时将重试');
+        break;
+    }
+    case 'version':
+        console.log(pkg.version);
+        break;
+    case 'help':
+        console.log(HELP);
+        break;
+    default:
+        console.error(`未知命令：${command}\n\n${HELP}`);
+        process.exit(1);
+}

package/launcher.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+/**
+ * wrong-notebook 安装包通用启动器（npm、桌面端、飞牛OS 共用）
+ *
+ * 与 docker-entrypoint.sh 的行为保持一致：
+ *   1. 准备数据目录：数据库、配置文件、NextAuth 密钥都放在数据目录，安装目录可以只读
+ *   2. 首次运行时复制打包时预置的数据库（含管理员账号和系统标签）
+ *   3. 每次启动执行 prisma migrate deploy，只做增量迁移，保留已有数据
+ *   4. 在当前进程内启动 Next.js standalone 服务
+ *
+ * 用法：node launcher.js [--port 3000] [--host 0.0.0.0] [--data-dir 目录]
+ * 也可用环境变量 PORT、HOSTNAME、WRONG_NOTEBOOK_HOME 指定。
+ */
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const crypto = require('node:crypto');
+const { spawnSync } = require('node:child_process');
+
+const APP_DIR = __dirname;
+const DEFAULT_PORT = 3000;
+
+function parseArgs(argv) {
+    const opts = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const [key, inline] = arg.split('=', 2);
+        const next = () => (inline !== undefined ? inline : argv[++i]);
+        if (key === '--port' || key === '-p') opts.port = next();
+        else if (key === '--host' || key === '-H') opts.host = next();
+        else if (key === '--data-dir' || key === '-d') opts.dataDir = next();
+    }
+    return opts;
+}
+
+function defaultDataDir() {
+    if (process.env.WRONG_NOTEBOOK_HOME) return process.env.WRONG_NOTEBOOK_HOME;
+    return path.join(os.homedir(), '.wrong-notebook');
+}
+
+function appVersion() {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(APP_DIR, 'package.json'), 'utf8')).version || 'unknown';
+    } catch {
+        return 'unknown';
+    }
+}
+
+/** NextAuth 会话密钥：首次运行随机生成并保存，之后保持不变，避免重启后登录失效 */
+function ensureSecret(dataDir) {
+    const file = path.join(dataDir, '.nextauth_secret');
+    if (fs.existsSync(file)) {
+        const saved = fs.readFileSync(file, 'utf8').trim();
+        if (saved) return saved;
+    }
+    const secret = crypto.randomBytes(32).toString('base64');
+    fs.writeFileSync(file, secret, { mode: 0o600 });
+    return secret;
+}
+
+/** Prisma 的 SQLite 地址统一使用正斜杠，Windows 盘符路径也可用 */
+function sqliteUrl(file) {
+    return `file:${file.split(path.sep).join('/')}`;
+}
+
+function runPrisma(args, env) {
+    const cli = require.resolve('prisma/build/index.js', { paths: [APP_DIR] });
+    const result = spawnSync(process.execPath, [cli, ...args], {
+        cwd: APP_DIR,
+        env,
+        stdio: 'inherit',
+        windowsHide: true,
+    });
+    if (result.error) throw result.error;
+    return result.status === 0;
+}
+
+/** npm 安装时 Prisma Client 由 postinstall 生成；被 --ignore-scripts 跳过时在这里补生成 */
+function ensurePrismaClient(env) {
+    let clientDir;
+    try {
+        clientDir = path.dirname(require.resolve('.prisma/client/index.js', { paths: [APP_DIR] }));
+    } catch {
+        clientDir = null;
+    }
+    if (clientDir && fs.existsSync(path.join(clientDir, 'schema.prisma'))) return;
+    console.log('[wrong-notebook] 正在生成 Prisma Client...');
+    if (!runPrisma(['generate', '--schema', path.join(APP_DIR, 'prisma', 'schema.prisma')], env)) {
+        throw new Error('Prisma Client 生成失败，请检查安装目录是否可写');
+    }
+}
+
+/**
+ * Turbopack 把 serverExternalPackages 编译成带哈希的别名（如 @prisma/client-2c3a283f134fdcb6），
+ * standalone 用 .next/node_modules 下的符号链接指向真实包。npm 打包会丢弃该目录，
+ * 飞牛OS 打包也不接受符号链接，因此安装包不带这些链接，改为在解析失败时去掉哈希后缀再解析。
+ */
+function installExternalAliasResolver() {
+    const Module = require('node:module');
+    if (typeof Module.registerHooks !== 'function') {
+        throw new Error(`需要 Node.js 22.15 或更高版本（当前 ${process.version}）`);
+    }
+    const alias = /^((?:@[^/]+\/)?[^/]+)-[0-9a-f]{16}(\/.*)?$/;
+    // 同时作用于 require 和 import（bcryptjs 3 为 ESM，由 import() 加载）
+    Module.registerHooks({
+        resolve(specifier, context, nextResolve) {
+            try {
+                return nextResolve(specifier, context);
+            } catch (error) {
+                const match = alias.exec(specifier);
+                if (!match) throw error;
+                return nextResolve(match[1] + (match[2] || ''), context);
+            }
+        },
+    });
+}
+
+function prepare(options = {}) {
+    const dataDir = path.resolve(options.dataDir || defaultDataDir());
+    const configDir = path.join(dataDir, 'config');
+    fs.mkdirSync(configDir, { recursive: true });
+
+    const dbFile = path.join(dataDir, 'wrong-notebook.db');
+    const version = appVersion();
+    const env = {
+        ...process.env,
+        NODE_ENV: 'production',
+        NEXT_TELEMETRY_DISABLED: '1',
+        DATABASE_URL: sqliteUrl(dbFile),
+        CONFIG_DIR: configDir,
+        NEXTAUTH_SECRET: process.env.NEXTAUTH_SECRET || ensureSecret(dataDir),
+        AUTH_TRUST_HOST: process.env.AUTH_TRUST_HOST || 'true',
+        PRESERVE_EXISTING_DATA: 'true',
+        APP_VERSION: process.env.APP_VERSION || version,
+        WRONG_NOTEBOOK_HOME: dataDir,
+    };
+
+    ensurePrismaClient(env);
+
+    if (!fs.existsSync(dbFile) || fs.statSync(dbFile).size === 0) {
+        const seed = path.join(APP_DIR, 'prisma', 'seed.db');
+        if (fs.existsSync(seed)) {
+            console.log('[wrong-notebook] 初始化数据库（默认管理员 admin@localhost / 123456，登录后请立即修改密码）');
+            fs.copyFileSync(seed, dbFile);
+        }
+    }
+
+    console.log('[wrong-notebook] 正在执行数据库迁移...');
+    if (!runPrisma(['migrate', 'deploy', '--schema', path.join(APP_DIR, 'prisma', 'schema.prisma')], env)) {
+        throw new Error('数据库迁移失败，已停止启动');
+    }
+    return { dataDir, dbFile, env, version };
+}
+
+function start(options = {}) {
+    const { dataDir, env, version } = prepare(options);
+    const port = String(options.port || process.env.PORT || DEFAULT_PORT);
+    const host = options.host || process.env.HOSTNAME || '0.0.0.0';
+    Object.assign(process.env, env, { PORT: port, HOSTNAME: host });
+    console.log(`[wrong-notebook] v${version} 数据目录：${dataDir}`);
+    const shownHost = host === '0.0.0.0' || host === '::' ? '127.0.0.1' : host;
+    console.log(`[wrong-notebook] 访问地址：http://${shownHost}:${port}`);
+    installExternalAliasResolver();
+    // standalone 的 server.js 会切换工作目录到自身所在目录并监听 PORT/HOSTNAME
+    require(path.join(APP_DIR, 'server.js'));
+}
+
+module.exports = { prepare, start, parseArgs, defaultDataDir, sqliteUrl };
+
+if (require.main === module) {
+    try {
+        start(parseArgs(process.argv.slice(2)));
+    } catch (error) {
+        console.error(`[wrong-notebook] 启动失败：${error.message}`);
+        process.exit(1);
+    }
+}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "wrong-notebook",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2026.10.21",
+  "description": "错题本：上传题目图片，由 AI 识别、解析并标注知识点，支持练习、统计与打印导出",
+  "keywords": [
+    "wrong-notebook",
+    "mistake-notebook",
+    "错题本",
+    "ai",
+    "education"
+  ],
+  "homepage": "https://github.com/margrop/wrong-notebook",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/margrop/wrong-notebook.git"
+  },
+  "bugs": "https://github.com/margrop/wrong-notebook/issues",
+  "license": "MIT",
+  "bin": {
+    "wrong-notebook": "bin/wrong-notebook.js"
+  },
+  "files": [
+    "bin",
+    "launcher.js",
+    "server.js",
+    ".next",
+    "public",
+    "prisma",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.15"
+  },
+  "scripts": {
+    "postinstall": "node bin/wrong-notebook.js prepare-client"
+  },
+  "dependencies": {
+    "@prisma/client": "5.22.0",
+    "bcryptjs": "3.0.3",
+    "google-auth-library": "10.5.0",
+    "next": "16.3.8",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "prisma": "5.22.0"
+  }
+}

package/prisma/migrations/20251127143435_init/migration.sql

@@ -0,0 +1,62 @@
+-- CreateTable
+CREATE TABLE "User" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "email" TEXT NOT NULL,
+    "password" TEXT NOT NULL,
+    "name" TEXT,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL
+);
+
+-- CreateTable
+CREATE TABLE "Subject" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "name" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    CONSTRAINT "Subject_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "ErrorItem" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "subjectId" TEXT,
+    "originalImageUrl" TEXT NOT NULL,
+    "ocrText" TEXT,
+    "questionText" TEXT,
+    "answerText" TEXT,
+    "analysis" TEXT,
+    "knowledgePoints" TEXT,
+    "source" TEXT,
+    "errorType" TEXT,
+    "userNotes" TEXT,
+    "masteryLevel" INTEGER NOT NULL DEFAULT 0,
+    "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 SET NULL ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "ReviewSchedule" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "errorItemId" TEXT NOT NULL,
+    "scheduledFor" DATETIME NOT NULL,
+    "completedAt" DATETIME,
+    "isCorrect" BOOLEAN,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "ReviewSchedule_errorItemId_fkey" FOREIGN KEY ("errorItemId") REFERENCES "ErrorItem" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "PracticeSession" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Subject_name_userId_key" ON "Subject"("name", "userId");

package/prisma/migrations/20251129152530_init/migration.sql

@@ -0,0 +1,40 @@
+/*
+  Warnings:
+
+  - You are about to drop the `PracticeSession` table. If the table is not empty, all the data it contains will be lost.
+  - Added the required column `updatedAt` to the `Subject` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- DropTable
+PRAGMA foreign_keys=off;
+DROP TABLE "PracticeSession";
+PRAGMA foreign_keys=on;
+
+-- CreateTable
+CREATE TABLE "PracticeRecord" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "subject" TEXT,
+    "difficulty" TEXT,
+    "isCorrect" BOOLEAN,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "PracticeRecord_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_Subject" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "name" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "Subject_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+INSERT INTO "new_Subject" ("id", "name", "userId") SELECT "id", "name", "userId" FROM "Subject";
+DROP TABLE "Subject";
+ALTER TABLE "new_Subject" RENAME TO "Subject";
+CREATE UNIQUE INDEX "Subject_name_userId_key" ON "Subject"("name", "userId");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;

package/prisma/migrations/20251130150624_add_education_info/migration.sql

@@ -0,0 +1,6 @@
+-- AlterTable
+ALTER TABLE "ErrorItem" ADD COLUMN "gradeSemester" TEXT;
+
+-- AlterTable
+ALTER TABLE "User" ADD COLUMN "educationStage" TEXT;
+ALTER TABLE "User" ADD COLUMN "enrollmentYear" INTEGER;

package/prisma/migrations/20251130161659_init/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "ErrorItem" ADD COLUMN "paperLevel" TEXT;

package/prisma/migrations/20251201050917_add_admin_role/migration.sql

@@ -0,0 +1,21 @@
+-- RedefineTables
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_User" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "email" TEXT NOT NULL,
+    "password" TEXT NOT NULL,
+    "name" TEXT,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    "educationStage" TEXT,
+    "enrollmentYear" INTEGER,
+    "role" TEXT NOT NULL DEFAULT 'user',
+    "isActive" BOOLEAN NOT NULL DEFAULT true
+);
+INSERT INTO "new_User" ("createdAt", "educationStage", "email", "enrollmentYear", "id", "name", "password", "updatedAt") SELECT "createdAt", "educationStage", "email", "enrollmentYear", "id", "name", "password", "updatedAt" FROM "User";
+DROP TABLE "User";
+ALTER TABLE "new_User" RENAME TO "User";
+CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;

package/prisma/migrations/20251203155126_cascade_delete_subject_error_items/migration.sql

@@ -0,0 +1,29 @@
+-- RedefineTables
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_ErrorItem" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "subjectId" TEXT,
+    "originalImageUrl" TEXT NOT NULL,
+    "ocrText" TEXT,
+    "questionText" TEXT,
+    "answerText" TEXT,
+    "analysis" TEXT,
+    "knowledgePoints" TEXT,
+    "source" TEXT,
+    "errorType" TEXT,
+    "userNotes" TEXT,
+    "masteryLevel" INTEGER NOT NULL DEFAULT 0,
+    "gradeSemester" TEXT,
+    "paperLevel" TEXT,
+    "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
+);
+INSERT INTO "new_ErrorItem" ("analysis", "answerText", "createdAt", "errorType", "gradeSemester", "id", "knowledgePoints", "masteryLevel", "ocrText", "originalImageUrl", "paperLevel", "questionText", "source", "subjectId", "updatedAt", "userId", "userNotes") SELECT "analysis", "answerText", "createdAt", "errorType", "gradeSemester", "id", "knowledgePoints", "masteryLevel", "ocrText", "originalImageUrl", "paperLevel", "questionText", "source", "subjectId", "updatedAt", "userId", "userNotes" FROM "ErrorItem";
+DROP TABLE "ErrorItem";
+ALTER TABLE "new_ErrorItem" RENAME TO "ErrorItem";
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;

package/prisma/migrations/20251213132347_add_knowledge_tag_model/migration.sql

@@ -0,0 +1,38 @@
+-- CreateTable
+CREATE TABLE "KnowledgeTag" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "name" TEXT NOT NULL,
+    "subject" TEXT NOT NULL,
+    "parentId" TEXT,
+    "order" INTEGER NOT NULL DEFAULT 0,
+    "code" TEXT,
+    "isSystem" BOOLEAN NOT NULL DEFAULT false,
+    "userId" TEXT,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "KnowledgeTag_parentId_fkey" FOREIGN KEY ("parentId") REFERENCES "KnowledgeTag" ("id") ON DELETE SET NULL ON UPDATE CASCADE,
+    CONSTRAINT "KnowledgeTag_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "_ErrorItemToKnowledgeTag" (
+    "A" TEXT NOT NULL,
+    "B" TEXT NOT NULL,
+    CONSTRAINT "_ErrorItemToKnowledgeTag_A_fkey" FOREIGN KEY ("A") REFERENCES "ErrorItem" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT "_ErrorItemToKnowledgeTag_B_fkey" FOREIGN KEY ("B") REFERENCES "KnowledgeTag" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- CreateIndex
+CREATE INDEX "KnowledgeTag_parentId_idx" ON "KnowledgeTag"("parentId");
+
+-- CreateIndex
+CREATE INDEX "KnowledgeTag_subject_idx" ON "KnowledgeTag"("subject");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "KnowledgeTag_subject_name_userId_key" ON "KnowledgeTag"("subject", "name", "userId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "_ErrorItemToKnowledgeTag_AB_unique" ON "_ErrorItemToKnowledgeTag"("A", "B");
+
+-- CreateIndex
+CREATE INDEX "_ErrorItemToKnowledgeTag_B_index" ON "_ErrorItemToKnowledgeTag"("B");

package/prisma/migrations/20251219014445_fix_tag_constraints/migration.sql

@@ -0,0 +1,11 @@
+/*
+  Warnings:
+
+  - A unique constraint covering the columns `[subject,name,userId,parentId]` on the table `KnowledgeTag` will be added. If there are existing duplicate values, this will fail.
+
+*/
+-- DropIndex
+DROP INDEX "KnowledgeTag_subject_name_userId_key";
+
+-- CreateIndex
+CREATE UNIQUE INDEX "KnowledgeTag_subject_name_userId_parentId_key" ON "KnowledgeTag"("subject", "name", "userId", "parentId");

package/prisma/migrations/20260427090000_add_mistake_analysis_fields/migration.sql

@@ -0,0 +1,4 @@
+-- Add mistake-analysis fields to existing wrong-answer records.
+ALTER TABLE "ErrorItem" ADD COLUMN "wrongAnswerText" TEXT;
+ALTER TABLE "ErrorItem" ADD COLUMN "mistakeAnalysis" TEXT;
+ALTER TABLE "ErrorItem" ADD COLUMN "mistakeStatus" TEXT;

package/prisma/migrations/20260608000000_add_geogebra_commands/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "ErrorItem" ADD COLUMN "geogebraCommands" TEXT;

package/prisma/migrations/20261018120000_add_practice_mastery_exam/migration.sql

@@ -0,0 +1,103 @@
+-- AlterTable
+ALTER TABLE "ErrorItem" ADD COLUMN "masteryEvaluatedAt" DATETIME;
+ALTER TABLE "ErrorItem" ADD COLUMN "masteryProbability" REAL;
+ALTER TABLE "ErrorItem" ADD COLUMN "masteryReason" TEXT;
+ALTER TABLE "ErrorItem" ADD COLUMN "masterySource" TEXT;
+ALTER TABLE "ErrorItem" ADD COLUMN "shortId" TEXT;
+
+-- CreateTable
+CREATE TABLE "ExamPaper" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "status" TEXT NOT NULL DEFAULT 'generating',
+    "scope" TEXT NOT NULL,
+    "difficulty" TEXT NOT NULL,
+    "requestedCount" INTEGER NOT NULL,
+    "subjectIds" TEXT NOT NULL,
+    "tagNames" TEXT,
+    "resultsRecordedAt" DATETIME,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "ExamPaper_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "ExamQuestion" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "paperId" TEXT NOT NULL,
+    "order" INTEGER NOT NULL,
+    "errorItemId" TEXT,
+    "sourceShortId" TEXT NOT NULL,
+    "status" TEXT NOT NULL DEFAULT 'pending',
+    "questionText" TEXT,
+    "answerText" TEXT,
+    "analysis" TEXT,
+    "error" TEXT,
+    "practiceRecordId" TEXT,
+    CONSTRAINT "ExamQuestion_paperId_fkey" FOREIGN KEY ("paperId") REFERENCES "ExamPaper" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT "ExamQuestion_errorItemId_fkey" FOREIGN KEY ("errorItemId") REFERENCES "ErrorItem" ("id") ON DELETE SET NULL ON UPDATE CASCADE,
+    CONSTRAINT "ExamQuestion_practiceRecordId_fkey" FOREIGN KEY ("practiceRecordId") REFERENCES "PracticeRecord" ("id") ON DELETE SET NULL ON UPDATE CASCADE
+);
+
+-- RedefineTables
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_PracticeRecord" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "subject" TEXT,
+    "difficulty" TEXT,
+    "isCorrect" BOOLEAN,
+    "errorItemId" TEXT,
+    "result" TEXT,
+    "questionText" TEXT,
+    "answerText" TEXT,
+    "analysis" TEXT,
+    "source" TEXT NOT NULL DEFAULT 'practice',
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "PracticeRecord_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT "PracticeRecord_errorItemId_fkey" FOREIGN KEY ("errorItemId") REFERENCES "ErrorItem" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+INSERT INTO "new_PracticeRecord" ("createdAt", "difficulty", "id", "isCorrect", "subject", "userId") SELECT "createdAt", "difficulty", "id", "isCorrect", "subject", "userId" FROM "PracticeRecord";
+DROP TABLE "PracticeRecord";
+ALTER TABLE "new_PracticeRecord" RENAME TO "PracticeRecord";
+CREATE INDEX "PracticeRecord_errorItemId_createdAt_idx" ON "PracticeRecord"("errorItemId", "createdAt");
+CREATE TABLE "new_User" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "email" TEXT NOT NULL,
+    "password" TEXT NOT NULL,
+    "name" TEXT,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    "educationStage" TEXT,
+    "enrollmentYear" INTEGER,
+    "role" TEXT NOT NULL DEFAULT 'user',
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "confirmBeforeImport" BOOLEAN NOT NULL DEFAULT false
+);
+INSERT INTO "new_User" ("createdAt", "educationStage", "email", "enrollmentYear", "id", "isActive", "name", "password", "role", "updatedAt") SELECT "createdAt", "educationStage", "email", "enrollmentYear", "id", "isActive", "name", "password", "role", "updatedAt" FROM "User";
+DROP TABLE "User";
+ALTER TABLE "new_User" RENAME TO "User";
+CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;
+
+-- CreateIndex
+CREATE INDEX "ExamPaper_userId_createdAt_idx" ON "ExamPaper"("userId", "createdAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ExamQuestion_practiceRecordId_key" ON "ExamQuestion"("practiceRecordId");
+
+-- CreateIndex
+CREATE INDEX "ExamQuestion_paperId_order_idx" ON "ExamQuestion"("paperId", "order");
+
+-- 为已有题目补发 6 位 base58 短 ID，并重抽极小概率出现的重复值
+UPDATE "ErrorItem" SET "shortId" = substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) WHERE "shortId" IS NULL;
+UPDATE "ErrorItem" SET "shortId" = substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) WHERE rowid NOT IN (SELECT MIN(rowid) FROM "ErrorItem" GROUP BY "shortId");
+UPDATE "ErrorItem" SET "shortId" = substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) WHERE rowid NOT IN (SELECT MIN(rowid) FROM "ErrorItem" GROUP BY "shortId");
+UPDATE "ErrorItem" SET "shortId" = substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) || substr('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz', (abs(random()) % 58) + 1, 1) WHERE rowid NOT IN (SELECT MIN(rowid) FROM "ErrorItem" GROUP BY "shortId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ErrorItem_shortId_key" ON "ErrorItem"("shortId");
+

package/prisma/migrations/20261018133653_add_duplicate_import_details/migration.sql

@@ -0,0 +1,4 @@
+-- AlterTable
+ALTER TABLE "PracticeRecord" ADD COLUMN "mistakeAnalysis" TEXT;
+ALTER TABLE "PracticeRecord" ADD COLUMN "originalImageUrl" TEXT;
+ALTER TABLE "PracticeRecord" ADD COLUMN "wrongAnswerText" TEXT;

package/prisma/migrations/20261018134606_add_question_duplicate_threshold/migration.sql

@@ -0,0 +1,2 @@
+-- 直接新增带默认值的列，保留所有账户和关联数据，避免重建用户表。
+ALTER TABLE "User" ADD COLUMN "questionDuplicateThreshold" REAL NOT NULL DEFAULT 99;

package/prisma/migrations/20261019090000_add_user_enable_geogebra/migration.sql

@@ -0,0 +1,2 @@
+-- 直接新增带默认值的列（默认关闭 GeoGebra 动态演示），保留所有账户和关联数据，避免重建用户表。
+ALTER TABLE "User" ADD COLUMN "enableGeogebra" BOOLEAN NOT NULL DEFAULT false;