一个从真实复习场景中提炼出来的 AI 辅助复习系统原型。
原仓库名仍为zhongkao,但当前维护重点已经从单次考试冲刺,转向可复用、可研究、可部署的复习解决方案。
这个仓库现在可以被理解为:
Review OS:基于 GitHub、Markdown Vault 和 AI Agent 的复习操作系统。
它的核心目标是把资料、错题、作文素材、知识弱点、每日训练、AI 接手规则和完整来源统一放进一个版本化仓库,让复习过程变成可以维护、迁移、复用和部署的学习工程。
完整方案见:docs/review-os-solution.md
| 层级 | 路径 | 作用 |
|---|---|---|
| Vault 层 | vault/ |
主知识库:资料、错题、作文、母题、附件、问老师清单 |
| Model 层 | vault/02_母题模型/ |
把错题和典型题抽象成可迁移模型 |
| Writing 层 | vault/04_万能素材/、vault/语文/作文素材/ |
管理作文素材、完整稿、适配关系和来源状态 |
| Agent 层 | 99-Agent/ |
AI 接手协议、自动化说明、内容完整性规则、修复记录 |
| Script 层 | scripts/ |
自动检查、整理和维护脚本 |
| Solution 层 | docs/ |
面向复用、部署、网站展示的方案说明 |
- 原题、原文、图片、来源说明优先于漂亮总结。
- 索引只负责导航,不能代替完整资料。
- 摘要不能冒充正文。
- 有迁移价值的错题要沉淀为“下次看到怎么反应”的模型。
- AI 接手时必须先读 README 和对应接手指南。
- 自动化只做提醒或接手卡,不能冒充真实执行。
- 公开部署时只展示系统结构、方法论和脱敏样例。
- 课堂资料
- 错题截图
- 作文草稿
- 练习反馈
- 老师建议
- AI 对话产物
- 判断材料类型:原题、错题、素材、方法、索引、状态。
- 检查是否有完整来源。
- 写入对应目录。
- 把有迁移价值的内容抽象成母题、素材卡或方法卡。
- 把不完整内容放入待补清单,不伪装成完整资料。
- 由 AI 根据仓库状态继续生成题单、修复索引或整理资料。
- 每日题单
- 错题回炉清单
- 作文素材适配表
- 学科弱点地图
- 打印资料
- 网站展示页
- 可复用模板
| 类型 | 入口 |
|---|---|
| 系统方案 | docs/review-os-solution.md |
| 主知识库 | vault/ |
| 母题模型 | vault/02_母题模型/ |
| 作文素材 | vault/04_万能素材/、vault/语文/作文素材/ |
| AI 接手协议 | 99-Agent/specs/chatgpt-github-learning-protocol.md |
| 内容完整性协议 | 99-Agent/specs/content-integrity-protocol.md |
| 自动化说明 | 99-Agent/automations/ |
| 修复记录 | 99-Agent/status/content-integrity/ |
- 不要把本仓库继续当成单纯的考前提醒器。
- 优先把它视为 Review OS 原型:系统化、模型化、可交接、可部署。
- 做具体资料时,仍然先读
vault/中对应原文和索引。 - 做网站展示时,只抽取结构、方法论和脱敏样例。
- 修改文件前要确认路径和来源,不凭聊天记忆乱写。
- 发现断链、摘要冒充正文、状态过期、步骤缺失时,应直接修复并说明。
- 需要删除大段旧资料、公开私有内容、改变仓库权限时,必须先询问。
- 把系统方案拆成公开版与私有实施版。
- 从现有目录抽出干净模板。
- 统一错题卡、作文素材卡、每日题单模板。
- 在个人网站新增 Review OS 展示页。
- 整理可公开案例。
- 未来可考虑做成静态网站、CLI 或轻量 Web App。
本仓库仍保留旧复习资料,因为这些材料是系统原型的真实地层。
但从现在开始,维护重点转向:
把一次复习工程提炼为一个可研究、可复用、可部署的 AI 学习系统。