---

DSH introduces itself as "Everything is a Plugin."

That is not marketing. Open Settings → Plugins → Plugin list and look at the count:

133 of them. llm (the model adapter), session (conversation history), webserver (the page you are looking at), ui-sidebar (the sidebar on the left), and agent-loop — the agent loop itself is a plugin.

This repo walks you from "open a terminal" to building your own plugin and watching its lifecycle.

---

Start here

→ Full tutorial: Hello DSH

🌏 The tutorial is currently written in Chinese. An English version is in progress. The code, commands, and screenshots are language-neutral, so the walkthrough is still followable — and the skills in examples/skills/ work regardless of what language you read.

⚠️ Launch the web UI with --patch, or skills silently do nothing. See the gotcha below.

It assumes you have nothing: no Node.js, no command-line experience. Every section ends with a checkpoint — you don't move on until you see the expected result.

| Steps | What | Time | |---|---|---| | 1–2 | Open a terminal, install Node.js | 7 min | | 3–5 | Launch DSH, configure the API key, pick a workspace | 10 min | | 6 | See all 133 plugins for yourself | 3 min | | 7–8 | Build your first plugin, watch its lifecycle | 10 min | | 9–10 | What's next, theory (optional) | 13 min |

Steps 1–8 take about 30 minutes and leave you with a working setup.

---

Two routes to extend DSH

| Route | What you write | Effort | Good for | |---|---|---|---| | Markdown (skill) | One text file | 5 minutes | Changing how the model judges, formats, and works | | TypeScript (code plugin) | A code module | 30+ minutes | New tools, external services, UI changes |

Rule of thumb: if you can explain it in plain language, take the Markdown route.

The tutorial walks through both.

---

Ready-made examples

Once you're through the tutorial, examples/skills/ has 22 Chinese-language skills ready to use.

Let an AI install them (easiest)

Hand this link to Codex, Claude Code, or DSH itself:

https://github.com/pingfanfan/hello-dsh/blob/main/INSTALL-FOR-AGENTS.md
install this

It checks Node, DSH, and the API key first, then copies files.

Or run one command

git clone https://github.com/pingfanfan/hello-dsh.git
cd hello-dsh && ./install.sh

Preview first: ./install.sh --dry-run Remove: ./install.sh --uninstall

The skills

| Skill | Use it when | |---|---| | hello-dsh | Start here: verify the plugin system, lifecycle, theory | | dsh-onboarding | First run of DSH, or stuck on startup, workspace, permissions | | dsh-skill-dev | Full rules for writing skills (Markdown route) | | dsh-first-plugin | Building your first code plugin (tested walkthrough) | | dsh-plugin-dev | Full rules for writing plugins (TypeScript route) | | dsh-troubleshoot | Won't start, config not applying, UNKNOWN_TOOL, missing skills | | plan-before-code | A task spanning several files, with unknowns | | code-review-cn | Reviewing a change, PR, or diff | | debug-systematically | A bug, a failing test, "it worked yesterday" | | explain-codebase | Getting oriented in an unfamiliar project | | refactor-safely | Refactoring, splitting functions, removing duplication | | test-first | Writing tests, implementing a feature, fixing a bug | | api-design | Designing an interface, adding a public method | | error-handling | Designing error handling, throw vs return | | perf-optimize | Optimizing performance, finding what's slow | | security-review-cn | Security review, attack surface, credential handling | | commit-message | Writing commit messages, splitting changes | | pr-description | Writing a PR description, preparing review | | write-tech-cn | Writing Chinese docs, READMEs, technical posts | | write-docs-cn | Writing or organizing project docs, API references | | web-research | Researching online, verifying facts, evaluating options | | ask-good-questions | Asking a technical question, reporting a bug |

Once installed, say "hello dsh" to DSH and it walks you through, one layer at a time.

---

One gotcha

⚠️ The DSH web UI ships with skills disabled (the CLI profile has them on). Verified on 0.1.0-rc.6.

To use skills in the web UI:

npx @deepseek-ai/dsh web --patch ./enable-skills-in-web.yml

That file is in this repo's root.

---

What this tutorial found

Writing this meant running DSH end to end on two clean Macs. These behaviors are documented in the tutorial because each one silently blocks a beginner:

| Finding | Why it matters | |---|---| | The web profile ships with tool-skill and skill-filesystem disabled; headless has them on | Same skill works in the CLI, silently does nothing in the web UI, with no error | | The web UI requires a workspace before the send button activates | The CLI has no such requirement, so it's easy to miss when testing | | A stale DSH process holding port 3080 makes the page load normally | New instance exits with EADDRINUSE; the browser silently talks to the old one and no config change appears to take effect | | --patch inserts rather than overrides, so patched plugins mount twice | Harmless, but the plugin list shows 7 skill plugins instead of 5 | | A camelCase frontmatter key drops the entire skill, warning only | Documented fail-closed behavior, but hard to diagnose without knowing it |

All verified on 0.1.0-rc.6.

Companion tool

dsh-doctor — config health checks that catch silent failures:

npx dsh-doctor

Read-only. Every rule maps to a real failure documented in DeepSeek's own docs or postmortems.

---

How these skills are written

Following DSH's own .agents/skills/ — 11 skills DeepSeek wrote for internal use. What they have in common:

1. Guidance, not a checklist (their words: "This skill is guidance, not a complete checklist")
2. Name the sources of truth, and say "read them, don't restate them"
3. Layer it: blocking requirements / manual checks / what not to do
4. A dedicated "what not to do" section — it prevents more than the positive instructions do

See docs/writing-skills.md.

Contributing

See CONTRIBUTING.md. Two requirements: Chinese, and you actually use it.

License

MIT

---

Unofficial community project. Not affiliated with DeepSeek.