dsh-plugins

Community plugins for DeepSeek Harness (dsh), developed and published independently of the dsh monorepo. Each package under packages/ is an installable profile bundle: it declares dsh.bundle.patch, and one command mounts it on any profile.

中文说明见 README.zh.md。

Install a plugin

Choose the command that matches how dsh is installed:

# dsh installed globally
dsh plugin --profile web add @aetheri-ai/dsh-show-image

# Run dsh directly from npm
npx @deepseek-ai/dsh plugin --profile web add @aetheri-ai/dsh-show-image

# A deepseek-harness source checkout
pnpm dsh plugin --profile web add @aetheri-ai/dsh-show-image

Restart the profile afterwards so the new layer is composed. For Web, stop the existing server and start it again with the same command (dsh web, npx @deepseek-ai/dsh web, or pnpm dsh web). Start a new conversation after the restart; its model tool list then includes the installed plugin.

A registry mirror can take time to receive a new release. Add --registry=https://registry.npmjs.org to the install command when the configured mirror cannot yet resolve a package.

Removing the bundle removes its patch layer:

dsh plugin --profile web remove @aetheri-ai/dsh-show-image

Plugins

Package	Role
@aetheri-ai/dsh-show-image	show_image — the model presents a local image to the human viewer in the conversation

Compatibility

Plugins track the dsh npm release line (0.1.1-rc.x today). dsh is in developer preview and ships compatibility-breaking changes; a plugin update accompanies each breaking dsh release.

Development

pnpm install
pnpm run test        # vitest across all packages
pnpm run build       # tsdown bundles + declaration types
pnpm run typecheck
pnpm run pack        # npm pack every package into dist/

Every plugin package carries the same shape: TypeScript source, a cordis.patch.yml patch layer, tests that boot the real Loader composition, and a tsdown build producing lib/ for the npm tarball.

License

MIT