DeepSeek Harness 插件

bortpro/dsh-plugin-socratic-tutor

Star 数 ★ 0 分类 工具与能力 收录于 2026-11-20

苏格拉底式导师:按主题定制课程、诊断性提问、保存技能图谱、间隔复习与结业评估。

安装

# Release 预构建包

dsh plugin --profile web add "https://github.com/bortpro/dsh-plugin-socratic-tutor/releases/download/v1.0.0/dsh-plugin-socratic-tutor-1.0.0.tgz"

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:bortpro/dsh-plugin-socratic-tutor

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

该插件的 README 只有英文版本。

Socratic Tutor runs an ongoing lesson in a DeepSeek Harness conversation. It builds a curriculum from the topic, asks one question at a time, tracks evidence against a 0–5 skill scale, and uses spaced review and a final assessment.

Install

Use DeepSeek Harness 0.2.2-rc.5, Node.js 24.9.0 or later, and pnpm on your path.

dsh plugin --profile web add https://github.com/bortpro/dsh-plugin-socratic-tutor/releases/download/v1.0.0/dsh-plugin-socratic-tutor-1.0.0.tgz
dsh --profile web

To build and install from a local checkout:

npm ci
npm pack
dsh plugin --profile web add ./dsh-plugin-socratic-tutor-1.0.0.tgz
dsh --profile web

The package declares its profile layer through dsh.bundle.patch. Harness bundle documentation

Use

Input Effect
/tutor <topic> Start a lesson for the current conversation and ask the first diagnostic question.
/tutor <topic> --full-mastery Require level 5 in every skill before the final assessment.
/progress or show progress Display the skill map.
/tutor-save or save state Return a portable JSON snapshot.
/tutor stop Pause the current lesson and keep its progress.
/tutor resume Resume the lesson saved for the current conversation.
/tutor resume <saved JSON> or resume from: <saved JSON> Restore a portable snapshot in this conversation.

You can also start with Teach me linear algebra, Quiz me on SQL joins, or Help me master fractions. Requests such as Help me understand fractions prompt for confirmation when no lesson is active. Standalone queries such as What is covariance? follow the ordinary chat route. During a lesson, type harder, easier, or just tell me to change how the tutor handles the current question.

The Cordis configuration field defaultTargetLevel accepts integers from 1 to 5 and defaults to 4. Progress is written after each lesson action to a conversation-specific JSON file under .socratic-tutor/ in the current workspace. Reopening the same conversation in that workspace preserves progress across Harness restarts and model switches. Use a portable snapshot to move a lesson to another workspace or conversation. Snapshots can contain pending questions and notes on misconceptions.

Harness enforces state transitions and the evidence required to promote a level. The selected model generates the curriculum, asks the questions, and evaluates answer quality. Use a model and agent preset with tool calling enabled.

Development

npm ci
npm test

The tests use the Harness command registry, prompt assembly, and native tool executor with scripted model actions.

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。