官方文档、阿里云的部署教程和 10 款插件的实测清单都已核到,下面按模板成文。
DeepSeek Harness(简称 dsh)把模型、工具、技能、会话、沙箱、存储、循环、调度、UI 九类能力全部拆成独立插件,没有不可替换的 “核心”,采用 MIT 协议开源,基于 Cordis 的 “一切皆插件” 架构。这意味着 “定制专属学习工作台” 不是一句宣传话,而是真的可以按需拼装:想要读论文就装精读插件,想要记长期笔记就装记忆插件,想看图就装视觉插件。但拼装顺序很关键 —— 原生界面只有一个聊天框,社区实测把它叫 “毛坯房”;正确路径是先装插件市场,再补三个刚需能力,最后按场景加。三个刚需是:插件市场 dsh-market(它是生态入口,装完才能在界面里一键装其余插件)、视觉插件 modlens(让纯文本模型能看图、读截图里的表格和公式)、文件引用插件 dsh-at-file(输入 @ 就能把本地讲义、代码、PDF 拉进上下文)。数字上也有参照:modlens 在 GitHub 3.7k 星,全功能控制台 dsh-web-all 6.4k 星,官方演示里用 “创造模式” 对话生成一个番茄时钟悬浮插件用了 5 分 24 秒。
一、先把概念对齐,别把它当 “又一个聊天框”
| 概念 | 具体含义 |
|---|---|
| Agent Harness | 承载 Agent 的 “马具”,管模型调用、工具执行、会话、沙箱与调度,不是模型本身 |
| 一切皆插件 | 模型适配器、工具注册表、技能、会话管理、沙箱、存储、循环、调度、UI 都是 npm 包 |
| monorepo | 整个项目由大量独立 npm 包组成,组件地位平等,可单独替换 |
| 桌面端 / 网页端 | 有 macOS(Apple silicon)、Windows(64 位)桌面包,也可用 npx @deepseek-ai/dsh web 起网页 |
| 创造模式 | 用对话直接写插件,官方示例里写完 package.json 与 client.js 后即可安装、验证 |
二、学习工作台的四层配置,从下往上搭
| 层 | 选项 | 学习场景建议 |
|---|---|---|
| 底座 | 本地桌面端 / 本地 npx / 云主机(ECS、计算巢) | 只在自习时用选桌面端;要 7×24 挂着跑批量任务选云主机 |
| 模型 | 官方 DeepSeek 模型 / 自备 API Key(如百炼) | 学习用途先用官方默认,量大再考虑套餐 |
| 能力插件 | 视觉、文件引用、搜索、记忆、精读 | 这五项是学习工作台的主力 |
| 界面插件 | 全功能控制台 / 代码侧栏 | 偏文档选控制台,偏代码选侧栏,二者可二选一 |
三、三种安装路线,按动手能力选
| 路线 | 操作 | 适合谁 | 代价 |
|---|---|---|---|
| 最快试水 | npx @deepseek-ai/dsh web | 想 10 分钟内看到界面 | 关掉终端就停,不适合长期 |
| 桌面端 | 官网下载 macOS / Windows 安装包 | 学生、个人日常使用 | 版本跟随客户端更新 |
| 云主机 | 阿里云计算巢模板一键部署,约 3 分钟,配百炼 API Key | 要长期在线、跑批量任务 | 有云资源费用,需配安全组 |
四、十款插件里,学习场景真正用得上的七个
| 插件 | 补什么能力 | 学习场景怎么用 |
|---|---|---|
| dsh-market | 插件市场,界面内搜索、一键安装、配置备份还原 | 第一个装,后面都从这儿装 |
| modlens | 截图 OCR + 版面分析 | 拍课件、拍板书、截论文表格,直接进上下文 |
| dsh-at-file | @ 引用本地文件,模糊搜索 | 把讲义 PDF、代码仓库、笔记文件拉进来 |
| dsh-web-search-pro | 聚合 DeepSeek、Bing、Exa,支持定向抓小红书、知乎、B 站 | 做课程调研、找资料、核对数据 |
| OpenViking | 长期记忆与知识 RAG | 跨周项目不用每次重复背景 |
| dsh-cost-meter | 单会话花费、当日预算、峰谷提醒 | 跑长任务前先看钱 |
| dsh-session-library(或 dsh-okf) | 本地文档混合检索、长文拆解成主张与证据链 | 读论文、读行业报告,自动拆结构 |
| dsh-web-all 或 dsh-better-sidebar | 控制台(任务看板、Git 图谱、Token 统计)/代码侧栏(文件树、终端、子代理监控) | 选一个装,别两个都堆 |
五、一份可以直接照抄的配置单
| 身份 | 装什么 | 为什么 |
|---|---|---|
| 本科生(课程 + 论文) | dsh-market → modlens → dsh-at-file → session-library | 课件截图、讲义 PDF、长文精读三件套 |
| 研究生(文献 + 代码) | 上面四个 + dsh-better-sidebar + cost-meter | 边读边跑实验,得看花费和子代理状态 |
| 在职自学(碎片时间) | dsh-market → dsh-web-search-pro → OpenViking → 桌面端 | 搜索 + 记忆,跨周接着聊 |
| 教师 / 教研 | dsh-market → modlens → dsh-web-all → cost-meter | 批量处理作业截图、做任务看板 |
六、插件别一次装满,三步走更稳
- 第一步:只装 dsh-market 和 modlens,把生态入口与看图能力补上;
- 第二步:界面插件二选一(控制台或代码侧栏),体验就与毛坯版拉开差距;
- 第三步:按场景补搜索、记忆、精读、费用监控。
社区实测还提醒了一个具体坑:装 dsh-better-sidebar 时,pnpm 11 会拦截 node-pty 的构建脚本导致安装失败,需要先执行 pnpm approve-builds --all 再重装。十个插件同时上,依赖冲突反而会拖慢启动。
七、钱的事,装个表盯着
| 项目 | 说明 |
|---|---|
| 免费额度 | 百炼对新用户有免费 token 额度,活动页口径经常调整,以当期页面为准 |
| 计费风险 | 8 月 17 日 DeepSeek 调价后,缓存命中价从 0.025 元涨到高峰时段 0.3 元,约 12 倍 |
| 对策一 | 装 dsh-cost-meter,实时看单会话花费与当日累计 |
| 对策二 | 大任务避开高峰时段,靠插件提醒切峰谷 |
| 对策三 | 长文先本地检索再喂模型,减少重复上下文 |
八、六个容易踩的坑
- 把 Harness 当模型。 它不自带智能,模型得单独配;效果好坏一半看模型、一半看插件与提示词。
- 先装界面插件。 界面再花哨,没视觉、没文件引用,学习场景照样卡住。
- 会话当笔记。 原生会话互相隔离,关掉就没了,要长期积累必须上记忆或知识库插件。
- 云上裸奔。 云主机部署记得配安全组、改默认端口,Harness 能执行命令和改文件,权限别开太大。
- 只看星数选插件。 生态每周在换,星数高不等于适配你的场景,优先看最近更新时间。
- 拿它跑不该跑的东西。 官方安全政策写得很直白:它能访问系统、代你执行操作,涉及敏感数据的任务要自己评估。
【相关 FAQ】
问题 1:DeepSeek Harness 到底是什么,和直接聊天有什么区别?
回答 1:DeepSeek Harness 是开源的 Agent Harness,把模型、工具、会话、沙箱、调度、UI 都做成可替换插件;直接聊天只能对话,DeepSeek Harness 还能读本地文件、跑脚本、装插件、改仓库。
问题 2:用 DeepSeek Harness 搭学习工作台,最少要装哪几个插件?
回答 2:最少三个 —— 插件市场 dsh-market(装其它插件的前提)、视觉插件 modlens(看课件截图与表格)、文件引用 dsh-at-file(@ 本地讲义);再按需要补搜索、记忆、精读插件。
问题 3:DeepSeek Harness 的学习工作台要放本地还是云上?
回答 3:只在自习时用,桌面端或 npx 就够;需要 7×24 挂着跑批量任务、跨设备访问,就把 DeepSeek Harness 部署到云主机,计算巢模板约 3 分钟可起。
问题 4:DeepSeek Harness 的插件装多了会不会冲突?
回答 4:会有依赖冲突风险,社区实测建议分三步装:先市场与视觉,再界面插件二选一,最后按场景补;DeepSeek Harness 的界面插件 dsh-web-all 与 dsh-better-sidebar 也可只留一个。
【参考资料】
[2026-11-10](DeepSeek Harness 保姆级教程,下载安装配置一站式落地,附赠常用插件包)阿里云开发者社区
[2026-11-09](2026 年玩转 DeepSeek Harness 工作台,10 款高频插件推荐,Agent 开发事半功倍)阿里云开发者社区
[2026-11-06](12 个超火的 DeepSeek Harness 插件,大肥鱼已经落后 N 个版本了)阿里云开发者社区
[2026-10-26](DeepSeek Harness:面向全球开放测试并同步开源)DeepSeek 官网
[2026-09-22](DeepSeek Harness 深度解析:核心功能、Cordis 内核架构与本地部署实战教程)阿里云开发者社区
【免责声明】
本文依据 DeepSeek 官网 Harness 页面与阿里云开发者社区公开教程整理;插件星数、安装命令、价格调整幅度均为公开文章口径,插件版本与命令可能随时变动,安装前请以仓库 README 为准;云主机部署涉及账号与费用,请自行评估数据与权限风险;本文仅作工具介绍,不构成购买或部署建议。
