ARTICLE · 1363208
DSH 插件怎么装?手装30分钟只进1个,另条路3条命令搞定
DSH 插件怎么装?手装30分钟只进1个,另条路3条命令搞定
手装30分钟只进1个,市场3条命令两分钟一个
DSH 插件专题 · 第 4 天
我给自己定了个规矩:装同一个插件,两条路各走一遍,看差多少。
一条是老老实实按 GitHub 仓库的说明手动装,一条是走插件市场。
结果很难看。第一条路我花了 30 分钟,装进 1 个,另外 1 个没装上。第二条路我先花 4 分钟把市场装上,之后每个插件都是一条命令,两分钟一个。
下面是我这两条路的完整记录,命令可以照着敲。先说结论:如果你还没装市场,先去装市场,这道弯路不值得走。
测的是两个插件:dsh-market(12519 星,2026-11-15 下午还在更新)和它的用法。
我特意选这两个,因为它们有依赖关系:市场本身也是插件,装完才能用市场上装别的。所以「手动装市场」这件事,谁都躲不过一次。
▍第一条路:从仓库 README 复制安装步骤,手敲命令,出问题自己排查
▍第二条路:先用手动方式把市场装上,之后所有插件都从市场里搜、装、卸
▍两边记录三件事:耗时、卡在哪、装完怎么验证

图1:两条安装路径的耗时对照
仓库的说明大概是这样的结构(我只贴关键那几行):
npm install -g dsh-market
dsh plugin add dsh-market
dsh plugin list
照着敲,第 1 步就慢。我这边网络拉包花了将近两分钟,进度条走得不匀,中间停了一次。
第 2 步 `dsh plugin add` 报了这么一行:
[error] plugin manifest not found: dsh-market/plugin.json
我当时的处理是去 GitHub 上翻目录,发现这个仓库的实际结构里,manifest 不在根目录,而是在一个子路径下。也就是说 `plugin add` 这条命令它默认找的位置跟仓库实际布局对不上。
解决办法是加一个路径参数,把它指到真正的目录:
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` 出来是这样的:
NAME VERSION SOURCE STATUS
dsh-market 0.4.x local enabled
这一行我很在意,因为 STATUS 那列写的是 `enabled` 才算真的生效。如果是 `installed`,说明装上了但没启用。
第 4 步我试了第二个插件,按同样流程走,卡在版本不匹配上。我没继续折腾,因为我看明白了:手装的成本不在命令本身,在于每个仓库的布局都不一样,你得一个个猜。
手动把市场装进去之后,剩下的事就是另一回事了。

图2:市场装完之后的三条命令
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 秒。这就是两条路的实际差距,前面那半小时主要花在「猜仓库布局」上。
市场这条路的好处不是快,是它替你处理了布局问题。你只提供一个名字,剩下的路径、版本、依赖,它自己解决。

图3:手装路径卡住的三个位置
这是我最想提前知道的一条。
装完 dsh-context,DSH 的主界面不会多出任何东西。没有新菜单、没有提示、没有欢迎语。因为插件给你的是一个新命令,不是界面上的按钮。
我等了十几秒,以为没装上,又去 `dsh plugin list` 看了一遍,确实是 enabled。
第一次真正看到它,是敲了:
dsh context stats
这个设计其实是对的,启动路径保持干净。但对第一次装的人极不友好,因为「没反应」和「装失败」在体感上一模一样。
我给自己的判断标准是:装完先敲一次它的命令,看到输出才算装好。 光看 `list` 里 enabled 不够。
有一次下载的时候我嫌慢,按了 Ctrl+C 想重来。之后 `dsh plugin list` 里显示的是 `installed`,不是 `enabled`。
我一开始试图在配置里改状态,改不动。后来下载那份残留清了两三次还是不对,才发现问题是残留状态没清干净。
最后用的办法很土:
dsh plugin remove dsh-context
dsh market install dsh-context
卸干净再装,一次就成。中途打断过的安装,不要试图修,直接卸了重装。 这条我写在便签上了。
说句实话,市场不是万能的,有两种情况我建议你别用。
第一种:插件更新很勤、而且你有本地改动。 市场帮你解决的是版本管理,但你要改源码的时候,它每装一次都会覆盖你的改动。我有个本地小改动的插件,第三次被覆盖之后就改成手动装了。
第二种:你只是想快速试一下,试完就删。 这种情况下市场确实快,但如果你连主流程都还没跑通,先装市场容易把问题搞复杂。我第一次就是典型的:「DSH 跑不通 → 装市场 → 还是跑不通 → 以为市场有问题」。实际上是我版本太旧。
顺便说一句我不赞同的:有人在群里说插件全从市场装就对了,这不对。市场是分发渠道,不是质量保证。里面有的插件星数三百多,装上去照样能让启动变慢。
装完一个插件,我现在的动作是固定的三步:
▍先敲它的专用命令,看到真实输出
▍再敲 `dsh plugin list`,确认 STATUS 是 enabled
▍最后跑一个我平时正经在做的活,确认它真的帮上忙
三步里第三步最难,也最容易省。我前两天就是省了第三步,装了一个插件用了三天才发现它对我根本没用。
这个专题前面我写过「装什么」「怎么写技能」,这篇讲「怎么装」,其实是一条线上的三件事。下一篇我想收一下尾,把这几天在 DSH 和另一套 harness 上跑同一件事的差别摆出来,包括那些我没跑的、存疑的部分。
你装插件的时候,是信 `list` 里的状态,还是要去敲一次才算数?我现在的习惯是必须敲一次,光看状态骗过我一次。
你装完插件,是信 list 里的状态,还是必须敲一次命令?















































































