插件安装教程
三种装法（在线 / 市场 / 离线）+ 报错排查，装不上的情况这里基本都能找到原因。
先确认前置条件
- 已安装 dsh CLI 引擎（这是所有插件的运行基础）——快速开始见这里
- Node.js ≥ 22.19
- 知道要装插件的 GitHub 完整名（
owner/repo）
方式一：命令安装（最常用）
dsh plugin --profile web add 作者名/仓库名例：dsh plugin --profile web add omdsh-dev/DSH-better-sidebar
⚠️ 最常见的报错：漏掉
--profile。dsh plugin add 作者名/仓库名 会直接报 error: required option '--profile <name>' not specified—— dsh 把它声明为必需参数，不是可选项，add / remove / list 一律要带。 本站插件详情页给出的命令都已包含该参数，直接复制即可。⚠️ 第二容易踩的坑：不能只写仓库名（如
DSH-better-sidebar），必须带上 owner。缺 owner 时安装器无法定位包， 会报「找不到包」而不是「权限不足」，很多人卡在这里。这里的 web 是浏览器 Web UI 所使用的 profile 名；装完必须重启 dsh 才会加载新插件。 插件详情页都提供了一键复制的安装命令， 去插件目录挑一个 →
方式二：市场可视化安装
部分环境内置了插件市场（dsh-market 类插件），可以在界面里搜索、点选安装， 不用敲命令。安装市场本身：
dsh plugin --profile web add dsh-market/dsh-market方式三：离线 / 内网环境安装
没有外网或公司内网受限时，先在能联网的机器把仓库拉下来，再拷到目标机器手动放置：
git clone https://github.com/作者名/仓库名.git
# 把整个目录拷到目标机器的 dsh 插件目录下，重启 dsh 即可提示：离线安装跳过了依赖自动解析，若插件依赖 npm 包，需要在目标机器上单独安装依赖。
顺手装上：严选插件（本站自荐）
把本站的插件目录装进你的 dsh：侧边栏会多一个「严选插件」入口，可搜索、 按可信度筛选，并对已验证的插件一键安装。
在终端执行（装完重启 dsh）
dsh plugin --profile web add zhanghao3693/dsh-dpharness该插件未发布到 npm，走 GitHub 源安装 —— 与插件详情页给出的命令完全一致。
这是本站自己做的工具，属于自荐位；它同时也在 插件目录 里，收录与验证走的是和其他插件同一套流程。
报错排查
提示找不到包 / package not found
九成是只写了仓库名没带 owner。用完整 GitHub 名：dsh plugin --profile web add owner/repo。
error: required option '--profile <name>' not specified
命令漏了 --profile，dsh 把它声明为必需参数（add / remove / list 都要带）。正确写法：dsh plugin --profile web add owner/repo。其中 web = 浏览器 UI 所用的 profile。
dsh: command not found
CLI 没装成功或没进 PATH。用 npx @deepseek-ai/dsh 免安装方式，或检查 npm 全局目录是否在 PATH 里。
装上了但界面没变化 / 插件没生效
插件需要重启 dsh 才加载——命令执行成功不等于界面立刻生效，这一步最容易被忽略。完全退出进程后重新启动，再看设置里的插件列表。
报 Node 版本错误
dsh 要求 Node ≥ 22.19。用 nvm 切换：nvm install 22 && nvm use 22。
依赖冲突 / peer dependency 报错
插件与当前 dsh 版本不兼容。查看该插件在本站的兼容性标注（装前注意 / 需源码安装），或等作者适配新版本。