保姆级教程:8 分钟给 DSH 装插件市场,3 条命令跑通

保姆级教程：8 分钟给 DSH 装插件市场，3 条命令跑通

8 分钟装好入口，我第一次以为装失败了

保姆级教程

先说个数字：从敲下第一条命令到在终端里搜到第一个插件，我计时 8 分钟。

其中真正跑命令的时间不到 1 分钟。剩下 7 分钟全花在一件我没想到的事上：装完之后界面没有任何变化，我盯着屏幕愣了大概半分钟，以为自己装失败了。

这篇就把那 7 分钟里我想找但没找到的东西写清楚。

dsh-market 这个项目，星数 12413（2026-11-14 查的），pushed_at 也是 11-14 当天。它是 DSH 生态里装插件的入口，定位是「在终端里搜、装、卸」。

先确认你的 DSH 版本。DSH 的插件接口在最近几个版本里动过，装之前对一下版本号，比装完报错再回头查省事。

如果你的版本比这个旧，先升级。这一步我跳过过一次，结果是插件装上去之后命令能识别、但执行时找不到入口，报错信息完全没有提到版本，我按报错去查了四十分钟。

第一条：加源。 DSH 默认的插件源里没有这个市场，要先把它加进去。

「parsed 1 manifest」这行是关键。如果你看到的是 parsed 0，说明源地址指错了目录，后面搜索会一直是空结果。我第一次就少写了一个路径层级，搜了十分钟什么都没有，还以为市场里就是这个样。

第二条：装。

2.1 秒。这个速度快到我又怀疑了一次。

第三条：验证它到底装没装上。

STATUS 那一列是 enabled，才算真的好了。这里有个坑：如果 STATUS 显示 installed 而不是 enabled，说明装上了但没启用，插件不会生效。我遇到过一次，原因是安装过程中我按了 Ctrl+C 又重跑，残留状态没清干净。解决办法是先 uninstall 再装一次，不要试图「修」。

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

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

命令是这样的：

敲下去，才第一次看到列表。

我当时的错误预期来自别处：我用过的多数工具，装完扩展都会在界面上加一个可见入口。而 DSH 的插件设计更接近命令行工具的思路——装上之后它「存在」，但你不叫它，它不出现。

这个设计其实是对的。它让启动路径保持干净。但对第一次装的人不友好，因为「没有任何反馈」和「装失败了」在体感上完全一样。

判断装成功与否，只看 `dsh plugin list` 里那一行 STATUS。 别靠界面。

进到市场里之后，日常用的就下面这几条，我按使用频率排：

其中 dsh market info 那条我建议当成固定动作。它输出的内容里有两个字段值得看：

last update：超过两个月没更新的插件，装上去要谨慎。不是因为代码烂，是因为 DSH 本身在动，老插件可能对不上新接口。

requires：会列出它依赖的 DSH 最低版本。这里如果写着比你当前版本高的号，装上去大概率是能装上、不能用。

我在这一步吃过一次亏。有个插件 requires 写的是 0.10，我的是 0.9.x，装的时候没有任何提示，装完执行报了一个完全无关的错误，我按那个错误去查了半天，最后才想起来回头看 requires。

如果你只记一条：装之前敲 `dsh market info`，看完再决定。

第一个：搜索没结果是常态，不是故障。

市场的索引是按名字和描述做的。你搜「上下文」可能什么都没，搜 context 就有了。它的搜索不做中文分词。我第一次搜中文关键词，以为市场是空的。

第二个：装完重启一次更稳。

理论上插件装完立即生效。实际我遇到过两次「命令能识别但执行报模块找不到」，重启 DSH 之后就好了。后来我把「装完重启」当成固定动作，这类问题再没出现过。代价就是多几秒，值得。

第三个：不要在一个会话里连装多个。

DSH 的会话里，插件是加载时初始化的。同一个会话里连着装三个，第三个经常出现初始化不完整的情况。我的做法是：装一个，重启，验证，再装下一个。

这三条都不是文档里的内容，是我自己撞出来的。文档写的是「正常情况下」，而正常情况下你也不会来看这篇。

市场本身不产生价值，它是个入口。装完之后真正的判断是「我到底要不要装第二个」。

我给自己的标准还是那一条：能不能说清它替我做了哪个判断。说不清就先别装。

如果只是想试一个，我建议从上下文用量那类开始。它给的反馈最直接——你能看到每轮花了多少，这个数字不需要任何解释，看一眼就懂。

插件市场这种入口类的东西，装一次就够了，后面所有插件都从它里面进。

我给不了你「哪个插件值得装」的答案。这篇只解决「怎么把入口装好、怎么确认装对了」。

如果你的 DSH 版本比 0.9 老很多，上面的输出可能和你的不完全一样，以 dsh plugin list 的实际结果为准。

这个专题的上一篇我写了照着精选清单装 8 个只留 2 个的筛选过程。下一篇我想写另一头的事：我不想再攒插件了，能不能自己写一个小的。看了两个大技能库的写法，结论互相打架——同一件事，两边的做法几乎是相反的。

你装第一个插件的时候，是怎么判断它到底生效了的？我现在还是靠 list 里那行 STATUS，总觉得有点原始。

你装第一个插件时，是怎么确认它生效的？

觉得有用，欢迎点赞、在看、转发

THANKS FOR READING