DeepSeek Harness 初体验：源码部署、API Key 配置与插件定制

这篇文章聊聊我对 DeepSeek Harness 的初次上手体验。

DeepSeek Harness 是 DeepSeek 官方最新开源的 AI Agent 运行环境，简称 DSH。你可以把它理解成一个高度可定制的 AI 编程工具，对标 Claude Code 和 Codex，核心理念是「一切皆插件」。

1 源码下载

先克隆源码：

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

如果 GitHub 访问较慢，也可以使用国内镜像：

git clone https://gitcode.com/gh_mirrors/de/deepseek-harness.git

2 Node 版本

克隆完成后进入项目目录，执行安装和构建：

cd deepseek-harness
pnpm install
pnpm run build

注意 Node.js 版本需要满足 ^22.19.0 或 >=24，否则构建会报错。建议用 nvm 管理 Node 版本。

安装 nvm 后，使用以下命令切换版本：

nvm install 24
nvm use 24
node -v
# v24.14.0

启动成功后，终端会输出类似下面这样的信息：

3 填写 DeepSeek API Key

首次进入首页时，需要先填写 DeepSeek API Key。

API Key 可以通过以下界面创建：

4 创建测试空间

5 发起任务

发起一个任务：

我想找张柏芝拍摄《喜剧之王》的照片

也可以查看所有的执行轨迹：

点击轨迹条目，可以查看调用详情：

任务执行完成后，可以直接在工作空间里查看生成的文件：

6 多种模型支持

DeepSeek 本身已经很强，但很多时候我们仍需要接入其他模型。进入设置即可添加其他模型：

7 多种插件定制

DeepSeek Harness 的核心理念在于「一切皆插件」。系统支持丰富的插件扩展，覆盖开发工作流的各个环节。插件市场涵盖代码生成、文件管理、网络搜索、系统集成等多个领域，开发者可以根据实际需求灵活组合使用。

如需了解当前生态中优秀的插件作品，可以参考 awesome-deepseek-harness 项目，该仓库收录了众多优质的 DeepSeek Harness 插件。