dsh-plugins
English | Русский
Plugins for DeepSeek Harness (DSH) — an independent, MIT-licensed collection maintained by Rinat Fathutdinov. This is not an official DeepSeek repository.
What is DeepSeek Harness?
DeepSeek Harness is a local agent workspace with a desktop application and a web
UI. It can be extended with installable plugins: an npm package that ships a
Cordis bundle patch (dsh.bundle.patch) for Host-side behavior and, optionally,
a web Client half (dsh.client) that renders into the existing UI. DSH provides
an official Plugin Manager and the CLI command
dsh plugin --profile <name> add <spec> for installing such packages.
What this repository is
A small monorepo for DSH plugins that follow the same rules:
- Official extension points only. No DOM injection, no patching of DSH internals, no profile-file editing behind the user's back.
- Host-owned state. Configuration is persisted through DSH's official
configEditor; secrets are never sent back to the browser. - Fail closed. Security-sensitive actions are saved disabled and require an explicit user confirmation before they can run.
- No build step and no dependencies for the repository itself. Plain ESM JavaScript checked by Node's built-in test runner and a dependency-free validator — the same commands CI runs.
Plugins
| Plugin | Version | License | Description |
|---|---|---|---|
dsh-mcp-guard |
0.1.0 | MIT | Security-first MCP server manager with a Z.ai/GLM-style settings UI: strict validation, execution preview, bounded audit trail, takeover of existing profile rows and read-only discovery/import of Cursor, Claude and VS Code MCP configs. |
dsh-skill-curator |
0.1.0 | MIT | RU-first skill studio: catalog of DSH, project and external agent skills (Claude Code, Codex, Hermes, ZCode, Cursor, Gemini, Kimi, OpenCode, custom) with validation diagnostics, a bounded file tree, safe editing of SKILL.md and modular resources, invocation toggles, skill creation, backups, a restorable trash, copy/symlink import from other agents with a preview and per-item report, a library-first Studio UI, an AI chat handoff with a bundled skill creator, and opt-in live exposure of read-only external sources in the DSH catalog. |
dsh-visual-studio |
0.2.0 | MIT | Visual studio: inline choice widgets in the chat (the agent proposes, the user adjusts, the answer returns to the same turn) and published interactive visuals in the right sidebar with versions, device widths, HTML download and full-screen mode, plus a visual_guidelines complexity budget for diagrams, mockups, charts and interactive pages. |
More plugins may be added over time. docs/PLUGINS.md is the
catalog and lists the acceptance criteria for new entries.
Status
0.1.0 is a development preview targeting DSH 0.2.2-rc.1.
Automated verification in this repository:
- unit tests under
packages/dsh-mcp-guard/test/andpackages/dsh-skill-curator/test/(Node's built-innode --test, no third-party test framework); node scripts/validate.mjs— checks the package manifest, bundle patch, locales, icon, required files and JavaScript syntax;- the GitHub Actions workflow in
.github/workflows/ci.yml, which runs both on Ubuntu with Node 22.
The Host and bundle mechanics were verified on a DSH Desktop
0.2.2-rc.1 profile: the bundle installed and activated without a restart, the
settings.section page is registered and active in the live slot ledger, the
management route enforces both the intent header and signed-peer admission, and
an end-to-end check mounted a fixture stdio MCP server through the official
@deepseek-ai/dsh-mcp-client and observed its mcp__<name>__echo tool until
the test configuration was reverted. See
docs/VERIFICATION.md for the record.
dsh-skill-curator was installed as a linked bundle into the same desktop
profile on 2026-11-06 (Host row active; route 403 without the intent header,
401 without signed-peer admission). Stage 2 adds confirmation-gated writes,
backups and a restorable trash; its rendered page is still awaiting a visual
run-through.
Remaining verification limit: this build environment has no browser control, so the rendered settings pages have not been visually inspected — layout, themes and interactive behaviour are unconfirmed and no screenshots are included. Treat the visual interface as unverified until a maintainer completes a manual run-through and records it.
Security defaults at a glance
These are the defaults and hard rules of dsh-mcp-guard (details in
docs/SECURITY-MODEL.md):
- Every new or edited MCP server is saved disabled. Enabling is a separate user action with an execution preview; high-risk rows additionally require an explicit risk acknowledgement.
- Environment variables and HTTP headers are write-only: the API returns key names only, never values, and values never appear in errors, audit entries or logs.
- No expressions. Configuration containing DSH loader expressions is never written by the plugin; such rows from other plugins stay read-only.
- Plaintext HTTP to a non-loopback host is blocked unless that individual row is explicitly allowed; URLs with userinfo and header injection are rejected.
- Execution-influencing environment variables (
NODE_OPTIONS,LD_PRELOAD,PATH,DYLD_*,DSH_*, and similar) are hard-blocked and cannot be overridden from the UI. - Strict import:
mcpServersenvelope only, bounded size, field allowlist, no duplicate or prototype-pollution keys; imported rows are saved disabled. - Mutations are serialized, revision-guarded and confirmed; the local HTTP route requires a DSH-admitted peer and an intent header, and responses are never cached.
- The agent cannot enable MCP servers. There is no agent tool or command that creates or enables a server; enabling is a user gesture in the settings UI.
Installation
The plugin is installed into a DSH profile, from this checkout. It is not yet published to npm.
A. DSH Plugin Manager (Desktop, recommended)
- Open DSH Desktop and go to Plugin Manager.
- Install a bundle from the local package directory — the absolute path to
packages/dsh-mcp-guardinside this repository (the officialinstall_bundleaction with that directory as its target). - Restart DSH if the application reports that a restart is required. Bundle layers are composed at startup.
A local directory install links the checkout rather than copying it, so edits in this repository are picked up by the next plugin/application reload.
B. Command line
dsh plugin --profile desktop add "/absolute/path/to/dsh-plugins/packages/dsh-mcp-guard"
dsh plugin --profile desktop add "/absolute/path/to/dsh-plugins/packages/dsh-skill-curator"
- Use the profile the GUI actually runs:
desktopfor DSH Desktop,webfor adsh webdeployment. - If
dshis not onPATH, the documented equivalent isnpx @deepseek-ai/dsh plugin --profile <name> add <spec>. - A
link:spec (for exampledsh plugin --profile desktop add "link:/absolute/path/to/dsh-plugins/packages/dsh-mcp-guard") is the alternative form used by other DSH plugins for a linked source checkout. - After install/update/removal, fully restart DSH (not just reload the page) — the Host bundle layer is composed at startup.
C. From GitHub / npm
The repository is published at https://github.com/RinatITP/dsh-plugins. It is a monorepo, and the plugin package is in a subdirectory:
- Not yet tested: installing directly from GitHub, in particular from a package subdirectory of a monorepo. Do not assume it works.
- Not yet available: the plugin is not published to npm.
- GitHub Releases: downloadable preview tarballs are attached to releases.
For
dsh-skill-curatorv0.1.0 see https://github.com/RinatITP/dsh-plugins/releases/tag/dsh-skill-curator-v0.1.0: downloaddsh-skill-curator-0.1.0.tgz, unpack it (tar -xzf ...) and add the unpackedpackage/directory withdsh plugin --profile desktop add "$PWD/package". This download route is documented but has not been exercised by CI; the linked-checkout route above is the tested one.
See docs/INSTALL.md for prerequisites, verification steps,
uninstall, update and troubleshooting.
Repository layout
dsh-plugins/
├── .github/workflows/ci.yml # Ubuntu + Node 22: tests, validator, syntax checks
├── docs/
│ ├── API-CONTRACT.md # Host ↔ Client contract (working source of truth)
│ ├── ARCHITECTURE.md # Host/Client halves, data flow, persistence
│ ├── INSTALL.md # Install, verify, update, uninstall, troubleshoot
│ ├── PLUGINS.md # Plugin catalog and acceptance criteria
│ └── SECURITY-MODEL.md # Threat model, controls, secure defaults, residuals
├── packages/
│ ├── dsh-mcp-guard/ # MCP server manager (bundle + Host + Client)
│ └── dsh-skill-curator/ # skill studio: catalog, editor, trash (bundle + Host + Client)
├── scripts/validate.mjs # dependency-free repository validator
├── CONTRIBUTING.md
├── LICENSE
├── NOTICE
├── README.md # this file
├── README.ru.md
└── SECURITY.md
Development
There is nothing to install for development: the repository has no dev
dependencies and no third-party runtime code. The plugin uses the official
@deepseek-ai/dsh-mcp-client as an optional peer dependency resolved from the
DSH host. Use Node.js 22 or newer.
node --test packages/dsh-mcp-guard/test/*.test.mjs # MCP guard unit tests
node --test packages/dsh-skill-curator/test/*.test.mjs # skill studio unit tests
node scripts/validate.mjs # repository/host validation
node --check packages/dsh-mcp-guard/client.js # Client half syntax
node --check packages/dsh-mcp-guard/index.js # Host half syntax
node --check packages/dsh-skill-curator/client.js # skill studio client syntax
node --check packages/dsh-skill-curator/index.js # skill studio host syntax
See CONTRIBUTING.md for the change process and
docs/ARCHITECTURE.md for how the plugin is wired.
Security
Please report vulnerabilities privately — see SECURITY.md. Do
not open a public issue for an exploitable problem.
License
MIT © 2026 Rinat Fathutdinov. Third-party attribution is in
NOTICE.
No comments yet. Be the first to write one.