Boundaries & Limitations · 边界与局限
洞见不做什么：已知局限与适用边界
洞见是一套辅助诊断与练习安排的工具，不是提分保证，也不是拍照识题工具：拍照试卷的公式与上下标识别尚未验证，按不可用处理；部分真题缺少配图会被自动跳过；产品为单机单 worker 部署，不适用于多进程写入或任意规模的并发场景；备份恢复演练尚未在生产执行。[S5][S4]
本页把仓库交付材料中明确记录的局限集中列出。目的是让使用者在使用前就知道哪里会失败，而不是在上线后才发现。没有依据的「能力」不写，未验证的项目一律标注「未验证」。
1. 拍照试卷的公式识别：未验证，按不可用处理
附件能力支持图片，但图片识别目前只实测过纯文字场景：2026-11-12 生产实测中，一张只含一行文字的图片返回 315～317 字、耗时约 4.1～5.3 秒。[S4]
公式与结构未验证：交付清单将「公式、分式、根式、上下标的识别还原」记录为未验证，并按不可用处理。[S5]
这意味着：把整张数学试卷拍照上传，期望系统准确读出题目并解题，不在当前可承诺的能力范围内。若题目本身是纯文字描述，识别结果相对可用；含公式、图形、表格的题目请勿依赖图片识别。
如果确实需要把纸质题目录入系统，建议由教师或学生手工输入文字题干，或使用纯文字描述；这比依赖图片识别更可靠。[S5]
2. 缺图题会被自动跳过
题库中存在部分真题缺少配图的情况。为避免学生在看不到图的情况下作答，系统会自动跳过题干含「图 / 如图 / 图象 / 图像」但没有配图的题目。[S2][S5]
这是一个有意的保护机制，但也意味着：涉及几何图形、函数图象的题目在该题库版本中可能无法进入诊断，诊断覆盖的知识点会因此略有偏差。教师若发现某类题目长期缺席，应核对题库版本而不是调整学生。
3. 部署规模：单机、单 worker
- 后端固定单 uvicorn worker（
DEEPTUTOR_BACKEND_WORKERS=1），生产实测仅 1 个进程。[S5] - 账号表在多进程同时写入下不安全，存在整表覆盖风险，因此不能通过简单调大 worker 数来扩容。[S5]
- 数据库、缓存与应用同机部署，没有多机集群或负载均衡的实测记录。[S5]
结论：适合单校、单机构或教师自用；若目标是区域级多校平台或高并发公网服务，需要先做架构改造与容量验证，不能直接按参考配置上线。详见部署与运维。[S5]
4. 模型依赖与故障切换
- 对话与每日一讲依赖外部模型供应商；供应商超时、限流或额度耗尽会直接影响这两项能力。生产实测的响应耗时区间随供应商波动。[S3][S4]
- 模型自动 failover 未验证：2026-11-12 回归报告将其列为唯一未验证项（H4），需要读取部署实例配置才能确认，公网接口无法验证。[S4]
- 模型输出具有不确定性：同一问题可能得到不同表述。产品定位明确为「不替代老师」，生成内容需要教师或学生自行判断。[S1]
5. 运维侧尚未闭环的事项
| 项目 | 当前状态 | 影响 |
|---|---|---|
| 备份恢复演练 | 未执行（交付清单 B5 未勾选；测试报告标记未验证） | 只验证过备份可生成，尚未证明能在生产完整恢复 |
| 模型自动 failover | 未验证（H4） | 供应商故障时是否自动切换，需读实例配置确认 |
| 对象存储桶权限与生命周期 | 待部署方在云控制台确认 | 配置不当可能导致备份暴露或持续计费 |
| 安全组 22 端口来源 | 待部署方收窄 | 主机防火墙已限制，但云安全组仍需单独设置 |
6. 产品侧的已知限制
- 教师端没有错因下钻页面：逐题证据只能由管理员通过接口查询；教师看到的是聚合指标与学生表。[S3]
- 教师看不到对话正文：这是权限设计，不是缺陷；需要了解学生具体提问内容时，应直接与学生沟通。[S3]
- 实验室依赖静态产物：实验页空白通常是静态产物未正确打包，需要运维检查；未登录时实验进度只保存在本机。[S3]
- 反馈栏显示瑕疵：交付材料记录了反馈栏中「✗」符号的显示问题，不影响主链路。[S5]
- 家长端依赖学生确认：学生不确认绑定，家长看不到任何学习数据；这是隐私设计，不是故障。[S3]
7. 本站刻意不写的三类内容
效果数字
不写提分幅度、提分率、学生人数、合作学校、家长满意度。仓库材料中没有这类可核验数据，写了就是编造。
绝对化表述
不写「100% 准确」「保证提分」「完全替代老师」。产品文档的定位本身就是辅助工具。
社会证明
不使用用户评价、客户 logo、奖项或媒体报道。没有可核验来源的社会证明一律不放。