dsh-first-plugin

Write a TypeScript module exporting name, inject, and an apply function that registers a tool via ctx.tools.register, then create a cordis.yml overlay with the absolute file path and load it using npx @deepseek-ai/dsh --patch ./cordis.yml.

Write a skill (a single Markdown file) when natural language can express the change, such as altering model judgment or output format. Write a plugin only when you need to register new tools, connect external services, or hook lifecycle events.

Tool registration requires an output block containing a schema describing the return value structure and a render function for displaying results to the model. Declaring only name, description, and parameters is insufficient.

The loader's unwrapExports prefers exports.default, so a default export yields a bare function while sibling named exports like inject and name are discarded. The plugin then runs without injected services; remove export default and use named exports only.

No, the required field only accepts true. To mark a parameter as optional, omit the required field entirely; writing required: false triggers an UNSUPPORTED_SCHEMA violation.

Run dsh --profile web --dump-config and grep for your plugin id. If absent, the overlay did not apply, usually due to a relative path; if present but disabled, check for !!js usage on the disabled field.