dsh_plugin

中文版 · English

A collection of DeepSeek Harness plugin bundles. Each package under packages/ is one installable dsh plugin; this repository only manages them together — it is not itself a plugin.

Layout

packages/
  agent/                 agent strategy and preset plugins
  feature/               feature plugins: model adapters, Web GUI settings sections, composer and UI features
  <group>/dsh-<name>/    one plugin per directory (dir name starts with dsh-), published as @neplich/dsh-<name>
    package.json         npm manifest + dsh.bundle declaration
    cordis.patch.yml     the layer applied when a profile installs this bundle
    src/index.ts         function plugin: name / inject / Config / apply
    README.md            English doc
    README.zh-CN.md      Chinese doc (mutually linked at the top)
    tests/               package-level vitest tests

A package becomes an installable bundle by declaring "dsh": { "bundle": { "patch": "./cordis.patch.yml" } } in its manifest; the patch rows reference the package by name so Node resolution finds the installed build. See the official Package and install a plugin tutorial for the full bundle/profile model.

Plugins

Agent plugins

Feature plugins

The three config plugins share code through packages/feature/dsh-config-shared (@neplich/dsh-config-shared), an internal library inlined at build time — not itself a plugin. Its shared scope-widget copy ships as dictionaries (sharedScopeZh/sharedScopeEn) that each consumer spreads into its own locale namespace.

Every finished plugin ships an English README.md and a matching Chinese README.zh-CN.md (mutually linked at the top) in its package directory describing its function (features, config, install); the table above links to the English one. Keep the table in sync with packages/: any plugin addition, removal, or major update must update the plugin READMEs and this table in the same change.

Commands

pnpm install     # pnpm workspaces, node ^22.19 || >=24
pnpm run build   # tsc project-references build, emits packages/<group>/*/lib
pnpm run test    # vitest
pnpm run clean   # remove build outputs

Add a plugin

1. Create packages/<group>/dsh-<name>/ (directory name must start with dsh- and match the package suffix; choose agent/ for agent strategy and preset plugins, feature/ for LLM adapters, Web GUI, and other feature plugins) with package.json (name: @neplich/dsh-<name> plus the dsh.bundle declaration), src/index.ts, tsconfig.json, tests/, README.md and README.zh-CN.md.
2. Update the plugin row in cordis.patch.yml (both id and name) and name in src/index.ts.
3. Add { "path": "packages/<group>/dsh-<name>" } to the root tsconfig.json references.
4. Write packages/<group>/dsh-<name>/README.md (English) and its Chinese counterpart README.zh-CN.md (mutually linked at the top) describing the plugin's function, config, and install, and link the English one from the Plugins table above.
5. pnpm install && pnpm run build && pnpm run test.

Installability: plugin source must install and build in any environment after cloning. Depend on harness packages with npm-registry semver ranges in devDependencies (matching peerDependencies), never link:../../../deepseek-harness/... sibling-checkout paths; use the pnpm workspace: protocol for in-repo dependencies. Re-run a full pnpm install (not just the existing node_modules) after any dependency change.

Choose the extension point before writing code — tool, hook, LLM adapter, command, capability seam — with the dsh-plugin-development agent skill and the upstream extension cookbook.

Try a plugin locally

pnpm run build
dsh plugin --profile demo add ./packages/<group>/dsh-<name>   # links the checkout into the profile
dsh --profile demo                                   # boot the profile

During active development against a source checkout of deepseek-harness, a --patch overlay can load src/index.ts directly without building; see Your first plugin.

Publish

pnpm run build && pnpm -r publish --access public ships the prebuilt lib/; consumers install with dsh plugin --profile <name> add @neplich/dsh-<name>. Add the dsh-plugin topic to this repository for discoverability.