Pasumao/dsh-plugin-dev-kb

中文 | English

dsh-plugin-dev-kb

184-page official mirror · 58 supplementary docs · 245-file search index · 0 runtime dependencies

The official docs at your side whenever you write dsh plugins: the entire content of the DeepSeek Harness official documentation site https://deepseek-harness.github.io/deepseek-harness/ is organized into a form natively usable by dsh — once this plugin is installed, the agent automatically loads the knowledge base when writing plugins and locates docs by task scenario, so you never have to dig through web pages again.

What is this

• Complete site mirror: the official docs (VitePress) are generated as a projection of the raw Markdown in docs/ of the deepseek-ai/deepseek-harness repository (links rewritten to site routes, verbatim identical to the live site). 184 pages in both Chinese and English.
• Supplementary docs: 58 development references from the repo's docs/ that were not published to the site (glossary, defensive patterns, module graph, testing strategy, incident postmortems, i18n specs, etc.).
• Agent-friendly: the skills/dsh-plugin-dev-kb.md skill lets dsh auto-load it during plugin development tasks, providing the knowledge base location, topic navigation, and search strategy; kb/meta/topics.md maps task scenarios to the files to read; kb/meta/search-index.json provides full search coverage.

Features

• Complete mirror of the official docs: the entire content of the deepseek-ai/deepseek-harness official documentation site, organized into a form natively usable by dsh, 184 pages in both Chinese and English, links rewritten to site routes, verbatim identical to the live site;
• Repo supplementary docs: 58 development references not published to the site (glossary, defensive patterns, module graph, testing strategy, incident postmortems, i18n specs, etc.);
• Agent-friendly: the dsh-plugin-dev-kb skill lets dsh auto-load the knowledge base during plugin development tasks; kb/meta/topics.md maps task scenarios to the files to read, and kb/meta/search-index.json provides full search coverage;
• Human-usable: browse the kb/ directory directly, or open kb/INDEX.md to look things up by URL mapping;
• Pure data plugin, zero runtime dependencies, registers no tools.

Configuration

No configuration required — it works right after installation:

• Reads no environment variables, needs no API key / token, writes no config files;
• After mounting, the skills/dsh-plugin-dev-kb.md skill enters the available skills list at session startup and takes effect automatically;
• Knowledge base updates go through npm run rebuild-index (see "Updating the knowledge base"); there are no manual configuration items.

Install / Mount

# npm (recommended)
dsh plugin --profile web add dsh-plugin-dev-kb
# or GitHub
dsh plugin --profile web add github:Pasumao/dsh-plugin-dev-kb

Install from source (local development / debugging):

git clone https://github.com/Pasumao/dsh-plugin-dev-kb.git
cd dsh-plugin-dev-kb
npm install
# mount into the profile as a link: dependency

This plugin is a "pure data + skill" plugin and does not ship with automatic bundle mounting. After installation, add one line at the end of the profile's cordis.patch.yml to mount it manually (the only one-time step, just copy it; it mounts as a plugin row in the profile root layer, and its skills/ skill enters the global layer):

- insert:
    - id: dsh-plugin-dev-kb
      name: dsh-plugin-dev-kb

Only after restarting / creating a new dsh session will the dsh-plugin-dev-kb skill appear in the available skills list (the skill catalog is snapshotted at session startup).

5-minute verification

After restarting, open a new session and simply ask:

Help me write a minimal dsh plugin

The agent will automatically load the dsh-plugin-dev-kb skill (visible in the skill catalog), locate the docs via kb/meta/topics.md, and only then start working — if you see it referencing kb/site/... paths, the verification has passed.

Directory structure

dsh-plugin-dev-kb/
├── cordis.patch.yml   mount declaration
├── package.json       plugin metadata
├── skills/
│   └── dsh-plugin-dev-kb.md   ★ knowledge base usage guide (the skill the agent loads)
├── kb/
│   ├── site/          site mirror: guide/ develop/ reference/ (+ en/ English site)
│   ├── extra/         repo supplementary docs: glossary, defensive-patterns, module-graph, postmortem/, i18n/ …
│   ├── meta/
│   │   ├── topics.md         ★ topic navigation: task scenario → files
│   │   ├── search-index.json full index (245 files)
│   │   ├── source.json       source commit / time / stats
│   │   └── site-pages.txt    list of live site pages
│   ├── INDEX.md        site URL ↔ local file mapping
│   └── README.md       knowledge base overview and update instructions
└── LICENSE

Usage

• Agent side: when writing plugins / Tools / config / services / events / packaging / LLM adapters, load the dsh-plugin-dev-kb skill → read kb/meta/topics.md to locate → read/grep as needed.
• Human side: browse the kb/ directory directly, or open kb/INDEX.md to look things up by URL mapping.

Self-check

Run the structural self-check before publishing (offline, zero dependencies):

npm run selfcheck   # structural integrity + entry / bundle patch existence

Updating the knowledge base

See kb/README.md: re-clone deepseek-ai/deepseek-harness (master branch), install the projection dependencies, then call projectDocs() from scripts/project-doc-site.ts inside the repo to generate website/.generated/, overwrite this plugin's kb/site/ (and sync kb/extra/ according to the publishing checklist), then run node scripts/rebuild-index.mjs in this plugin's root directory to rebuild the index and INDEX.md.

Related plugins

This plugin is part of Pasumao's dsh plugin ecosystem; other published plugins in the same series can be used alongside it:

Plugin (npm)	GitHub	Description
dsh-notify	GitHub repo	Native Windows notifications + system tray
dsh-plugin-choice-refresh	GitHub repo	Choice enhancement: regenerate options / more options
dsh-plugin-image-tools	GitHub repo	Image choice cards + inline images in replies + image handoff for blind models
dsh-plugin-table-zoom	GitHub repo	Floating viewer for long chat tables + one-click copy as Markdown
dsh-plugin-windows-guard	GitHub repo	Windows environment pitfall prevention: rule skills + mojibake detection / dangerous-write interception / encoding diagnosis & repair
dsh-plugin-workbench	GitHub repo	VS Code-style file explorer + editable preview

See Pasumao · dsh plugins for the rest of the series; if you find them useful, a ⭐ on GitHub is much appreciated.

AI-generated content statement

The knowledge base content is an organized mirror of the official documentation (sources noted in kb/meta/source.json); the index and navigation were AI-assisted (DeepSeek Harness), and all of it has been manually verified.

License

MIT