Preface

In DSH plugin development, it is often necessary to verify the interfaces and behaviors of Tool, configuration, service, events, packaging, or LLM adapters. Existing practices usually involve opening the DeepSeek Harness official documentation site, searching page by page, and then passing the conclusions to the agent or writing them into personal notes.

dsh-plugin-dev-kb does something more direct: it organizes the content of the DeepSeek Harness official documentation site into local files readable by dsh, while also adding supplementary development references to the repository. When the agent performs plugin development tasks, it can automatically load this knowledge base, locate documents based on task scenarios, and read files as needed.

Below is an introduction to what it is, what materials it contains, how to install and enable it, and what scenarios it is suitable for.

What is it

dsh-plugin-dev-kb is a dsh plugin maintained by Pasumao, licensed under MIT.

Its positioning is: your portable official documentation while writing dsh plugins.

It organizes the content of the DeepSeek Harness official documentation site into a form natively usable by dsh, while also putting un-published-to-site development references into the same kb/ directory, and enabling dsh to automatically load the knowledge base during plugin development tasks via the dsh-plugin-dev-kb skill.

It is not a runtime enhancement plugin, nor does it register tools. It can be understood as a local document library plus an agent skill entry point.

Core Features

The capabilities listed below are all derived from verified information.

  • Official Documentation Full Mirror: All content of the DeepSeek Harness official documentation site is organized into a form natively usable by dsh. Bilingual Chinese and English, totaling 182 pages, with links rewritten according to site routing.
  • Repository Supplementary Documentation: 56 development references not published to the site, including glossaries, defense patterns, module diagrams, testing strategies, post-mortems, i18n specifications, etc.
  • Agent Friendly: The dsh-plugin-dev-kb skill enables dsh to automatically load the knowledge base during plugin development tasks.
  • Topic Navigation: kb/meta/topics.md maps files to be read based on task scenarios.
  • Full-text Search: kb/meta/search-index.json provides a full index of 241 files.
  • Human Accessible: You can browse the kb/ directory directly, or open kb/INDEX.md for URL-based reference.
  • Pure Data Plugin: Zero runtime dependencies, registers no tools.
  • No Configuration Required: Does not read environment variables, does not require API Key / token, and does not write configuration files.

Installation and Enablement

First, perform the installation. The recommended npm command is as follows:

dsh plugin --profile web add dsh-plugin-dev-kb

Next, perform a one-time manual mount. This plugin is a pure data + skill plugin, and does not come with a self-contained bundle for automatic mounting, so you need to add the following to the end of the profile’s cordis.patch.yml:

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

Then restart or create a new dsh session. The skill list is snapshot at session startup, so after a new session starts, the dsh-plugin-dev-kb skill will enter the available skills list.

Runtime requirements:

peerDependencies: @deepseek-ai/cordis ^4.0.1
engines: node >=18

Typical Usage

Agent Side

When writing plugins, Tool, configuration, service, events, packaging, or LLM adapters, you can first let dsh load the dsh-plugin-dev-kb skill, then read:

kb/meta/topics.md

This step uses topic navigation to locate which files need to be read for the current task.

After locating, read or search specific files as needed. The full index is located in:

kb/meta/search-index.json

Human Side

On the human side, you can browse directly:

kb/

If you wish to check local files against site URLs, you can open:

kb/INDEX.md

Quick Verification

After restarting, open a new session and ask directly:

帮我写一个最小的 dsh 插件

The agent will automatically load the dsh-plugin-dev-kb skill, locate the documents based on kb/meta/topics.md, and then get to work.

If you see the agent reference paths like:

kb/site/...

This indicates verification passed.

Applicable Scenarios and Notes

Suitable for these situations:

  • You frequently write dsh plugins, Tool, configuration, service, events, packaging, or LLM adapters.
  • You hope the agent reads local documentation before writing code, rather than inferring solely from prompts.
  • You need to find official documentation or repository supplementary documents based on task scenarios.
  • You wish to be able to browse directly on the human side and cross-reference URLs and files.

Needs attention:

  • The plugin runs with the permissions of the current dsh process; check source code and license before installing.
  • The current repository license is MIT.
  • The knowledge base content is an organized mirror of official documentation. The index and navigation are generated with AI assistance and verified by humans.
  • This plugin does not register tools, does not read environment variables, does not require API Key / token, and does not write configuration files.
  • The skill entering the available list depends on the session startup snapshot; restart or create a new dsh session after installation.

Conclusion

If you frequently write plugins in DSH, the value of dsh-plugin-dev-kb lies in putting official documentation and repository supplementary materials in a position directly readable by the agent. After installation, perform a manual mount, and in new sessions you can locate documents via topic navigation, then read specific files as needed.

GitHub repository can be found at:

https://github.com/Pasumao/dsh-plugin-dev-kb