studymate

<p align="center"><img src="docs/images/logo.png" width="120" alt="StudyMate"></p> <h1 align="center">StudyMate</h1> <p align="center"><b>你的AI学习搭档：定计划、讲知识、做项目，学透一门科目</b></p> <p align="center">_{StudyMate 是面向数学与计算机科目学习的助手，原则是「learn with doing」}</p> <p align="center">简体中文 · <a href="README.en.md">English</a></p> <p align="center"><a href="#快速开始">快速开始</a> · <a href="#它是什么">它是什么</a> · <a href="#核心功能">核心功能</a> · <a href="#常见问题">常见问题</a> · <a href="docs/使用/使用说明.md">使用说明</a> · <a href="docs/使用/Antigravity.md">Antigravity 说明</a></p> <p align="center"><img src="docs/images/taitou.png" width="860" alt="StudyMate：看板娘 + 手写体品牌字 + 覆盖科目（线代／微积分／概率论／C++／Python／机器学习／深度学习）+「任何科目，一站式搞定 / Learn With Doing」"></p>

前言

本项目原先是vibe出来给自己用的一个小项目，没想到有这么多人喜欢。但是vibe出来的东西有很多的问题，包括但不限于「文档过于臃肿且充满AI味、可读性极差」、「海量且无用的防御性代码」、「混乱的功能模块」。

虽然现在跑起来的效果也不差，但是跟我理想中的效果还是有很大差距

我觉得这样的东西对不起这么多的信任与star，我会直视这些问题，并且人工修改审查每一个文件，在未来的更新维护中给大家带来更好的体验，感谢大家的使用与支持，有任何建议都可以提个issue，本项目将长期维护。

快速开始

DeepSeek Harness

DSH 依赖：DSH 0.1.7-alpha.1+

安装

• web端

dsh plugin --profile web add @yunmiao/studymate

• 桌面端

dsh plugin --profile desktop add @yunmiao/studymate

更新

• web端

dsh plugin --profile web update @yunmiao/studymate@latest

• 桌面端

dsh plugin --profile desktop update @yunmiao/studymate@latest

• 第一次学习：新建会话时选「学习模式」，说一句「我想学 [某个科目]」。学习数据直接写进配置好的学习工作区（暂存模式已删，没有"收尾问落点再搬一次"这一步）。
• 还没想好学什么：在学习对话里说「我不知道学什么，帮我选方向」，可选探索后再决定是否开课；已有明确科目或恢复学习直接走原流程。
• 学习工作区默认在 ~/StudyMate，所有课件与记忆均存放在工作区；已有配置会沿用。
• 阅读在 DSH 的阅读端：装好后新建会话时选「学习模式」，从侧边栏切到阅读端就能读课件、作答、搜资料——页面由阅读端实时渲染，不再预生成 HTML。

工作区、更新、桌面端与换机器续学、以及老版本 DSH 的替代装法见 安装说明。

Codex 和 ChatGPT Work

支持范围：只有 v1.0.0。 1.1.0 起的版本不再保证在这一侧可用。

从 v1.0.0 的 Release（ZIP 直链）下载 studymate-openai.zip，通过 Codex/ChatGPT 提供的插件导入入口导入（详见 导入说明）。这一侧没有后续版本可换，换机器时用同一个 ZIP。

Google Antigravity

支持范围：只有 v1.0.0。 1.1.0 起的版本不再保证在这一侧可用。

用 v1.0.0 那棵树构建并安装（不要用 main）：

git checkout v1.0.0
node bin/studymate.mjs build-antigravity --install

或者通过 npm run build:antigravity 构建 ZIP 包手动导入（详见 Antigravity 说明）。

它是什么

StudyMate 是一套数学/计算机学习工作流、SKILL 与 DSH 插件，支持 DSH（DeepSeek Harness）的「学习模式」预设、Google Antigravity 原生多智能体插件，也可打包为 Codex 和 ChatGPT Work 插件。它按需组织收集资料、采图、课程设计、讲解、练习评估五个角色；宿主支持时可委派给子代理，否则依次完成各角色工作。

• 课程组成：讲解|练习|项目实操：每门课一份大纲——知识点按前置依赖排成路线图，每个知识点标课的类型「概念课 | 实操课 | 实验课」（大纲里写 概念／实操／实验）。学习进度落在文件里，每次新对话可继承已有进度。
• 跨科目共享记忆：记住你的现有水平、哪种讲法有效、常见卡点，下一门课不用重新自我介绍。

为什么用它

常见做法	卡在哪	StudyMate 的做法
直接跟 AI 聊天学	会话一长上下文就吃不下；聊完不留痕，下次从零开始	信息与偏好由记忆文件保存；每次会话只带相关记忆、上下文短；课件是教科书式的讲解与配图
看视频课 / 网课	质量参差不齐；付费；无法跟随前沿发展的节奏	讲解方式定制化；收集最新的资料与标准；完全开源

核心功能

课程总览与大纲路线图：总览页列全部科目与当前节点，点进去是那门课的知识点路线图，按依赖分层排开、按状态着色，点节点原地展开课件子卡片。

课件是学习的主载体：经典教材的讲解风格，丰富的配图，定制化的题目与项目目标。

…