一口气装 16 个插件,DeepSeek Harness 怎么玩
内容导航:插件从哪来、16 款实测推荐、三步装好、避坑指南。文末附官方链接和安装命令。
装完 DSH,界面是"空的"
DeepSeek Harness(简称 dsh)是 DeepSeek 官方 8 月 13 日开源的 Agent 框架,MIT 协议,发布当天 GitHub Star 就破 5 万。官方给了一个公式:Agent = Model + Harness。模型负责思考,Harness 负责干活。
但很多人装完 npx @deepseek-ai/dsh web 之后,第一反应是界面干干净净,什么都没有。传文件不行、粘图不行,想 @ 一个文件也不行。
别慌,这是设计使然。官方理念是"一切皆插件"(Everything is a plugin):模型适配、工具、UI、记忆、搜索,所有能力都靠插件往上装。框架是毛坯房,插件是装修队。
所以这篇文章不聊框架本身,只聊插件:从哪来、哪些值得装、怎么装。
一、插件渠道:4 个入口
① 官方渠道(最稳)
• GitHub 源码仓库:https://github.com/deepseek-ai/deepseek-harness • npm 包: @deepseek-ai/dsh,一行命令启动:npx @deepseek-ai/dsh web• 官方内置标准工具组合(Web Search 联网搜索、文件编辑、Shell 执行等),在 Web UI 的插件管理里直接启用
② dsh-market 插件市场(最省事)
社区开发的图形化插件市场,一条命令安装:
dsh plugin --profile web add dsh-market装完在 设置 → Plugin Market 里逛:目前收录 300+ 插件(持续增长中),按 UI、主题、会话、记忆、工具、搜索、视觉、GitHub、自动化、模型接入等场景分类,支持搜索、筛选、排序,点卡片上的"安装"按钮即可,多数插件刷新页面就生效。
③ 社区精选清单(找灵感)
• awesome-dsh-plugin/awesome-dsh-plugin:中英双语,分类最清晰• AdamPlatin123/awesome-dsh-plugins:自动扫描索引,覆盖面广• 0xsline/awesome-deepseek-harness:生态精选(插件+工具+基础设施)
④ AI 导购(让 Agent 帮我们找)
dsh plugin --profile web add dsh-find-plugin装上后直接告诉 Agent"我想要一个能做 X 的插件",它会检索并给出安装命令。提醒一句:它负责找,不负责审。
二、插件推荐:16 款实测清单
以下来自实测加社区口碑,按"装了才算齐全、看情况装、重度用户、好玩的"分成四档。
第一档:装了才算齐全(5 款)
dsh-market:插件市场,第一个就装它,之后不少插件在界面上点两下就装好。
ModLens:生态里第一个视觉插件,给纯文本模型外挂"眼睛",粘图、识别文字、看图表都行。注意它自己不带视觉能力,需要配一个能看图的模型接口。
dsh-at-file:输入框打 @ 就能搜索工作区文件并引用,原生界面最明显的缺口,属于刚需。
dsh-files:拖拽/上传文件让它读 TXT、PDF、Word、Excel,带会话隔离和格式检测,还能限制文件大小。
dsh-office-tools:让 Agent 直接生成 Word、PPT、Excel,纯 JS 处理,本机不用装 Office,生成的文件真能下载。新项目,复杂排版别指望。
第二档:看情况装(6 款)
dsh-explorer:界面加上文件树和 Git 状态,支持改动对比和文件预览,基本只读、比较安全(安装需装两个部分)。
dsh-genui:让回复里直接长出图表、表单、流程图,丢个需求就能渲染出可视化结果。
dsh-turn-rewind:把对话和文件恢复到某条消息之前。恢复前先预览将变动的文件,确认后执行,还留救援点,比手动回滚靠谱。
dsh-message-edit:编辑已发消息、重试、重新生成,保留分支式时间线。只管对话,已写进硬盘的文件它撤不了。
dsh-usage-stats:统计 Token 消耗、缓存命中、调用次数和账户余额,带热力图,还能自动补全历史会话。建议都装,不然烧了多少 Token 都不知道。
dsh-find-plugin:上面提到的 AI 导购,找插件专用。
第三档:重度用户再考虑(3 款)
dsh-agent-teams:组一个多 Agent 团队,拆任务、排依赖、分工协作,面板上看进度。功能强但 Token 烧得也多。
dsh-memento:跨会话本地记忆,存在本地数据库,每次写入需要手动确认,带审计面板。用久了旧记忆会干扰新任务,需定期清理。
dsh-llm-fallbacks:主力模型限流、欠费、报错时自动切换备用模型。默认不生效,需要自己配好几个模型、打开开关、设好切换顺序。
彩蛋:好玩的(2 款)
dsh-ads:恶搞插件,给 AI 推理"插播页游广告",界面一秒梦回 2005 年门户网站,右下角还有 DSH 跑分中心。效率提升是负数,节目效果接近满分。
dot-skill(原 colleague-skill):把一个人的经验做成 Skill。喂给它聊天记录、工作文档、邮件,它提炼出这个人的工作方法、判断标准和说话习惯,生成可被 Agent 调用的 Skill。注意隐私风险,未经本人同意的资料别乱喂。
三、使用教程:三步装上插件
第一步:安装 DSH 并启动
npx @deepseek-ai/dsh web浏览器打开 http://127.0.0.1:3080/,在设置里填入 API Key(DeepSeek 官方或 40+ 家兼容供应商均可),选好工作目录。
第二步:装插件(三种方式任选)
# 命令行:包名或 GitHub 仓库dsh plugin --profile web add dsh-marketdsh plugin --profile web add github:作者/仓库# UI:设置 → Plugin Market → 搜索 → 点安装# 或者:直接告诉 Agent"帮我安装 xxx 插件到 web profile"第三步:验证生效
dsh plugin list # 确认插件已加载安装后建议重启一次。之后在 设置 → 插件 → 插件列表 里可以看到每个插件的运行状态,随时启用或停用。
想自己写插件?官方入门文档推荐克隆源码仓库用 TypeScript 开发,从写一个最小工具插件(比如 greet)开始,理解注册机制后用 --patch ./cordis.yml 挂载调试。
四、避坑指南(比插件清单更重要)
1. 社区插件 = 本机权限:官方索引自己写明——“进了插件市场,不代表通过安全审计”。插件能读我们的文件、碰我们的凭据、走网络,装之前花半分钟看仓库、安装脚本和最近更新时间; 2. 别全开:插件越多,给模型的工具列表越长,Token 占用越高、推理越慢。用什么开什么; 3. 锁版本号:官方 README 提醒别用 @latest,直接装容易对不上号; 4. 预览版有破坏性变更:v0.1 快速迭代中,生产环境注意版本。
写在最后
DSH 现在的状态,一句话就能说清:什么都能装,但什么都得自己装。它还不够开箱即用,天花板确实高——开源几天插件就上千个,连"插播页游广告"这种恶搞都有人做成了。
如果只想先试一两个,建议从 dsh-market 和 dsh-at-file 起步,前者解决"去哪装",后者解决"装完怎么用文件"。装顺了再往下翻清单,都不迟。
准备先装哪一款?欢迎在评论区聊聊。
官方链接:
• 源码仓库:https://github.com/deepseek-ai/deepseek-harness • npm 包:https://www.npmjs.com/package/@deepseek-ai/dsh • 生态清单:https://github.com/awesome-dsh-plugin/awesome-dsh-plugin
夜雨聆风