Miaotofu01/Study-Mate 预览 preview

Miaotofu01/Study-Mate

你的AI学习搭档:定路线、讲知识、做项目,边学边做,学透一门科目

Project Overview项目介绍

StudyMate is a self-study AI tutor workflow that ships twelve DSH skills, an HTML lesson renderer, a curriculum engine, and a "learning mode" preset, designed primarily for DeepSeek Harness and additionally packaged as an OpenAI plugin for Codex and ChatGPT Work. Installation on DSH 0.1.5-rc.2+ runs npx -y @yunmiao/studymate@latest install followed by dsh web, copying the preset and skill set into ~/.dsh/studymate/engine/; the alternative OpenAI build is delivered as studymate-openai.zip from the latest GitHub Release and imported through the host's plugin uploader, with updates handled by re-running the npx command or uploading the refreshed zip to the existing plugin link in the browser.

A typical session begins when the user creates a chat under the learning mode preset and either declares a target subject such as "I want to learn C++ for competitions" or asks "I don't know what to study, help me pick a direction," after which the learning-system skill probes goals, prior level, project aims, and lab preferences before orchestrating five role skills (resource-scout, image-scout, curriculum-designer, learning-coach, practice-evaluator) either through sub-agents when the host supports delegation or sequentially otherwise. Each subject receives a roadmap of nodes ordered by prerequisites and tagged as concept, practice, or lab lessons, all persisted in the workspace at ~/StudyMate along with shared memory covering the learner's level, preferred explanations, and recurring blockers, so subsequent conversations resume rather than restart from scratch.

Required dependencies are Node.js 22.x or 24+, Python 3.9+, and PyYAML, with jsonschema additionally needed for full schema validation, while the DSH preset imposes the 0.1.5-rc.2 floor; the project is MIT licensed under Cattofu, the examples/ directory contains a pre-rendered linear-algebra plus computer-networks workspace that can be cloned and opened directly, and contributors are expected to run npm test plus the four check scripts (check_curriculum, check_lesson, check_pool, check_skill) before submitting changes.

StudyMate 是一套面向数学与计算机科目自学的 AI 学习工作流,内置 12 个 DSH 技能、HTML 课件引擎与「学习模式」预设,通过 npx -y @yunmiao/studymate@latest install 安装到 DSH 0.1.5-rc.2+,随后运行 dsh web 启动;同时也提供 OpenAI 插件包 studymate-openai.zip,可在 Codex 与 ChatGPT Work 中导入,从而同时覆盖 DeepSeek Harness、Codex 与 ChatGPT 三个宿主平台。

典型使用流程是:新建会话时切换到「学习模式」,告诉教练「我想学某门科目」或在不确定时说「我不知道学什么,帮我选方向」,主控技能会盘问目的与基础后调度资源侦察、采图、课程设计、讲解、练习评估五个角色;产出按前置依赖排序的知识点路线图,每个节点标注概念课/实操课/实验课类型,并以独立 HTML 课件呈现,工作区默认存放在 ~/StudyMate,跨会话通过记忆文件持久化水平、偏好与卡点。

依赖方面需要 Node.js 22 或 24+、Python 3.9+ 与 PyYAML(完整校验还需 jsonschema),预设有 DSH 版本下限,许可证为 MIT,版权归属 Cattofu;仓库提供线性代数与计算机网络的 examples/ 示例工作区可直接打开,首次建课前会先盘问再生成 <workspace>/index.html 入口,手动改 YAML 后需补充 npm test 与四项校验脚本。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 no risk signal found未发现风险信号
  • This site's static screen found no obvious risk signal (stars, license, activity, manifest)本站静态筛查没发现明显风险信号(星标、许可证、更新活跃度、清单完整度)
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Miaotofu01/Study-Mate

把 Miaotofu01/Study-Mate 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

StudyMate

StudyMate

你的AI学习搭档:定计划、讲知识、做项目,学透一门科目

DSH 学习模式预设 Antigravity 插件 Python MIT License

StudyMate 是面向数学与计算机科目学习的助手,原则是「learn with doing」

快速开始 · 它是什么 · 核心功能 · 常见问题 · 使用说明 · Antigravity 说明

StudyMate:看板娘 + 手写体品牌字 + 覆盖科目(线代/微积分/概率论/C++/Python/机器学习/深度学习)+「任何科目,一站式搞定 / Learn With Doing」

前言

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

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

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

快速开始

DeepSeek Harness

DSH 依赖:DSH 0.1.5-rc.2+、Node.js(支持范围见 package.json 的 engines)、Python 3.9+、PyYAML。

npx -y @yunmiao/studymate@latest install
  • 桌面端(DeepSeek Harness Desktop):桌面端自带 DSH。它启动过一次之后,安装器就会用桌面端自带的 dsh,把「学习模式」装进它的 desktop 档位。装完完全退出桌面端再重新打开,新建会话时选「学习模式」。
  • 官方 CLI:先 npm install -g @deepseek-ai/dsh@latest,同一条安装命令默认注册到 web 档位,之后用 dsh web 启动。

更新:再次运行上述 npx 命令,然后重启对应的 DSH(桌面端完全退出再打开;CLI 重启并新建会话)。

  • 第一次学习:新建会话时选「学习模式」,说一句「我想学 [某个科目]」。会话开在学习工作区目录里(权限选 workspace-write 或 danger-full-access)最省事——课程就地建,零授权。
  • 会话开在别处也行(比如某个代码仓):课程先建在会话目录下的 .studymate-stage/<slug>(全程零授权),结束时总控问你一句放哪——学习工作区/桌面/文档文件夹/用户根目录/先留着——然后一次 cp -a 搬过去。
  • 还没想好学什么:在学习对话里说「我不知道学什么,帮我选方向」,可选探索后再决定是否开课;已有明确科目或恢复学习直接走原流程。
  • 学习工作区默认在 ~/StudyMate,所有课件与记忆均存放在工作区;已有配置会沿用。
  • 第一次生成课程后,课程主页在工作区目录 <workspace>/index.html,是未来所有课件的入口

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-image-gen 下一个 Next dsh-wallpaper-engine →