zhaoxuejie/dsh-plugin-learning-path

DeepSeek Harness 插件开发 · 学习教程

零基础学会开发 DeepSeek Harness 插件。
4 个阶段 · 15 节课程 + 4 个实战项目 · 纯 HTML/CSS/JS，双击 index.html 即用。

这是什么

一份可交互的学习路线 + 教程：从「Harness 是什么」讲到「给官方仓库提 PR」，全部概念用生活比喻解释，代码示例对照真实插件（whale-girl）源码编写。

功能

- 📚 15 节完整教程 + 4 个实战项目：概念讲解 + 代码示例（含预期输出）+ 排错表 + 小练习 + 随堂小测（66 题）
- 🛠 实战项目按插件组织：Hello World → 状态面板 → 错误记录器 → 每日摘要（含发布课 3.5）；每个项目 = 步骤条 + 逐步进度；新增插件 = 在 projects.js 追加一个对象（见 practice/_TEMPLATE.md）
- 🧭 课程总览首页：进度条、继续学习定位、四阶段导航
- 🔍 全文搜索：输入关键词（如 EADDRINUSE）直达相关课程并高亮
- 📖 术语表：44 个黑话速查，可跳回出处课程
- 👀 访问统计：页尾展示网站访问量（第三方服务，失败自动隐藏）
- 📝 学习进度：课程级 + 项目步骤级双层进度，自动存 localStorage
- 📱 响应式：桌面 3 区布局 / 手机顶部横滑目录

界面预览

界面预览 1

界面预览 2

课程结构

| 阶段 | 内容 | 学完能 |
|---|---|---|
| 一 · 认识基础（4 课） | Harness / 插件 / Profile / 启动即组装 | 用大白话讲清概念 |
| 二 · 核心入门（5 课） | JS/ESM / YAML / Cordis 四概念 / 解剖 whale-girl / 安装验证闭环 | 看懂真实插件源码 |
| 三 · 实战演练（2 课 + 项目库） | 实战方法论（四步闭环）+ 4 个实战项目：Hello World → 状态面板 → 错误记录器 → 每日摘要（多数据源 + 持久化）+ 发布课（npm/GitHub 全流程 + 踩坑清单） | 写出、跑通并发布自己的插件 |
| 四 · 进阶探索（4 课） | 工具系统 / 子代理·Goal·Plan / MCP 与 Skills / Web 插件与源码贡献 | 选定方向深耕 |

本地使用

双击 index.html 即可（无需构建、无外部依赖；图标使用 Font Awesome CDN）。

或克隆到本地：

git clone https://github.com/zhaoxuejie/dsh-plugin-learning-path.git
cd dsh-plugin-learning-path
start index.html   # Windows；macOS 用 open index.html

文件结构

learning-path/
├── index.html        # 页面骨架（顶栏 + 目录侧栏 + 内容区）
├── styles.css        # 全部样式（渐变/毛玻璃/响应式/动画）
├── README.md
├── assets/
│   ├── logo.png      # 顶栏 logo 图片
│   ├── img1.png      # README 界面预览图 1
│   └── img2.png      # README 界面预览图 2
└── js/
├── app.js            # 应用逻辑（路由/搜索/测验/进度）
├── glossary.js       # 术语速查表（40 条）
└── content/          # 课程内容（以后加课/改课只动这里）
├── content-s1.js     # 阶段一课程内容
├── content-s2.js     # 阶段二课程内容
├── content-s3.js     # 阶段三方法论总览课
├── content-s4.js     # 阶段四课程内容
└── practice/         # ★ 实战项目库
├── projects.js   #   项目数据（顺序即展示顺序）
└── _TEMPLATE.md  #   新增项目模板说明

说明

- 教程内容以真实环境为基准：代码示例对照 whale-girl 插件源码编写；如与最新版 DSH 官方文档有出入，以官方文档为准。
- 仅用于学习交流；DeepSeek Harness 为 DeepSeek 官方项目，商标归其所有。