FAQ · 常见问题
关于洞见的常见问题：具体回答，标明边界
洞见是一套面向学校、机构与教师自建部署的高考数学学习诊断系统，用先修知识点图定位薄弱环节并生成每日一讲；它不承诺提分、不替代教师，拍照试卷的公式识别尚未验证。[S1][S5]
以下问题按使用者最常问的顺序排列。每个回答都尽量给出可核验的数字或明确的能力边界；涉及未验证事项时会直接写「未验证」。
产品与定位
洞见是什么产品？
洞见是一套面向学校、机构与教师自建部署的高考数学学习诊断系统。它把高中数学拆成 17 个主干知识点及其先修依赖，通过默认约 25 题的诊断定位薄弱环节，并按诊断结果生成当日讲义。产品基于开源项目 DeepTutor 改造，版本基线 1.7.2。[S1][S7]
洞见适合什么规模的用户使用？
适合单所学校、单个机构或教师自建自用。产品是单机部署，后端固定单 worker，数据库与缓存同机运行，没有多机集群或水平扩容的实测记录。若是区域级多校平台或高并发公网服务，需要先做架构改造与容量评估。[S5][S6]
洞见能保证提分吗？
不能，产品也不做这类承诺。洞见定位为辅助诊断与练习安排的工具，不替代教师。仓库材料中没有提分幅度、提分率、学生人数或满意度等可核验数据，因此官网不提供任何效果数字，也不写「100% 准确」「保证提分」。[S1][S5]
学习流程
入学诊断要做多少题、需要多久？
诊断默认总预算 25 题，可中途退出，再次进入可继续。系统围绕 17 个主干知识点的先修图自适应出题：答对往更难的方向走，答错回溯先修节点。2026-11-12 生产实测中，一轮完整流程为 2 轮提交、约 20 题。[S1][S3][S4]
每日一讲每天能生成几次？
每个账号每天最多生成 5 次，超出返回 HTTP 429，次日恢复。同一账号在同一天再次打开同一知识点的讲义时读取缓存，不重复调用模型、不重复计费。生产实测单篇讲义为 542 字，包含知识点、例题、方法链、3 道变式与先修提醒。[S3][S4]
为什么有的题目（比如几何图）没有出现在诊断里？
因为题库中部分真题缺少配图。系统会自动跳过题干含「图 / 如图 / 图象 / 图像」但没有配图的题目，避免学生在看不到图的情况下作答。这会让个别知识点在诊断中覆盖不足，属于已知限制。[S2][S5]
输入与附件
拍照上传数学试卷，能准确识别公式吗？
不能按这个预期使用。图片识别目前只实测过纯文字场景：一张只含一行文字的图片返回 315～317 字、耗时约 4.1～5.3 秒。公式、分式、根式与上下标的识别还原未验证，在交付清单中按不可用处理。含公式或图形的题目建议手工输入文字题干。[S4][S5]
附件大小有什么限制？
图片与文档走同一套上限：单文件 20 MB，单轮累计 25 MB。超限时前端在读取文件之前就拦截，不发出上传请求；绕过前端直接调接口，服务端也会在写库前拒绝，返回 protocol_error、code=attachment_too_large、status_code=413 与中文提示。[S3][S4]
部署与权限
能部署多台服务器或开多个 worker 扩容吗？
当前不建议这样做。后端固定单 uvicorn worker（DEEPTUTOR_BACKEND_WORKERS=1），账号表在多进程同时写入下不安全，存在整表覆盖风险。产品没有多机集群、负载均衡或水平扩容的实测记录，需要扩容时应先做架构改造与验证。[S5]
教师能看到学生的聊天记录吗？
看不到。教师端只呈现班级聚合数据与学生个体指标，例如学生数、近 7 天活跃、总学习时长、整体正确率、完成实验、诊断正确率与状态提示，不包含对话正文。教师也没有错因下钻页面，逐题证据需由管理员通过接口查询。[S3]
家长怎样查看孩子的学习周报？
家长用邀请码开通账号后进入家长端，输入孩子登录账号与关系发起绑定；必须由学生本人在「我的监护人」中确认后，家长才能看到数据。周报包含有效学习时长、学习天数、完成题目、正确率、完成讲解、完成实验，以及薄弱知识点与错因分布，数字由服务端事件聚合而非模型生成。[S3]
数据存在哪里？删除账号会怎样？
数据存放在部署方自有服务器的独立数据目录（DEEPTUTOR_HOME=/data/deeptutor），PostgreSQL 与 Redis 仅监听回环地址，每日定时备份并在本地保留 30 天、同步对象存储。管理员删除账号会级联清理学习事件、实验进度、诊断计划、周报与班级成员关系，并移除个人工作区；家长绑定关系做匿名化保留。[S3][S5]
费用与运维
使用洞见需要付软件费用吗？
洞见本身不按额度收费，也不内置售卖 token 的机制。实际费用发生在所接入的模型服务商侧，按 token 用量计费，由部署方与供应商直接约定。管理员可在用量看板查看模型调用次数、错误率与 token 用量，学生可在每条回复下方看到本次用量。[S2][S3]
备份可靠吗？恢复过吗？
备份每天定时执行，本地保留 30 天并同步对象存储，这部分有运行记录。但恢复演练尚未在生产执行：只验证过备份文件可以生成，尚未验证完整恢复流程，交付清单已将其列为未完成项。[S5]