DeepSeek Harness插件:能干什么、怎么装、怎么用

一、插件是什么：一个"什么都能拆"的设计

先把机制说清楚，后面每一步都会顺很多。

dsh 的架构原则是"一切皆插件"：模型、工具、技能、会话、沙箱、存储、循环、调度，甚至界面本身，都是可拆卸的插件。内核只干三件事——挂载、卸载、管理依赖。

这意味着你在界面上看到的每一个按钮，背后几乎都挂着一个插件在干活。也意味着：任何一项能力都可以单独摘掉，而不用动其他部分。

出厂自带的插件分两组：

• 内置插件（默认可用）
  ：子智能体（递归层级、数量、模型）、网页搜索（搜索提供方）、Agent 循环（工具调用的派发方式）、终端（单条命令的时长与输出上限）
• 实验性插件（默认全关）
  ：智能体团队、语音输入、自动授权审查、开发者工具

想让 dsh 干出厂能力之外的事，就得往这个列表里加东西——这才是"装插件"的意义。

二、插件能干什么：六类能力，对应六种日常需求

简单说，插件就是 Harness 的能力单元——不同插件，给 Agent 赋予不同技能。

同一句"帮我修一下这个仓库里的登录问题"，装没装代码类插件，是两个完全不同的 Agent。社区已经攒了 6.7k 个插件（市场"全部"那个数字），按"它给 Agent 加了什么手艺"来分，落在六类里。

🧑‍💻 代码开发类——让它真的进仓库干活。 读取项目仓库、检索代码、定位 bug、写功能、自动跑单元测试、批量改代码。

没装的时候，它只能凭空写一段代码贴给你；装了之后，它能自己找到那个文件、看清上下文、改完再跑一遍测试回来报结果。"帮我定位一下登录为什么会 401""把这三个文件里的旧接口名统一换掉"这一类要求，从此才是有意义的。

📂 本地文件 & 脚本类——让它能碰你的硬盘。 读取本地文档、批量处理文件、运行 Shell 脚本、自动归档整理资料。

第二篇里那个整理乱文件夹的任务，靠的是内置的终端与文件能力；文件类插件是在这之上再扩一层——认更多格式、按内容而不是按文件名归类、一次说清又要重命名又要归档的活。

🔍 调研检索类——让它查得到，并且说得出出处。 联网搜索、资料查证、引用溯源。

关键在于最后三个字：不是"搜到了就行"，而是给结论配上能点回去的链接。写需求调研、做竞品对比、查某个 API 的最新文档，缺这一类，它只能回你一句"我无法联网"。

🧩 自定义能力类——不会写插件，也能给自己造一个。 Creator（创造）模式里直接对话开发新插件，不用搭前端后端。

你说清楚要什么——"每周一把这周动过的文件列成清单"——它在创造模式里生成、装到本机。这一类不是"装现成的"，是"现场做一个"；门槛从"会写代码"降到"能把需求说明白"。

🤝 子 Agent 调度类——把大任务拆开分头做。 拆分复杂任务，调用多个子 Agent 分工协作。

一个人干十件事是串行的，十个 Agent 干十件事可以并行。内置的"子智能体"插件已经给了递归层级、数量、模型三个开关，调度类插件是在这之上管"谁去干什么、什么时候汇合"。

📝 办公类——把"整理"这件事做到底。 整理文档、数据分析、辅助 PPT、整理会议纪要。

这一类最像"日常打杂"，但省下的时间最实在：一堆散落的会议记录丢进去，出来的是带待办事项的纪要；一份 CSV 丢进去，出来的是能直接看的结论和一张图。

市场里的分类比这六类细得多：AGI 架构探索、UI 增强、用量与计费、主题与外观、模型与账号接入、身份与通信、会话与消息、记忆、工具与能力、WSL 与 Windows 互操作、浏览器与网页、视觉与多模态、语音与音频、文档与渲染、技能包、工作流与自动化、Git 与代码评审。六类是"按用途归并"，市场是"按领域切细"，两边对不上是正常的。

一句话概括：插件不是"功能堆叠"，是让你按自己的工作方式裁剪工具。

三、插件怎么安装：三种来源，一个入口

所有插件的装法只有一个入口：插件页右上角的「+ 添加插件」。

输入框里可以填三种东西：npm 包名、GitHub 仓库地址、本地目录路径

输入框里的三种来源

• npm 包名
  ：像 dshmarket 这样直接写名字，从 npm 拉
• GitHub 仓库地址
  ：想装某个仓库的某个分支，用这个
• 本地目录路径
  ：自己写的、或者从别处下载下来的插件，直接指到文件夹

下面还有一项「安装源」。国内网络建议选中国大陆镜像源，能把等待时间从"以为卡死了"降到"几秒钟"。

装之前先看三样东西

安装对话框里那段提示不是免责声明，是三件真事：

1. 依赖
   ：有些插件要求先装别的东西。比如 dsh-wallpaper-engine 就写明要 dsh-better-sidebar ≥ 0.19.0 和客户端 ≥ 2.0.7，"安装前请先更新两者"。不满足就装不上，或者装上了不工作
2. 权限
   ：对话框原话是"插件在本机以你的权限运行，来源不明的插件可能损坏 DeepSeek Harness，或读取和泄露你的数据"。它能读你的文件，也能跑系统命令
3. 版本兼容
   ：市场顶部会写"已隐藏 N 个与 DSH 版本不兼容的插件"——对不上的直接不给你看，省得装完报错

装完必须刷新

装完立刻浮出的提示：「1 项变更，刷新后生效」，右边是「刷新页面」

插件是在页面加载时挂载的，运行中的进程不会把已渲染的界面重新挂一遍。所以：

• 加工具、改界面的插件 → 刷新页面
• 改启动流程的插件（比如启动动画）→ 重启应用
• 只加后台能力的插件 → 通常刷新一下就生效

"装了没反应"，九成是这一步没做。

四、以 dsh-market 为例：从零到装上第一个插件

选它当例子，是因为它有两个特殊性：它是所有其他插件的前提，而且它的安装过程把上面所有环节都走了一遍。

为什么要先装它

dsh 出厂只有"内置插件配置"那四个开关。想装社区插件，你得知道包名——而包名从哪来？从市场里搜。

所以顺序是：先装市场 → 在市场里搜 → 装你想装的。少了第一步，后面只能靠别人告诉你包名。

五步装完

1. 左栏点「插件」
2. 右上角点「+ 添加插件」
3. 输入 dshmarket
4. 安装源选中国大陆镜像源
5. 点「安装」

装完，界面多了两处

插件页顶部多出「插件市场」页签：发现 / 主题 / 收藏 / 已安装 / 已屏蔽 / 高级

• 插件页顶部多了两个页签
  ：「已安装」和「插件市场」。前者管你已有的，后者是逛的地方
• 设置左栏多了一项
  「插件市场」，和「内置插件」并列

市场页面本身也有三个值得留意的位置：右上角「导出日志」（装插件出问题时先点它）、右侧「任务」（安装队列，装多个时看进度）、顶部「申请收录插件」（你自己写了插件想上架，走这里）。

在市场里搜索插件

搜 dsh-pet：好几个同名包，靠作者、近 30 天安装量和 star 来分辨

这是新手最容易翻车的地方——同一个名字会有好几个包。搜 dsh-pet 出来四个，描述几乎一样，因为多半是同一个项目被不同人重发，或者改了一版又发一次。

挑的时候看三样：

• 作者
  ：点作者名看他发过什么，同一个人维护多个插件可信度高一些
• 近 30 天安装量
  ：比总下载量更能说明"现在还有人用"
• 星标数
  ：★0 的新包不是不能装，但别当第一个吃螃蟹的人

再加上标签（宿主要求未知、UI 增强、娱乐、安全与权限）和卡片上的描述，基本能判断出这个包是干什么的、靠不靠谱。

选中之后点「安装」，装完状态变成绿色的「✓ 已安装」，然后回到第三节最后一步——刷新页面。

到这儿，你已经完整走过一遍"从市场装一个插件"的闭环。

五、插件怎么用：三个入口

装完不是结束，得知道去哪儿用。插件的能力有三个出口，视类型而定。

入口一：设置里的插件分页

装完在设置左栏多出一项，配置都在自己的分页里

绝大多数插件装完会在设置左栏加一项，和「内置插件」「Agent 预设」并列。点进去就是它自己的配置面板——开关、参数、素材、权限，都在这一页。

判断一个插件装没装成功，最快的办法就是看这里有没有多出一项。

入口二：插件自己的界面

有些插件不止给配置，还带自己的界面：

• 市场类插件会往插件页加页签（比如刚才那两个）
• 桌面类插件（桌宠）直接在屏幕上挂一个悬浮元素
• 启动类插件（启动动画）在应用启动那一秒播放

这类插件往往"装完就能看见"，反而不用找。

入口三：对话里直接使唤

第三类比较隐蔽：能力型插件装完之后没有新页面，它的作用是让 Agent 多一项工具。你正常提要求，它自己会调用。

比如配好了网页搜索的提供方，你说"帮我查一下这个 API 的最新文档"，它就会走搜索，而不是回一句"我无法联网"。

另外，创造模式里还能让它现写一个插件：描述清楚要什么，它在创造模式里生成、装到本机。这条比装现成的更野，也更需要你想清楚要什么。

装完怎么确认它真的生效了

别急着做大任务，用一句最小的话验证。分三类分别验：

• 能力型
  ：问一个"不装它就答不了"的问题。比如装了搜索，就问"今天有什么新闻"；回答里开始出现联网结果，就对了
• 界面型
  ：看界面有没有变化。没变化先刷新，还不变化去设置里看那一页在不在
• 子系统型
  ：看它的入口在不在。市场类插件看插件页有没有新页签，队列类看有没有新面板

这一步只花一分钟，但能省掉后面"任务跑到一半发现插件没生效"的返工。

用不下去的时候：更新、卸载、屏蔽

• 更新
  ：官方插件版本不一致时直接给「更新」按钮
• 卸载
  ：市场卡片里有卸载入口，界面回到默认
• 屏蔽
  ：不想再看见某个插件，用「已屏蔽」页签藏起来，比卸载温和

六、小结

1. 插件是 dsh 的组织方式，不是附加功能
   ——模型、工具、界面都是插件，所以每样能力都能单独装、单独摘。
2. 装插件的入口只有一个
   ：插件页右上「+ 添加插件」，输入框支持 npm 包名、GitHub 仓库、本地目录三种来源。
3. 装之前看依赖和权限，装完记得刷新
   ，改启动流程的要重启——"装了没反应"基本都是这一步。
4. 先装 dsh-market，再从市场里挑
   ：同名包认作者、看近 30 天安装量、看 star；用的时候去设置左栏找它多出来的那一页。

如果你装插件时踩到了坑（尤其是依赖不满足、装完不生效），欢迎在后台留言，把市场里那行提示和 dsh 版本号一起贴上，我在后续文章里补进去。