English | 中文
A course on DeepSeek Harness (dsh), modeled after the Hugging Face Course. It helps learners:
- Master the overall architecture of DeepSeek Harness (the Cordis microkernel, profile/bundle layering, and the capability seam pattern)
- Understand the implementation details of the main modules (the event-sourced session log, the agent loop turn/step flow, the tool execution pipeline, the LLM adapter protocol, and subsystems such as subagent, hooks, skill, MCP, and sandbox)
- Build their own plugins and agent applications (tool plugins, hook plugins, packaging & publishing, TypeScript / Python SDKs, and a capstone project)
| Part | Chapters | Topics |
|---|---|---|
| Part 1 · Getting Started | 1–2 | Meet dsh, install & first run, CLI and profiles, daily use |
| Part 2 · Cordis Fundamentals | 3–6 | Plugins & lifecycle, services & dependency injection, events, configuration & composition |
| Part 3 · Architecture Deep Dive | 7–11 | Overall architecture, the agent runtime, the tool system, LLM adapters, subsystems tour |
| Part 4 · Agent Architectures & Common Modules | 12–13 | Architectures (ReAct / plan-and-execute / routing / orchestrator-workers / evaluator-optimizer / reflection / CodeAct / human-in-the-loop) and common modules (memory / knowledge bases & RAG / observability / evaluation / scheduling / guardrails / model routing) |
| Part 5 · Build Plugins & Agents | 14–17 | Your first plugin, advanced plugins & publishing, building agent apps with the SDKs, capstone project |
Each chapter ends with a quiz and hands-on exercises.
website/ VitePress course site (bilingual: Chinese at the root locale, English under /en/)
examples/ Per-chapter companion examples (standalone packages, intentionally outside the root
workspace — install dependencies inside each example directory per its README)
pnpm install
pnpm docs:dev # dev server
pnpm docs:build # build (doubles as a dead-link check)
pnpm docs:preview # preview the build outputEach example is a standalone package. Enter its directory and follow its README, e.g.:
cd examples/ch03-cordis-hello
pnpm install --ignore-workspace
pnpm start- Chapters 3–6 (Cordis) examples need no API key
- Harness practice examples from chapter 9 onward require the dsh runtime; steps involving real model conversations need a
DEEPSEEK_API_KEY(clearly marked in each README)
DeepSeek Harness is in developer preview and the upstream project explicitly warns of breaking changes. This course targets the v0.1 series (@deepseek-ai/dsh@0.1.5-rc); always confirm commands and behavior against the official docs for your installed version.
MIT. Course content is derived from the documentation and source code of the official DeepSeek Harness repository (MIT).