How to use DSH-Plugins-Marketplace
Third-party plugins and general Skills marketplace within DSH Web GUI: automatically indexes all GitHub repositories tagged with dsh-plugin, agent-skills, or claude-skills. The settings page provides browsing, one-click installation, version detection, and installed status identification.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
DSH-Plugins-Marketplace
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add dsh-plugin-marketplace
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
Why do I need to restart DSH after installation?
Yes. DSH's Web profile has hot-reload disabled (changes to cordis.patch.yml registration or plugin code won't trigger HMR). You must restart dsh web to load new plugins; this is host behavior, the marketplace only writes entries to the patch file.
Does browsing the plugin list consume my GitHub API quota?
No. The list is built every 2 hours by GitHub Actions as a static index (registry.json). Users read via jsDelivr CDN with zero API calls, zero rate limiting; only when manually clicking 'refresh' and both CDN/raw.githubusercontent are unavailable will it fall back to the search API, which has an unauthenticated rate limit of 10 requests/minute.
What types can a repository be recognized as?
Four types total: cordis plugins (with package.json, installed to web profile), skills (with SKILL.md, installed to ~/.dsh/skills/), agent presets (with preset.yml + agent.cordis.yml, installed to ~/.dsh/.agent-presets/), and installation scripts (install.sh/install.ps1). Plugin authors must write corresponding markers according to STANDARD.md for proper identification.
How are plugins that require API keys handled?
During step 3 of installation, it scans README, .env examples, and install scripts. If it finds environment variables like API_KEY / TOKEN / SECRET / PASSWORD, it will automatically pause and pop up a dialog for you to fill in or skip; the filled values are only passed as environment variables to the subprocess for this installation, and are not written to any persistent files.
What if I entered the wrong API Key for an installed plugin?
Installed cards have an 'Edit' button that lists the environment variable keys scanned by the plugin (values are not echoed back, configured items will be marked). You can fill in missing values, modify them, or manually add new keys; after saving, it writes to ~/.dsh/.env and merges into envs.json, taking effect after restarting DSH.
Why do some installed plugins not have an 'Uninstall' button?
Uninstallation relies on the installed.json installation records maintained by this marketplace. The uninstall button is only provided for plugins 'installed through this marketplace'. It will delete the installation directory, cordis.patch.yml registration entries, and installation records together; plugins pre-installed manually or installed via third-party CLI can only be recognized as 'installed' and require manual directory deletion.
How does this plugin marketplace upgrade itself?
When a new version is detected on the settings page, a 'vold → vnew' banner and 'Update Now' button will appear; clicking it will have the server clone the latest repository, verify staging integrity, atomically replace the main directory (with automatic rollback on failure), and restart DSH after completion to take effect; it shares a global mutex with installation, and repeated clicks during the process will return 409.
Can other computers on the LAN use this marketplace?
Browsing is allowed on LAN (read endpoints are open to all trusted Hosts), but write operations like install/uninstall are only allowed on localhost by default; if you need to perform write operations on LAN, you need to set {"lanWrite": true} in ~/.dsh/marketplace/config.json and include the session token injected by the page in the request (x-dsh-marketplace-token header).
— source: plugin_wiki.faq_json
Compatibility
- DSH: 未声明(适配目标为 DSH web profile,依赖 cordis、webServer、slots、locale、tapIndex 等宿主服务;install.sh 头部要求 dsh CLI 与 pnpm)
- Node: 未声明(lib/index.js 大量使用 node:child_process / node:fs/promises / node:crypto / node:zlib 等内置模块,建议跟随 DSH 宿主版本)
- Platforms: macOS, Windows, Linux
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule