dsh plugin 命令怎么用？DSH 插件安装、卸载、列出命令大全

dsh plugin 是管理 DSH 插件的命令族：add 安装、remove 卸载、list 列出，都配合 --profile 指定环境。安装有 npm 包名、GitHub 源码、本地目录、市场图形化四种方式，卸载有命令行与界面两种，本文逐个展开步骤并附常见问题排查。

本文转自 DSH Plugin Hub 插件中心

dsh plugin 是管理 DSH 插件的命令族：add 安装、remove 卸载、list 列出，配合 --profile 指定环境。安装插件有四种方式（npm 包名、GitHub 源码、本地目录、市场图形化），卸载有两种方式（命令行、界面），本文逐个展开步骤、给出完整命令，并把常见问题与解决办法列成清单。

概览：dsh plugin 命令家族全景

三条核心子命令管住插件的增、删、查，另外两个参数（--profile / --help）贯穿始终。 基本格式（来源）：

<环境> 通常是 web（Web 界面环境），后面单独讲；<目标> 可以是 npm 包名、github:owner/repo 或本地路径。

安装插件：四种方式任选

安装同一个插件有四条路，按场景选择最顺手的。 四种方式最终效果一致，都是把插件写入当前 profile 的依赖。

方式一：npm 包名安装（推荐）

知道包名就能装，来源可溯、依赖自动处理，是最稳的方式。 操作步骤：

1. 确认包名：到 npm 或 dsh-plugin.org 搜索准确包名；
2. 执行安装命令：

# 以插件中心为例
dsh plugin --profile web add dsh-plugin

1. 等待 npm 下载并写入 profile，出现成功提示；
2. 重启 dsh web，刷新页面验证生效。

npm 方式会从你配置的 registry 拉取，之前配过镜像会自动生效；包名拼错会提示 404，用 npm view <包名> 可提前确认存在。

方式二：GitHub 源码安装

市场没收录、或想装源码版的插件，用仓库地址。 操作步骤：

# 格式：github: 前缀 + owner/repo
dsh plugin --profile web add github:meteornox/deepseek-balance-whale-widget

# 等价写法：直接给完整仓库地址也可以（视版本而定）
dsh plugin --profile web add github:owner/repo

前置条件是本机能访问 GitHub（网络受限时需配置代理）。源码方式会 clone 仓库并处理依赖，个别仓库缺少构建产物时可能装完不生效，此时改装 npm 版或反馈作者。

方式三：本地目录安装

自己开发插件、或想直接用本地克隆的仓库，用绝对路径。 操作步骤：

# 进入插件仓库上一级，用相对/绝对路径均可
dsh plugin --profile web add ../my-plugin

# 或绝对路径
dsh plugin --profile web add /Users/you/dev/my-plugin

这是插件开发调试的常用姿势（来源）：改完代码重新 add 一次即生效，调试确认后再考虑发布到市场。

方式四：插件市场图形化安装

不想敲命令就点按钮，系统帮你生成并执行命令。 操作步骤：

1. 先装好 DSH Plugin Hub（dsh plugin --profile web add dsh-plugin）；
2. 打开 DeepSeek Harness Web UI → 设置 → 插件中心；
3. 搜索或分类找到目标插件，点卡片上的安装；
4. 在弹出的确认弹窗里核对插件名、来源仓库与将要执行的命令；
5. 确认后自动执行，弹窗实时显示进度。

图形化方式的底层命令和方式一/二相同，只是由系统代为执行，对新手最友好。

卸载插件：两种方式

卸载和安装一样，命令行与界面都能做，底层一致。 两种方式都只移除插件依赖，$DSH_HOME 下的配置、密钥与会话不受影响。

方式一：命令行卸载

# 按包名卸载
dsh plugin --profile web remove dsh-plugin

执行后插件从当前 profile 的依赖中移除，重启 dsh web 后生效。不确定包名时先 dsh plugin --profile web list 查一下。

方式二：界面卸载

1. 打开设置 → 插件中心 → 已安装；
2. 找到目标插件，点行尾的卸载；
3. 在确认弹窗核对插件与来源，点确认；
4. 实时进度完成后插件从列表消失。

想彻底清理插件留下的缓存目录（不只是移除依赖），需要手动检查 $DSH_HOME 下对应插件的残留文件。

查看已装插件：两种方式

确认装没装、装了什么版本，用下面两种方式。 典型命令：

# 命令行列出
dsh plugin --profile web list

输出会列出插件名与版本；不想开终端的话，打开设置 → 插件中心的已安装页，除了看列表还能直接点「更新」「卸载」「在 Finder 中显示」，比命令行更直观。

--profile 环境参数详解

profile 是插件的隔离环境，--profile 决定命令作用在哪个环境上。 需要理解三点：

1. 为什么必须带：dsh 支持多环境（web、桌面端等），不带 --profile 命令不知道往哪装，官方把它设为必填参数；
2. 怎么知道有哪些 profile：dsh plugin --profile web list 对应 web 环境；其他环境用对应名字，可查看官方文档；
3. 装错 profile 怎么办：插件不会出现在目标环境里，重新用正确的 --profile add 一次即可，无需先卸载。

常见问题与解决

命令出错先看报错类型，再对症处理。 常见问题清单：

还定位不了时，打开设置 → 系统日志查看完整报错，再按对应排查文章处理。

总结速查

一句话：add 装、remove 卸、list 查，永远带 --profile。 四个提醒：

1. 默认推荐 npm 包名，来源可溯、依赖自动处理；
2. 日常管理用插件中心界面，命令留给脚本与批量操作；
3. 装完重启再验证，界面与 list 双重确认；
4. 出错先看日志，系统日志会记录每次操作的完整上下文。

常见问题

dsh plugin 命令有哪些子命令？

常用三个：add 安装插件、remove 卸载插件、list 列出已装插件。执行 dsh plugin --help 可查看当前版本支持的全部子命令与参数；每次使用都要带 --profile 指定环境（如 --profile web）。

dsh plugin add 有哪几种安装方式？

四种：npm 包名（dsh plugin --profile web add dsh-plugin）、GitHub 源码（add github:owner/repo）、本地目录（add /path/to/plugin）、以及插件市场图形化安装（点按钮，系统自动生成命令）。推荐 npm 包名，来源可溯。

怎么用 dsh plugin 卸载插件？

命令行：dsh plugin --profile web remove <包名>；界面：打开设置 → 插件中心 → 已安装 → 点卸载。两者底层一致，都只移除依赖，不影响 ~/.dsh 下的配置与会话。

--profile 参数是干什么的？

指定插件装到哪个环境（profile），比如 web profile 对应 Web 界面环境；不同 profile 的插件相互隔离，装错 profile 会导致插件不生效，所以每次命令都要带上。

命令不识别或报错怎么办？

先确认 dsh 已启动过（web profile 已初始化）且版本支持该子命令，运行 dsh plugin --help 看帮助；包找不到换 npm 镜像或改用 github:owner/repo；仍不行到系统日志查具体报错。

本文转自 DSH Plugin Hub 插件中心，版权归属 DSH Plugin Hub 插件中心。

分类：安装与快速上手

原文地址：https://dsh-plugin.org/zh/tutorials/dsh-plugin-command-guide

首页：DSH Plugin Hub

来源：dsh CLI README、DeepSeek Harness 官方文档 - 打包与安装插件、dshplugin/dsh-plugin-hub