Skip to main content

dsh-web-ui/packages/dsh-community-plugins

5.1kStars310Forks49Issues5Watchers

Community plugin market card in DSH settings page: search and category filtering to browse contributor plugins, with one-click install and uninstall support after the plugin manager is installed.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the zhu1090093659/dsh-web-ui monorepo — stars and activity count the whole repository.

Language
TypeScript
License
Apache-2.0
Branch
dev
deepseek-harnessdshdsh-pluginweb-ui

Install

cmdweb profile
$ dsh plugin --profile web add @linxin666/dsh-client-ui-community-plugins

Run 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 zhu1090093659/dsh-web-ui/packages/dsh-community-plugins for me: review the repository at https://github.com/zhu1090093659/dsh-web 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 Description

The "Community Plugins" top-level section in DSH Web's Settings page: displays plugins maintained by community contributors via search box, category pills, and dual-column card grid; each card can copy the installation command; after installing the Plugin Manager, you can directly install and uninstall items from your local browser.

Core Capabilities

  • Registers a top-level section (Community Plugins) in the Settings page, parallel to "General Settings / Modes / Plugins / Agent Presets", with expanded content by default and its own enable toggle (persisted in community plugin index settings namespace).
  • Displays items in marketplace style: search box for name/author/description, filter pills with category counts (UI & Experience, Agent & Automation, Developer Tools, Memory & Knowledge, Integration & Sharing, Security & Ops, Utility Tools), and dual-column card grid; each card shows npm published or repo install badge, category·author metadata line, repository jump link, and one-click copy installation command button.
  • When running in local browser with the companion "Plugin Manager" plugin installed, cards provide install button (polls host progress, displays real-time stages: fetching info / downloading / extracting / writing), "Installed · effective after restart" badge, and uninstall button with confirmation dialog.
  • Graceful degradation: without Plugin Manager plugin or when accessing from remote browser, the section degrades to read-only index; each card still retains the copy installation command fallback button, with a prompt explaining why remote browser cannot perform in-browser installation.
  • Acts only as an index, does not bundle any indexed code: entry data comes from community.json (35 entries, 14 published on npm), compiled into client bundle by scripts/community-index.
  • Stays synchronized with Plugin Manager tab state: subscribes via pluginManager.onChange; after either side changes install state, the other side refreshes instantly; only one change operation allowed at a time, with other cards' operation buttons disabled during the process.

Technical Implementation

  • Language: TypeScript + React (TSX)
  • Key Dependencies: @deepseek-ai/dsh-client-ui-settings (settings.section slot) / @deepseek-ai/dsh-client-runtime (settingsScope) / @deepseek-ai/dsh-client-ui-slots (settings.section injection and injection surface) / schemastery (Config validation)
  • Architecture Pattern: Standalone cordis bundle package (host half registers settings namespace + client half renders cards), injected into web profile via cordis.patch.yml; browser half declares injection dependencies on client-runtime / client-connection / client-ui-settings via dsh.client.inject; optional pluginManager service bridged via ctx.inject (not in module-level inject array, degrades when missing)
  • Entry Files: src/index.ts (host) / src/client/index.ts (client) / cordis.patch.yml

Use Cases

Users new to DSH who want to directly browse community-contributed plugins in the web Settings page, compare categories, and copy installation commands as needed. If the "Plugin Manager" plugin is also installed, they can complete installation and uninstallation without leaving the browser. This plugin only indexes and does not bundle code, making it ideal for discovering and trying third-party contributions.

Prerequisites & Compatibility

DependencyMinimum VersionNotes
DSHNot declaredThis package's package.json does not declare dsh engines; locked implicitly at runtime via @deepseek-ai/* SDK, depends on settings page exposing settings.section slot (provided by @deepseek-ai/dsh-client-ui-settings)
Node^22.19 || >=24Per packages/AGENTS.md:9; this package's package.json does not declare engines
React^18.2.0peerDependencies declared
PlatformCross-platformBrowser half is primary; host dsh web runs cross-platform
Native ModulesNoneAll via cordis bundle + Web DOM API, no native bindings

Installation

dsh plugin --profile web add github:zhu1090093659/dsh-web-ui/packages/dsh-community-plugins

Configuration Options

ConfigTypeDescriptionDefault
enabledbooleanCard's own enable toggle, determines whether to expand the community plugin index list in Settings page; when closed, the section folds into "Disabled" prompt, does not affect other settingstrue

FAQ

Q: What does this plugin do?

A: Adds a "Community Plugins" top-level section in DSH Web Settings page, displaying community-contributed plugins via search box + category pills + dual-column card grid, with each card having repository jump link and one-click copy installation command button.

Q: Why do I need to install "Plugin Manager" to install from the interface?

A: In-browser installation/uninstall relies on the Plugin Manager plugin (@linxin666/dsh-client-ui-plugin-manager) exposing the pluginManager service and local (loopback) browser permissions. Remote browsers can only see read-only index and copy command buttons.

Q: Will the installed list sync with "Plugin Manager" tab?

A: Yes, it syncs. This plugin subscribes to pluginManager.onChange; after clicking install/uninstall on a card, the installed snapshot refreshes immediately. Only one change operation allowed at a time; other cards' buttons will be disabled during the operation.

Q: Why isn't it effective after clicking "Install"?

A: The card displays "Installed · effective after restart" badge; you must restart dsh web for the installed plugin's toggle and config to appear in the Settings page's plugin configuration area.

Q: How to distinguish "npm published" vs "repo install"?

A: Look at the badge on the card: entries with npm field show "Published on npm / npm 已发布", otherwise show "Install from repo / 仓库安装".

Q: Does this plugin itself need configuration?

A: No configuration needed by default. The section's "Enable Community Plugin Index" toggle is the only configurable option (default true); when closed, the section folds the index list, does not affect other settings.

Q: Can I contribute new community plugin entries?

A: Yes. Entries are reviewed and registered in community.json by maintainers, then scripts/community-index regenerates src/client/generated/community.ts into the client bundle.

Q: What's different when accessing DSH web remotely after installing Community Plugins card?

A: Remote browsers automatically degrade to read-only index; each card still retains the copy installation command button; there's an additional prompt at the top explaining why remote browsers cannot perform in-browser installation.

Difficulty Level

Beginner — one command to install and it works; default config is ready to use; to add new community entries, just maintain community.json and run scripts/community-index to regenerate.

Known Issues & Limitations

  • Cards only appear in DSH Settings page when the dependent @deepseek-ai/dsh-client-ui-settings exists; when missing, the section silently uninstalls along with the dependency (README.md:42 / README.zh.md:42).
  • In-browser install/uninstall depends on "Plugin Manager" plugin (@linxin666/dsh-client-ui-plugin-manager) and local browser; remote browsers only get read-only copy command index (README.md:43-44).
  • Install and uninstall initiated from cards only take effect after restarting dsh web; the "Installed" badge on the card notes this (README.md:44-45).
  • Entries are reviewed and registered in community.json by maintainers; cards display snapshot at build time: after a plugin is registered, scripts/community-index must be rerun for it to appear in Settings page (README.md:45 / src/client/generated/community.ts:1-7).
  • npm install and git install for the same repo are treated as different sources: entries with npm field won't match git install records of the same repo; cards will continue showing install button, leaving decision to the host (src/client/install-source.ts:71-81).
  • Only one install/uninstall operation allowed at a time; other cards' operation buttons are disabled during the operation, and the cancel button is also disabled during the change (src/client/CommunityPluginsCard.tsx:248,318).

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/zhu1090093659/dsh-web-ui/packages/dsh-community-plugins)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory