dsh-plugin-practice

The DeepSeek Harness plugin system touches on lifecycle hooks, tool definition, config validation, service injection, typed events, and waterfall middleware, which can be hard to piece together from scattered docs and source code alone. dsh-plugin-practice is a minimal exercise repo that walks through these concepts in six incremental lessons, each focused on one core abstraction. From apply(ctx) to short-circuiting in ctx.waterfall(), every pattern is demonstrated in a single loadable Bundle you can inspect and test end to end.

The repo ships two patches: cordis.patch.yml for the built artifact and cordis.dev.patch.yml for loading TypeScript directly from src/. You can either deploy via the official install flow or use overlay mode for rapid iteration. The six lessons cover plugin lifecycle heartbeats, tool injection with defineTool, Schemastery-based config validation, Service Provider / Consumer wiring, loose-coupled ctx.emit / ctx.on events, and around-middleware with short-circuit wrapping, all with expected outputs for self-testing.

Best suited for developers who are new to DSH or Cordis plugin development and want a small, runnable codebase to build a solid mental model step by step. The repo tracks the current DSH development version, so API changes should be cross-referenced with official docs.