Pull the GitHub `dsh-plugin` topic into a searchable DSH plugin marketplace settings panel with one-click install/update/uninstall, and equip the agent with four marketplace tools.
- Language
- JavaScript
- License
- MIT
- Branch
- master
Install
$ dsh plugin --profile web add dsh-plugin-marketplaceRun 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 AwesomeHou/dsh-plugin-marketplace for me: review the repository at https://github.com/AwesomeHou/dsh-plugin-marketplace 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
The "Plugin Marketplace" entry for DeepSeek Harness: pull all repositories with the dsh-plugin topic on GitHub into a searchable list, allowing you to install, update, disable, and uninstall plugins with one click in the settings panel. Agents can also call tools with the same names to search and install.
Core Capabilities
- Sync GitHub
dsh-plugintopic (default 50 per page, max 100), supports paginated loading and keyword search; search uses GitHub's ownq, so it searches the entire topic, not just loaded pages - One-click card install, start async task with real-time display of stage, percentage, downloaded bytes, network speed, ETA, and recent log lines; cancellable mid-way
- Distinguish root-level plugins from monorepo workspaces: prioritize npm-published versions (skip GitHub fetch, runtime dependencies installed together), monorepo roots clone source and use corepack pnpm to build, then register with
link: - "Installed" tab manages third-party plugins: check for latest version, update, disable/enable, uninstall; when this plugin itself has a new version, show banner on both tabs
- Register 4 tools for the agent:
market_search/market_install/market_installed/market_update, enabling the model to search and install plugins autonomously
Technical Implementation
- Language: JavaScript (ESM, pure Node built-in modules, no npm dependencies)
- Key dependencies:
node:child_process(callsdsh plugin),node:net(loopback proxy for real-time download byte/speed stats),node:fs+node:path(read/write profile manifest, clone source to$DSH_HOME/marketplace-src),fetch(calls GitHub Search / npm registry / translation service) - Architecture pattern: Dual half-bundle plugin — Host half (
lib/index.js) injects itself into Loader viacordis.patch.yml, registers/api/market/*same-origin HTTP endpoints and model tools; Client half (lib/client.js) declares itself viadsh.clientas a browser module, uses React to register twosettings.plugins.tabentries; ends communicate viafetch(permanent plugin has no sandbox RPC) - Entry files:
lib/index.js(host injectswebServer/timer/tools),lib/client.js(client injectsslots/sessions/workspaces)
Use Cases
- After installing DSH, you want to "discover and install community plugins with one click" instead of manually running
git cloneand modifyingpackage.json. - You want agents to search and install plugins themselves (e.g., user says "install a plugin that translates web pages"), using
market_search+market_install. - After installing multiple third-party plugins, you need unified management: see which have new versions, disable unused ones, uninstall those you want to replace—without editing the profile manifest.
Prerequisites and Compatibility
| Dependency | Minimum Version | Description |
|---|---|---|
| DSH Harness | Not declared | Requires exposure of webServer / timer / tools services and settings.plugins.tab slot, client slots/sessions/workspaces services; not explicitly declared in package.json |
| Node | Not declared | Source uses AbortSignal.timeout() (Node ≥17.3) and global fetch (Node ≥18), not explicitly declared in package.json#engines |
| pnpm | Any | Subprocess injection sets CI=true (pnpm ≥10 without TTY no longer waits indefinitely for interactive prompts), locks store path via --config.store-dir to prevent cross-major version drift |
| git | Any | Handles cloning/pulling GitHub repositories for monorepo workspaces |
| Platform | Cross-platform | Windows uses taskkill /T /F to kill process trees, POSIX uses kill(-pid), dedicated branches for both environments |
| Native modules | None | Uses all Node built-in modules, zero native dependencies |
Installation
dsh plugin --profile web add github:AwesomeHou/dsh-plugin-marketplace
Configuration
| Config | Type | Description | Default |
|---|---|---|---|
DSH_HOME | Environment variable | Determines web profile directory ($DSH_HOME/profiles/web) and marketplace source/workspace directory | ~/.dsh (harness default) |
DSH_MARKET_STALL_MS | Environment variable | Installation stall watchdog threshold: process tree killed if subprocess has no output or byte growth for this duration, then reconnects once (seconds) | 120 |
Note: Neither of these environment variables are "required config"—defaults are used if not set. The plugin itself has no separate config file.
FAQ
Q: Do I need to restart harness after installation?
A: Yes. This plugin is a permanent (bundle) plugin—installation/update/uninstall, disable/enable, and updates to this plugin itself all require restarting the DSH harness to be truly loaded by Loader. A "restart to take effect" prompt appears at the top of the page.
Q: Why does the "Installed" tab only show plugins I installed afterward—where are the built-in ones from harness?
A: This is intentional. Harness's built-in plugins are in the profile template's dsh.profile.bundles and cannot be disabled or uninstalled. Only third-party plugins you install into dependencies appear in "Installed", with a declaration at the top of the page explaining this.
Q: Installing a certain plugin is stuck at "Resolving dependencies 8%" for over ten minutes—why?
A: Usually a network issue (GitHub unreachable or too slow). The default 120 seconds without progress triggers the stall watchdog to automatically kill and reconnect once; if it stalls again, it fails fast with "Check network and retry, or use 'Let agent install'". To extend wait time, set DSH_MARKET_STALL_MS=300 (seconds).
Q: When does the "Let agent install" button appear? Is it safe?
A: It appears when direct install fails. Its implementation: host first ensures a dedicated workspace directory exists ($DSH_HOME/marketplace-install), then client calls runtime's workspaces.create / sessions.create / sessions.open to create a new session in that workspace and switch to it, sending the install task to that new session—no pollution to current session, no manual workspace selection needed. If runtime's session/workspace services are unavailable, it falls back to sending the task to the current session.
Q: How does the plugin marketplace know it has a new version? Could it misjudge?
A: It reads the repository field declared in its own package.json, compares it against the version on GitHub's default branch, and shows "vX → vY · Update now" at the top of both tabs when there's a new version. It explicitly uses its own GitHub repo rather than a bare npm name—because dsh-plugin-marketplace is owned by someone else in the npm registry, using the bare name would pull an unrelated package.
Difficulty Level
Beginner — One installation command, restart and use immediately; when installation fails, follow the error message directly or click "Let agent install", no manual manifest or config file editing needed.
Known Issues and Limitations
- Only supports web profile plugin management (CLI/headless profile not covered)
- Installation uses
dsh plugin add -w, requiring the target profile to be a valid pnpm workspace (needspnpm-workspace.yaml); if not, it gives a clear error, but this plugin cannot automatically create the workspace file for you - Plugins declaring pre-release peer dependencies like
@deepseek-ai/*@^0.1.0-rc.6will be rejected by pnpm on direct install (ERR_PNPM_NO_MATCHING_VERSION), need to use "Let agent install" as fallback - Installed plugins' "latest version" is cached for 15 minutes; list loading/installed queries may slightly lag behind npm registry or GitHub
- In extremely poor network conditions, the stall watchdog may falsely kill normal long dependency resolution (threshold can be adjusted via
DSH_MARKET_STALL_MS) - "Let agent install" requires client runtime's
sessions/workspacesservices to both be available; when services are missing, it falls back to sending to current session, which pollutes the current conversation
English | 中文
一个 DeepSeek Harness 的永久插件,把 GitHub
dsh-plugin topic 变成插件市场——既是 设置 → 插件 里的标签页,也提供一组模型工具,让 agent 自己就能搜索并安装插件。

插件市场:搜索、浏览、一键安装、检查更新。
功能
- 全量分页 — 完整 topic 按页拉取(默认 50 / 最大 100),UI 带"加载更多"按钮。不再有"只看 50 个"的硬限制:
total反映真实的total_count。 - 搜索 — 关键词搜索走 GitHub 自己的
q(所以是在整个 topic 里搜,而不是只在已加载的页里过滤),UI 搜索框和market_search工具都用它。 - Agent 工具(Host 侧通过
ctx.tools.register注册):market_search(q?, page?, perPage?)— 返回 topic 仓库的 JSON 列表(full name、star、语言、简介、URL)。market_install(spec)— 通过dsh plugin --profile web add -w <spec>安装到webprofile。执行前会校验 spec 是否含 shell 元字符;完成后提示需要重启 harness。market_installed()— 列出webprofile 已安装的第三方插件:启用状态、当前版本、最新版本与是否可更新(含市场自身的更新状态)。内置插件不在此列。market_update(name)— 把某个已安装插件更新到最新版本(需重启 harness 生效)。
- 安装(默认:直装,优先 npm 包) — 每个插件卡片都有 安装 按钮,点击后通过
POST /api/market/install启动确定性的异步安装任务:host 侧planInstall先探测仓库形态——根package.json声明了dsh.bundle/dsh.client的根级插件走标准dsh plugin add -w <spec>;已发布到 npm 的插件优先用name@<latest>装 npm 版(快、稳、免 GitHub 拉取,pnpm 把插件及运行时依赖如ws/node-pty一起装进 profile);未发布到 npm 的用 github spec;monorepo/workspace 根则克隆到$DSH_HOME/marketplace-src、corepack pnpm 构建后link:注册(沙箱内自带 node_modules,依赖可解析)。装完做真实结果校验(进入dsh.profile.bundles、入口文件存在、运行时依赖可解析——后一条专门防“link 缺依赖导致启动失败”的历史回归)。注意:不能用link:装根级插件。卡片内联渲染 App Store 式进度条(阶段 / 百分比 / 已下载 / 速度 / ETA / 实时日志),可取消。 - pnpm 兼容层(借鉴 dsh-market) — 所有安装子进程注入
CI=true(pnpm ≥10 无 TTY 时不再无限等交互提示而卡死,遇错直接报错);检测到 pnpm 大版本漂移(ERR_PNPM_VIRTUAL_STORE_DIR_MAX_LENGTH_DIFF/PUBLIC_HOIST_PATTERN_DIFF,即 modules 目录由别的 pnpm 大版本创建)会自动pnpm install重建 modules 目录并重试一次。失败分类classifyPnpmFailure覆盖:预发布 peer 解析、构建脚本拦截(IGNORED_BUILDS/GIT_DEP_PREPARE_NOT_ALLOWED)、幽灵依赖 404、发布新鲜度等待期、workspace 缺失、pnpm 缺失等,统一给可操作文案而不是裸报错。 - 安装卡住自动止损 — pnpm / git 在死网络或过慢的下载上可能零输出挂死(例如 GitHub 暂不可达时停在"正在解析依赖… 8%")。host 侧带停滞看门狗:一段时间(默认 120s,可用
DSH_MARKET_STALL_MS覆盖)没有任何进度(无输出行、无字节增长)就杀掉进程树 → 自动直连重试一次(去掉字节统计代理)→ 若再次停滞则快速失败并提示「检查网络后重试,或改用「让 agent 安装」」,不再无限转圈等到 10 分钟超时。 - 对等依赖失败识别 — 若插件声明了
@deepseek-ai/*@^0.1.0-rc.6这类预发布对等依赖,dsh plugin add可能以ERR_PNPM_NO_MATCHING_VERSION退出。host 侧会识别并给出可操作的说明(而不是裸的 "exit 1"),卡片同时提供 「让 agent 安装」 兜底按钮——agent 会按仓库 README / 安装脚本处理这类结构。 - workspace 缺失的友好报错 — host 侧在安装/更新前检查 web profile:
package.json或pnpm-workspace.yaml缺失时,market_install//api/market/install会返回可操作的错误信息(告诉用户如何创建pnpm-workspace.yaml或重新初始化 profile),而不是 pnpm 那种晦涩的--workspace-root may only be used inside a workspace。 - agent 安装方案(兜底,专属工作区新开对话) — 当直装失败时(尤其对等依赖 / 非标准结构场景),卡片上会出现 「让 agent 安装」 按钮。点击后 host 会确保一个专属安装工作区(
$DSH_HOME/marketplace-install,经GET /api/market/install-workspace暴露),client 通过 runtime 的workspaces.create/sessions.create/sessions.open在该工作区新开一个对话并切过去,再把固定提示词session.prompt发给那个会话——由 agent 读 README 并自行决定安装方式,不污染当前会话、无需手动选工作区。若 runtime 服务不可用则回退为发给当前会话。代码在lib/client.js的installViaAgent。更新/关闭/卸载仍走 host 接口(/api/market/update等)。 - 更新插件(有新版本提示) — 每个已安装插件都会对照最新版本(npm registry 的
latest,或 GitHub 默认分支package.json的version,GitHub 插件优先)。有新版本时在卡片上标 可更新 并给 更新 按钮(/api/market/update)。 - 区分内置 / 后安装 —
dsh.profile.bundles里来自 profile 模板的包是内置插件(随 harness 提供,不能关闭 / 卸载),dependencies里的是后安装插件。已安装标签页只展示后安装(第三方)插件,内置插件不列出(页面顶部有声明)。 - 后安装插件可停用 / 卸载 — 停用 / 启用(
/api/market/set-enabled)通过把它移出 / 移回dsh.profile.bundles实现(依赖保留);卸载(/api/market/uninstall)通过dsh plugin --profile web remove <name>移除依赖并自动从 bundle 层摘除。两者都需重启 harness。 - 市场自更新检查 — 插件市场(本插件)会检查自己的最新版本(从其 GitHub 仓库
package.json读取)。有新版本时在"插件市场"和"已安装"两个标签页顶部显示横幅:vX → vY · 立即更新。 - 声明来源 — 插件市场标签页顶部声明插件清单的来源:GitHub
dsh-plugin话题(github.com/topics/dsh-plugin),通过 GitHub Search API 实时同步。 - 并入插件设置 — 注册两个
settings.plugins.tab(market插件市场、installed已安装),与自带的"插件配置"、"插件列表"并列。
安装
手动安装
dsh plugin --profile web add https://github.com/AwesomeHou/dsh-plugin-marketplace
安装后需重启 harness 才能生效。
让 Agent 安装
帮我安装这个插件 https://github.com/AwesomeHou/dsh-plugin-marketplace
结构
| 部件 | 文件 | 作用 |
|---|---|---|
| Bundle 清单 | package.json | 声明 dsh.bundle.patch(host 层)+ dsh.client(浏览器模块) |
| Patch 层 | cordis.patch.yml | 把插件自己的 host 行插入 Loader 树 |
| Host 半 | lib/index.js | GitHub 分页同步 + /api/market/list、/api/market/install(异步任务)、/api/market/install/status、/api/market/install/cancel、/api/market/installed、/api/market/update、/api/market/set-enabled、/api/market/uninstall + market_search/market_install/market_installed/market_update 工具 |
| Client 半 | lib/client.js | __ModuleLoader__ bundle:插件市场 / 已安装 两个设置标签页 + 搜索 + 加载更多 + 一键安装(带进度条/速度/大小/阶段/取消)+ 更新 / 停用 / 启用 / 卸载 + 市场自更新横幅 |
数据走 Host 半在 ctx.webServer 上注册的同源 HTTP 端点(/api/market/*)——永久插件没有 harness/host.call 沙箱 RPC,所以浏览器半用 fetch。
开发
npm run check # 语法检查两个半
License
MIT
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/AwesomeHou/dsh-plugin-marketplace)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.