PerryLink/dsh-plugin-guide
dsh-plugin-guide is the DSH plugin-development knowledge base plus a CLI toolchain packaged as one installable bundle. The knowledge base registers as the dsh-plugin-guide agent skill (visible in every session catalog) covering the plugin contract & hard rules (effects/disposers, waterfall next(), model-visible ⟺ logged, Schemastery config), a verbatim official-docs archive (EN + ZH), a Cordis primer, 20+ real-world pitfalls with root cause + fix, community deep-dives (114 community repositories archived, 15 deep-dived, with a source index linking every fact to its origin), and a zero-runtime-dependency dsh-plugin-dev CLI (new / check / verify: scaffold, static-check, and pack-verify DSH plugins; every check links back to the skill section it enforces).
Install
dsh plugin --profile web add dsh-plugin-guidenpm channel is dsh plugin --profile web add dsh-plugin-guide; git channel is dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha> (pin a commit for reproducibility — entry point is plain ESM JS, no build step); tarball channel is pnpm pack then dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz; uninstall with dsh plugin --profile web remove dsh-plugin-guide. Can also be copied as a plain agent skill via scripts/install-skill.ps1.
Compatibility
DeepSeek Harness 0.1.1-rc.2; Node ^22.19.0 || >=24.0.0; all platforms (plain ESM bundle, no native code, no network); any model (no model interaction). Declares filesystem:read in its workshop manifest; read-only — no network requests, no writes, no model calls.
Details
- Repo: PerryLink/dsh-plugin-guide
- Category: Web UI Enhancements
- Stars: 13
- Version: npm dsh-plugin-guide (npm version badge); Apache 2.0; Harness 0.1.1-rc.2
- Last push: 2026-09-21
- First seen: 2026-08-13
Recent updates
The current README documents the knowledge-base layout (SKILL.md, guide/, references/official-docs, references/*.md, scripts/, templates/), the CLI subcommands (new/check/verify), the three install channels, the skill-copy install path, and the security boundaries (read-only, verbatim official docs, distribution notices).
FAQ
- Is it a plugin or a skill?
- Both — it installs as a DSH bundle that registers the dsh-plugin-guide agent skill and ships the dsh-plugin-dev CLI; it can also be copied as a plain agent skill.
- Does it make network calls?
- No — read-only: it reads its own bundled guide/ and references/ files; no network requests, no writes, no model calls (per README security boundaries).
- How do I scaffold a plugin with it?
- Run dsh-plugin-dev new <name> [--lang ts|js] to scaffold a TS or JS plugin repo, then dsh-plugin-dev check and dsh-plugin-dev verify (pack + clean-profile install test).
Alternatives
w2112515/dsh-plugin-development · omdsh-dev/dsh-plugin-check · AKS1st/dsh-skill-manager