DeepSeek Harness 保姆级入门：从安装到三大必装插件

以后想用 DeepSeek 干活，不用再把它接到 Codex、Claude Code 里了——DeepSeek 官方终于开源了自己的第一款桌面端 AI 产品 Harness（dsh）。发布不到 24 小时，GitHub 上就冲到了 6 万多个 star。

这篇给你最需要的：Harness 到底是什么、怎么从 0 装起来、三个必装插件，还有几个我实测踩过的坑（含命令，方便直接复制）。

完整跟做步骤在视频里，这篇整理的是原理、关键命令、避坑和链接。

Harness 是什么：为什么值得装#

Harness 字面是「操纵台」，在 AI 领域指的是「让大模型操作电脑的一系列工具和流程」——你现在用的 Codex、Claude Code，本质都是 Harness：它们是壳，里面装的是各家模型。

DeepSeek 更进一步，把这个壳做成了 「一切皆插件」：

连工具、连界面、连模型调用，全部封装成可拆装、可替换的插件
需要什么自己拼，甚至可以创建属于你自己的工具插件
核心只有一个 Cordis 内核，只管插件的加载、卸载、依赖管理，其余全交给插件生态

理念先不吹，实际体验下来：虽然还是预览版、界面谈不上精致，但值得一试。下面就从 0 把它跑起来。

准备工作：两件事#

DeepSeek API 密钥——platform.deepseek.com 注册 + 充值购买，很简单
网络环境——插件要从 GitHub 拉取，国内网络经常失败，建议打开 Clash 的 TUN 模式（让所有流量走代理），或提前给 PowerShell 配好代理

安装：三步走#

第 1 步｜装 Node.js#

dsh 依赖 Node.js。如果电脑里已经装过 Codex 或 Claude Code，Node 基本已经有了，node --version 验证一下即可；没有就装：

1
winget install OpenJS.NodeJS.22

⚠️ 装 22 LTS，别点官网默认按钮（那是 24）。24 下部分插件有兼容问题。

第 2 步｜全局安装 dsh#

官方推荐用 npx，但 npx 是临时安装——不注册成系统命令，每次重启都要重新输入长命令，而且有些插件运行时找不到 dsh 命令会直接失败。所以推荐 npm 全局安装：

1
npm install -g @deepseek-ai/dsh@latest

第 3 步｜启动#

1
dsh web

装好会自动给出一个本地地址（http://127.0.0.1:3080），按 Ctrl 点击它，浏览器就打开主界面了。

首次使用：填密钥 + 选工作区#

首次打开会提示填 API 密钥，默认 DeepSeek；填别家模型的密钥也支持，也可以先跳过、在设置里选其他模型
主界面和 Claude Code / Codex 差不多：左侧任务列表、中间输入区
⚠️ 刚进来对话框里输入不了字——得先点「选择文件夹」把当前工作目录设好，才能开聊

实测：基础功能 + 速度#

我让它干了几件真活，验证基本功能都生效了：

读本地文件做总结——能正确读取工作区里的文件 ✅
写可视化 HTML——让它读本地文件、生成一个可视化网页，效果不错；⚠️ 生成完不会自动预览，要手动打开文件 ✅
整理文件夹——把文件分门别类整理好 ✅

速度很惊喜：平均每秒 150+ tokens，缓存命中率也不错。

四种模式 & 轨迹视图#

标准模式：功能完整的编码 Agent，日常使用无脑选这个就够
PTC / 极简 / 创造：更面向开发人员——PTC 用代码程序组合工具省 Token、极简是纯基准测试、创造模式让 Agent 现场给自己造插件（“没有扳手就造一把扳手”）
轨迹视图：能看到大模型每一步执行过程——用了哪些工具、做了什么操作，一目了然。排查任务失败很有用，但普通用户用不上

三大必装插件#

dsh 的设置里内置了很多插件，有的默认启用、有的默认停用；社区里也已经有不少第三方插件。以下三个是我最推荐的，能补上基础体验的短板：

① dsh-at-file：@ 引用文件#

dsh 默认不能通过 @ 引用文件，这个插件补上它。

1
# 先装 pnpm（插件安装都依赖它）
2
npm install -g pnpm
3

4
# 再装插件（注意这里用的是 dsh 命令——这就是为什么前面要 npm 全局安装）
5
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/heads/main.tar.gz

装完重启 dsh、新建工作区后，输入框里就能 @ 搜文件当上下文了（旧工作区不生效）。

② ModLens：让 DeepSeek 看图#

众所周知 DeepSeek 模型不认图，这个插件通过调用 Gemini API 补上视觉能力（Gemini 有免费额度，去 AI Studio 申请个 key 就行）。

复制安装指令发给 dsh，它会自动检测系统里的 Gemini、让你贴 key 并自动测图，通过后就提示”DeepSeek 可以识别图片了”。

⚠️ 缺点：图片不能直接粘贴进对话框，只能给文件路径或 URL。

装完侧边栏能看文件目录、预览代码，还能把命令窗口集成进来，接近 Claude Code / Codex 的操作体验：

1
dsh plugin --profile web add dsh-better-sidebar@0.10.3

⚠️ 官方推荐走 CLI 安装。GitHub 上的 install.ps1 脚本有兼容 bug（实测与 Node 版本无关）；如果报 ERR_PNPM_IGNORED_BUILDS（node-pty / protobufjs 原生模块被拦），打开 .dsh\profiles\web\pnpm-workspace.yaml，把 node-pty / protobufjs 的注释值改成 true 再重跑 add 即可。

几个容易踩的坑#

Node 装 22 别装 24：24 下部分插件有兼容问题（winget install OpenJS.NodeJS.22）
npm 全局装，别用 npx：npx 不注册 dsh 命令，装插件会报 CommandNotFoundException
装插件前先装 pnpm：dsh plugin add 底层依赖 pnpm，没装会报“‘pnpm’ 不是内部或外部命令”
GitHub 拉插件网络失败（ECONNRESET）：开代理 / 手动下载 tar.gz 本地安装 / 用镜像前缀，三种兜底
ModLens 不能粘贴图片：只能给路径或 URL
每装一个插件都要重启 dsh 才生效
启动 dsh 的那个 PowerShell 窗口千万别关：关了服务就停，dsh 直接没法用
换 Node 版本后重装一次 dsh：npm install -g @deepseek-ai/dsh@latest，避免旧缓存问题

用到的链接#

DeepSeek Harness 官方页：https://www.deepseek.com/harness/
DeepSeek API 平台：https://platform.deepseek.com/
GitHub 仓库：https://github.com/deepseek-ai/deepseek-harness
dsh-at-file（@ 引用文件）：https://github.com/omdsh-dev/dsh-at-file
ModLens（读图）：https://github.com/liustack/modlens
DSH-better-sidebar（侧边栏工作台）：https://github.com/omdsh-dev/DSH-better-sidebar
Google AI Studio（Gemini API key）：https://aistudio.google.com/

具体每一步怎么点、怎么填，跟着视频做最直观。预览版确实还有粗糙的地方，但如果你想省一套第三方工具的钱、又愿意折腾，它值得一试。有问题评论区见。