Miaotofu01/Study-Mate

选用指南

AI 根据 README 整理 · 2026/10/17 01:06:19

使用方式

通过 DSH 插件安装，或作为 Antigravity 插件、Codex/ChatGPT 插件使用；日常使用通过命令行运行 npm test 自检。

查看 README 依据

<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端 ```bash dsh plugin --profile web add @yunmiao/studymate ``` - 桌面端 ```bash

> **支持范围：只有 `v1.0.0`。** 1.1.0 起的版本不再保证在这一侧可用。 从 [`v1.0.0` 的 Release](https://github.com/Miaotofu01/Study-Mate/releases/tag/v1.0.0)（[ZIP 直链](https://github.com/Miaotofu01/Study-Mate/releases/download/v1.0.0/studymate-openai.zip)）下载 **studymate-openai.zip**，通过 Codex/ChatGPT 提供的插件导入入口导入（详见 [导入说明](docs/使用/Codex与ChatGPT.md)）。这一侧没有后续版本可换，换机器时用同一个 ZIP。 ### Google Antigravity > **支持范围：只有 `v1.0.0`。** 1.1.0 起的版本不再保证在这一侧可用。 用 `v1.0.0` 那棵树构建并安装（不要用 `main`）： ```bash git checkout v1.0.0 node bin/studymate.mjs build-antigravity --install ```

- **带着指定教材自学** → 盘问结束后主动提供本地资料路径（讲义、笔记或教材目录），系统把教材转成 Markdown 放进 `reference/`（学生能翻），把它收集到的在线来源转成 Markdown 放进 `sources/`（写课对齐用）；大纲与课件都对着这批原文写。 - **贴一段看不懂的课文 + 「这里没懂」** → 主教练当场答一小段，记一条档案，送你回原位接着读。 - **「考考我」** → 现场出题 + 按可运行证据核验，给一份评估记录并更新进度。 - **「太简单了 / 没听懂」** → 换讲法（加边界与反例，或降一层抽象），并把这条偏好记进共享记忆。 <img src="docs/images/preview-chat.png" width="640" alt="对话示例"> ## 配置与维护 日常要跑的命令只有一条，就是你装完之后自检的那条： ```bash npm test ```

部署要求

需要 Node.js 22.19+ 或 24；DSH 侧需要 DSH 0.1.7-alpha.1+；导出静态页面时需要 React。

查看 README 依据

<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"> <img src="https://img.shields.io/badge/DSH-%E5%AD%A6%E4%B9%A0%E6%A8%A1%E5%BC%8F%E9%A2%84%E8%AE%BE-1c5a40" alt="DSH 学习模式预设"> <img src="https://img.shields.io/badge/Antigravity-%E5%A4%9A%E6%99%BA%E8%83%BD%E4%BD%93%E6%8F%92%E4%BB%B6-4285f4" alt="Antigravity 插件"> <img src="https://img.shields.io/badge/Node.js-22.19%2B%20%7C%2024-339933" alt="Node.js">

<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端 ```bash dsh plugin --profile web add @yunmiao/studymate ``` - 桌面端 ```bash

<summary><b>装完看不到课件页</b></summary> 课件由**阅读端实时渲染**，不再预生成 HTML（页面模板已随 #83 退役）。在 DSH 里新建会话选「学习模式」，从侧边栏切到阅读端即可。要一份能离线打开的，跑 `npx -y @yunmiao/studymate export`，产物在 `<工作区>/export/`。 </details> <details> <summary><b>还需要装 Python 吗</b></summary> 不需要。引擎从 Python 脚本迁到了随包发的 TypeScript 插件（[ADR-0002](docs/adr/0002-引擎改用TypeScript.md)），安装器也不再探测 Python。只有一件事另外要 Node：导出静态页面时要一份 React（`npm i -g react react-dom`，或用 `STUDYMATE_REACT_DIR` 指过去）。 </details> 更多问题（手改 YAML 的坑、大纲改节点后指针为什么会错、能不能离线）见 [使用说明 §八 常见问题](docs/使用/使用说明.md#八常见问题)。 ## 贡献 / License - **项目交流群**(QQ)：161914370

已知限制

Codex 和 ChatGPT 侧仅支持 v1.0.0，1.1.0 起不再保证可用；Antigravity 侧同样仅支持 v1.0.0。

查看 README 依据

> **支持范围：只有 `v1.0.0`。** 1.1.0 起的版本不再保证在这一侧可用。 从 [`v1.0.0` 的 Release](https://github.com/Miaotofu01/Study-Mate/releases/tag/v1.0.0)（[ZIP 直链](https://github.com/Miaotofu01/Study-Mate/releases/download/v1.0.0/studymate-openai.zip)）下载 **studymate-openai.zip**，通过 Codex/ChatGPT 提供的插件导入入口导入（详见 [导入说明](docs/使用/Codex与ChatGPT.md)）。这一侧没有后续版本可换，换机器时用同一个 ZIP。 ### Google Antigravity > **支持范围：只有 `v1.0.0`。** 1.1.0 起的版本不再保证在这一侧可用。 用 `v1.0.0` 那棵树构建并安装（不要用 `main`）： ```bash git checkout v1.0.0 node bin/studymate.mjs build-antigravity --install ```