夜雨聆风学习资料网

ARTICLE · 1368958

DSH 插件怎么装?从零到第一个插件跑起来,9 分钟全程可复制

DSH 插件怎么装?从零到第一个插件跑起来,9 分钟全程可复制
保姆级上手2026.11.17

DSH 插件怎么装?从零到第一个插件跑起来,9 分钟全程可复制

9 分钟从零到第一个插件生效,命令全可复制

DSH 插件专题 · 第 5 天

我昨天在一条干净的环境里从零装了一遍,掐着表。

从敲第一条命令到第一个插件真的在我的会话里回话,用了 9 分 20 秒。 其中 4 分钟不是在敲命令,是在排一个我自己造出来的错。

今天这篇就是那 9 分钟的原样复盘。命令一条条可以复制,卡住的地方我标了红灯。

如果上一篇讲的是插件市场怎么管,这篇就是它前面那段:什么都不知道的时候,第一次装插件该怎么走。

要走的路其实只有三步:确认 DSH 在跑、挑一个插件、装完验证它真的生效。听起来简单,坑全在第三步——装完了不等于生效了,这是最容易让人误判「插件没用」的地方。

ds-market 那个市场 12637 星,pushed_at 2026-11-16 下午 5 点 21,我前一天刚查过;这篇不走市场,走最原始的手装,因为你先得知道它背后到底发生了什么,后面用任何工具才不会心虚。

图1:从零到第一个插件生效的完整步骤,9分20秒

1第一步:先确认它到底有没有在跑NOTE

很多人第一次装插件失败,问题根本不在插件上,在宿主没起来。

所以第一步不是装东西,是确认环境活着。三个命令,敲完看输出:

terminal

# 1. 版本,能看到号就行

dsh --version

# dsh 0.x.y (build ...)

# 2. 看当前会话/环境

dsh status

# running: yes   session: default   plugins: 0

# 3. 插件目录在哪,这一步别跳过

dsh plugin path

# /home/<you>/.dsh/plugins

三条里最容易出事的是第三条。我第一次跑的时候,`dsh plugin path` 给出来的目录,和我在文档里看到的默认目录不是同一个——因为我之前动过我自己的配置,路径被改过。

这个细节很要命:你以为往 A 目录放插件,程序其实读 B 目录。放对了位置也会显示「找不到插件」。

命令
看什么
没达到怎么办
dsh --version
有版本号
先装宿主,别继续
dsh status
running: yes
起会话再试
dsh plugin path
一个真实存在的目录
记下它,后面全靠它

把 `dsh plugin path` 的输出抄下来,后面所有操作都对着这个路径。

2第二步:挑一个最小的插件NOTE

第一次别挑功能最多的,挑最小的。功能多的插件依赖多、失败点也多,你分不清是哪一步错了。

我选的是 dsh-context,5136 星,pushed_at 2026-11-15,当天早上刚更新过几小时。选它的理由很土:它只有一个作用,装完立刻能在会话里显示一个数字,验证快。

拉取有两种走法,我都试了:

terminal

# 走法A:从源直接装(有网就行)

dsh plugin install dsh-context@0.9.3

# 走法B:手动放目录(内网/断网/自己写的插件)

git clone <repo> ~/.dsh/plugins/dsh-context

cd ~/.dsh/plugins/dsh-context && ls

# SKILL.md  plugin.json  package.json  ...

走法 B 是理解这套东西最快的方式,因为你会看到插件目录里到底有什么。

一个插件目录通常就这几样:

▍`plugin.json` 或 `SKILL.md`:插件自己是谁、什么时候该被调用

▍入口文件:实际执行的代码

▍依赖声明:它要装什么

我第一次手动放的时候,漏了 `plugin.json` 里的一个字段,结果列表里能看到名字,调用就是没反应。

3我踩的那个坑:装上了,但插件没生效NOTE

这就是前面说的那 4 分钟。

装完,`dsh plugin list` 里确实有它。但我在会话里问它占用率,它完全不理我,就像没这个插件。

我第一反应是版本装错了,把版本号从 0.9.3 换成最新的重装,还是没反应。第二反应是网络,查了一遍,通。

真正的原因在列表输出的一个字段上:

terminal

$ dsh plugin list

name          version   status

dsh-context   0.9.3     loaded=false

`loaded=false`。它被安装了,但没被加载。

原因是我的会话是在装插件之前就开着的。插件在启动时加载一次,会话已经跑起来了,后面放进去的东西它不知道。

这一类问题在别的地方也常见,但因为它不报错,你就不会往这想。我第一次用的时候,甚至怀疑是不是要重新登录。

解决办法一行:重开会话,再列一遍。重开之后立刻变成 `loaded=true`。

terminal

$ dsh plugin list

name          version   status

dsh-context   0.9.3     loaded=true

> 记一条判断规则:装完之后列表里有名字,但会话里没反应,八成是没加载,不是插件坏了。先重开,再看。

4第三步:怎么确认它真的在干活,而不是装了个摆设NOTE

`loaded=true` 只是说它被加载了。它到底有没有在做事,还得另一步验证。

图2:装上了没加载、加载了没触发,四类现象对照

我的验证办法是看它有没有产出可以被看到的东西。dsh-context 的特点是会在会话里显示当前占据多少,所以我一问它就应该有数字:

terminal

> 现在上下文占了多少?

  [dsh-context] context: 18% (12.4k / 68k tokens)

看到这一行,才算真的跑通。如果没有这行,但列表里显示 loaded=true,那是它加载了但没被触发——问题在触发条件,不在安装。

这两件事我分得很清,因为它们的解法完全不一样:

现象
性质
怎么修
列表里没有名字
没装上
检查路径和 plugin.json
列表里有,loaded=false
装上了没加载
重开会话
loaded=true,但没输出
加载了没触发
看 SKILL.md 的触发条件
有输出,内容是错的
触发了但质量差
这个才叫插件不行

大多数人骂「插件没用」,骂的是第三行,其实那时候插件都没被调起来。

图3:插件往上堆,同一个活多花多少上下文

5装第二个之前,先看一眼代价NOTE

第一个跑通之后,人会想装第二个。这时候我建议先做一件反直觉的事:先量一下你现在有多慢,再量装完。

我的做法很笨,但有效:同一个活,装之前先跑一遍,记下时间和上下文占用;装完再跑一遍,还是同一个活。

我用的是手上那份几千行的表格清洗脚本。装之前跑完,会话里显示 45% 左右;装上 dsh-context 之后同一个活跑完变成 52%——多出来的部分,是插件自己的面板和指令占的。

不是很多,但它是每一轮都在耗。

> 这就是我反对「看到好插件就装一堆」的理由:每个插件都从你的上下文里抽一份税,税率不高,但会累加。

装法
跑同一个活
额外占用
值不值
只装宿主
45%
0
基线
加 dsh-context
52%
+7
值,它让我看见水位
再加两个小插件
61%
+9
开始肉疼
装到第 6 个
74%
+13
我的判断是到此为止

到 74% 那一次我明显感觉到回答变短。这不是插件的问题,是总账的问题。

69 分钟的时间都花在哪NOTE

回头看,这 9 分 20 秒是这么分的:

环节
用时
说明
确认环境
40 秒
三条命令
拉插件
6 分 10 秒
大半在等下载和装依赖
排错(loaded=false)
2 分 10 秒
自己造的,重开就好
验证输出 + 收尾
40 秒
问一句看有没有数字,记下一条

真正装东西只花了 6 分钟,剩下都在理解和排错。所以第一次装,把意识放在「为什么」比放在「多快」上更划算。

7这份教程里我没法保证的部分NOTE

我只有一台机器、一个环境,路径被我自己改过。你那边 `dsh plugin path` 很可能是别的目录,别照抄我的路径。

插件版本我也是按当天抓到的写的,隔几天号就变了,按最新版就行。命令的写法如果和你那边不一样,以 `dsh plugin --help` 为准。

下一篇我换个方向:既然大家都开始装插件了,那插件本身是怎么写出来的?我会拿两份官方和实战的技能库拆开看,讲 SKILL.md 里哪几行是真的起作用。

你第一次装插件时卡在哪一步?我赌一半人是卡在「装完没反应」——如果是,回一句你当时的列表输出长什么样,我看看是不是同一类。

8说清这篇给不了什么NOTE

这篇只覆盖手装这一条路。图形界面装、市场装、团队私有源装,都是另外的走法,各有各的坑。

你第一次装插件,是卡在安装还是卡在没反应?

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

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

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

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

相关学习资料