2026年8月13日深夜，DeepSeek放了个大招——开源了首个智能体运行框架DeepSeek Harness（简称DSH）。一句话说清楚它的价值：以前AI只能跟你聊天，现在它能直接帮你改代码、跑测试、修Bug，而且全程自动化。最关键的是，安装只需要一行命令。
一、DeepSeek Harness是什么？
先说一个公式：Model + Harness = Agent
- Model（模型）：DeepSeek V4 Pro等大模型，负责思考和推理
- Harness（框架）：负责工具调用、任务规划、上下文管理、错误重试——也就是模型以外全部的”干活”工作
- Agent（智能体）：两者结合，就是一个能自主完成任务的AI助手
你可以把它理解为：DeepSeek给大模型装上了”手和脚”，让它从”只会说”变成”能做事”。直接对标的产品是OpenAI Codex和Anthropic Claude Code。
核心设计理念叫“一切皆插件”——模型、工具、技能、会话、沙箱、存储、UI等所有能力都由插件组合而成，可以自由替换。这意味着你不满意任何一个组件，都可以换成自己喜欢的。内测期间开发者已经开发了约300个插件。
二、安装教程：一行命令搞定
第一步：确认电脑已装Node.js
打开终端（Mac/Linux）或PowerShell（Windows），输入：
node --version看到版本号（如v22.x.x）就说明已安装。如果没装，去 nodejs.org 下载LTS版本安装即可。
第二步：一行命令启动
在终端输入以下命令：
npx @deepseek-ai/dsh web系统会自动下载依赖并启动本地服务。等几秒钟，终端会显示服务已启动。
第三步：打开浏览器
在浏览器地址栏输入：
http://127.0.0.1:3080就能看到DeepSeek Harness的Web界面了。界面非常简洁，左侧是会话列表，右侧是输入框和模式选择区域。注意：DeepSeek的Logo鲸鱼在这里是黑色的。
第四步：配置API Key
第一次使用需要配置DeepSeek API Key：
- 点击界面上的配置入口（Settings → Models）
- 填入你的DeepSeek API密钥
- 保存后即可使用
如果没有API Key，前往 platform.deepseek.com 注册并创建。新用户有免费额度。
备选：从源码安装
如果你想看源码或自己编译，也可以用这种方式：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web三、四种运行模式详解
DeepSeek Harness内置四种预设模式，每种模式默认加载不同插件集合：
1. 标准模式（Standard）
适合场景：日常编程开发，最常用的模式
提供完整的工具组合，Agent可以读写文件、运行命令、搜索代码、修改Bug，适合大多数开发任务。如果你不确定选哪个，选这个就对了。
2. PTC模式（程序化工具调用）
适合场景复杂自动化流程
由模型生成一段TypeScript代码来组合多轮工具调用，适合需要精确控制执行流程的场景。比如”读取所有CSV文件、提取特定列、合并输出”这类批量操作。
3. 极简模式（Minimal）
适合场景：基准测试、最简环境
只保留一个Shell工具和一个文件编辑工具，专为最小环境下的模型性能测试设计。普通用户一般用不到。
4. 创造模式（Creation）
适合场景：开发插件、试验新功能
允许你检查运行时、试验新插件并组合新模式。如果你想在Harness上开发自己的插件，用这个模式。
四、实际使用：让AI帮你干活
场景1：让AI修Bug
- 选择工作空间：点击”Choose workspace”，添加你的项目目录
- 新建会话，选择”标准模式”
- 输入指令，例如：”帮我检查src/目录下的代码，找出可能的内存泄漏问题并修复”
- Agent会自动读取文件、分析代码、提出修改方案，需要你确认后执行
场景2：让AI跑测试
输入指令：”运行项目中的全部测试，如果有失败的帮我分析原因并修复”
Agent会自动执行测试命令、读取报错信息、定位问题代码、提出修复方案。
场景3：让AI写新功能
输入指令：”在用户管理模块添加一个密码重置功能，需要发送邮件通知”
Agent会自动查找相关文件、理解现有架构、编写新代码、运行测试验证。
五、安全须知：权限策略
DeepSeek Harness在执行需要权限的操作前，会弹出确认窗口请求批准。这是非常重要的安全机制——请务必仔细阅读确认弹窗的内容再点击同意。
建议初次使用时：
- 先在小项目上试用，不要一上来就让它操作生产代码
- 保持默认权限策略，不要为了方便全部自动批准
- 定期检查会话日志，了解Agent做了什么操作
六、和其他工具的对比
| 维度 | DeepSeek Harness | Claude Code | OpenAI Codex |
|---|---|---|---|
| 架构 | 一切皆插件（Cordis） | 单体式 | 单体式 |
| 可替换性 | 极高（任何组件可换） | 低 | 低 |
| 热插拔 | 支持 | 不支持 | 不支持 |
| 开源协议 | MIT（完全开源） | 闭源 | 闭源 |
| 运行模式 | 标准/PTC/极简/创造 | 单一模式 | 单一模式 |
| 会话日志 | 追加式+轨迹视图 | 内置 | 内置 |
七、进阶：开发自己的插件
DeepSeek Harness的插件通过Cordis框架开发。一个插件可以贡献服务、类型化事件和可逆效果到共享上下文中。当插件卸载时，其注册会自动清理，不会有孤立状态。
插件在package.json中声明：
{
"dsh": {
"profile": ["my-plugin-bundle"],
"bundle": "./cordis.patch.yml"
}
}开发流程建议：
- 在创造模式中试验，检查运行时行为
- 把你的插件打包为bundle
- 在配置文件中挂载，或用
--patch参数加载 - 用
--dump-config查看当前加载的配置
开发完成后，可以在GitHub仓库添加 dsh-plugin 标签让其他用户发现你的插件。
常见问题
Q：DeepSeek Harness免费吗？
A：框架本身完全免费，MIT开源。使用时需要DeepSeek API Key，新用户有免费额度。
Q：不会编程能用吗？
A：Harness目前主要面向开发者，需要基本的命令行操作能力。但安装和使用已经非常简化，跟着本教程一步步来即可。
Q：支持其他大模型吗？
A：支持。除了DeepSeek自家的模型，还支持其他OpenAI兼容端点，在Settings → Models中配置。
Q：Mac/Windows/Linux都能用吗？
A：都可以，只要有Node.js环境即可。
总结
DeepSeek Harness的意义不只是一个新工具——它代表了AI从”对话”走向”执行”的关键一步。以前你问AI”这段代码有什么问题”，它告诉你答案；现在你问同样的问题，它直接帮你改好、跑通测试、提交修复。
对于开发者来说，这是目前为止最灵活、最开放、最可定制的AI编程智能体框架。对于想入门AI编程的新手来说，一行命令就能上手，门槛已经低到了地板。
参考来源：DeepSeek官方GitHub、智东西实测、新浪科技、cnblogs、搜狐Datawhale教程、deepwiki.directory