What is this?
A systematically organized Chinese-language tutorial for DeepSeek Harness (dsh), written from the official source code and structured in teaching order, walking from 'what is dsh' to writing your own dsh plugin.
A systematically organized Chinese-language tutorial for DeepSeek Harness (dsh), written from the official source code and structured in teaching order, walking from 'what is dsh' to writing your own dsh plugin.Is this the official dsh documentation or an independent tutorial?It is an independent, third-party written tutorial that acts as a teaching roadmap; the official deepseek-ai/deepseek-harness repo remains the authoritative reference for exact types and APIs.
It is an independent, third-party written tutorial that acts as a teaching roadmap; the official deepseek-ai/deepseek-harness repo remains the authoritative reference for exact types and APIs.How should I use this tutorial?If you are new to agent concepts, start with the Beginner Primer, then work through the 14 chapters in order — each chapter maps to a specific package/module in the dsh source and builds on the previous one.
If you are new to agent concepts, start with the Beginner Primer, then work through the 14 chapters in order — each chapter maps to a specific package/module in the dsh source and builds on the previous one.What do I need to know before starting?You should already know modern JavaScript/TypeScript and have Node.js (^22.19 or >=24) plus pnpm installed; a basic grasp of 'LLM calls + tool calling' helps but is not required, since the Beginner Primer fills that gap.
You should already know modern JavaScript/TypeScript and have Node.js (^22.19 or >=24) plus pnpm installed; a basic grasp of 'LLM calls + tool calling' helps but is not required, since the Beginner Primer fills that gap.Is dsh's API stable while following this tutorial?No — dsh is still in developer preview, so its interfaces can change in breaking ways quickly; the tutorial tracks whatever the current official source code looks like.
No — dsh is still in developer preview, so its interfaces can change in breaking ways quickly; the tutorial tracks whatever the current official source code looks like.Who is this tutorial for?Developers who want to understand dsh's source code and module boundaries, plugin authors adding tools/model adapters/Web UI nodes, and integrators assembling their own agent apps (CLI / Web / ACP / JSON-RPC) on top of dsh.
Developers who want to understand dsh's source code and module boundaries, plugin authors adding tools/model adapters/Web UI nodes, and integrators assembling their own agent apps (CLI / Web / ACP / JSON-RPC) on top of dsh.What is dsh (DeepSeek Harness) at its core?dsh is an agent framework built on the principle that everything is a plugin, built on top of the Cordis plugin framework, with a core agent loop, LLM adapters, execution capabilities (shell, sandbox), tools (fs, web, mcp), orchestration (subagent, workflow), and a persistence layer.
dsh is an agent framework built on the principle that everything is a plugin, built on top of the Cordis plugin framework, with a core agent loop, LLM adapters, execution capabilities (shell, sandbox), tools (fs, web, mcp), orchestration (subagent, workflow), and a persistence layer.How is the tutorial structured chapter by chapter?A Beginner Primer plus 14 chapters covering overall architecture, environment setup, the Cordis framework, the core agent loop, LLM integration, execution/tool capabilities, orchestration, context and human collaboration, persistence, boot/bundling, external interfaces, and how to extend dsh, ending with a glossary appendix.
A Beginner Primer plus 14 chapters covering overall architecture, environment setup, the Cordis framework, the core agent loop, LLM integration, execution/tool capabilities, orchestration, context and human collaboration, persistence, boot/bundling, external interfaces, and how to extend dsh, ending with a glossary appendix.What is Cordis and why does chapter 3 matter so much?Cordis is the underlying plugin framework dsh is built on; chapter 3 covers its plugins, Context, services, events, and effects, and the README calls it the foundation for all subsequent chapters.
Cordis is the underlying plugin framework dsh is built on; chapter 3 covers its plugins, Context, services, events, and effects, and the README calls it the foundation for all subsequent chapters.Where do I go for precise API details not covered here?Check the official deepseek-ai/deepseek-harness repository directly, since this tutorial is a learning roadmap rather than the authoritative API reference.
Check the official deepseek-ai/deepseek-harness repository directly, since this tutorial is a learning roadmap rather than the authoritative API reference.What are similar projects?oh-dsh, learn-harness-engineering, dsh-handbook, dsh_desktop, DSH-Plugins-Marketplace, Minke, dsh-lowtide, dsh-routing-suite
oh-dsh, learn-harness-engineering, dsh-handbook, dsh_desktop, DSH-Plugins-Marketplace, Minke, dsh-lowtide, dsh-routing-suiteWhich topics is it in?cordis, study-guide, chinese-language, dsh, harness, agent-framework, plugin-system, dsh-plugin, deepseek-harness, deepseek, beginner-friendly, guide
cordis, study-guide, chinese-language, dsh, harness, agent-framework, plugin-system, dsh-plugin, deepseek-harness, deepseek, beginner-friendly, guide