DSHGuide

Unofficial guide

DeepSeek Harness

A Beginner's Guide

A practical guide for complete beginners. Learn to use it, understand it, then extend it.

Book map

10 chapters + appendix. Read in order, or jump straight to the chapter you need.

01

Meet DSH: Models, Harnesses, and Agents

Separate the model, the harness, and the Agent.

4 min read · 867 words · 11 sections
02

First Launch: Desktop, Model, Workspace

Connect a model, pick a workspace, and start your first conversation.

4 min read · 830 words · 12 sections
03

Your First Task: Say What You Mean

Turn a vague request into a verifiable task.

4 min read · 800 words · 12 sections
04

Workspaces, Files, and Permissions

Understand workspace boundaries, approvals, and destructive actions.

4 min read · 850 words · 12 sections
05

Sessions, Context, and Memory

Learn why the Agent forgets, and how to work with context.

4 min read · 814 words · 12 sections
06

Tools and Skills: The Agent's Hands and Mind

Tools, plans, subagents, and Skills — who does what.

4 min read · 939 words · 13 sections
07

Modes and Presets: Same Model, Different Ways to Work

Standard, Creator, PTC, and Minimal — when to use each.

4 min read · 826 words · 13 sections
08

Plugins, Bundles, and Profiles: Giving DSH New Powers

Plugin, Bundle, Profile, and how installation works.

4 min read · 934 words · 13 sections
09

Creator Mode: From User to Extender

What Creator mode can do, its safety boundary, and a real plugin case study.

8 min read · 1,710 words · 12 sections
10

Troubleshooting, Safety, and Next Steps

Common failures, cost control, and a safety checklist.

3 min read · 685 words · 9 sections
A

Appendix

Glossary, prompt templates, and a one-page cheat sheet.

3 min read · 641 words · 6 sections

Cognition

A practical decision checklist distilled from a real project, ready to hand to an Agent.

Cognition

From CLI to DSH Plugin: A Decision Guide for Better Agent Work

Not an API catalogue, but a sequence of decisions that helps an Agent design, implement, test, and publish a plugin with less rework and fewer errors.

Standalone article

Three reading paths

Everyday use Chapters 1–7: get comfortable with workspaces, permissions, context, and tools.
Plugins and skills Chapters 1–8: understand Plugin, Bundle, Profile, and Preset.
Build a plugin Chapters 1–9: enter Creator mode and build one small extension.

About this book

An unofficial, practical introduction to DSH for people who are about to let an Agent read files, run tasks, and change real things. It does not try to document every API. It builds the right habits first: use a small workspace, start read-only, plan before executing, and ask for evidence before accepting. This English edition was edited for natural English usage; corrections are welcome.

Based on DeepSeek Harness Desktop 0.2.1-rc.2 · Text CC BY-NC-ND 4.0 · Code MIT
GitHub · GitHub Pages

↑