Product Overview · 产品概览
洞见是什么：一套可自建部署的高考数学学习诊断系统
一句话定义（可独立引用）
洞见是一套面向学校、机构与教师自建部署的高考数学学习诊断系统：它把高中数学拆成 17 个主干知识点及其先修依赖，通过约 25 题的诊断定位学生的薄弱环节，并按诊断结果生成当日讲义，帮助回答「我到底哪里不会、今天该练什么」。[S1][S2]
洞见不替代老师，也不承诺提分。它做的是把「诊断 → 讲解 → 练习」这条路上的信息整理清楚，让教师看到班级整体学情、让家长看到学习记录、让学生知道下一步练什么。
[S1]产品定位：解决什么问题
高中数学复习中，学生常见的困境不是「没有题做」，而是不知道自己的缺口在哪一层：是某个公式没记住，还是前置的知识点没有学会。洞见的做法是先建立一张知识点先修图，再用诊断题在图上定位，而不是随机抽题。
- 诊断有结构：高中数学被拆成 17 个主干知识点（L0 基础到 L4 综合），节点之间存在「必须先会 A 才能学会 B」的依赖关系。[S1]
- 结果有状态：每个知识点按作答情况归入已掌握、待巩固、薄弱、未测四种状态，判定规则写在学生手册中。[S2]
- 下一步有指向：诊断完成后生成「每日一讲」，内容包含知识点、例题、方法链、变式与先修提醒，而不是泛泛的学习建议。[S2][S3]
它如何工作：三步主链路
适用规模与部署形态
洞见是单机部署的产品，面向学校、机构或教师自行搭建使用，并不是多租户 SaaS，也不承诺任意规模的并发能力。[S6][S5]
| 项目 | 当前形态 |
|---|---|
| 运行方式 | 单台 Linux 服务器，Nginx 终止 HTTPS，前端 Next.js 与后端 FastAPI 均只监听回环地址 |
| 进程模型 | 后端固定单 uvicorn worker；任务 worker 内嵌在后端进程内，没有独立服务 |
| 数据组件 | PostgreSQL 16 与 Redis 7，均仅回环监听 |
| 参考配置 | 4 核 8G、50G 系统盘 + 100G 数据盘、5 Mbps 带宽（文档给出的参考值，不是性能承诺） |
| 数据与备份 | 数据根目录独立挂载；每日定时备份，本地保留 30 天并同步对象存储 |
如果对象是区县一级的多所学校、或需要弹性扩容的公有云服务，本产品当前的部署形态并不匹配，需要另行评估。详见边界与局限。[S5][S6]
哪些事实有实测依据
本站只引用仓库内文档与生产测试报告中可核验的记录，不写未经实测的效果数字。下面几类事实可以追溯到具体材料：
| 产品与版本 | 洞见基于开源项目 DeepTutor 改造，版本基线 1.7.2；上游采用 Apache 2.0 许可证。[S1][S7] |
|---|---|
| 回归测试 | 2026-11-12 生产环境全量回归：92 条用例，91 条通过、0 条未通过、1 条未验证（模型自动 failover 需读实例配置确认）。[S4] |
| 稳定性 | 账号库死锁修复后并发实测 2352 次请求，0 死锁、0 个 500 响应。[S5] |
| 已关闭的三项缺陷 | 邀请码账号未要求同意书、图片 20 MB 上限失效、新账号无初始模型授权，均在生产环境复测通过。[S4] |
| 未验证项 | 备份恢复演练（restore）尚未在生产演练；模型自动 failover 未验证。本站不将其表述为已具备的能力。[S4][S5] |