DeepSeek Harness 插件:先装什么,怎么判断靠不靠谱
核验于 2026-10-31dsh 0.2.1-rc.5版本说明
插件是什么
dsh 的设计是“一切皆插件”:模型适配器、工具、会话日志、界面和 Agent Loop 都可以拆成插件。
实际使用时有三个词要分清:
- 插件(plugin):一个可加载的模块,向系统注册工具、事件或界面。
- 组合包(bundle):一组插件的打包,安装时通常装的是 bundle。
- profile:一个独立保存的插件集合,有自己的目录和依赖记录。
web、tui、headless是随 dsh 提供的 profile。
所以遇到“装了插件但不显示”,你要先确认的是:插件被装进了哪个 profile?
第一批插件从自带组合包开始
dsh 的 web profile 自带插件管理器等基础 bundle,这些 bundle 不需要额外安装就能用。2026-10-31 用 --dump-config 导出的 profile 里能看到:
- id: plugin-manager
name: '@deepseek-ai/dsh-plugin-manager'
- id: tool-plugin-manager
name: '@deepseek-ai/dsh-plugin-manager/tools'
- id: timer
name: '@deepseek-ai/cordis-plugin-timer'
想知道某个 profile 里装了哪些插件,不需要模型 Key:
dsh --profile web --dump-config
--dump-config 也是排查“插件到底装没装进去”的最直接办法。
第三方插件安装前的四项检查
DSH 不内置任何第三方插件索引源。官方文档写明:要浏览和安装索引里的插件,需要先打开实验性的“自定义插件索引”组合包,然后在“发现”页添加索引文件的 URL。
也就是说,你看到的“插件市场”里的内容全部来自第三方。索引里的标题、描述、作者和来源都由索引提供方决定,DSH 只检查文件格式,不验证这些声明。
安装之前至少检查四件事:
- 来源:索引 URL 是否可信、是否使用 HTTPS。官方文档明确提醒,能控制
http:索引内容的人,可以修改该索引列出的安装来源。 - 版本兼容:插件声明的 dsh 版本范围是否覆盖本机安装的 dsh 版本。
- 维护状态:最近一次更新是什么时候,仓库是否公开。
- 权限:插件会以你的权限运行,能读文件、执行命令。来源不明的插件不要装。
本站的第三方插件表只收录实际装过、并且记录过版本的插件条目。截至 2026-10-31,第三方插件实测还没有完成,因此不列推荐;“20 个必装”这类清单在没有实测记录之前无法核对。
三种情况下自己写插件更合适
当你要把内部工具接入 dsh、需要把一套工作流固定下来,或者现有插件的权限太大时,自己写一个最小工具插件更合适。
从 写第一个插件 开始:先做一个只返回文本的工具,确认加载成功后,再考虑发布。