1Vewton/dsh-edu

The educational version of deepseek harness

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), adding a switchable education mode to the DSH agent workflow. Unlike simple prompt snippets, it ships with a valid DSH bundle manifest and Cordis plugin structure, so it can be installed directly via the DSH CLI without extra build steps. The pre-built lib directory is committed to the repository, so no additional build permissions are required to install and run the plugin. It injects a structured teaching protocol into every model request and adds three custom tools to manage the full learning lifecycle from course creation to final grading.

After installation, users activate education mode by running the /edu [subject] command in the DSH chat interface. The agent follows a strict five-stage process: gathering authoritative sources via existing DSH web tools, explaining concepts in a structured, learner-friendly way, writing lesson notes to a persistent course file, quizzing the user to check understanding, and marking progress across sessions. All course content is stored as markdown files in the DSH session workspace, so progress persists even after the session ends. This plugin is designed for users who want to learn new topics with the help of the DSH agent.

The plugin is released under the open-source MIT license, and can be installed via npm, a GitHub Release tarball, or directly from the Git repository using the DSH CLI. It has several documented limitations: mode state is per-session, so turning off education mode in one session does not affect others; courses with identical names are merged; open-ended quiz questions rely on the model’s judgment for grading; and education mode does not block access to other DSH tools. No external dependencies are required beyond the base DSH installation, and the plugin works on both Ubuntu and Windows systems with supported Node.js versions.

这是专为DeepSeek Harness(DSH)打造的原生插件,为DSH添加了可随时开关的教育学习模式。它不是简单的提示词片段,而是包含完整的DSH包清单和cordis插件结构,会为DSH Agent注入一套结构化的教学流程,还额外提供了三个自定义工具,支撑从课程创建到笔记整理再到测验评分的完整学习流程。

用户安装插件后,可以通过 /edu 指令开启教育模式,设定想要学习的主题。Agent会按照收集权威资料、讲解核心知识点、整理结构化课程笔记、发起测验检查掌握情况、记录学习进度的步骤推进学习,所有学习内容会保存在工作区的课程文件中,进度可跨会话保留。适合想要借助DSH Agent系统学习新知识领域的用户使用。

该插件已将编译好的产物提交到仓库,无需额外构建,也不需要构建脚本权限,可通过npm、GitHub Release压缩包或Git源直接安装,遵循MIT许可开源。它的限制包括:模式状态仅对当前会话有效,同名课程会被合并,开放题依赖模型评分,教育模式不会限制其他DSH工具的使用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 dsh-edu-mode

把 1Vewton/dsh-edu 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-edu-mode — education mode

English | 中文

An education mode for DeepSeek Harness (DSH): inside this mode the agent's deliverable is your understanding of a subject. It gathers real sources, teaches the material properly, writes the class notes down, and quizzes you before claiming you have learned anything.

This is a real plugin, not a prompt snippet: a switchable session mode, a teaching protocol injected into every model request, three tools the model has to use, and course files that survive the session.

What it does

Stage Behaviour Enforced by
1. Gather web_search / web_fetch for authoritative sources (textbooks, university course pages, standards, papers), with titles and URLs recorded; parallel subagents when a lesson needs many teaching protocol + the existing web tools
2. Explain why it matters → intuition/analogy → precise definition (every symbol defined before use) → derivation → a fully worked example → usual misconceptions → how it connects teaching protocol
3. Notes after each lesson, edu_notes writes the explanation, key points, pitfalls and sources into the course notes file edu_notes tool
4. Quiz at the end of each lesson, edu_quiz asks you questions in the conversation's own question UI, grades them, and re-teaches anything you missed with new examples edu_quiz tool
5. Progress once a module's quizzes back it, edu_course checks it off; progress persists across sessions edu_course tool

The three tools:

  • edu_course — open creates or rewrites the syllabus (goal, level, module checklist, sources) and makes it the session's active course; status reports progress and the next module; complete checks a module off.
  • edu_notes — writes the class notes for one lesson (body + key points + misconceptions + sources). A second write for the same lesson is refused unless replace: true is passed.
  • edu_quiz — asks, collects answers through the interactive question UI, grades, and logs the result. Choice questions are graded automatically (single- and multi-select); open questions are handed back for the model to judge. With no interactive channel (headless, ACP, a subagent), it degrades gracefully: the questions come back to the model to ask in chat instead of failing.

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-trae-api 下一个 Next dsh-conversation-stats →