只装可信的:我给 DeepSeek Harness 挑了 5 个插件
社区插件已经数以千计,但「能装」和「该装」是两回事。这篇文章记录我如何用四条硬标准筛选、用官方插件管理器安装,并用三重证据确认 5 个插件真的在跑。
先说边界
这不是一份安全审计报告,也不是「2026 必装插件 Top10」。它只是一次带着明确取舍的筛选与安装记录:环境是 Windows 11 + Node v24.18.1 + pnpm 12.6.0 + DeepSeek Harness(DSH)0.1.7-rc.2,目标是给我自己这台机器配一套够用、可信、成本可控的插件。
我没有逐行读每个插件的源码。所以下面的「可信」,指的是一组可被验证的门槛(公开包、无安装脚本、声明了官方规范的字段、来源可追溯),而不是「我担保它绝对安全」。任何第三方插件,你都应该在安装前自己看一眼它的仓库。
另外一条边界:装了插件不会改变对话内容要发给模型这件事。本机处理的部分(比如文献检索、费用统计)确实不出去,但对话本身仍然走你在 DSH 里配的 API。这两件事别混。
为什么值得折腾插件
把 dsh --profile web --dump-config 的输出数一遍,模块加载条目有 300 条——网页搜索、终端、计划模式、子代理、定时任务都在里面,日常够用。我后来加的 5 个插件,只占其中 5 条。
不过有两类需求它默认不管:
-
成本可见性:你花了多少钱、上下文被什么吃掉了,默认是黑箱;
-
私有资料的处理:把几十篇 PDF 丢给云端检索,既贵又让人不放心。
这两件事恰好都能由很小的插件补上,而且都能在本机完成。
候选从哪来
我没有在 npm 上瞎搜,而是先去找「别人已经整理过的清单」:
-
GitHub 上的几个 awesome 清单(awesome-dsh-plugin、awesome-deepseek-harness 等),两份加起来有 600 多个包名;
-
知乎、博客园的一些「推荐清单」文章;
-
npm 的搜索与下载量数据,用来交叉验证。
600 多个名字里,真正符合我需求的其实只有十几个。候选多不等于选择多——这正是需要标准的原因。
怎么判断一个插件「可信」
我给自己定了四条硬标准,全部满足才考虑装:
-
npm 公开可查。
npm view能拿到信息,不是刚发布、无仓库、无来源的包。 -
没有安装脚本。这一条最重要:
preinstall/install/postinstall会在你敲下安装命令的那一刻执行任意代码,风险最高。很多正规包用prepare/prepack只是发布前构建,registry 安装时并不会执行,可以接受,但我仍会留意。 -
是「正规」的 DSH 插件。
package.json的dsh字段里应同时有bundle.patch(它是个插件组合包)和client.inject(它给 Web 前端注入了东西),否则它可能只是给 TUI 用的,装到 Web 上等于没装。 -
来源可追溯。有 GitHub 仓库、有下载量、近期还在更新。
前三条可以一行命令看完:
npm view <包名> version dsh scripts repository.url
我最后留下的 5 个
| 插件 | 版本 | 作用 | 当时的公开数据 |
|—|—|—|—|
| dsh-context | 0.59.1 | 上下文洞察:看窗口占用、压缩事件 | 月下载 11 万+,★1564 |
| dsh-spend | 0.6.3 | token / 费用统计(USD↔CNY) | 月下载 1.4k |
| dsh-kb-rag | 1.6.7 | 本地文献库 RAG,带 DOI 引用 | 月下载 2.8k |
| dsh-deepread | 1.0.1 | 深度阅读长文 / 网页 | 月下载 3.1k |
| dsh-univer-office | 0.3.5 | 表格 / Office(Univer 引擎) | 月下载 6.1 万+,★433 |
选择逻辑很简单:「看得见成本」+「资料不出本机」+「顺手的生产力」。dsh-context 和 dsh-spend 解决第一点,dsh-kb-rag 解决第二点,后两个补上阅读和表格。
下载量不是安全证明,只是一个「有没有人用、出问题会不会被很快发现」的粗略参考。
安装原理:dsh plugin 其实是 pnpm 的代理
这是过程中最有意思的发现。DSH 的插件不是一个全局市场,而是每个 profile 的一层叠加:
-
profile 目录在
~/.dsh/profiles/<名字>/; -
package.json里的dsh.profile.bundles数组决定加载顺序; -
cordis.patch.yml负责覆盖和启停。
而官方的 dsh plugin 命令,本质是「在对应 profile 目录里执行 pnpm」——你甚至可以用它打印 pnpm 的帮助:
dsh plugin --profile web --help # 打印出来的其实是 pnpm 的帮助
所以它有个很容易踩的前提:机器上必须能跑 pnpm。我的机器上有 Node 24、npm 11,但就是没有 pnpm,于是 dsh plugin 直接报 'pnpm' 不是内部或外部命令。装上就好了:
npm i -g pnpm
完整安装步骤
# 1. DSH 本体(还没有的话)
npm i -g @deepseek-ai/dsh
# 2. 先跑一次,按引导填 API Key;这一步会创建 profile 目录
dsh web
# 3. 补上插件管理器的依赖
npm i -g pnpm
# 4. 一次性装齐(会自动写进 dsh.profile.bundles)
dsh plugin --profile web add \
dsh-context dsh-spend dsh-kb-rag dsh-deepread dsh-univer-office
装完必须重启 DSH 才生效。重启后地址里的 token 会换新(旧的随进程失效),这个是正常的;已有的会话和工作区文件都会原样保留。
如果你不想碰命令行,Web 界面左侧的「插件」页也能点着装。
kb-rag 的 Python 依赖
只有 dsh-kb-rag 需要额外的东西——它的向量检索依赖 pymupdf、faiss-cpu、sentence-transformers、torch。不装也能用,但没有语义检索。
最省事的办法是:装完重启一次,然后看它的启动日志,它会直接告诉你用哪个 Python 解释器、跑哪条命令:
[kb-rag] Python dependencies missing: pymupdf, faiss-cpu, sentence-transformers, torch
[kb-rag] Install with: <你的python路径> -m pip install --disable-pip-version-check pymupdf faiss-cpu sentence-transformers torch
复制那条命令执行即可。体积参考:torch(CPU 版)约 124 MB,四个加起来约 160 MB;都装在用户目录、可以 pip uninstall 回退。装完再重启一次,日志会变成 [kb-rag] Python dependencies OK。
怎么确认「真的装上了」
界面里出现新按钮,不一定代表模块真的加载成功。我用了三重证据:
-
看组合配置——最硬核的一条:
dsh --profile web --dump-config在输出里搜包名,能看到条目、并且没有被
disabled: true,才算真的进了加载栈。 -
看启动日志(Windows 下在
%LOCALAPPDATA%\dsh-web\logs\run-*.log)。我的日志里出现了:[kb-rag] static tools registered (v1.6.7): kb_ingest / kb_search / kb_rag / kb_zotero / kb_dedup / kb_clear / kb_fetch / kb_scope / kb_stats / kb_status [kb-rag] ready (v1.6.7): 10 tools + /kb command [kb-rag] Python dependencies OK -
看界面:左侧出现「上下文洞察」,右下角出现费用挂件(形如
$0.0035 · 124.4K),「插件」页里五张卡片状态都是 running。
三重都过了,我才把这篇文章写下来。
过程中踩到的几个坑
1. 少了 pnpm,报错很像「DSH 坏了」。 实际只是缺一个包管理器,装上即可。
2. token 每次启动都换。 这不代表会话丢了;用最新打印的完整地址打开,历史对话都在。
3. torch 很大,但没想象中大。 CPU 版约 124 MB,而且 Python 3.14 也有现成轮子,不需要编译。
4. 「下载量高」不等于「适合你」。 有些插件是给 TUI 设计的科研/记忆套件,功能很强但体量大、偏命令行;装到 Web 上体验一般。我因此放弃了两个看着很诱人的候选。
5. 有一个包抓到了 prepare 脚本。 按 registry 安装并不会执行 prepare,但出于谨慎我最终没有装它。门槛是用来一票否决的,不是用来说服自己的。
卸载与回退
dsh plugin --profile web remove dsh-deepread # 卸载单个
npm uninstall -g pnpm # 不要插件管理了
pip uninstall pymupdf faiss-cpu sentence-transformers torch # 回退 kb-rag 依赖
只停用不卸载的话,可以用「插件」页的开关,或直接在 cordis.patch.yml 里给它加 disabled: true。改动前把 ~/.dsh/profiles/web/ 整个复制一份,是最省心的保险。
如果你也想装:一页速查
npm i -g @deepseek-ai/dsh && dsh web # 首次运行、填 Key、然后关掉
npm i -g pnpm
dsh plugin --profile web add dsh-context dsh-spend dsh-kb-rag dsh-deepread dsh-univer-office
# 重启 DSH → 「插件」页状态 running 即成功
# 要 kb-rag 向量检索:按启动日志提示装 Python 依赖,再重启
担心安全的话,记住那条一票否决:先 npm view <包名> scripts,出现 preinstall/install/postinstall 就别装。
两句收尾
插件生态刚起飞,包名、参数、甚至管理方式都可能变。所以本文的重点不是「这五个包永远正确」,而是那套可以自己重复一遍的判断流程:先定标准,再看数据,最后用构建产物和日志验证——而不是被一个漂亮的界面说服。
感谢 DSH 与这些插件的作者们把工具做得足够透明,让别人能读懂、能改、能验证。本文基于 2026 年 9 月的版本实测,不构成对任何第三方包安全性的担保;如需引用命令,请以你机器上 dsh plugin --profile web --help 与各插件 README 的说明为准。