skyzhao1223/dsh-plugin-scaffold
Minimal runnable DeepSeek Harness (dsh) plugin scaffold: one model-facing tool via ctx.tools
A minimal runnable DeepSeek Harness plugin scaffold that proves the whole load path — plugin resolution, Loader mount, tool registration, model call — with the smallest possible surface: one model-facing hello tool that takes a name and returns structured JSON with a greeting and the current working directory. The README positions it as a starting template for a real capability and lists directions to take it (data-lookup tool, UI card via presentCall/presentResult, self-modification plugins) plus official examples to copy from, and it includes two verification scripts that exercise the ctx.plugin() path and the real Cordis Loader boot path.
Install
dsh web --patch "$PWD/cordis.yml"README's 'Load it into dsh' block quoted verbatim (the repo ships the relative form), after the README's development step of building the plugin. For a persistent install the README says to add the same insert block to $DSH_HOME/profiles/<profile>/cordis.patch.yml (one profile) or $DSH_HOME/cordis.patch.yml (every profile). Registry check 2026-09-17: the npm name dsh-plugin-scaffold resolves at 0.4.5 but publishes no repository field, so npm ownership is disclosed, not asserted; the README also warns that a bare name: dsh-plugin-scaffold only resolves from the Cordis Loader's own module location, not the launch directory.
Compatibility
README: built against the published npm packages (@deepseek-ai/dsh-tools, @deepseek-ai/dsh-llm, @deepseek-ai/cordis) at the 0.1.0-rc.6 series, not monorepo workspace versions; if a future release changes the defineTool / ToolRuntime contracts the peer dependencies have to be updated. It is an external/community plugin and the README notes the project currently does not accept external PRs but welcomes ecosystem plugins tagged dsh-plugin.
Details
- Repo: skyzhao1223/dsh-plugin-scaffold
- Category: Other
- Stars: 1
- Version: npm package name resolves at 0.4.5 (no repository field published; repo 1★, MIT, last push 2026-08-24)
- Last push: 2026-08-24
- First seen: 2026-08-14
Recent updates
The README documents the scaffold's shape, the resolution rules and the verification scripts rather than a release-by-release table.
FAQ
- How do I load it into dsh?
- The README's command is dsh web --patch "$PWD/cordis.yml"; for a persistent install, add the same insert block to a profile's cordis.patch.yml or to $DSH_HOME/cordis.patch.yml.
- What does the tool do?
- Per the README the hello tool takes a name and returns structured JSON — { "greeting": "Hello, World!", "cwd": "/path/to/cwd" } — and exists to verify plumbing rather than to do real work.
- Why does a bare package name not resolve?
- The README explains the Cordis Loader resolves bare specifiers from its own module location, not the launch directory, so a persistent install needs the row added to a profile patch layer.