dsh插件市场 点安装前 60 秒:权限、依赖、构建脚本、回滚成本完整清单与安装后验证顺序
60 秒,是点下「安装」之前你真正愿意花的时间;超过这个长度,大多数人会直接点确认。 所以这份清单只放四项能在 60 秒内看完的东西:权限范围、依赖数量、构建脚本、回滚成本(2.2.5 索引)。它不要求你读源码,只要求你在 DSH Plugin Hub 的详情页、安装提示和来源仓库之间走一遍。四项里任何一项说不清,就先别装。
前 20 秒:DSH plugin 的权限范围与依赖数量
前 20 秒只回答两个问题:它需要碰什么,它拉了多少东西。 这两项决定风险的影响面,也最容易在详情页里快速看到。
- 用功能倒推权限:只做界面调整的插件不需要网络请求,只做摘要的插件不需要整盘文件访问。
- 在详情页或安装提示里找能力声明,对照功能判断是否超配;说不清就问来源仓库。
- 看依赖数量,再扫一眼有没有与功能无关的陌生包或陌生 scope。
- 依赖规模明显大于同类插件时,进仓库看依赖清单,不要只看数字。
| 功能类型 | 合理权限 | 需要警惕 |
|---|---|---|
| 界面主题 | 读取主题配置 | 整盘文件访问、网络请求 |
| 记忆检索 | 读写记忆目录 | 访问无关用户目录 |
| 联网搜索 | 网络请求 | 本地文件全盘访问 |
| 文档处理 | 读写指定文档目录 | 起本地端口、执行任意命令 |
权限与依赖要一起看:权限大但依赖少,可能是内置能力;依赖多但权限小,可能只是供应链面大。两类风险不会互相抵消。
中 20 秒:DSH plugin 的构建脚本、平台限制与版本兼容
中 20 秒回答「装的时候会不会执行代码、装完能不能跑」。 构建脚本决定安装阶段的风险,平台与版本决定装完能不能用。
- 从源码安装时,留意是否提示允许执行构建脚本;只对能对上来源的仓库放行。
- 不确定就拒绝脚本,改用 npm 预构建版本;拒绝通常只是装不上,比执行来源不明的脚本安全。
- 看插件声明的平台限制:Windows、macOS、Linux 是否都支持,有没有原生模块依赖。
- 看版本兼容:插件要求的 Harness 版本区间是否包含你当前的版本,跨大版本先别装。
- 平台或版本对不上时,先去详情页或仓库确认,不要指望「装上再看」。
构建脚本是安装阶段唯一会「先执行、后使用」的环节。它的风险不在插件运行时,而在你点确认的那一刻;所以这一项宁可保守。
后 20 秒:dsh plugin market 的回滚点怎么留
后 20 秒只做一件事:把「装坏了怎么退」提前准备好。 回滚点不是备份整个系统,而是留三样能让你退回原状的东西。
- 记下当前已安装列表里同名插件的版本,没有同名插件就记「未安装」。
- 备份当前 profile 的
package.json,里面同时有依赖清单与加载清单。 - 记下与这个插件相关的关键配置,尤其是你手动改过的项。
- 确认卸载入口在哪:已安装列表行尾的「卸载」,会先弹确认再移除。
- 把三样东西放在一个能找到的位置,别只记在脑子里。
版本、清单、配置三样里,清单最容易被忽略,却最有用:出问题时它能告诉你「本来应该装什么、启动时该加载什么」。只记版本,恢复时还是要猜。
没有备份时的最小回退
- 先看已安装列表的版本记录,确认原来是不是同名插件。
- 再查 profile 的 package.json 备份或版本控制记录。
- 都没有时,按「卸载当前版本 → 装回上一个已知版本」执行。
- 装回后重启验证入口,再补一次备份。
安装确认弹窗:DSH Plugin Hub 的最后一道闸
确认弹窗是安装前最后一次「看清来源」的机会,它列出插件名、来源仓库与将要执行的安装命令。 点确认之前,这三项都要能对上你前面的判断。

- 核对插件名是否就是你选的那个,注意同名不同作者的条目。
- 核对来源仓库是否与详情页、你查过的仓库一致。
- 看将要执行的安装命令,确认没有额外的全局安装或脚本参数。
- 三项都对上再点确认;任何一项对不上,取消并回详情页重查。
- 确认后不要连续重复点击,等待进度走完,失败先去通知中心。
确认弹窗不是形式主义:它把「你以为要装的」和「实际要执行的」放在同一屏。前面 60 秒的判断,最后都要在这一屏里复核一次。
装后 3 分钟:DeepSeek Harness 的验证与回滚演练
装完的验证分两步:先证明它生效,再证明你知道怎么退。 两步都做完,这次安装才算闭环。
- 重启 DeepSeek Harness,打开插件提供的入口、命令或面板。
- 实际调用一次插件能力,确认不是只有界面出现。
- 去已安装列表确认版本、来源标签与状态,再回系统日志看有没有激活错误。
- 打开卸载确认弹窗,看清它会移除什么,然后点取消——这是一次不动手的回滚演练。
- 把版本、来源与验证结果记进环境笔记,下次更新时直接对照。
验证时一次只动一个变量:先重启、再看入口、最后看日志。三个信号都通过,说明这次安装可以留在环境里;任何一个失败,按 安装失败怎么看通知 的顺序排查,不要直接卸载重装。
出现这三种情况就别继续验证
- 插件启动后宿主反复崩溃或无法进入会话。
- 入口出现,但一调用就报权限或路径错误。
- 系统日志里出现持续的激活失败。
先卸载、回到已知可用的状态,再排查;不要在坏环境里继续加变量。清单里的权限与依赖判断,还可以对照 怎么安全安装插件。
常见问题
DeepSeek Harness 里先看权限范围,因为它决定插件能碰到什么,影响面最大。权限之后再看依赖数量、构建脚本与回滚成本;四项不用读源码,靠详情页、安装提示与来源仓库就能判断,任何一项说不清就先不装。
DeepSeek Harness 里用功能倒推权限:只做摘要的插件不需要整盘文件访问,只做界面调整的插件不需要网络请求。依赖数量没有绝对标准,但出现与功能无关的陌生包、或依赖规模远大于同类插件时,就值得进仓库核对。
DeepSeek Harness 里构建脚本会在安装或构建阶段执行代码,所以只对你能对上来源的仓库放行。不确定就拒绝执行,改用该插件的 npm 预构建版本;拒绝脚本通常会导致装不上,这比装上一个来源不明的脚本安全。
DeepSeek Harness 里回滚点要留三样:当前插件版本、profile 清单与关键配置。更新或安装前把已安装列表与 profile 的 package.json 备份一份;只记版本不够,清单和配置才是恢复时真正要用的依据。
DeepSeek Harness 里先重启宿主,确认插件入口或命令真的出现,再实际调用一次能力。验证通过后,走一次卸载确认弹窗但点取消,确认你知道回滚入口在哪;真正的回滚要等需要时再做,不要用「装完就卸」来测试。
相关术语
- 安装前检查
- 安装前检查是在 dsh插件市场点安装之前,对权限范围、依赖数量、构建脚本与回滚成本做的四项核对。它用几十秒换掉一次可能的卸载与清残留。— https://dsh-plugin.org/zh/plugins/dshplugin/dsh-plugin-hub
- 安装确认弹窗
- 安装确认弹窗是 DSH Plugin Hub 在真正执行安装前显示的安全关卡,列出插件名、来源仓库与将要运行的安装命令。用户确认后才开始下载与写入 profile。— https://api.dsh-plugin.org/images/releases/2-2-5/index.json
- 回滚点
- 回滚点是安装或更新前保存的可恢复状态,通常包括当前版本、profile 依赖清单与关键配置。它决定出问题时能否退回而不是重装。— https://github.com/deepseek-ai/deepseek-harness
- 构建脚本
- 构建脚本是 DSH plugin 或其依赖在安装、构建阶段自动执行的脚本。它会在插件运行前就执行代码,因此需要确认来源后再放行。— https://github.com/dshplugin/dsh-plugin-hub
来源
- DSH Plugin Hub 2.2.5 界面截图索引· dsh-plugin.org
- deepseek-ai/deepseek-harness(源码仓库)· GitHub
- dshplugin/dsh-plugin-hub 仓库· GitHub