先说边界

这不是一份安全审计报告,也不是「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 多个名字里,真正符合我需求的其实只有十几个。候选多不等于选择多——这正是需要标准的原因。

怎么判断一个插件「可信」

我给自己定了四条硬标准,全部满足才考虑装:

  1. npm 公开可查。npm view 能拿到信息,不是刚发布、无仓库、无来源的包。

  2. 没有安装脚本。这一条最重要:preinstall / install / postinstall 会在你敲下安装命令的那一刻执行任意代码,风险最高。很多正规包用 prepare / prepack 只是发布前构建,registry 安装时并不会执行,可以接受,但我仍会留意。

  3. 是「正规」的 DSH 插件。package.json 的 dsh 字段里应同时有 bundle.patch(它是个插件组合包)和 client.inject(它给 Web 前端注入了东西),否则它可能只是给 TUI 用的,装到 Web 上等于没装。

  4. 来源可追溯。有 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。

怎么确认「真的装上了」

界面里出现新按钮,不一定代表模块真的加载成功。我用了三重证据:

  1. 看组合配置——最硬核的一条:

    
    dsh --profile web --dump-config
    
    

    在输出里搜包名,能看到条目、并且没有被 disabled: true,才算真的进了加载栈。

  2. 看启动日志(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
    
    
  3. 看界面:左侧出现「上下文洞察」,右下角出现费用挂件(形如 $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 的说明为准。