Back to directory

dsh-plugin-template

Maintenance: Active

bugmaker2/dsh-plugin-template

Template for deepseek-harness plugin development.

View on GitHub
$ dsh plugin --profile web add .

110

stars

1

forks

TypeScript

Language

MIT

License

2026-08-13

Created

2026-08-27

Last push

MIT-licensed DeepSeek Harness plugin starter (TypeScript) that scaffolds a host + client plugin pair exposing a Typert Remote, with build, tests and CI pre-wired.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-30

License

MIT

01What can it help you accomplish?

  • Scaffold a dual-side DeepSeek Harness plugin (host + client) from a working reference

    A ready-to-build template that registers a `greet` Remote — the host composes `"Hello, <name>"` and the client renders it in a new "Greet" tab

    Plugin developers building for the DeepSeek Harness runtime who want the full plugin surface wired up (type-checking, linting, tests, CI, publishing)

  • Learn how a DeepSeek Harness host plugin and Web client plugin connect end to end

    Annotated `src/` layout, `dsh.plugin.json` registry manifest, `cordis.patch.yml` profile mount, and `build.mjs` dual build

    Developers who want a concrete reference for the Harness plugin surface before writing their own plugin

02How to install into DeepSeek Harness

Prerequisites

  • Node.js >= 22.19 (or >= 24)
  • pnpm >= 9
  • DeepSeek Harness >=0.1.0-rc.6

Installation steps

  1. 01

    pnpm install

  2. 02

    pnpm run build

  3. 03

    $ dsh plugin --profile web add .

  4. 04

    Restart the Web Harness after rebuilding the plugin

Verify the integration

  • A "Greet" tab appears in the session view ring showing `Hello, DSH`

Rollback

  • dsh plugin --profile web remove dsh-plugin-template

03DSH integration and capability boundaries

DSH integrationNative runtime

Built for the DeepSeek Harness runtime: a host plugin exposes a Typert `greet` Remote and a client plugin mounts it into a React view; install via `dsh plugin --profile web add .`.

  • Host plugin: greet Remote (Typert)

    configurable prefix via the Config schema→composes `"Hello, <name>"` string from the prefix and the name

  • Client plugin: Greet tab (React view)

    the greet Remote result→renders `Hello, <name>` in a new "Greet" tab of the session view ring

    mounts the Remote into the Web harness module loader and adds a "Greet" tab to the session view ring
  • Dual build & CI

    TypeScript sources in src/ and tests/→host ESM + client CJS bundles plus type declarations; vitest unit tests; CI on push

04Who is it for? When not to use it?

Good for

  • Plugin developers building for the DeepSeek Harness runtime who want the full plugin surface wired up (type-checking, linting, tests, CI, publishing)
  • Developers who want a concrete reference for the Harness plugin surface before writing their own plugin

Not for

  • A Git install (`dsh plugin --profile web add github:...`) fetches sources, not built artifacts, so pnpm runs `prepare` to build `lib/`. pnpm >=10 blocks that build until you set `allowBuilds`; that allowance lets the package run code at install time, so only allow packages you trust and pin a commit.

05Compatibility, maintenance and safety notes

  • A Git install (`dsh plugin --profile web add github:...`) fetches sources, not built artifacts, so pnpm runs `prepare` to build `lib/`. pnpm >=10 blocks that build until you set `allowBuilds`; that allowance lets the package run code at install time, so only allow packages you trust and pin a commit.
2026-08-132026-08-27Not specified by the author

MIT licensed DeepSeek Harness plugin template (sources: ours); last push 2026-08-27; no tagged GitHub release

06Frequently asked questions

How do I install dsh-plugin-template with DeepSeek Harness?

From a local checkout run `pnpm install`, `pnpm run build`, then `dsh plugin --profile web add .` and restart the Web Harness. A "Greet" tab appears showing `Hello, DSH`.

What are the prerequisites?

Node.js >= 22.19 (or >= 24), pnpm >= 9, and DeepSeek Harness >=0.1.0-rc.6.

How does the template connect to DeepSeek Harness?

It ships a host plugin that exposes a Typert Remote (`greet`) and a client plugin that mounts that Remote into a React view; `package.json` is the only manifest Harness needs, plus `dsh.plugin.json` for the dsh.so registry.

How do I remove it?

Run `dsh plugin --profile web remove dsh-plugin-template`.

Why does a Git install ask me to set allowBuilds?

A Git install fetches sources, not built artifacts, so pnpm runs `prepare` to build `lib/`. pnpm >=10 blocks that until you add `allowBuilds: dsh-plugin-template: true` to the profile's `pnpm-workspace.yaml`; that lets the package run code at install time, so only allow packages you trust and pin a commit.

08Data and sources

  • Author-claimedgithub.com31af7ebeb8d0…

    A complete dual-side [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin template.

  • Author-claimedgithub.com31af7ebeb8d0…

    a **host** plugin exposing a Typert Remote, and a **client** plugin mounting that Remote into a React view

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-30. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.