DeepSeek Harness全攻略：一条命令启动开源Agent框架，一切皆插件-AI助手

DeepSeek Harness全攻略：一条命令启动开源Agent框架，一切皆插件

2026-08-17 20:32:00 1228 AI智能编辑DB DeepSeek Harness Agent框架开源AI 智能体 Claude Code替代

先说结果

DeepSeek Harness 是 DeepSeek 8月13日开源的 Agent 运行框架，一条命令 npx @deepseek-ai/dsh web 启动，一切皆插件架构，支持 DeepSeek/OpenAI/Anthropic 等任意模型。对标 Claude Code 和 Codex，MIT 协议免费商用，本地可控、轨迹可追溯。

一、DeepSeek Harness 是什么

2026年8月13日，DeepSeek 开源了 Harness v0.1 开发者预览版。如果说 DeepSeek V4-Pro 回答的是"模型有多强"，Harness 回答的则是"模型强了之后，怎么用起来"——前者是大脑，后者是身体和工作台。

Harness 不是又一个聊天界面，它是一套把大模型接到本地文件与工具上的开源 Agent 运行时。核心理念是"Everything is a Plugin（一切皆插件）"：模型适配器、工具注册表、会话日志、Agent 循环本身，全部是可替换的插件，没有特权内核。

底层基于 Cordis 元框架，用 TypeScript 编写，MIT 协议全量开源。GitHub 发布一夜 Star 破5万，被称为"Agent 界的 Android"。

二、三分钟跑起来，五步走

安装 Node.js 环境：需要 Node.js v22.19+ 或 v24+，从 nodejs.org 下载安装。终端输入 node -v 验证版本。国内用户建议先配置 npm 镜像加速。

一条命令启动：终端输入 npx @deepseek-ai/dsh web，首次运行自动下载依赖。启动成功后终端打印访问地址，默认 http://127.0.0.1:3080。

配置模型 API Key：浏览器打开 Web UI，进入设置→模型，填入 DeepSeek API Key（在 platform.deepseek.com 申请）。也可以添加 OpenAI、Anthropic 等其他模型提供方。

选择工作区目录：点击"选择工作区"，添加你想让 Agent 操作的项目目录并选中。建议单独准备一个练习目录，避免 Agent 误操作重要文件。

发送第一个任务：在对话框输入任务，例如"分析这个项目的结构并列出主要依赖包"。Agent 会自动规划步骤、调用工具、执行操作，全程可观察。

三、四种运行模式，按需选择

Harness 提供四种运行模式，覆盖不同场景：

标准模式（standard）：完整工具组合，包括文件操作、Shell、搜索、子任务委派、计划维护。日常写代码、修 Bug、分析项目的默认选择，能力最全最省心。

PTC 代码模式：模型先生成一段代码，再由代码组织多轮工具调用。适合连续查询、批量处理、根据中间结果分支的任务，减少模型与工具的反复往返。

极简模式（minimal）：只保留 Shell + 文件编辑两个工具。适合做模型基准测试，尽量减少外围工具差异，直接观察模型的自主规划和操作能力。

创造模式（creative）：Agent 可以检查当前运行时、在内存中试验 Cordis 插件，组合出新的运行模式。适合插件实验和"让 Agent 自己改进自己"的探索。

四、附：照抄即用的命令和配置

下面是快速启动和常用配置的命令，直接复制到终端即可。

# 1. 配置npm国内镜像（可选，国内用户推荐）

npm config set registry https://registry.npmmirror.com

# 2. 一键启动 Harness Web UI

npx @deepseek-ai/dsh web

# 3. 从源码运行（开发插件时用）

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

npm install -g pnpm

pnpm install

pnpm run build

pnpm dsh web

# 4. Python SDK 环境变量配置

export DEEPSEEK_API_KEY=你的API密钥

export DSH_MODEL=deepseek-v4-flash

第一个任务的提示词模板：

请帮我完成以下任务：

【任务目标】（描述你要做什么，例如：分析当前项目结构，找出所有未使用的依赖包）

【约束条件】

1. 不要修改任何源代码，只做分析和报告

2. 涉及删除操作前必须先确认

3. 每完成一个步骤告诉我进度

4. 最终输出一份Markdown格式的分析报告

【输出要求】

列出项目结构、主要依赖、潜在问题、改进建议

五、哪些场景最适合用

代码开发 Bug修复项目分析文档整理批量处理模型评测插件开发自动化运维

六、避坑提醒

避坑提醒

坑一：Node.js 版本不够，启动报错。Harness 要求 Node.js v22.19+ 或 v24+，低版本会启动失败。用 node -v 检查版本，不够就去官网升级。
坑二：工作区选了重要目录，Agent 误删文件。Agent 有文件操作权限，选错目录可能误删或修改重要文件。建议单独建一个练习目录，重要项目先 Git 提交再操作。
坑三：API Key 存错位置，调用失败。密钥存储在 $DSH_HOME/.credentials.yaml 中，不要提交到 Git。页面只显示脱敏描述符，不会回显明文，保存后无法查看，记错了只能重新填。
坑四：v0.1 预览版有 Bug，别用于生产。目前是开发者预览版，可能有不稳定的地方。用于学习和实验没问题，关键生产环境等正式版。
坑五：创造模式乱改运行时，导致崩溃。创造模式允许 Agent 修改正在运行的插件环境，实验性很强。新手先用标准模式，熟悉后再玩创造模式。

Agent 框架的竞争，本质是"谁能让模型更安全、更高效地干活"。DeepSeek Harness 用"一切皆插件"给出了答案——你可以换模型、换工具、换运行模式，甚至让 Agent 自己改自己。一条命令启动，MIT 协议免费，想搭自己的 Agent 环境，从这里开始。

作者声明：本作品含 AI 生成内容