pingfanfan/hello-dsh
Starting from scratch, understand DeepSeek Harness' "Everything can be plugged in" - Zero-based plug-in development tutorial (including 22 Chinese skill examples) | Zero-to-plugin tutorial for DeepSeek Harness
Hello DSH is the community's beginner tutorial for DeepSeek Harness — "from open a terminal to your first plugin in 30 minutes" across 10 steps with a checkpoint at the end of every section — plus 22 ready-made skills in examples/skills/ (onboarding, skill/plugin development, systematic debugging, test-first, code review, commit messages, PR descriptions, web research and more) and the dsh-doctor config health-check companion (npx dsh-doctor, read-only). The tutorial starts from a machine with nothing installed, walks through launching DSH, configuring the API key and workspace, showing the 133 built-in plugins (the agent loop itself is one), and building a first plugin to watch its lifecycle. It documents five beginner-blocking behaviours found while writing it, including the disabled web-profile skills and the stale-process-on-port-3080 trap.
Install
git clone https://github.com/pingfanfan/hello-dsh.git && cd hello-dsh && ./install.shREADME installs the 22 example skills from the repo root: ./install.sh (preview with ./install.sh --dry-run, remove with ./install.sh --uninstall). The agent-driven route is also documented — hand Codex / Claude Code / DSH the link https://github.com/pingfanfan/hello-dsh/blob/main/INSTALL-FOR-AGENTS.md and say "install this"; it checks Node, DSH and the API key first, then copies files. README warns the DSH web UI ships with skills disabled (the CLI profile has them on, verified on 0.1.0-rc.6): launch with npx @deepseek-ai/dsh web --patch ./enable-skills-in-web.yml or skills silently do nothing.
Compatibility
Requires Node.js (the tutorial's steps 1-2 install it) and DeepSeek Harness. Verified on DSH 0.1.0-rc.6. The web profile disables tool-skill / skill-filesystem, so the --patch launch flag is required in the Web UI.
Details
- Repo: pingfanfan/hello-dsh
- Category: Agent Capabilities
- Stars: 79
- Version: Docs + skill pack (no npm package); README badges state DSH 0.1.0-rc.6 verified
- Last push: 2026-09-14
- First seen: 2026-08-13
Recent updates
README documents the findings from writing the tutorial on two clean Macs: the web profile ships tool-skill and skill-filesystem disabled while headless has them on (same skill works in CLI, silently does nothing in the Web UI); the web UI requires a workspace before the send button activates; a stale DSH process holding port 3080 makes the page load normally while a new instance exits with EADDRINUSE; --patch inserts rather than overrides so patched plugins mount twice (7 skill plugins instead of 5); and a camelCase frontmatter key drops the entire skill with only a warning (documented fail-closed behaviour).
FAQ
- How do I install the Hello DSH skills?
- Clone the repository and run ./install.sh from the repo root (--dry-run previews, --uninstall removes). Alternatively give an agent the INSTALL-FOR-AGENTS.md link and ask it to install — it checks Node, DSH and the API key first.
- Why do my skills do nothing in the DSH web UI?
- The web profile ships with tool-skill and skill-filesystem disabled (the CLI profile has them on). Launch the UI as npx @deepseek-ai/dsh web --patch ./enable-skills-in-web.yml, using the file shipped in this repository.
- Is Hello DSH affiliated with DeepSeek?
- No — the README states it is an unofficial community project, not affiliated with DeepSeek. Its companion dsh-doctor health check is read-only.