夜雨聆风学习资料网

ARTICLE · 1363208

DSH 插件怎么装?手装30分钟只进1个,另条路3条命令搞定

DSH 插件怎么装?手装30分钟只进1个,另条路3条命令搞定
上手记录2026.11.16

DSH 插件怎么装?手装30分钟只进1个,另条路3条命令搞定

手装30分钟只进1个,市场3条命令两分钟一个

DSH 插件专题 · 第 4 天

我给自己定了个规矩:装同一个插件,两条路各走一遍,看差多少。

一条是老老实实按 GitHub 仓库的说明手动装,一条是走插件市场。

结果很难看。第一条路我花了 30 分钟,装进 1 个,另外 1 个没装上。第二条路我先花 4 分钟把市场装上,之后每个插件都是一条命令,两分钟一个。

下面是我这两条路的完整记录,命令可以照着敲。先说结论:如果你还没装市场,先去装市场,这道弯路不值得走。

1两条路我各测了什么NOTE

测的是两个插件:dsh-market(12519 星,2026-11-15 下午还在更新)和它的用法。

我特意选这两个,因为它们有依赖关系:市场本身也是插件,装完才能用市场上装别的。所以「手动装市场」这件事,谁都躲不过一次。

▍第一条路:从仓库 README 复制安装步骤,手敲命令,出问题自己排查

▍第二条路:先用手动方式把市场装上,之后所有插件都从市场里搜、装、卸

▍两边记录三件事:耗时、卡在哪、装完怎么验证

图1:两条安装路径的耗时对照

2手装路径:4 步,卡在第 3 步NOTE

仓库的说明大概是这样的结构(我只贴关键那几行):

terminal

npm install -g dsh-market

dsh plugin add dsh-market

dsh plugin list

照着敲,第 1 步就慢。我这边网络拉包花了将近两分钟,进度条走得不匀,中间停了一次。

第 2 步 `dsh plugin add` 报了这么一行:

terminal

[error] plugin manifest not found: dsh-market/plugin.json

我当时的处理是去 GitHub 上翻目录,发现这个仓库的实际结构里,manifest 不在根目录,而是在一个子路径下。也就是说 `plugin add` 这条命令它默认找的位置跟仓库实际布局对不上。

解决办法是加一个路径参数,把它指到真正的目录:

terminal

dsh plugin add dsh-market --manifest ./dsh-market/plugin.json

# 我这边执行后输出:

# [info] resolved manifest: ./dsh-market/plugin.json

# [info] plugin 'dsh-market' added

第 3 步 `dsh plugin list` 出来是这样的:

terminal

NAME          VERSION   SOURCE         STATUS

dsh-market    0.4.x     local          enabled

这一行我很在意,因为 STATUS 那列写的是 `enabled` 才算真的生效。如果是 `installed`,说明装上了但没启用。

第 4 步我试了第二个插件,按同样流程走,卡在版本不匹配上。我没继续折腾,因为我看明白了:手装的成本不在命令本身,在于每个仓库的布局都不一样,你得一个个猜。

3市场路径:3 条命令,4 分钟NOTE

手动把市场装进去之后,剩下的事就是另一回事了。

图2:市场装完之后的三条命令

terminal

dsh market search sqlite

# 输出(节选):

# dsh-sqlite-tools   0.2.x    sqlite 工具集

# dsh-context        0.5.x    上下文可视化

dsh market install dsh-context

# [info] downloading dsh-context@0.5.x

# [info] installed in 2.1s

dsh plugin list

# NAME           VERSION   SOURCE        STATUS

# dsh-context    0.5.x     dsh-market    enabled

2.1 秒。这就是两条路的实际差距,前面那半小时主要花在「猜仓库布局」上。

市场这条路的好处不是快,是它替你处理了布局问题。你只提供一个名字,剩下的路径、版本、依赖,它自己解决。

项
手装
市场
单个插件耗时
10~15 分钟
1~2 分钟
卡点
manifest 路径、版本
基本没有
失败时怎么办
翻仓库、猜布局
卸了重装
需要知道的事
仓库结构
插件名

图3:手装路径卡住的三个位置

4一个没人提醒我的坑:装完看不到任何变化NOTE

这是我最想提前知道的一条。

装完 dsh-context,DSH 的主界面不会多出任何东西。没有新菜单、没有提示、没有欢迎语。因为插件给你的是一个新命令,不是界面上的按钮。

我等了十几秒,以为没装上,又去 `dsh plugin list` 看了一遍,确实是 enabled。

第一次真正看到它,是敲了:

terminal

dsh context stats

这个设计其实是对的,启动路径保持干净。但对第一次装的人极不友好,因为「没反应」和「装失败」在体感上一模一样。

我给自己的判断标准是:装完先敲一次它的命令,看到输出才算装好。 光看 `list` 里 enabled 不够。

5我还踩了一个 Ctrl+C 的坑NOTE

有一次下载的时候我嫌慢,按了 Ctrl+C 想重来。之后 `dsh plugin list` 里显示的是 `installed`,不是 `enabled`。

我一开始试图在配置里改状态,改不动。后来下载那份残留清了两三次还是不对,才发现问题是残留状态没清干净。

最后用的办法很土:

terminal

dsh plugin remove dsh-context

dsh market install dsh-context

卸干净再装,一次就成。中途打断过的安装,不要试图修,直接卸了重装。 这条我写在便签上了。

6什么时候别走市场这条路NOTE

说句实话,市场不是万能的,有两种情况我建议你别用。

第一种:插件更新很勤、而且你有本地改动。 市场帮你解决的是版本管理,但你要改源码的时候,它每装一次都会覆盖你的改动。我有个本地小改动的插件,第三次被覆盖之后就改成手动装了。

第二种:你只是想快速试一下,试完就删。 这种情况下市场确实快,但如果你连主流程都还没跑通,先装市场容易把问题搞复杂。我第一次就是典型的:「DSH 跑不通 → 装市场 → 还是跑不通 → 以为市场有问题」。实际上是我版本太旧。

顺便说一句我不赞同的:有人在群里说插件全从市场装就对了,这不对。市场是分发渠道,不是质量保证。里面有的插件星数三百多,装上去照样能让启动变慢。

7装完的第一件事NOTE

装完一个插件,我现在的动作是固定的三步:

▍先敲它的专用命令,看到真实输出

▍再敲 `dsh plugin list`,确认 STATUS 是 enabled

▍最后跑一个我平时正经在做的活,确认它真的帮上忙

三步里第三步最难,也最容易省。我前两天就是省了第三步,装了一个插件用了三天才发现它对我根本没用。

这个专题前面我写过「装什么」「怎么写技能」,这篇讲「怎么装」,其实是一条线上的三件事。下一篇我想收一下尾,把这几天在 DSH 和另一套 harness 上跑同一件事的差别摆出来,包括那些我没跑的、存疑的部分。

你装插件的时候,是信 `list` 里的状态,还是要去敲一次才算数?我现在的习惯是必须敲一次,光看状态骗过我一次。

你装完插件,是信 list 里的状态,还是必须敲一次命令?

点赞
在看
收藏
觉得有用,欢迎点赞、在看、转发THANKS FOR READING

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料