dsh-project-based-learning

skill已测通过npmMIT

项目制教学教练：学科无关的教学引擎 + 可替换领域包（随包提供 Unity/C#），同时以 DSH 技能与可安装组合包分发。技能协议强制"先做后教"与分级提示；零依赖校验器会拒绝证据不支撑的能力结论，并在存在未解决阻塞项时阻止阶段通过。

下载量 / Downloads

1,060

依赖体积 / node_modules

0.1 MB

测试时间 / Tested

2026-11-06

DSH 版本 / Version

0.2.2-rc.1

安装

dsh plugin --profile web add dsh-project-based-learning

沙箱测试结果

阶段	结果
1 安装	✓
2 列装	✓
3 挂载	✓
4 启动	—

四阶段在隔离沙箱里跑：安装（有网）→ 列装 → 挂载 → 启动（后三步断网）。

README

项目制教学教练：学员动手，教练跑闭环

面向 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>（DSH）的教学技能与组合包 —— 教学法与学科内容分离，领域导航可整体替换

<a href="README.md">简体中文</a> · <a href="README.en.md">English</a>

本项目把「AI 辅导」约束成一套可执行的教学协议：围绕学习者真正想完成的作品组织教学，把明确讲授作为正式环节，让初学者先获得足以行动的理解，再尽快在真实项目中实践。

先教学，后实践：陌生知识先讲最小必要机制，不要求学员猜测；理论只覆盖当前步骤所需内容，然后立刻回到一次真实操作。
就地解释：新概念、新内置函数和非显然语法在首次使用处说明，不逐行翻译整个文件，也不为「完整」一次展开整门学科。
非评分式证据：只用五档描述性概念状态记录「讲过」与「已经通过实践展示」的区别，不使用数字能力分或固定维度等级。
学科解耦：教学法在教学引擎中，学科知识在可整体替换的领域导航中；换学科不需要改引擎。

命名：仓库名、npm 包名、技能注册名三者一致，均为 dsh-project-based-learning（模型侧通过 skill("dsh-project-based-learning") 调用）。

📐 设计取向

教学问题 · 本项目的处理

事实性知识与技能混为一谈 · 事实性知识直接讲授（它解决什么 → 当前代码怎样用它 → 会看到什么 → 最相关的一个坑）

学员自述被一律采信或不采信 · 三类分别处理：能力自述仅作线索；缺口自述直接采信并转入讲授；操作自述无反证时接受，不要求重复实测

讲授被当成掌握 · 「讲过」只能记为已讲授待实践；只有真实使用、修改、排错或迁移才提高状态

示例代码替学员代劳 · 允许完整可运行示范（初学者需要整体结构），但示范后必须让学员修改、解释、验证或迁移

一讲就停不下来 · 连续解释两个以上核心概念、或学员开始追问「什么时候开始做」时，强制转入实践

用同一套标准衡量所有情况 · 支架按最近的真实表现调整：需要更多结构 / 可以局部放手 / 可以开放实践 / 可以检验迁移

🚫 它不是什么

不是题库或刷题工具：领域导航只给粗略依赖与门槛概念，不含诊断题库、固定课时或标准答案。
不是代写工具：审阅请求不自动授权修改；教学请求也不自动扩大项目写权限。
不是官方 DeepSeek 插件：本项目为第三方实现。
不限定学科：随包提供 Unity Shader 与 Unity C# 两份导航，它们都不属于引擎。

🚀 快速开始

方式一：让 DSH 自己装（推荐）

复制下面整段，粘给你正在用的任意一个 DSH 会话——它会自己安装并逐项核对：

请帮我安装 DSH 插件 dsh-project-based-learning（项目制教学教练：技能 + 组合包）。步骤：

1. 执行：dsh plugin --profile web add dsh-project-based-learning
   （profile 名按你实际使用的改，桌面端默认是 web；若失败或装到的版本低于 3.0.0，改用：
    dsh plugin --profile web add github:Kirisame1969/dsh-project-based-learning）
2. 执行：dsh --profile web --dump-config，确认输出里出现 dsh-project-based-learning 层
3. 确认技能已注册：技能目录里应出现 dsh-project-based-learning
4. 向我报告：装到的版本、该层是否存在、技能是否可用

遇到报错先读 https://github.com/Kirisame1969/dsh-project-based-learning 的 README「安装细节」一节。

方式二：自己敲一条命令

dsh plugin --profile web add dsh-project-based-learning

装好后在会话里直接说明要学什么即可，不需要记指令词：

教学模式：我完全没学过 <主题>，请评估我的水平

教练会先判断该走哪条教学车道，然后先讲授当前必要的最小机制，再尽快带你做出一个可观察的结果——而不是先甩一组诊断题。

随包提供的领域导航示范见 skills/dsh-project-based-learning/references/domains/unity-shader.md 与 unity-csharp.md。

📦 安装细节

组合包：从 npm 或 GitHub 安装

dsh plugin --profile web add dsh-project-based-learning     # 也可用 --profile headless 或你自己的 profile
dsh --profile web --dump-config                             # 应出现 dsh-project-based-learning 层

不经 npm，直接从本仓库安装：

dsh plugin --profile web add github:Kirisame1969/dsh-project-based-learning

组合包层（cordis.patch.yml）通过 ctx.skills.register() 注册随包分发的技能。插件只消费 skills 服务，不 import 任何 harness 包，也不会带进第二份 Cordis。

卸载：

dsh plugin --profile web remove dsh-project-based-learning

学习数据位于工作区的 .learning/，卸载插件不会删除它。

完全不安装

将 agent 指向 skills/dsh-project-based-learning/SKILL.md，令其按该文件执行。教学协议、领域导航与脚本均为普通文件。

🛣️ 教学车道

技能按请求自动选择最轻的一条车道，不需要你记住分类：

车道 · 何时走 · 是否建档

快速教学 · 解释一个概念或局部代码 · 否

单次带练 · 一次或少数几轮里做出一个小结果 · 默认否

持续课程 · 围绕项目跨多轮推进 · 是（.learning/state.json）

成果审阅或排错 · 检查你提交的代码、作品或现象 · 否

里程碑回顾 · 你明确要求回顾、验收或调整路线 · 否（读已有状态）

意图清楚时直接开始，不先做知识考试。只有缺失信息会明显改变技术方案、项目边界或教学方式时才提问，且每轮最多问三个。

🧩 工作原理

flowchart LR
    A["定位本次结果"] --> B["教学必要机制"] --> C["示范（按需）"]
    C --> D["学员实践"] --> E["观察现象"] --> F["因果反馈"]
    F --> G["邻近变化"] --> H{"调整支架"}
    H -->|成功| I["减少支架 / 下一个结果"]
    H -->|受阻| D
    I --> J["记录有意义的变化"]

skills/dsh-project-based-learning/
├── SKILL.md                         # 入口：车道、不可违背原则、默认循环、输出方式、路由
├── references/
│   ├── teaching-loop.md             # 注意力焦点、教学粒度、示范强度、实践设计、提问、纠错、防理论漂移
│   ├── planning-and-state.md        # 路线粒度（now/next/later）与概念状态语义
│   ├── review-and-adapt.md          # 成果审阅、把排错当教学、支架调整、里程碑回顾
│   ├── permissions.md               # 请求类型区分、项目写边界、证据与隐私
│   ├── domain-guidance.md           # 领域导航「应包含 / 不得包含」的契约
│   └── domains/
│       ├── index.md                 # 选择至多一份相关导航
│       ├── unity-shader.md          # Unity Shader 依赖图、门槛概念、风险、版本核对
│       └── unity-csharp.md          # Unity C# 依赖图、门槛概念、风险、版本核对
├── assets/
│   ├── state.template.json          # 2.0 状态模板
│   └── lesson-note.md               # 可选的单课记录模板
└── scripts/
    ├── validate-learning-state.mjs  # 零依赖状态校验器
    └── migrate-v1-state.mjs         # 从 2.x 旧状态一次性迁移

协议按需加载：SKILL.md 只在需要时引用上表的详细文件，避免把整门课的方法论塞进每一轮上下文。
学科只影响路线：领域导航提供粗略依赖与门槛概念；具体讲解、示例、练习和问题围绕当前作品即时生成。

🎛️ 领域导航

教学法不绑定任何学科。领域导航是单文件、粗粒度的依赖图，用来避免路线失序，不储存课程正文——即使一份导航都没有，通用教学循环依然完整可用。

<summary>随包提供的两份导航（点击展开）</summary>

文件 · 覆盖范围

references/domains/unity-shader.md · Shader、材质、Sprite 视觉处理、屏幕滤镜。门槛概念如「片元 / 屏幕像素 / 纹素不是同一个概念」「UV 是坐标不是循环变量」；含透明渲染状态、坐标比例、过度绘制等风险

references/domains/unity-csharp.md · C# 游戏逻辑、组件模型、场景组织、运行时调

…(truncated)

以上内容来自 npm 上的 README，我们只做格式化，不改内容。

版本

npm 上共发布：4，最后更新 2026-09-27

链接

GitHub · Homepage · npm