pingfanfan/hello-dsh

Name: pingfanfan/hello-dsh
Author: pingfanfan

插件Plugin ⭐ 83 MIT 其他Other

从零开始，看懂 DeepSeek Harness 的「万物皆可插件」— 零基础插件开发教程（含 22 个中文技能实例）| Zero-to-plugin tutorial for DeepSeek Harness

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

Hello DSH 是 DeepSeek Harness（DSH）的入门教程插件，通过 10 个步骤（约 30 分钟）带用户从零开始认识 DSH 的"一切皆插件"理念，并亲手构建首个插件、观察其生命周期。核心能力：演示 DSH 的插件机制与技能系统，提供 22 个现成中文技能示例，覆盖 onboarding、skill 开发、code review、调试、安全审查等场景，并通过 install.sh 一键安装。适用场景：DSH 新手快速入门、希望编写 Markdown 技能或 TypeScript 插件的开发者、遇到启动或配置问题的使用者。注意事项：Web UI 默认禁用技能，必须使用 --patch 参数加载仓库根目录的 enable-skills-in-web.yml，否则技能静默失效。

Hello DSH is a beginner tutorial plugin for DeepSeek Harness (DSH), walking users through ten steps in about 30 minutes to grasp the "everything is a plugin" concept, build a first plugin, and watch its lifecycle. It demonstrates DSH's plugin and skill mechanisms, ships 22 ready-to-use Chinese skills covering onboarding, skill authoring, code review, debugging, and security review, and includes install.sh for one-line setup. Use it when onboarding to DSH, writing Markdown skills or TypeScript plugins, or troubleshooting startup and config issues. Caveat: the web UI ships with skills disabled, so you must launch it with --patch ./enable-skills-in-web.yml or skills silently do nothing.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【hello-dsh】【https://github.com/pingfanfan/hello-dsh】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:pingfanfan/hello-dsh

把 pingfanfan/hello-dsh 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

7.3 KB · 缓存于 2026-08-23 03:40:50 · 7.3 KB

The first lesson for DeepSeek Harness

From "open a terminal" to your first plugin, in 30 minutes

English · 中文 · Start →

DSH introduces itself as "Everything is a Plugin."

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

Plugin list

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:

Guidance, not a checklist (their words: "This skill is guidance, not a complete checklist")
Name the sources of truth, and say "read them, don't restate them"
Layer it: blocking requirements / manual checks / what not to do
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.

渲染基于仓库 pingfanfan/hello-dsh 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install