DSH web client plugin marketplace: browse and search the dsh-plugin community, one-click install, update, and uninstall. Built-in China mirror, AI plugin search, pre-installation health checks, and conversation management.
- Language
- TypeScript
- License
- MIT
- Branch
- main
Install
$ dsh plugin --profile web add github:mishibeikejie/zat-dsh-engineRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin mishibeikejie/zat-dsh-engine for me: review the repository at https://github.com/mishibeikejie/zat-dsh-engine first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
One-Line Positioning
zat-dsh-engine is the DeepSeek Harness Plugin Marketplace: click the 🛒 Plugin Market in "Settings → Plugins" on the web interface to search all community plugins on GitHub tagged with dsh-plugin, install/update/uninstall them with one click, plus built-in domestic mirror, AI plugin finding, pre-install health check and security scanning, conversation management, and auto-update.
Core Capabilities
- Browse and search all plugins in the GitHub
dsh-plugintopic community, filter by 12 categories, support bilingual (Chinese/English) descriptions and real-time search (no Enter key needed) - One-click install / update / uninstall: uses host pnpm underneath, install/uninstall/start-stop all with real-time progress bar, auto-rollback and one-click backup; on failure restores profile and prompts how to fix
- Pre-install health check + security scan: automatically checks entry files, build scripts, official package dependency写法, peer dependencies, runtime commands, system/CPU support, network destinations, obfuscation/suspicious outbound; blocks objective hard failures, only warns about ambiguous risks
- AI find plugins: model calls
find_plugintool to search the marketplace by user description, each candidate comes with pre-install health check and security scan conclusions (✅/⚠️/❌), no blind recommendations - Works in China without VPN: mirror first → system proxy → direct connection → curl → wget → Node fetch six-level fallback, npm uses npmmirror acceleration
- One-click detect / fix / start-stop / star / auto-update / conversation management: scan all installed plugins for conflicts/missing dependencies/system compatibility/mount row duplication; directly start-stop on cards, use local git credentials to star (no login popup); Settings page gains 🗑 Conversation Management tab, can permanently delete archived sessions
Technical Implementation
- Language: TypeScript (Node ESM host + browser CJS client, React 18 UI)
- Key dependencies:
@deepseek-ai/cordis^4.0.1 (host framework, peerDep);@deepseek-ai/dsh-typert-protocol(Typert Remote service protocol, peerDep);js-yaml^4.1.0 (parsing cordis.patch.yml's!!jssyntax);zod^4.0.0 (hand-written schema definition for typert-loader manifest) - Architecture: Dual-form Typert plugin — host side injects a
plugin-marketentry in cordis Loader viacordis.patch.yml(auto-mounts a Remote service, namespacepluginMarket, 22@Remotemethods); client side uses React components + Typert strict descriptor to remotely call host methods, and registers 🛒 Plugin Market and 🗑 Conversation Management two tabs onsettings.plugins.tabandsettings.sectionslots - Entry files: Host entry
src/index.ts(export default ZatMarketGateway, 4004 lines); Client entrysrc/client/index.tsx(export const inject,export async function apply(ctx), 1647 lines); Build configtsdown.config.ts(ESM + CJS dual output, host uses Node ES2024, client uses browser CJS)
Use Cases
Regular users who use DSH web interface and want to pick plugins from the community instead of manually typing dsh plugin add commands; people in China without VPN who want to install/update plugins; people with many plugins unsure which ones conflict and want one-click health check and fix; and people who want AI to help find plugins while seeing whether each candidate can actually be installed.
Prerequisites and Compatibility
| Dependency | Min Version | Description |
|---|---|---|
| DSH | >= 0.1.0-rc.6 | Client needs five shared client packages (@deepseek-ai/dsh-client-connection, -locale, -runtime, -ui-settings, -dsh-api-remotes) (package.json#dsh.client.inject); host needs @deepseek-ai/dsh-tools, dsh-subprocess, dsh-fs, dsh-llm, dsh-typert-protocol, cordis all as peerDep |
| Node.js | Not declared | package.json sets no engines; @types/node ^26.2.0, TypeScript targets ES2024, uses node:fs, node:path built-in modules |
| pnpm | Any resolvable | Install/update/plugin build scripts all rely on host's built-in pnpm; when missing, one-click fix will first corepack enable, then if that fails npm i -g pnpm (src/index.ts:3464-3471 / src/index.ts:3684-3692) |
| Platform | macOS / Windows / Linux | Cross-platform code; Windows alone goes PowerShell (-NoProfile -NonInteractive), PowerShell hides window; non-Windows goes /bin/sh -c (src/index.ts:32 / src/index.ts:767-789) |
| Native modules | None | Only uses Node.js built-in modules and two pure JS dependencies: js-yaml / zod |
| System commands | curl / git (optional) | Network requests auto-fallback between curl → wget → Node fetch; starring requires git credential helper configured |
Installation
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
After installation, please restart dsh for the marketplace to appear in Settings.
Configuration
| Config | Type | Description | Default |
|---|---|---|---|
plugin-market node config.mirror in cordis.patch.yml | string | Domestic mirror address; install/search/star all fallback to direct connection after mirror fails | https://gh-proxy.com/ |
Environment variable DSH_HOME | path | Override dsh main directory; when not set, infer from ~/.dsh (on Windows uses USERPROFILE / C:\Users) | ~/.dsh |
Environment variable DSH_PROFILE | string | Override profile name to operate on; when not set, pick from profiles directory (prefers web) | First profile with package.json |
Environment variable GITHUB_TOKEN / GH_TOKEN | string | Takes precedence over zat-market.json and git credentials; when non-empty, all GitHub API requests include token (rate limit rises from 60/h to 5000/h) | None |
githubToken in profile directory zat-market.json | string | GitHub Token manually entered at marketplace bottom, only written locally, not sent to any server; next starring prioritizes it | None |
Other system proxies, HTTP_PROXY / HTTPS_PROXY etc. environment variables are automatically recognized and prioritized for network requests; profile name can also be directly specified in
dsh plugin --profile <name> ...(src/index.ts:1850-1853 / src/index.ts:1693-1731).
FAQ
Q: The "All" view only shows up to 1000 plugins, how do I find the rest?
A: This is a hard limit from GitHub search API single query. Enter keywords in the search box or use category filters to bypass this limit and hit any plugin (src/index.ts:2430-2472).
Q: dsh won't start after installing a certain plugin, what do I do?
A: The marketplace backs up package.json / cordis.patch.yml / pnpm-lock.yaml to zat-backup/ in the profile directory after each successful operation, and removes the crashed bundle from the enabled list. Copy the three files back using the command in README (macOS/Linux: cp ~/.dsh/profiles/<yourprofile>/zat-backup/* ~/.dsh/profiles/<yourprofile>/, Windows: PowerShell's Copy-Item) and restart (src/index.ts:960-1000 / README.zh.md:101-108).
Q: A plugin shows "Current system not supported" and gets blocked, what does that mean?
A: This is one of the objective hard failures from pre-install health check. The plugin's package.json has os (e.g., ["linux"]) or cpu (e.g., ["!arm64"]) fields declaring supported range, and gets blocked if they don't match your current system — in such cases installing would also break dsh. If the plugin actually runs on your machine, contact the author to fix the manifest (src/index.ts:1302-1309 / src/index.ts:1497-1503).
Q: Why do I need to provide a GitHub Token to star? I don't want to log in.
A: The marketplace never forces a popup — it first reads GITHUB_TOKEN / GH_TOKEN environment variables, then the Token you've saved in local zat-market.json, and only then reads git credential helper non-interactively (only reads saved ones, never triggers login popup). Without credentials, it won't error, just failing to star and prompting how to fill in Token (src/index.ts:3868-3922).
Q: Installation reports pnpm not found, what should I do?
A: Click "🩺 One-click Detect" in Settings then "One-click Fix", the marketplace will automatically run corepack enable, if that fails then npm i -g pnpm, then continue the original flow; manually running one command in terminal also works (src/index.ts:3684-3692).
Q: I installed a plugin, but the marketplace list still shows "Install" button?
A: Cache retains old "not installed" state. Click the refresh button in the top-right of the list, or restart dsh to reload cache; if still not fixed, running "One-click Detect" usually identifies conflicts or disabled states (src/index.ts:2404-2413 / src/index.ts:3528-3535).
Q: Can two marketplace plugins be installed at the same time?
A: No. The install gate blocks: two marketplace plugins (mishibeikejie/zat-dsh-engine, lx2000wasd/dsh-web-plugin-manager, sanqi-normal/dsh-webui-market-plugin, or name/behavior matching "marketplace/plugin market" pattern) would register the same settings page and service, covering each other or even breaking dsh (src/index.ts:62-66 / src/index.ts:1007-1037).
Q: How does the marketplace upgrade? Will it uninstall itself?
A: After startup, it auto-compares with GitHub HEAD version, shows an update button next to the title if there's a new version, clicking uses the same mirror fallback chain as installation. The uninstall interface explicitly rejects calling uninstall('zat-dsh-engine') from within the marketplace, must use official dsh plugin remove (src/index.ts:2804-2876 / src/index.ts:3043-3047).
Learning Curve
Beginner — after installation and restart, it's ready to use with zero config to browse/search/install community plugins; when encountering specific issues like missing pnpm, network issues, missing entry, mount row conflicts, etc., the marketplace gives bilingual actionable guidance and "One-click Fix" buttons, no documentation lookup needed.
Known Issues and Limitations
- When two plugins in the same profile declare the same loader row id, it gets detected during health check, disable one or manually select; newly installed plugins with duplicate id to enabled plugins get blocked at pre-install health check (src/index.ts:3542-3553 / src/index.ts:1310-1316)
- Large GitHub source plugins (full repo download) may take a while on slow networks, progress bar updates with pnpm real-time output; if nothing happens within 60 seconds, the chain at src/index.ts:1857-1968 auto-switches to direct connection or mirror
- pnpm blocks dependency prepare/preinstall build scripts by default, the marketplace automatically writes corresponding package names to
pnpm-workspace.yaml'sallowBuildsand retries on pre-install/failure; if retry still fails, manual confirmation needed (src/index.ts:2279-2295 / src/index.ts:939-954) - Static security scan can only warn, cannot prove safety: it presents patterns like obfuscation/reading sensitive credentials/suspicious outbound addresses, but false positives are common (e.g., plugins "sending notifications to Discord/Telegram" will match webhook hooks), so it only warns instead of blocking — real hard blocking left to objective items like missing entry/unsupported system (src/index.ts:488-524 / src/index.ts:1354-1362)
- Marketplaces installed via
link:/ local path won't check for updates from GitHub to avoid local changes being overwritten by remote; to switch back to GitHub version, first uninstall then reinstall (src/index.ts:2809-2823) - When DSH is installed in macOS /Applications and subprocess can't get full PATH, the marketplace automatically supplements common paths like
/opt/homebrew/bin,/usr/local/bin,~/.local/binduring installation;极少数 PATH completely empty scenarios still require launching DSH from terminal (src/index.ts:1638-1666 / src/index.ts:1834-1855) - "All" view is limited by GitHub search API single query 1000 items limit, search box and category filters can hit any plugin (src/index.ts:2430-2472)
- If a candidate plugin's name/author looks like a marketplace but actually isn't, it's covered by dual detection: functional feature detection (pnpm / dsh plugin / slots.register) + known repository list, but may still miss newly emerging similar plugins (src/index.ts:78-82 / src/index.ts:1173-1177)
The visual plugin marketplace for DeepSeek Harness. Browse, search, install, update and uninstall community plugins — Wallpaper Engine style.
Zat-DSH Engine adds a Plugin Market tab to Settings → Plugins in the DeepSeek Harness web GUI. It lists the entire dsh-plugin topic community from GitHub, shows bilingual intros, and installs plugins with one click.
Features
- Full community catalog — live GitHub search of the
dsh-plugintopic (1700+ repositories, growing daily) - AI plugin finder — in any conversation just say what you need (e.g. "find me a plugin that lets the model see images") and the AI searches the market, recommends candidates, and reports each one's pre-install health + security scan (✅/⚠️/❌) — problems are reported honestly, nothing is blindly recommended
- 12 categories — Theme, Tools, Browser, Skills, Vision, Network, Agents, Data, Hardware, Design, Security…
- Live search — type to filter, no Enter key needed; clearing the box returns to the full list
- Bilingual intros — 999 pre-translated Chinese intros bundled; new plugins are translated on the fly by your current model; English UI shows the original GitHub description
- Install / Update / Uninstall — one click, powered by the official
dsh pluginprofile mechanism (pnpmunder the hood) - Monorepo-aware install — repositories that bundle several plugins install correctly: a single-plugin repo installs silently, multi-plugin repos offer a plain-language picker
- Installed detection — marks plugins you already have, with version comparison and an update badge when a newer version is released
- Cross-platform — full Windows and Linux support (PowerShell / sh, curl / wget, system-proxy aware)
- Network auto-adaptation — inherits your VPN/system proxy for fetching and installing; if GitHub is unreachable, requests automatically fall back to
gh-proxy.comand recover. Works without a VPN: proxy → direct → mirror → built-in fetch fallback - One-click enable/disable — toggle plugins right on the card (official core and the market itself are protected)
- Pre-install conflict gate + 🩺 health check — blocking two marketplaces at once, official-package hijack, duplicate patch rows / registered names; one-click health report on conflicts and dependency issues
- Pre-install health + security scan — every candidate is checked before install (entry files, build artifacts, dependency style, network destinations, OS support); the security scan catches obfuscation/credential theft/exfiltration but only warns (no false positives); objective issues (missing entries, unsupported OS) are blocked
- One-click check + repair — detects network/pnpm/entry/OS/past-error problems in one click, auto-fixes what it can (installs pnpm, enables plugins, fills deps), and explains the rest
- Safe by default — install/uninstall/toggle roll back automatically on failure; a last-known-good backup restores a broken profile with one command
- Live progress bar — install/update/uninstall show a bar right on the card (percent + live counts); progress survives leaving and re-entering the market
- One-click star — reuses your local git credentials to star repos; badge color legend, auto-fading notices
- Self-update — a button appears beside the title when a newer version of the marketplace itself is available
Installation
⚠️ Install it with the command below — do NOT hand-edit any patch file. Letting an AI "install" this project by pasting the repo URL and manually editing
cordis.patch.ymlbreaks dsh: the market's ownplugin-marketrow is auto-mounted by dsh from the bundled patch, and writing it by hand into two places (app.asar.unpacked/cordis.patch.ymland~/.dsh/profiles/<profile>/cordis.patch.yml) duplicates the id and makes dsh fail to start. If dsh already won't start, delete the hand-writtenplugin-marketrow from your profile'scordis.patch.ymland reinstall with the command below.
From GitHub (recommended, after release)
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
From China without a VPN (via the domestic mirror, verified)
dsh plugin --profile web add https://gh-proxy.com/https://github.com/mishibeikejie/zat-dsh-engine.git
Either command installs the same plugin. Once installed, the market's own search and install paths carry the mirror fallback, so networking is handled for you.
From a local checkout
git clone https://github.com/mishibeikejie/zat-dsh-engine.git
dsh plugin --profile web add ./zat-dsh-engine
From npm (if published later)
dsh plugin --profile web add zat-dsh-engine
Replace web with your profile name if you use a different one (headless etc.).
Requirements: a working dsh installation,
pnpmandcurlon PATH, and a profile that has been initialized (dsh plugin --profile web addcreates it on first use).
Usage
- Restart dsh after installing.
- Open the web GUI → Settings → Plugins.
- Click the 🛒 Plugin Market tab on the right of the plugin list.
- Browse, search, filter by category or install state, and click Install on any card.
- Restart dsh to activate installed plugins.
Update
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
Re-running add updates to the latest commit. The marketplace also detects its own updates and shows an Update button beside the title.
Uninstall
dsh plugin --profile web remove zat-dsh-engine
FAQ
The market shows at most 1000 plugins in the All view. GitHub's search API caps any query at 1000 results. Search and category filters reach every plugin regardless.
Why do I need a model for Chinese intros? 999 intros ship with the plugin. Only plugins released after the snapshot are translated on the fly, using the model you selected in dsh.
Is the mirror safe? The mirror is only used when a direct GitHub request fails, and only for public repository metadata.
dsh won't start after installing a plugin — how do I recover? After every successful install/uninstall/toggle, the market backs up the last known-good state into the zat-backup/ folder inside your profile directory. Restore it by copying the three files back over the profile directory.
In the commands below, web is your profile name: everyone using the web GUI has the profile web (unless you started dsh with a custom name — if unsure, open the market and look at the "Profile:" line in the footer; use whatever it says):
# Windows (PowerShell)
Copy-Item "$HOME\.dsh\profiles\web\zat-backup\*" "$HOME\.dsh\profiles\web\" -Force
# macOS / Linux
cp ~/.dsh/profiles/web/zat-backup/* ~/.dsh/profiles/web/
Then start dsh again. This restores the state right after the last successful operation, so the plugin that broke startup is removed from the enabled list and the profile boots normally.
Can I install two marketplace plugins at once? No — the install gate blocks it: two market/manager plugins register the same settings pages and services, which can take dsh down. Uninstall the current one first if you want to switch.
Permissions & trust (security-review perspective)
This marketplace is at heart a package manager, and that job itself requires strong capabilities. A security review will always see the behaviors below — here is what each one is for and where its boundaries are:
- Running shell commands: install/update/uninstall means running pnpm. The market only runs the pnpm/curl/wget/powershell commands it assembles itself; during install, pnpm runs the plugin's own prepare/postinstall scripts (standard behavior for every package manager) — the market scans those scripts first and warns ahead of time about network downloads or high-risk patterns.
- Reading git credentials: used in exactly two places — starring a repo and the "set GitHub token" feature. Credentials only go to api.github.com; they are never written to disk, logged, or sent anywhere else.
- The gh-proxy.com mirror: only as a fallback when a direct GitHub request fails, and only for public repository metadata. A plugin's own network behavior after install has nothing to do with the mirror.
- Reading/writing profile files: install/uninstall/toggle must edit the profile's package.json etc. Every change is backed up to
zat-backup/first, and failed operations restore automatically. - Pre-install health + security scan: every candidate and every installed plugin is scanned for structural, dependency, and security patterns (obfuscation, credential theft, suspicious exfiltration, system modification), with all network destinations listed before install; security findings only warn (never block), while objective issues like missing entries or unsupported OS are blocked.
Each of these is the minimal permission set required for the market to work; if a review questions a specific behavior, this section is the reference.
Changelog
v0.6.1
- Removed a stray third-party theme dependency (
@deepseek-ai/dsh-client-ui-aqua) that was forcing an unaudited glassmorphism theme into every install and triggering pnpm 11's exotic-subdep block — the market never used it, so installs are now clean - New: hand-written duplicate patch row detection — the health check flags a
plugin-market-styleinsertid in your profilecordis.patch.ymlthat duplicates a plugin's own bundled patch id (the classic "an AI hand-copied the row into two patch files" failure), and one-click repair removes the duplicate row so dsh starts again - Installation warning added to the README: use
dsh plugin add, never hand-edit patch files
v0.6.0
- Fix install failures: network requests now try the mirror first with 2–4s per-path timeouts, so a dropped/timing-out proxy no longer stalls installs; skill packs can now be installed in one click into
~/.dsh/skills; file-in-use/permission errors are no longer misreported as network issues - "Installed" is now served locally and instantly (7ms), unaffected by network/proxy outages; an installed plugin no longer shows an "Install" button in the "All" list (state stays in sync)
- Opening a card detail and going back keeps the list at its previous scroll position
- Detail README now shows a failure notice within 10s instead of spinning forever
- Skills show the correct star count after install
v0.5.0
- One-click check + repair: real detection (network/pnpm/entry files/OS support/past errors), auto-fixes what it can (installs pnpm, enables plugins, fills missing deps), and explains the rest clearly
- System compatibility: cards show "supported systems" (Windows/macOS/Linux); unsupported plugins are blocked before install
- Category search fixed (no more 422) + search-term hardening (OR/symbols/Chinese all work) + auto mirror on rate limit
- Install/update now falls back to two mirrors (gh-proxy + ghfast), so it works without a VPN; triple-retry updates, no more false downgrade prompts
- Security scan only warns (no false positives, notification plugins no longer flagged); every error is now one line: what went wrong + how to fix
- npm/locally-installed plugins are visible, manageable, update-checkable (via the npm registry) and updatable in "Installed"; install and detail show "how to use"
v0.4.4
- Fix: no more automatic GitHub login popup when you're not signed in; starring no longer forces a login redirect
- Fix: installing a plugin now falls back to the domestic mirror when direct GitHub fails, so it works without a VPN; a missing pnpm now yields a clear error
- New: the Sessions page is now two columns — the right "Archived" column lists archived sessions separately, deletable directly
- Fix: plugins installed from npm/locally (no repo address) now appear in "Installed" and can be uninstalled/toggled
- Fix: installing a plugin whose entry files are missing (uncommitted build artifacts) is now blocked up front instead of failing in pnpm
- New: cards show "supported systems" (Windows/macOS/Linux), auto-detected for new plugins; plugins that don't support the current OS are blocked in the health check and install gate
v0.4.3
- New: say what you need in any chat and the AI finds plugins, with a pre-install health + security scan per candidate
- The scan catches missing files, bad deps, credential theft, suspicious exfiltration — ❌ ones can't install
- Fix: no more "update to an older version" prompts
v0.4.2
- Fix: health check falsely reported "multiple marketplace plugins" (aliased entries counted twice)
- Fix: install/update auto-discovers pnpm (nvm, corepack and npm-global installs all work)
- Update summary wraps instead of overflowing
v0.4.1
- New "Sessions" section (right below Agent Presets in Settings): lists every session with its title, one-click permanent delete, running/subagent sessions protected
- Fix: searching Chinese or special characters returned 400
- Fix: the update button gave no feedback — now a live progress bar with a completion notice
- Fix: deleted sessions left a stale "ungrouped" entry in the sidebar
v0.4.0
- Enable/disable plugins in one click, right on the card (official core and the market itself are protected)
- Pre-install conflict gate (market-vs-market, official-package hijack, duplicate patch rows / registered names) + one-click health check
- Auto-rollback on install/uninstall/toggle; last-known-good backup restores a broken profile with one command
- Live progress bar on the card (percent + live pnpm counts) that survives leaving and re-entering the market
- Works without a VPN: system proxy → direct → China mirror → built-in fetch fallback; mirror ≈7 MB/s
- Installed/installable filters served in one shot; paged results deduped
- One-click star, badge color legend, auto-fading notices
Sponsor
If Zat-DSH Engine saves you time, consider supporting the author:
- GitHub Sponsors: https://github.com/sponsors/mishibeikejie
Every bit of support keeps the catalog data, translations and feature updates coming.
License
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/mishibeikejie/zat-dsh-engine)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.