dsh-skill-mcp-panel

English | Simplified Chinese

DSH plugin that provides both a "Skills" and an "MCP" management panel on the Web settings page, and ships with a unified terminal command dsh-panel (two sub-command families: skill / mcp).

Note: The reference commands provided by this project default to specifying --profile web as the profile. If you need to use a different profile, please adjust accordingly.

Features

Skills Panel

• Skill card list: preview registered and installed skills; click a card to expand and view the full content
• Skill status: "Enabled" / "Disabled" status labels, same styling as the built-in plugin list
• Skill management: hot-toggle enable/disable, delete; search by name; auto-refresh when the page is opened
• Add skill (0.7.0 unified entry point): click "+" to directly select a file (.md / .zip), or drag a file, archive, or skill folder directly into the page — the directory bundle / single file / archive structure is auto-detected; non-compliant content is rejected with an explanation
• Workspace column (0.3.0): skill entities are stored directly in their owning location — global in ~/.dsh/skills, workspace-scoped in that workspace's .dsh/skills. Below the "Skills List" on the page there is a horizontal workspace bar (Global + each workspace, horizontally scrollable); clicking one shows only the skills under that workspace.
• Bulk migration: The migration button to the left of the "+" sign: source workspace, target workspace (multi-select), and the skills are all selected manually within a dialog, with bulk copy or move (by default no skills are pre-selected; migration is per-item, a failure doesn't affect the rest; move mode is limited to a single target). If the source workspace has groups, you can filter by group above the skills list (0.7.0).
• Skill groups (0.5.0): A new group bar below the workspace bar (All + group names, horizontally scrollable), clicking shows only skills in that group. The "Groups" button (to the left of the migration button) opens the group editor: create/rename/ delete groups, select workspace, and name + bulk-check members. Groups are only written to the plugin's own display config (~/.dsh/skills/.system/skill-viewer/groups.json), the skills directory is not modified.
• Scope-aware operations (0.6.4): When a skill with the same name exists in both global and a workspace, delete, enable/disable, and view content all operate precisely on (name + scope) — each row on the page expands and operates independently, never affecting copies in other scopes; if the target-scope entry cannot be found, an error is returned directly with no fallback mis-operation. For CLI commands with the same skill name, you must also explicitly specify with --global / --project / --workspace.

MCP Panel (v2.0.0)

• A new "MCP" page is added below "Skills" on the settings page, managing the MCP server managed block in the profile's cordis.patch.yml;
• Supports two invocation types: Stdio (local command) and HTTP (streamable-http);
• Supports add, edit, enable/disable, delete, and connection test; after saving, DSH HMR hot-loads the changes with no gateway restart needed;
• env / headers secrets are masked in RPC responses and on the page; when editing, an empty key retains the previous value;
• User content outside the cordis.patch.yml panel block is preserved byte-for-byte.

Installation

1. Install this package (auto-mounted at the bundle layer; no config file edits needed) — pick one of two options:

   Option 1: GitHub Release tarball

   dsh plugin --profile web add https://github.com/Fishquito7/dsh-skill-mcp-panel/releases/download/v2.0.4/dsh-skill-mcp-panel-2.0.4.tgz
   

   Option 2: npm (pre-built, same channel as the plugin marketplace)

   dsh plugin --profile web add dsh-skill-mcp-panel
   

   Both options install pre-built artifacts — no local build required. You can also install from Git (for Git-sourced dependencies, running prepare build scripts is disabled by default; if you see "git-hosted plugins build on install...", add the pnpm key printed above to the profile's pnpm-workspace.yaml under allowBuilds and re-run):

   dsh plugin --profile web add github:Fishquito7/dsh-skill-mcp-panel
   

2. Restart the gateway

   dsh-restart
   

   After restarting, refresh the page: under settings → "Plugins" you'll find "Skills", and below that, "MCP".

Command Line

The unified parent command is dsh-panel.

Skill Sub-commands

dsh-panel skill --help

dsh-panel skill list                                  # 列出技能（含工作区：全局 / 工作区）
dsh-panel skill add <path>                            # 添加到全局（.md 文件、目录束或 .zip 压缩包）
dsh-panel skill add <path> --workspace D:\项目A       # 直接添加到指定工作区
dsh-panel skill scope <name> --global                  # 迁移单个技能到全局
dsh-panel skill scope <name> --workspace D:\项目A      # 迁移单个技能到指定工作区（--copy 复制）
dsh-panel skill migrate <name...|--all> --from <全局|路径> --to <全局|路径> [--copy] [--yes]
dsh-panel skill update [--profile <name>]  # 检查并更新插件（默认 web 配置）
                                                 # 批量迁移（复制/移动）
dsh-panel skill disable <name>       # 停用
dsh-panel skill enable <name>        # 启用
dsh-panel skill delete <name>        # 删除（需确认）

MCP Sub-commands

dsh-panel mcp list [--profile <name>]
dsh-panel mcp add --name <serverName> --stdio --command <cmd> [--args <arg> ...] [--env KEY=VALUE ...] [--cwd <path>] [--profile <name>]
dsh-panel mcp add --name <serverName> --http --url <url> [--header KEY=VALUE ...] [--profile <name>]
dsh-panel mcp enable|disable <serverName> [--profile <name>]
dsh-panel mcp remove <serverName> [--yes] [--profile <name>]
dsh-panel mcp test <serverName> [--profile <name>]
dsh-panel mcp update [--yes] [--profile <name>]
dsh-panel update [--yes] [--profile <name>]      # 更新整个 dsh-skill-mcp-panel

MCP configuration is written into the managed block of the target profile's cordis.patch.yml; when the gateway is online, changes are hot-loaded automatically. The panel block is delimited by # >>> dsh-skill-mcp-panel:mcp:begin / # <<< ...end markers — do not edit the contents inside the block manually.

The CLI only scans the project root and user root anchored at the current directory. To manage skills in other workspaces, add --cwd <工作区路径>. When skills with the same name exist in multiple scopes, enable/disable/delete require --global/--project/--workspace to specify which one to operate on.

How It Works

Skills section:

Every operation from the page or the dsh-panel skill commands ultimately modifies skill files (SKILL.md) on disk; DSH's built-in file watcher detects the change instantly — so enable/disable, add/remove, and migration all take effect hot, with no gateway restart needed.

• Skill entities are stored directly in their owning workspace's skills folder: global = ~/.dsh/skills, workspace = <工作区>/.dsh/skills — no hidden storage or junction points; after uninstalling the plugin, skills remain regular files and are still discovered by DSH as usual
• Disable = rename SKILL.md to SKILL.md.disabled; enable = rename back
• Changing ownership = actually copy/move the file to the target location's folder (validated first; rolled back on failure)
• Bundled skills (shipped with the deployment) are read-only and cannot be disabled or deleted

MCP section:

• Writes MCP server configuration into the managed block of the profile's cordis.patch.yml; the actual connection and tool registration is handled by DSH's official plugin @deepseek-ai/dsh-mcp-client, auto-loaded by DSH's HMR.

Development

The source code is in TypeScript under src/; compiled output lib/*.js is committed to the repo (ensuring Git direct-install works). After modifying the source, run pnpm build: tsc compiles to lib/ and strips unnecessary module markers from the browser bundle. On release, npm pack automatically rebuilds via prepack — no manual compilation needed.

Uninstall

dsh plugin --profile web remove dsh-skill-mcp-panel

License

MIT