dsh-plugin-template

Building a tool plugin from scratch for the DeepSeek Harness ecosystem is far more involved than writing a single function. The schema DSL demands property-level required instead of a top-level array, pnpm enforces a 24-hour maturity gate on newly published versions, and local file: install is the only reliable way around Node resolving symlinked @deepseek-ai/* modules. Miss any of these and your plugin silently parks in PENDING or crashes with ERR_MODULE_NOT_FOUND. dsh-plugin-template bakes all these battle-tested pitfalls into a minimal working skeleton so you can go straight to business logic.

The template is pure ESM, zero-dependency, and requires no build step. It ships a complete hello_world placeholder tool exercising every critical surface: parameter schema, output schema (demonstrating property-level required and oneOf-null patterns), render, and execute. A mount self-check runs through the real ctx.tools.execute pipeline, and the README packs a first-batch gotcha cheat-sheet covering local install, schema expression, allowBuilds, and PENDING silence alongside the hard rules every tool must follow.

If you are drafting your first contribution to the Harness ecosystem or simply want to validate a quick pipeline-integration idea, fork this template, swap the placeholder comments in package.json and index.js, and you land on a structurally valid, pipeline-verified starting point that beats assembling the skeleton line by line from the official docs.