OpenK12 桌面学习与知识网络平台产品系统Vibe Coding

1. 立项原因与产品问题

传统数字化学习产品多以课程、视频或单篇练习为中心，学生容易停留在逐课学习，难以理解整本教材的结构及知识联系。同时，教材、资料与练习分散，正文与知识点缺乏稳定映射；大型知识图谱又容易增加认知负担。不同学科需要不同的知识组织方式，学习记录、错题、复测与教学审核也缺少统一的数据基础。

因此，OpenK12 以桌面客户端作为学生学习入口，以 Intellicore 作为内容与学习能力中台。项目首先通过九上世界历史验证“整册主线—单元导航—教材阅读—知识网络”的学习路径，后续再扩展练习、错题、复测和学情能力。

2. 行业场景

家庭自主学习

学生可在个人电脑上进行预习、复习和知识梳理，通过整册主线与知识网络理解历史事件之间的时间、因果和发展关系。

校内及教育机构

教师和教育机构可按单元、课程、知识主题组织课堂讲解与课后学习，后续可结合学习任务、错题训练和阶段复测形成连续学习流程。

数字教材与个性化学习

Intellicore 统一管理教材、知识点、知识关系和学习资源，OpenK12 负责学生端执行与呈现。接入学习者数据后，可根据练习和错题状态组织针对性训练。

本地化部署

客户端与中台分离，支持家庭、学校或机构内部部署。正式进入共享环境前，仍需完善认证、访问控制、跨域策略和凭据安全存储。

1. 具体功能模块

桌面应用与学习工作台
OpenK12 是基于 Tauri 的桌面学习客户端，具备 macOS、Windows 打包基础，提供首页、学习和设置入口。系统采用左侧导航、中间内容、右侧辅助信息的三栏布局，支持边栏折叠、拖拽调宽、快捷键、窗口状态记忆、页面动画和自适应画布。

教材阅读
系统从 Intellicore 获取内容树、资源信息和 Markdown 正文，并将本地单元与后端章节稳定映射。支持标题、列表、表格和教材图片渲染。服务不可用时仍保留本地单元导读；正文缺失、重复或无法唯一定位时会明确提示，不使用虚构内容替代。

历史知识网络
系统支持按照“单元—课—知识主题—原子知识点”逐级浏览七个单元、二十二课和一百二十八个知识主题。学生可搜索人物、事件和概念，查看知识点陈述、来源及真实关系，并使用缩放、平移、筛选、邻居高亮、跨主题跳转和 URL 定位。知识网络采用小规模子图渐进加载，避免一次展示全部节点。未完成教研审核的数据持续标记为开发预览。

Intellicore 接入与扩展
客户端支持配置 Intellicore 地址及课程 ID或标题，接入教材和知识接口，并校验数据结构、版本、层级和内容哈希。配置变化时会清理旧请求和缓存，避免混用数据。学习者身份、练习、错题、训练、复测、学情分析以及数学、物理等学科等模块已调试完毕。

2. 主要功能描述
OpenK12 将教材结构、教材正文和知识关系组织成连续的桌面学习过程。学生先通过整册主线建立整体认知，再进入单元学习、教材阅读和知识网络探索。
OpenK12 负责学生端交互与呈现，Intellicore 负责内容、知识及后续学习数据，两者通过接口协作，为下一阶段练习、错题训练和学情反馈奠定基础。

1. 项目中的具体任务

桌面应用与框架

- 基于 Tauri 2、React、TypeScript 和 Vite 搭建跨平台桌面客户端。
- 配置原生窗口、安装包、Hash Router、窗口状态记忆、全局样式和页面动画。
- 实现三栏学习布局、左右边栏折叠与拖拽、快捷键及 Windows 窗口控制。
- 建立首页、设置和九上历史模块路由。

九上历史与内容接入

- 建立整册历史主线、七个单元、二十二课及其核心问题、学习目标和学习路线。
- 实现历史首页、整册主线、单元导航、单元详情和教材阅读页面。
- 接入 Intellicore 内容树、资源信息和 Markdown 正文接口。
- 完成课程、章节映射及教材图片资源处理。
- 对章节缺失、重复、服务离线和契约错误提供提示，并保留本地单元导读。

知识网络

- 接入知识大纲、单元图谱和知识点详情接口。
- 使用 Cytoscape.js 实现缩放、平移、搜索、筛选、节点选择和邻居高亮。
- 建立“单元—课程—知识主题—知识点”渐进式导航。
- 支持主题关系图、跨主题关系出口、URL 深链接和右侧详情联动。
- 校验数据版本、内容哈希、层级、数量和关系完整性。

状态与质量控制

- 处理配置切换、并发请求、取消、缓存和数据版本失效。
- 防止旧请求覆盖新状态或混用不同数据快照。
- 建立内容映射和知识契约测试，覆盖重复、缺失、悬空关系及哈希漂移。
- 执行类型检查、自动测试、生产构建和 Intellicore 联调。
- 对未教研发布的数据持续显示开发预览标识。

2. 技术栈与架构

技术栈包括 Tauri 2、Rust、Window State Plugin、React 18、TypeScript、Vite、React Router、Zustand、Ant