Settings and Users

设置与用户管理

个人偏好

登录后打开“设置 → 通用”，可调整自己的偏好：

设置	默认行为
导入前人工确认	开启后先校对再保存，适合需要逐题核对的场景
SVG 动画讲解	默认开启
GeoGebra 动态演示	默认关闭
题目判重相似度阈值	默认 90%，相似度严格大于阈值时判重

个人偏好按用户保存。AI 服务配置和应用时区属于全局设置，需要管理员权限。

应用时区

应用默认使用北京时间 Asia/Shanghai。管理员在“设置 → 通用 → 应用时区”输入有效的 IANA 时区名称并保存，例如 UTC、Europe/London 或 America/New_York。

时区保存在 config/app-config.json 的 timeZone 字段。旧配置没有此字段时，自动回退到 Asia/Shanghai；普通用户可查看当前全局时区。

以下功能使用应用时区：

• 题目、练习历史、试卷和管理页面中的日期显示。
• 试卷默认标题中的时间、导出文件名和考试日期录入。
• 按日、按月统计，以及年级学期计算。

数据库与 API 中带 Z 的 ISO 时间仍表示同一个绝对时刻，显示时再转换。保存后当前页面使用新时区，其他已打开的页面刷新后生效；已保存的试卷标题文字不会自动改写。

详细规则见时区说明。

权限与用户管理

角色	主要权限
普通用户	管理自己的错题、练习、试卷和个人偏好，导入导出本人数据
管理员	使用全局 AI 和提示词设置、时区设置、注册开关、用户管理及管理范围的数据导入导出

管理员从“设置 → 用户管理”进入后台，可查看使用统计，启用、禁用或删除用户。删除前应确认对象并备份数据。

新用户注册默认关闭，避免服务暴露到公网时被陌生人注册并消耗 AI 额度。需要为家人创建账号时，管理员在“设置 → 用户管理”中打开“允许新用户注册”，账号注册完成后再关闭；也可以用环境变量 ALLOW_REGISTRATION=true 改变默认值，网页中保存过的开关优先。升级前已在网页中保存过设置的实例，保持原来的注册开关。

每日 AI 次数

为避免孩子反复生成讲解、重新出题而耗尽 API 额度，管理员可在“设置 → 用户管理”中设置“每人每日 AI 次数”，用户列表同时显示每人今天已用的次数。

• 计入次数的是用户主动发起的 AI 操作：识别题目、重新解答、举一反三出题和判题、配图、修复公式、GeoGebra、动画讲解、重新标注知识点和组卷。一次操作计 1 次，整套试卷和整本错题本重新标注也各计 1 次；写法一致直接判对的答案不调用 AI，不计次数。
• 后台自动进行的掌握概率评估不计入。
• 0 表示不限制（默认）；管理员不受限制。也可以用环境变量 AI_DAILY_LIMIT 设置默认值，网页中保存的值优先。
• 次数按应用时区每天零点重置。用完后再点 AI 功能会提示“今天的 AI 使用次数已达上限”。

默认管理员只用于新安装的初始化。已有实例升级应保留原账户，不应为了升级重复执行管理员播种。

后台任务与进度

页面右下角的任务入口展示识别、动画、重新解答、批量标注、数据导入和组卷等耗时操作的状态。部分批量任务提供已处理数量和失败数量。

录入界面的百分比是按压缩、上传、分析、处理、保存阶段给出的估计，不能理解为 AI 已完成的真实比例；已用时间用于了解等待时长。

任务列表保存在当前服务进程内存中。页面跳转通常不会停止已经开始的服务端处理，但服务重启会清空列表，运行中的任务也不能据此自动恢复。完成的业务数据以数据库中的保存结果为准。

查看运行版本

设置中的“关于”和 GET /api/health 可查看运行版本。排查问题时记录版本、复现步骤及脱敏后的错误提示；不要发送实际 API Key 或完整配置文件。