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

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

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)贯穿始终。 基本格式(来源):

子命令 作用 基本格式 使用频率
add 安装插件 dsh plugin --profile <环境> add <目标> 每次安装
remove 卸载插件 dsh plugin --profile <环境> remove <包名> 每次卸载
list 列出已装 dsh plugin --profile <环境> list 随时查看
--help 查看帮助 dsh plugin --help / dsh plugin add --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 Plugin Hub 自定义安装面板

卸载插件:两种方式

卸载和安装一样,命令行与界面都能做,底层一致。 两种方式都只移除插件依赖,$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 一次即可,无需先卸载。

常见问题与解决

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

问题 可能原因 解决办法
dsh: command not found 未全局安装、或 npx 缓存问题 用 npx @deepseek-ai/dsh 前缀执行,或 npm install -g @deepseek-ai/dsh
包找不到 / 404 包名拼错、镜像源滞后 npm view <包名> 确认存在,切换 npm 镜像重试
安装超时 网络慢、仓库访问受限 换 npm 镜像;GitHub 源配置代理
权限错误 全局目录无写权限 检查目录权限,必要时用用户级 npm 配置
装完不生效 没重启、装错 profile 重启 dsh web 并刷新;核对 --profile 与环境一致
命令不识别 版本过旧不支持子命令 dsh plugin --help 看支持项,升级 dsh 到最新版
卸载后仍有残留 只删了依赖、缓存还在 手动清理 $DSH_HOME 下插件残留目录

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

总结速查

一句话: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

相关文章
|
3月前
|
数据可视化
DeepSeek Harness 插件 DSH-Plugin 怎么安装?下载失败、下载慢?
DSH-Plugin Hub 是 DeepSeek Harness 官方插件市场,全新升级「装、卸、更、通知」闭环:一键安装(兼容命令行插件)、智能更新提醒、可视化卸载+自动重启提示、集成式通知中心。已收录4800+社区插件、4400+人工审核插件,官网:dsh-plugin.org。
4071 0
DeepSeek Harness 插件 DSH-Plugin 怎么安装?下载失败、下载慢?
|
19天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5829 69
|
1月前
|
数据可视化 安全 JavaScript
dsh plugin add 本地目录怎么装?git clone 源码、npm 与市场安装怎么选
dsh plugin add 加本地目录一条命令装进 profile:git clone 仓库后 add ../仓库目录;GitHub 源码源只拉源码不拉构建产物,要 author 的 prepare 脚本与用户 allowBuilds 授权;最后给 npm 版与官方市场的选择建议。
565 1
dsh plugin add 本地目录怎么装?git clone 源码、npm 与市场安装怎么选
|
2月前
|
缓存 数据可视化 开发工具
DeepSeek Harness 怎么更新?dsh 更新完整指南:更新本体(npx、npm、源码)与更新插件两种方式
DeepSeek Harness 的更新分两层:本体更新(npx 自动最新、npm update -g、源码 git pull)与插件更新(插件市场点更新、命令行覆盖安装)。本文按「准备 → 更新本体 → 更新插件 → 更新后检查」四步走,覆盖新手常见疑问。
6419 2
DeepSeek Harness 怎么更新?dsh 更新完整指南:更新本体(npx、npm、源码)与更新插件两种方式
|
3月前
|
安全 开发工具 git
DeepSeek Harness 插件从哪里安装?DSH plugin 的 npm 包、GitHub 源码与 tarball 三种来源对比
DeepSeek Harness 插件有三条安装来源:npm 包预构建开箱即用,GitHub 源码要 prepare 脚本与 allowBuilds 授权,本地 tarball 适合内部分发与调试;本文给三条命令与授权差异,并推荐先用 DSH Plugin Hub 一键安装。
1949 0
DeepSeek Harness 插件从哪里安装?DSH plugin 的 npm 包、GitHub 源码与 tarball 三种来源对比
|
1月前
|
缓存 开发工具 git
DSH skill 怎么安装、放在哪个目录?DeepSeek Harness 技能与插件的区别与用法
dsh skill 不是插件:它是给模型的可加载 Markdown 指令集,由本地提供方按 rank 扫描六个根目录发现,用 dsh plugin add 装不进去。本文讲清六个根目录的优先级、SKILL.md 写法与两个调用开关。
2482 4
DSH skill 怎么安装、放在哪个目录?DeepSeek Harness 技能与插件的区别与用法
|
3月前
|
Web App开发 人工智能 API
16 个超火的 DeepSeek Harness 插件,大肥鱼已经落后 N 个版本了。。。
DeepSeek Harness 精选插件推荐合集,从图片识别、浏览器操控、多 Agent 协作到手机远程控制,一口气带你看完 DSH 社区热门的十几个插件,覆盖技能扩展、UI 界面增强、整活玩法三大类,让你的鲸鱼变得更强。
7213 6
|
3月前
|
缓存 人工智能 监控
整理了一份 DeepSeek Harness 必备插件清单!
本文是DeepSeek Harness发布半个多月后的插件精选指南,涵盖10款高实用性插件:从生态入口dsh-market、视觉增强modlens,到界面升级、代码侧栏、文件引用、桌面端、多源搜索、长期记忆、费用监控及知识精读工具。附安装命令与适用场景,新手三步起步建议,助你高效打造个性化AI工作台。
7746 8
整理了一份 DeepSeek Harness 必备插件清单!
|
2月前
|
开发工具 git C++
dsh 更新插件用什么命令?DeepSeek Harness 单个插件更新、更新失败兜底与回滚指南
dsh 更新插件用 dsh plugin --profile <name> update <pkg>:该子命令把参数原样转发给 pnpm;本文区分本体更新与插件更新命令,给出单插件更新步骤、失败兜底与版本回滚方法。
1085 0
dsh 更新插件用什么命令?DeepSeek Harness 单个插件更新、更新失败兜底与回滚指南
|
3月前
|
缓存 资源调度 开发工具
dsh 怎么更新?DeepSeek Harness 更新到最新版三种方式:npx 自动更新、npm update -g、源码 git pull
更新 DeepSeek dsh 分三步:先查当前版本,再按安装方式更新——npx 自动用最新、全局安装用 npm update -g、源码用 git pull 重新构建,最后验证版本号。本文覆盖三种安装方式的更新命令、更新前备份、更新后验证与失败兜底排查。
3451 2
dsh 怎么更新?DeepSeek Harness 更新到最新版三种方式:npx 自动更新、npm update -g、源码 git pull