最后核对：2026-09-08，代码基线
main@c485941。赛题：XH-202620《面向一流学科建设的学科垂类大模型与创新应用开发》。赛题原文同时出现 2026-09-05 和 2026-09-15 两个提交日期，团队必须向赛事方确认，不在本文自行裁定。
ESA 面向计算机学科，以可信知识、真实任务和可验证证据形成教学研闭环：
- 学生获得结合知识点、前置关系和真实学习证据的讲解、练习与复习建议。
- 教师使用 AI 提高作业诊断效率，但保留评分、反馈和正式学习证据的最终裁决权。
- 科研用户在项目边界内组织检索、写作和数据分析，系统不伪造来源、数据或结论。
| 层 | 当前实现 |
|---|---|
| 客户端 | Flutter Web/iOS/Android/macOS/Windows/Linux 工程；学生与教师角色进入不同 Shell |
| API | FastAPI；canonical /api；118 个 OpenAPI path、147 个 HTTP operation；SSE 与 LSP WebSocket |
| Agent | Workspace Route、Scoped Tool/Skill、循环/工具/重试/墙钟预算、审批动作、三通道工具结果 |
| 模型 | Qwen3.5 主辅模型、vLLM、可选 LoRA；辅助模型承担受限分析和后台任务 |
| 学习 | 课程图谱、Student Model V2、学习证据、知识地图、推荐、课表与个人规划 |
| 教学 | 班级、邀请、作业、提交、AI 建议、教师复核、发布、学情聚合和审计 |
| 科研 | 项目、Project Profile、前沿任务、写作文档/版本、数据集与分析任务 |
| 知识 | MinerU、DocIR、Chunk、Qdrant、公共/个人检索、来源定位和引用资格 |
| 存储 | SQLite 业务状态、文件存储、Qdrant 向量；个人库具备 revision、journal、recovery 和 snapshot |
| 安全 | Bearer Session、用户/班级/项目隔离、TrustedHost/CORS/Proxy、审批、审计和 fail-closed 沙箱 |
- 自然语言问题能够结合当前 Workspace、课程与知识点进入正确教学策略。
- 未知知识点不写入学习状态；重复请求不重复计入证据。
- mastery、retention、confidence 和 evidence summary 语义分离。
- 推荐结果给出掌握缺口、复习压力、考试/目标和前置风险等可解释理由。
- 教师只能管理本人班级；学生只能访问本人提交和已发布反馈。
- AI 输出是可修改建议，不能绕过教师复核直接发布或更新掌握度。
- 发布后的逐题反馈可写入幂等学习证据，并进入班级已发布范围的聚合。
- 无权限和不存在资源使用不泄露归属的错误语义。
- 项目、文档、数据集和任务始终校验当前用户与绑定项目。
- 前沿追踪保留查询、时间窗和论文样本，不把启发式热点分数写成正式计量结论。
- 写作只使用已提供材料；证据不足时明确待补来源。
- 数据分析返回可核验统计和限制，不把相关性写成因果。
- 上传、授权、异步准备、状态、预览和删除均绑定当前用户与会话/知识库。
- DocIR 不补造 Page、bbox、slide 或 sheet；无法验证的 OCR 文本不得标记为可逐字引用。
- 检索必须携带可信 scope/generation 过滤并返回稳定 Evidence。
- 条件性依赖缺失时明确降级或 fail-closed，不伪造“已解析”“已检索”“已执行”。
- 同一对话跨 Worker 串行，不同对话可并行。
- SQLite 迁移、外键、事务、幂等和恢复路径有自动测试。
- 密码强哈希；密钥、验证码、Session、私人附件内容不进入日志。
- 生产代理只信任配置的 Host、Origin 和 Forwarded IP。
- 前端支持 Markdown、LaTeX、代码、工具状态、附件预览、移动端安全区和会话恢复。
- 所有质量结论必须说明运行环境和跳过项。
| 编号 | 材料 | 项目要求 |
|---|---|---|
| 01 | 参赛信息 | 报名系统审核通过且盖章的报名表，信息完全一致 |
| 02 | 伦理与安全合规性声明 | 脱敏、学术诚信、AI 标识承诺，负责人签字或团队盖章 |
| 03 | 作品 Demo | 可访问地址、临时账号交付方式、操作说明和故障边界 |
| 04 | 作品方案 | PPTX 小于 100 MB，覆盖作品、功能、技术、效果、迭代、创新、团队 |
| 05 | 作品代码 | 代码、模型文件或 ServiceID、技术报告和可复现说明 |
| 06 | 效果验证报告 | 至少 2 名真实目标用户、结构化记录、3 个典型问题、3 分钟以内真实交互视频 |
| 07 | 其他材料 | 测试、原始评测、RAG/数据报告和可选规模化数据 |
- 目标环境完整启动与双账号教学流程无阻断。
- 全量后端测试无失败；Flutter analyze/test/build 在固定 SDK 重跑。
- 3 个典型问题包含原始系统输出、标准答案/来源、人工判定和时间记录。
- 至少 2 名真实用户本人确认反馈；不使用占位内容。
- 技术报告、PPT、Demo 说明与代码使用同一项目名、版本和能力边界。
- 模型适配器或 ServiceID 可访问，并记录基座、LoRA、考卷和校验信息。
具体未完成项见 TODO.md，文档可信级别见 DOCUMENTATION.md。