大家好,我是楮墨。
最近一直在用DeepSeek Harness工作,越用越顺手,已经有种里离不开的感觉。
说到这,可能还会有很多新手朋友问DeepSeek Harness是个啥?干啥用的?
今天我们就来详细聊聊这个工具。
今年的8 月 13 日,DeepSeek 开源了一个叫 DeepSeek Harness 的工具。装上以后,同一句话发过去,它会自己打开你电脑里的那个文件夹,找到那张表,把重复行删掉,再把结果告诉你。两个东西底下跑的是同一个模型,差别在中间那层壳,也就是说,你在网页版里用的那个 DeepSeek 只有脑子,Harness 是给它接上手的那层。
接上手只是第一层。它还管两件网页版不用管的事。一件是把每一步干了什么记进只追加的会话日志,另一件是在它动你的文件之前先问你一句。网页版不需要这两件事,因为它碰不到你的硬盘。
它不是模型,而是一个Agent框架,在这个框架里你不仅可以使用 DeepSeek自家的模型,比如deepseek-flash 和 deepseek-v4-pro ,你还可以在设置里点「添加模型提供商」,添加一些第三方厂家的模型,比如kimi、智谱、OpenAI等,这些都能接。
DeepSeek Harness最牛的东西是「一切皆插件」,模型、工具、界面全是可拆换的零件,往上一层层加就行。所以它没有一份固定的功能清单,能干多少事,取决于你给它装了哪些插件。
如何安装
安装有两条路,一条是不碰命令行的,一条是碰命令行的。
至于新手,我更推荐不碰命令行那条,这篇文章我们着重讲解这个,首先去DeepSeek/Harness官网的下载页,选择跟你电脑系统匹配的版本。下载并且安装,第一次打开会走一遍引导。先让你选登录账号还是填 API Key,登录账号的会先看到账户额度,然后问主要拿它干什么,选办公和选开发对应的是两套不同的默认设置。
喜欢折腾的朋友,用这个安装方式。
碰命令行那条,先装 Node.js,然后在终端里敲一行。
这里的坑在 Node 版本。从 0.2.1-rc.2 这一版开始,官方要求 Node.js 24.9 或更高,上一版还允许 22.19。你要是照着几个月前的教程装,机器上还是 Node 20 或者 22,这一关先过不去。先敲一句 node -v 看一眼,比装完再回头查错省事。
我这台机器上 node -v 打出来是 v22.22.2,低于这条线。
但真正把我拦住的不是版本,是网络。那条命令跑下去,等了十分钟,最后报了一串 EIDLETIMEOUT,连接 registry.npmjs.org 超时。npx 第一次运行要先把整个包和一堆依赖从 npm 上拉下来,网慢的时候终端就那么干等着,看着像卡死。国内网络先把镜像源换成 npmmirror 再试,或者干脆换条网络。
跑起来之后它默认开在 http://127.0.0.1:3080。端口被占了加 --port 8080,不想它自动弹浏览器加 --no-open。
这个地址只有本机能开。手机、另一台电脑默认都打不开,因为它只监听本机。想换个网段访问,用 --host 指定一个具体的 IP,它不接受 0.0.0.0 这种通配写法,只认某个网卡上的确切地址。这一条是官方的设计,不是漏了。
打开之后,第一件事不是打字
进去先做两件事,官方指南给的就是这个顺序。
第一件是接模型。打开设置里的「模型」,把 DeepSeek 的 API Key 填进去保存。这个 key 需要你去DeepSeek官网创建,桌面版也支持直接登录 DeepSeek 账号。
第二件是选工作区。点「选择工作区」,把你要它干活的那个文件夹加进来,选中。
工作区是它的活动范围。你给它一个装满合同的文件夹,它就有机会翻那些合同。反过来,工作区之外的目录它读不到,你需要手动选择。
它动手之前会问你。改文件、跑命令这类操作,按当前的权限策略需要审批的,Web UI 会先问你一句,你准了它才继续。别嫌烦,一路点允许,等于把钥匙直接递过去。
允许是按次算的。点一次只放行这一次,下一个同类操作还会再问一遍,所以弹窗反复出现不是故障。
DeepSeek Harness 是实验性的开发者预览软件。它尚未接受安全审计,不得视为安全或可用于生产环境的软件。
本项目可以执行模型生成的代码与命令、加载第三方插件,并访问向其开放的网络、进程、凭据和文件。沙箱、审批提示与权限控制可以降低风险,但不保证隔离,也不能保证防止损害。
翻成大白话就是,这东西是放进你自己电脑里的,不是养在玻璃缸里的。放进去之前,重要文件先备份。
它手上到底有哪些工具
界面上的按钮你不用一个个记。决定它能干什么的,是它手里那批工具,官方工具目录里的,大致是这些。
文件这块有读、写、改三个,改是替换你指定的那段文字。搜索有两个,一个按文件名找,一个按内容搜。另有一件专门读图片,PNG、JPEG、WebP、GIF 四种都能进。
联网的两个,一个搜,一个抓网页。派活的一个,它可以把一件独立的事交给另一个自己,那个自己带着干净的上下文去干,干完把结果交回来。后台任务、定时提醒、任务清单也各有一组。
计划模式单独一套。它先把完整方案交给你评审,你批准了它才从下一步骤开始执行;不满意可以要求它继续规划,你的反馈会直接回到它手上。
装插件是另一码事,它要么要求你处在完全放开那一档,要么每次当场批准,那一档官方起的名字就叫 danger-full-access,字面就是危险。插件是按 profile 装的,改了会影响这个 profile 下的所有会话,不是只影响你手上这一个。带 experimental 前缀的那几组(浏览器操作、几个 Agent 组队)默认是禁的,要用得单独开。
钱是按字算的,先把单价看清楚
工具本身免费,MIT 开源。手机里那个聊天不花钱,这个花钱。你让它读的每个字、它吐出的每个字,都按 token 计费。中文的字数和 token 数不一一对应,别拿自己的字数直接乘单价,估出来的数不作数。
下面是官方收费标准,单位是元每百万 tokens。
deepseek-flash,缓存命中的输入,空闲时段 0.02,高峰 0.04。没命中的输入,空闲 1,高峰 2。输出,空闲 4,高峰 8。
deepseek-v4-pro,缓存命中 0.15 和 0.30,没命中 4.5 和 9.0,输出 13.5 和 27.0。
高峰时段是北京时间周一到周五的 9 点到 12 点、14 点到 18 点,其余时间包括周末和法定节假日,全是空闲价,价格正好是高峰的一半。
flash 这一档,缓存命中的价格只有没命中的百分之二,0.02 对 1。同一个会话里反复读同一批文件,跟每次开新会话重新读,账单差得很远。
按空闲时段价换算成单价,flash 读 1 万 token 是一分钱,写 1 万 token 是四分钱。看着便宜,但每次请求都得把系统提示词、工具说明这些固定内容跟着重发一遍,这部分也算钱。决定账单大小的主要是它每一轮要带多少上下文进去,跟你打了多少字关系不大。
网页搜索和抓取是另外算钱的,独立的接口,每 1000 次成功请求 5 元。官方价格页上写明,这项在 Harness 里从 2026 年 11 月 1 日 0 点起按次计费。
第一次用,建议就两条。账户先充一小笔,模型先用 flash,别一上手就挂个跑两小时的长任务然后去干别的。
怎么使唤它,才不算是白装
装完最容易犯的一个错,是问它「帮我看看这个项目」。这种问法它也能干,但你会觉得它干得很飘,因为你自己也说不清什么样算干完。
有效的写法是给它一个能验收的产物,路径、格式、判断标准都写进去。比如,读 src 目录下所有 .ts 文件,把每个文件导出的函数列成一张表,写到 report.md,一个文件一行。。
模式这会儿才用得上。标准模式是默认那档,全部工具都在里面,文件编辑、命令行、检索、技能、计划、子代理都算。新手第一周就待在这里,别的先别碰。
其余三个偏专项。PTC 模式让它写一段 TypeScript,把好几步操作串成一个程序,步骤固定、要反复跑的时候合适。极简模式只留一个 bash 和一个文件编辑工具,拿来测模型底子。创造模式是让你自己做一套新模式用的,能查当前运行时、在内存里试插件,给已经会写的人准备。
模型选择器里另有推理等级可调,DeepSeek 自家的模型给的是 off、low、high、max 四档。
它干活的过程你能看见。它有一条规矩,模型看到的每一样东西,都会写进只追加的会话日志。界面里那个 Trajectory 视图就是把这本流水账摊开,开场那段系统提示词、每一步调了哪个工具、拿到什么结果、子代理什么时候被派出去、上下文什么时候被塞进来,都在里面,还能按来源分开看。恢复会话、分叉、检索、回放,用的都是同一份事件流。
想让它定点干活,不用装东西,标准模式里自带。直接在对话里说一句「每天 Asia/Shanghai 时区 23:00 提醒我看看天气」,它就把这条存成任务了。侧栏有个「自动化任务」页面,所有任务都在那儿,能改名、改时间、看运行记录。前提是宿主进程还开着,关了就停。
插件是另一套东西。界面里有「插件」页,装好的都在「已安装」里,能停用、卸载、看它从哪来的。
想逛插件市场,得先自己开门。DSH 不内置任何索引源,插件页里默认连「发现」这个标签页都没有。打开插件页,在「实验性插件」下找到「自定义插件索引」,把开关打开,「发现」才会出现在「已安装」旁边。再点「添加索引源」,填一个索引文件的 URL。
很多人装完找不到插件市场,卡的就是这里。它不是藏起来了,是这功能默认关着,而且一个源都没配。
装的时候,点卡片上的安装,会先打开一个确认框,写明这个版本从哪来,是 npm 包还是 Git 仓库。确认了才开始装,中间还有一道兼容性检查。不经确认不会装任何东西。命令行也行,dsh plugin --profile web add 加包名。
它现在还不适合谁
最需要提前知道的一条,是它跑偏了不会自己喊停。这类会自己动手的 Agent 一旦方向错了,还会继续想、继续调工具,token 照烧。你得盯着,或者至少隔一会儿看一眼用了多少。
另一件事更现实,它是预览版,会有破坏兼容性的改动。某天更新完,你装的插件可能就不认了,配置项可能改名了。想拿它当稳定生产工具的人,现在还不是时候。
办公场景也还毛糙。我之前用自己 20 页的 PPT 去试,给了三份 Word 当参考,让它提要点往里塞,最后的结果是文字太小、排版粗糙。他还提了一个更根本的问题,这东西没有面向普通用户的技能商店,所谓的技能,底下全是插件,得有人写。
看图片得挑模型,官方价格页上写得很清楚,deepseek-flash 支持图像理解,deepseek-v4-pro 不支持。你丢张截图给它,选错模型就是白丢。
官方没出手机版。前面说的 --host 能让同一局域网里的手机用浏览器打开那个界面,但那只是一个网页,跟你手机 App 里的对话、文件、记录全都不通。只在手机上聊天的人,这个完全可以不碰。
一周之内,走到哪一步算正常
一上手就把功能全打开,最容易翻车。按五级往上走,哪一级出问题都能定位。
第一级,桌面版装上,建一个空文件夹当工作区,只让它读和总结。
第二级,让它读一份副本,把结果写到另一个新文件里,再去 Trajectory 视图里看它每一步干了什么。
第三级,装一个插件试,一次只装一个,隔一天再装下一个。
第四级,同一个任务手动跑顺三次,再把它改成定时任务。
第五级,再碰创造模式、子代理和接别家模型。
一周走到第二级就够了。第三级往后,等你手上有一件每天都要干的重复活再说。
既然看到了这里,如果觉得内容不错,欢迎点赞、在看、转发三连支持!不想错过更新,别忘了设为星标 ⭐。感谢阅读,下次再见!