ARTICLE · 1368958
DSH 插件怎么装?从零到第一个插件跑起来,9 分钟全程可复制
DSH 插件怎么装?从零到第一个插件跑起来,9 分钟全程可复制
9 分钟从零到第一个插件生效,命令全可复制
DSH 插件专题 · 第 5 天
我昨天在一条干净的环境里从零装了一遍,掐着表。
从敲第一条命令到第一个插件真的在我的会话里回话,用了 9 分 20 秒。 其中 4 分钟不是在敲命令,是在排一个我自己造出来的错。
今天这篇就是那 9 分钟的原样复盘。命令一条条可以复制,卡住的地方我标了红灯。
如果上一篇讲的是插件市场怎么管,这篇就是它前面那段:什么都不知道的时候,第一次装插件该怎么走。
要走的路其实只有三步:确认 DSH 在跑、挑一个插件、装完验证它真的生效。听起来简单,坑全在第三步——装完了不等于生效了,这是最容易让人误判「插件没用」的地方。
ds-market 那个市场 12637 星,pushed_at 2026-11-16 下午 5 点 21,我前一天刚查过;这篇不走市场,走最原始的手装,因为你先得知道它背后到底发生了什么,后面用任何工具才不会心虚。

图1:从零到第一个插件生效的完整步骤,9分20秒
很多人第一次装插件失败,问题根本不在插件上,在宿主没起来。
所以第一步不是装东西,是确认环境活着。三个命令,敲完看输出:
# 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 plugin path` 的输出抄下来,后面所有操作都对着这个路径。
第一次别挑功能最多的,挑最小的。功能多的插件依赖多、失败点也多,你分不清是哪一步错了。
我选的是 dsh-context,5136 星,pushed_at 2026-11-15,当天早上刚更新过几小时。选它的理由很土:它只有一个作用,装完立刻能在会话里显示一个数字,验证快。
拉取有两种走法,我都试了:
# 走法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` 里的一个字段,结果列表里能看到名字,调用就是没反应。
这就是前面说的那 4 分钟。
装完,`dsh plugin list` 里确实有它。但我在会话里问它占用率,它完全不理我,就像没这个插件。
我第一反应是版本装错了,把版本号从 0.9.3 换成最新的重装,还是没反应。第二反应是网络,查了一遍,通。
真正的原因在列表输出的一个字段上:
$ dsh plugin list
name version status
dsh-context 0.9.3 loaded=false
`loaded=false`。它被安装了,但没被加载。
原因是我的会话是在装插件之前就开着的。插件在启动时加载一次,会话已经跑起来了,后面放进去的东西它不知道。
这一类问题在别的地方也常见,但因为它不报错,你就不会往这想。我第一次用的时候,甚至怀疑是不是要重新登录。
解决办法一行:重开会话,再列一遍。重开之后立刻变成 `loaded=true`。
$ dsh plugin list
name version status
dsh-context 0.9.3 loaded=true
> 记一条判断规则:装完之后列表里有名字,但会话里没反应,八成是没加载,不是插件坏了。先重开,再看。
`loaded=true` 只是说它被加载了。它到底有没有在做事,还得另一步验证。

图2:装上了没加载、加载了没触发,四类现象对照
我的验证办法是看它有没有产出可以被看到的东西。dsh-context 的特点是会在会话里显示当前占据多少,所以我一问它就应该有数字:
> 现在上下文占了多少?
[dsh-context] context: 18% (12.4k / 68k tokens)
看到这一行,才算真的跑通。如果没有这行,但列表里显示 loaded=true,那是它加载了但没被触发——问题在触发条件,不在安装。
这两件事我分得很清,因为它们的解法完全不一样:
大多数人骂「插件没用」,骂的是第三行,其实那时候插件都没被调起来。

图3:插件往上堆,同一个活多花多少上下文
第一个跑通之后,人会想装第二个。这时候我建议先做一件反直觉的事:先量一下你现在有多慢,再量装完。
我的做法很笨,但有效:同一个活,装之前先跑一遍,记下时间和上下文占用;装完再跑一遍,还是同一个活。
我用的是手上那份几千行的表格清洗脚本。装之前跑完,会话里显示 45% 左右;装上 dsh-context 之后同一个活跑完变成 52%——多出来的部分,是插件自己的面板和指令占的。
不是很多,但它是每一轮都在耗。
> 这就是我反对「看到好插件就装一堆」的理由:每个插件都从你的上下文里抽一份税,税率不高,但会累加。
到 74% 那一次我明显感觉到回答变短。这不是插件的问题,是总账的问题。
回头看,这 9 分 20 秒是这么分的:
真正装东西只花了 6 分钟,剩下都在理解和排错。所以第一次装,把意识放在「为什么」比放在「多快」上更划算。
我只有一台机器、一个环境,路径被我自己改过。你那边 `dsh plugin path` 很可能是别的目录,别照抄我的路径。
插件版本我也是按当天抓到的写的,隔几天号就变了,按最新版就行。命令的写法如果和你那边不一样,以 `dsh plugin --help` 为准。
下一篇我换个方向:既然大家都开始装插件了,那插件本身是怎么写出来的?我会拿两份官方和实战的技能库拆开看,讲 SKILL.md 里哪几行是真的起作用。
你第一次装插件时卡在哪一步?我赌一半人是卡在「装完没反应」——如果是,回一句你当时的列表输出长什么样,我看看是不是同一类。
这篇只覆盖手装这一条路。图形界面装、市场装、团队私有源装,都是另外的走法,各有各的坑。
你第一次装插件,是卡在安装还是卡在没反应?















































































