DeepSeek Harness 安装教程,全新Agent模式一文看懂
DeepSeek V4 Pro 刚发完,自家 Agent 产品就跟着来了,名字叫 DeepSeek Harness。本篇带你一文看懂如何从零开始安装与使用 DeepSeek Harness 。
DeepSeek V4 Pro 刚发完,自家 Agent 产品就跟着来了,名字叫 DeepSeek Harness。
很多人第一眼看到会懵,觉得是跟 Codex、Claude Code 一样的本地编程 Agent ,装完跑网页,浏览器里敲命令,让 AI 帮你改代码。
了解 DeepSeek Harness
实际上,DeepSeek 做的不是"又一个 AI 编辑器",而是在做一层基建。
Agent = Model + Harness
模型是灵魂,负责思考和决策;Harness 是手脚和神经系统,负责理解环境、调用工具、在真实场景里持续干活。没有 Harness,模型再聪明也只能干瞪眼。
Codex、Cursor Agent、Claude Code,本质都是厂商封装好的 Harness,工具、沙箱、会话管理、UI,全给你藏得严严实实,能改的只有 Skill 和 MCP 。
DeepSeek Harness 不一样。核心理念为:一切皆插件。
模型接入是插件,文件编辑是插件,网页搜索是插件,这个 Web 界面,本身也是一个 UI 插件。换句话说,像当年的模块化手机,想换什么、加什么、拆什么,全由自己组装。
安装 Node.js
访问安装Node.js的官网: https://nodejs.org ,选择适合自己电脑系统的版本,下载安装。
一键启动
打开终端命令,输入下面的安装命令:
npx @deepseek-ai/dsh web
终端里继续输入 y。会弹出一个本地网址
复制地址到浏览器,界面就出来了。
可直接用电脑上已有的 AI Agent(Cursor、Claude Code、WorkBuddy 都行)安装,直接在桌面建个快捷方式。
第一次打开会弹窗让你填 DeepSeek API Key。没有的话在DeepSeek开放平台申请一个。
API 开放平台网址:https://platform.deepseek.com/
填完保存,就正式进入 Harness 里了。
整个页面就两部分:左边是工作区和会话列表,中间是对话区。
DeepSeek Harness 没有新建项目按钮
Harness 必须绑定一个本地文件夹作为"工作区"才能干活。点击"选择工作区",指定你的项目目录,Agent 才能在里面读文件、跑命令、改代码。
Harness 直接给了四套Agent 预设(Preset),相当于给同一个大脑配了四副不同的身体。
- 标准模式:功能最全的文件编辑、Shell 执行、网页搜索、Skill 调用、任务规划、子 Agent 协作,全都有。第一次用,选它。
- PTC 模式:PTC = Programmatic Tool Calling。和标准模式最大的区别是:AI 不再一步一步零散调工具,而是直接生成一段 TypeScript 代码,把多个操作编排、串联、甚至并行执行,一次性跑完。比如你要批量读 10 个文件、查资料、汇总、写入新文件。标准模式要几十轮对话,PTC 模式一段代码搞定,速度快得多,Token 也省得多。
- 极简模式:只给 bash 和文件编辑器两个工具,其他全砍掉。适合纯粹测试模型本身的代码能力,或者任务简单到没必要上全套装备。
- 创造模式:这个模式最"套娃":它让 AI 帮你创建新的 Agent 预设。你可以说"给我做一个专门审代码的 Agent",它就会自动生成配置文件、提示词、工具组合,保存后直接在模式列表里能用。
Harness 内置了三档权限,左下角盾牌图标切换:
- Read Only:适合代码审查、逻辑分析,绝对安全。
- Workspace Write(推荐):能读写当前工作区文件夹,碰不到系统其他地方。日常开发首选。
- Full Access:完全放行,能执行任意系统命令。
如果 Agent 准备执行超出当前权限的操作,会弹窗让你确认。
-
/plan:进入计划模式,AI 先列方案,你确认后再动手,防止瞎改。 -
/goal:给长任务设定总目标,AI 会记住并持续朝目标推进,中途跑偏了会自己纠正。 -
/compact:压缩早期对话历史,给上下文腾空间,长会话卡顿时的救命稻草。 -
/permission:快速切换权限等级。 -
/model:临时切换当前对话用的模型。
DeepSeek Harness 不是又一个 AI 编程工具,是一个开源、可插拔、可自进化的 Agent 承载框架。把模型、工具、UI、行为逻辑全部拆成插件,基于 Cordis 内核实现动态组合和副作用撤销。
目前还是开发者预览版,迭代很快。但如果你想体验"Agent 的底层长什么样",或者想亲手搭一个完全符合自己工作流的 AI 助手,值得你现在就装一个试试。