superFAN14/dsh-plugin-academy

⬡ DSH 插件开发学院 · dsh-plugin-academy

面向零基础的 DeepSeek Harness 插件开发学习 + 答题网站。
A zero-to-hero learning & quiz website for DeepSeek Harness plugin development.

纯静态网页 · 零依赖 · 双击即用 · 离线可用

license
platform
deps
lessons
quiz
terms

🚀 立即开始在线学习

免安装 · 免注册 · 打开浏览器即学

⚠️ 免责声明

- 本项目是第三方社区教学项目，与 DeepSeek（杭州深度求索人工智能基础技术研究有限公司）无任何隶属关系，非官方出品。
- 文中 "DeepSeek"、"DeepSeek Harness"、"DSH" 等名称均为其商标，版权归 DeepSeek 所有；本项目未使用其任何专有素材。
- 课程内容与示例代码为原创整理与编写，参考的官方资料均为 MIT 开源协议（@deepseek-ai/dsh、@deepseek-ai/cordis 等），仅作学习交流，不构成对任何开源项目的再分发。
- 课程文字由 AI 辅助编写、人工校对，如有疏漏欢迎指出。

📖 这是什么

DeepSeek Harness（DSH）是 DeepSeek 出品的智能体运行平台，本身几乎全部由插件组成。
这个网站把「学会开发 DSH 插件」拆成 8 章 35 节课 + 63 道测验题 + 55 个术语，
从「什么是 AI 智能体」这种最基础的问题讲起，一直讲到「从零开发一个插件」的完整实战流程。

内容不是编造的简化模型：全部基于 DeepSeek Harness 官方源码与文档整理，
并拆解了真实插件项目（如 dsh-plugin-agent-workflow）的源码作为教学案例。

适合谁

- 完全零基础，想搞清楚「插件到底是个什么东西」的新手
- 已经会用 DSH，想自己写插件、改造界面的用户
- 想快速复习 DSH 插件概念（术语表 + 测验）的开发者

✨ 功能特性

| 功能 | 说明 |
|---|---|
| 📖 学习 | 8 章 35 节课，图文 + 代码示例 + 类比讲解，正文术语可点击跳转查词 |
| 🎯 答题 | 每章一套测验 + 综合期末考，每题即时判分并附详细解析，错题可重考 |
| 📚 术语表 | 55 个专业名词：中文名 / 英文名 / 通俗解释 / 类比，支持搜索与分类筛选 |
| 🏆 成就 | 8 个成就徽章（学完一章、满分、毕业考试 80%+……），激励坚持学完 |
| 💾 本地进度 | 学习进度、成绩、成就自动保存于浏览器 localStorage，刷新不丢失 |
| 📴 离线可用 | 纯静态、零依赖、无网络请求，双击 index.html 即可使用 |

📸 界面预览

🏠 首页

📖 学习页

🎯 答题页

📚 课程目录

1. 🚀 认识 DeepSeek Harness —— Agent / Harness / DSH 是什么，插件扮演什么角色
2. 🧩 插件与 Cordis 框架 —— Context、apply 入口、生命周期（Fiber）、依赖注入、副作用清理
3. 🗂️ DSH 的组成与配置 —— Profile / Bundle / Patch 层叠加机制、插件来源（npm / GitHub / 本地）
4. 🔀 插件的两种形态 —— 正式 npm 插件 vs 会话内动态插件、Plugin / Package / Run 版本概念、授权机制
5. 🌐 Host 与 Client 两个世界 —— 主机侧与浏览器侧能力划分、host.call / harness.handle JSON RPC
6. ⚙️ 核心 API 上手指南 —— 服务、事件（含 waterfall）、定时器、模型工具注册、常见错误检查表
7. 🎨 客户端 UI 开发 —— Slot 插槽、React.createElement（无 JSX）、主题令牌与局部样式
8. 🛠️ 实战：从零开发一个插件 —— 官方七步工作流：inspect → define → run → 排错 → 固化为正式插件

🚀 快速开始

方式一（推荐）：在线直接学习

👉 打开 https://superFAN14.github.io/dsh-plugin-academy/ 即可开始学习，无需安装任何东西。

方式二：本机直接打开

双击 index.html 即可在浏览器中使用（Chrome / Edge / Firefox 推荐）

方式三：克隆到本地

git clone https://github.com/superFAN14/dsh-plugin-academy.git
cd dsh-plugin-academy
start index.html        # Windows
open index.html         # macOS

无需安装 Node.js / npm，无需构建，无需联网。
也可以用任意静态服务器托管，例如 python -m http.server 8080。

📁 项目结构

dsh-plugin-academy/
├─ index.html          # 入口页面（双击打开）
├─ css/
│  └─ style.css        # 深色主题样式
├─ js/
│  ├─ content.js       # 全部教学内容数据（8 章课程 / 55 术语 / 63 道题）
│  └─ app.js           # 应用逻辑（视图路由、答题判分、进度、成就、localStorage）
├─ LICENSE             # MIT 许可证
└─ README.md

🛠️ 技术栈

- 原生 HTML + CSS + JavaScript（ES5+ 语法，无任何第三方依赖、无构建步骤）
- 数据驱动：所有课程 / 术语 / 题目都以纯数据形式写在 js/content.js，改内容不改逻辑
- 持久化：浏览器 localStorage

🧠 内容来源

课程内容基于以下真实材料整理（均来自 DeepSeek Harness 官方）：

- @deepseek-ai/dsh、@deepseek-ai/cordis、@deepseek-ai/dsh-tool-cordis、@deepseek-ai/dsh-agent-instructions 等官方包的中文 README
- DSH 官方技能文档 cordis-plugin-development/SKILL.md（插件开发七步工作流、Host/Client 能力划分、常见错误清单）
- 真实插件项目源码（dsh-plugin-agent-workflow 等）逐行拆解

🤝 贡献

欢迎任何形式的贡献：修错别字、补充课程内容、增加测验题、改进样式、翻译成其他语言……

- 改内容：编辑 js/content.js（课程/术语/题目都在里面，格式见文件头注释）
- 改逻辑：编辑 js/app.js
- 提交前请确保 index.html 双击打开一切正常

📄 开源协议

MIT © 2026 dsh-plugin-academy contributors