欢迎光临我的个人博客查看最新文章rivers blog一、Harness 到底是什么DeepSeek 官方给了一个很好理解的核心公式Agent Model HarnessModel模型那颗聪明的大脑负责思考和生成。Harness马具给大脑装上的身体负责把模型接入文件系统、终端、网页、工具链让 AI 真正能在真实环境里干活。你平时接触的 Claude Code、Codex、各类 AI 编程助手本质都是 Harness——它们必须和模型搭配才能工作。DeepSeek 这次开源的就是一个可高度定制、对标 Claude Code 的 Agent 运行底座。核心设计一切皆插件Harness 整个框架建立在Cordis 微内核之上。这个内核极其克制只负责插件的加载、卸载和依赖管理。最亮眼的设计主张是Everything is a plugin一切皆插件模型、工具、技能、会话、沙箱、存储、Agent 循环、调度甚至连UI本身都是插件都可以拔掉换成别的。不满意哪一块随时替换或安装插件来扩展不需要改框架源码。GitHub 仓库https://github.com/deepseek-ai/deepseek-harness二、安装前的准备Harness 用 TypeScript 编写启动方式依赖 Node.js。Node.js 22.x 及以上推荐 22 LTS一个可用的DeepSeek API Key用于对话也支持其他 OpenAI 兼容端点检查 Node 版本node -v # 推荐输出 v22.x.x若未安装前往 Node.js — 下载 Node.js® 下载安装包按提示安装即可。三、三种安装方式方式一npx 一条命令最推荐打开终端执行npx deepseek-ai/dsh web # 或先安装再开启web服务 npm install -g deepseek-ai/dsh dsh web命令执行后终端会输出一个本地地址默认http://127.0.0.1:3080浏览器打开它即可进入 Harness 的 Web 界面。无需手动克隆仓库。方式二从源码构建想研究源码或参与插件开发可以克隆仓库git clone https://github.com/deepseek-ai/deepseek-harness cd deepseek-harness pnpm install pnpm run build pnpm dsh web方式三交给 AI 助手安装看不懂命令行直接把下面这句话丢给你常用的 AI 工具如 WorkBuddy让它帮你拉起帮我安装 DeepSeek Harnesshttps://github.com/deepseek-ai/deepseek-harness四、配置 API Key第一次启动 Web UI 后需要填入DeepSeek API Key前往 DeepSeek 开放平台 DeepSeek 创建一个 API Key复制粘贴到 Harness 的密钥输入框使用前记得往账户里充一点余额。安全提示API Key 以只写write-only方式存放在$DSH_HOME/.credentials.yaml设置里只保留密钥引用不会明文落库。模型路由本身也是一个插件——除了 DeepSeek你还可以在设置里添加 Anthropic、OpenAI、Bedrock、Vertex、Azure、Codex 等厂商或接入任何OpenAI 兼容端点添加后即时生效无需重启服务。五、快速上手Web UI 四步走进入 Web 界面后整体布局是左侧对话历史、中间任务区可选手工作目录与运行模式、右侧对话框。第 1 步选工作区Harness 必须先选择一个工作文件夹才能对话。在电脑上建好一个目录并让dsh打开它这就是 Agent 能操作的项目文件范围。第 2 步选权限Harness 提供三级文件护栏权限能力范围适用场景Read Only只能读不能改只想让它看代码Workspace Write可改工作目录内的文件越界会先问你日常最常用Full Access目录内外都能改清楚它在做什么时再用第 3 步选运行模式详见下一节第 4 步选模型与推理强度在右下角选择模型并可设置高/中/低三档推理强度。六、四种运行模式详解Harness 内置四种模式本质区别在于当前会话加载了哪些工具插件模式加载的插件集合适合谁标准模式 (Standard)文件编辑、Shell、搜索、Skills、子 Agent、工作流所有人默认选它PTC / Code 模式标准模式全部 程序化工具调用SDK批量操作、自动化流程极简模式 (Minimal)仅 Bash 文件编辑器模型基准测试创造模式 (Creator)标准模式 检查/试验/创建插件想自己造插件的高级用户小白建议第一次使用无脑选标准模式即可绝大多数日常开发任务用它就够了。七、总结DeepSeek Harness 的意义不只是又一个开源 Claude Code 竞品。它把 Agent 的运行底座开源出来它的核心卖点可以浓缩成三句话一切皆插件从模型到 UI 都能换完全可追踪每一次上下文注入都可审计模型无关换掉 DeepSeek它依然是你的 Agent 运行底座。如果你正在搭建自己的 Agent 工作流或者想研究一个可替换内核的 Agent 框架长什么样DeepSeek Harness 值得上手一试。 DeepSeek Harness 安装与使用
欢迎光临我的个人博客查看最新文章rivers blog一、Harness 到底是什么DeepSeek 官方给了一个很好理解的核心公式Agent Model HarnessModel模型那颗聪明的大脑负责思考和生成。Harness马具给大脑装上的身体负责把模型接入文件系统、终端、网页、工具链让 AI 真正能在真实环境里干活。你平时接触的 Claude Code、Codex、各类 AI 编程助手本质都是 Harness——它们必须和模型搭配才能工作。DeepSeek 这次开源的就是一个可高度定制、对标 Claude Code 的 Agent 运行底座。核心设计一切皆插件Harness 整个框架建立在Cordis 微内核之上。这个内核极其克制只负责插件的加载、卸载和依赖管理。最亮眼的设计主张是Everything is a plugin一切皆插件模型、工具、技能、会话、沙箱、存储、Agent 循环、调度甚至连UI本身都是插件都可以拔掉换成别的。不满意哪一块随时替换或安装插件来扩展不需要改框架源码。GitHub 仓库https://github.com/deepseek-ai/deepseek-harness二、安装前的准备Harness 用 TypeScript 编写启动方式依赖 Node.js。Node.js 22.x 及以上推荐 22 LTS一个可用的DeepSeek API Key用于对话也支持其他 OpenAI 兼容端点检查 Node 版本node -v # 推荐输出 v22.x.x若未安装前往 Node.js — 下载 Node.js® 下载安装包按提示安装即可。三、三种安装方式方式一npx 一条命令最推荐打开终端执行npx deepseek-ai/dsh web # 或先安装再开启web服务 npm install -g deepseek-ai/dsh dsh web命令执行后终端会输出一个本地地址默认http://127.0.0.1:3080浏览器打开它即可进入 Harness 的 Web 界面。无需手动克隆仓库。方式二从源码构建想研究源码或参与插件开发可以克隆仓库git clone https://github.com/deepseek-ai/deepseek-harness cd deepseek-harness pnpm install pnpm run build pnpm dsh web方式三交给 AI 助手安装看不懂命令行直接把下面这句话丢给你常用的 AI 工具如 WorkBuddy让它帮你拉起帮我安装 DeepSeek Harnesshttps://github.com/deepseek-ai/deepseek-harness四、配置 API Key第一次启动 Web UI 后需要填入DeepSeek API Key前往 DeepSeek 开放平台 DeepSeek 创建一个 API Key复制粘贴到 Harness 的密钥输入框使用前记得往账户里充一点余额。安全提示API Key 以只写write-only方式存放在$DSH_HOME/.credentials.yaml设置里只保留密钥引用不会明文落库。模型路由本身也是一个插件——除了 DeepSeek你还可以在设置里添加 Anthropic、OpenAI、Bedrock、Vertex、Azure、Codex 等厂商或接入任何OpenAI 兼容端点添加后即时生效无需重启服务。五、快速上手Web UI 四步走进入 Web 界面后整体布局是左侧对话历史、中间任务区可选手工作目录与运行模式、右侧对话框。第 1 步选工作区Harness 必须先选择一个工作文件夹才能对话。在电脑上建好一个目录并让dsh打开它这就是 Agent 能操作的项目文件范围。第 2 步选权限Harness 提供三级文件护栏权限能力范围适用场景Read Only只能读不能改只想让它看代码Workspace Write可改工作目录内的文件越界会先问你日常最常用Full Access目录内外都能改清楚它在做什么时再用第 3 步选运行模式详见下一节第 4 步选模型与推理强度在右下角选择模型并可设置高/中/低三档推理强度。六、四种运行模式详解Harness 内置四种模式本质区别在于当前会话加载了哪些工具插件模式加载的插件集合适合谁标准模式 (Standard)文件编辑、Shell、搜索、Skills、子 Agent、工作流所有人默认选它PTC / Code 模式标准模式全部 程序化工具调用SDK批量操作、自动化流程极简模式 (Minimal)仅 Bash 文件编辑器模型基准测试创造模式 (Creator)标准模式 检查/试验/创建插件想自己造插件的高级用户小白建议第一次使用无脑选标准模式即可绝大多数日常开发任务用它就够了。七、总结DeepSeek Harness 的意义不只是又一个开源 Claude Code 竞品。它把 Agent 的运行底座开源出来它的核心卖点可以浓缩成三句话一切皆插件从模型到 UI 都能换完全可追踪每一次上下文注入都可审计模型无关换掉 DeepSeek它依然是你的 Agent 运行底座。如果你正在搭建自己的 Agent 工作流或者想研究一个可替换内核的 Agent 框架长什么样DeepSeek Harness 值得上手一试。