1. 什么是 DeepSeek HarnessDeepSeek Harness简称 dsh是由 DeepSeek‑AI 开源、基于Cordis 微内核打造的新一代AI‑Agent 智能体运行时框架MIT 开源协议目前处于开发者预览阶段。核心设计理念一切皆插件。模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件组合而成可以自由替换和灵活重组。本文档介绍内容和提前安装工具Node.js 的安装与版本选择pnpm 的安装与版本介绍DeepSeek Harness 的安装与模型配置方法2. Node.js 安装与版本介绍2.1 版本要求DeepSeek Harness 在package.json中声明了 Node.js 的版本范围node: ^22.19.0 || 24.0.0。具体含义如下版本状态说明Node.js 22.19.0–22.x支持满足^22.19.0推荐使用Node.js 23.x不支持不在 ^22.19.0Node.js 24.0.0 及以上支持满足24.0.0本项目要求使用Node.js 22.19.0–22.x 或 24.0.0 及以上版本即满足^22.19.0 || 24.0.0。请注意Node.js 23.x 不在支持范围内。推荐通过nvm安装并切换到符合要求的版本避免依赖安装或运行阶段出现兼容问题。安装完成后可以通过以下命令查看版本node-vnpm-v预期输出示例v22.19.0 10.x2.2 安装方式Linux 或 macOS 推荐使用nvm管理多个 Node.js 版本# 安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh|bash# 重新加载环境变量source~/.bashrc# 安装并启用 Node.js 22.19.0满足 ^22.19.0nvminstall22.19.0 nvm use22.19.0# 或者安装并启用 24.x 及以上版本满足 24.0.0nvminstall24nvm use24Windows 用户可以直接从官网下载安装包https://nodejs.org/zh-cn下载 LTS 版本双击安装即可安装完成后需要重新打开终端使环境变量生效。3. pnpm 安装与版本介绍3.1 什么是 pnpmpnpm 是高性能的 Node.js 包管理器通过硬链接和内容寻址存储显著节省磁盘空间并提升依赖安装速度。DeepSeek Harness 使用 pnpm 管理依赖和运行脚本因此需要先完成 pnpm 的安装。3.2 版本要求版本状态说明pnpm 8.x可用稳定版本满足基本需求pnpm 9.x推荐当前主流稳定版本pnpm 10.x推荐更新版本需要 Node.js 18.12 以上建议使用pnpm 9 或以上版本。如果使用 Node.js 20 或更高版本可以直接使用最新版 pnpm。查看版本pnpm-v3.3 安装方式Node.js 自带的corepack是安装 pnpm 的最简单方式# 启用 corepackcorepackenable# 准备并激活指定版本的 pnpmcorepack prepare pnpm9.12.0--activate也可以使用独立脚本安装npminstall-gpnpm或者使用官方脚本适用于 Linux/macOScurl-fsSLhttps://get.pnpm.io/install.sh|sh-4. 安装 DeepSeek Harness4.1 克隆项目并安装依赖在确认 Node.js 与 pnpm 版本符合要求后按照以下步骤从源码安装并构建 DeepSeek Harness# 克隆官方仓库gitclone https://github.com/deepseek-ai/deepseek-harnesscddeepseek-harness# 安装依赖pnpminstall# 构建项目pnpmrun build如果希望跳过可选依赖以加快安装速度可以执行pnpminstall--no-optional构建完成后启动 DeepSeek Harness Web 服务pnpmdsh web启动成功后可访问本地 Web 服务http://127.0.0.1:3080/。浏览器显示页面5. Web‑UI 可视化基础配置打开页面后进入设置 → 模型页面即可配置各类大模型服务商。5.1 添加 DeepSeek 官方模型在 DeepSeek 卡片的 API 密钥输入框填入你的密钥点击保存。密钥为只写字段保存后页面只会展示脱敏标识不会回显明文密钥。凭据文件存储位置Mac / Linux 默认路径~/.dsh/.credentials.yamlWindows 默认路径%USERPROFILE%\.dsh\.credentials.yaml⚠️ 安全提醒请勿将.credentials.yaml文件提交到 Git 代码仓库密钥明文保存在本地。5.2 添加目录内置服务商选择「添加提供方」列表内置 Anthropic、OpenAI 等服务商输入对应平台的 API‑Key 保存即可。注意Bedrock、Vertex、Azure 这类云服务商不能仅填写 API 密钥还需要配置区域、项目 ID、OAuth 凭证等原生认证参数。5.3 添加自定义提供方自建网关、第三方兼容接口适用于私有化部署、公司中转网关、不在内置目录中的服务商。Provider ID填写小写唯一标识会话记录、配置都会引用该 ID。如后续需要改名请新建提供方后删除旧配置。基础 URL模型接口地址。API 协议选择对应协议OpenAI‑Compatible 最常用。凭据填入接口密钥添加至少一个可用模型标识。保存配置。保存前可点击「获取可用模型」测试连通性预览返回的模型列表草稿配置不会自动保存。6. 常见问题依赖安装失败确认 Node.js 版本是否满足^22.19.0 || 24.0.0注意 Node.js 23.x 不在范围内同时确认 pnpm 版本是否为 9 以上必要时删除node_modules和pnpm-lock.yaml后重新执行pnpm install。 DeepSeek Harness 安装与模型配置指南
1. 什么是 DeepSeek HarnessDeepSeek Harness简称 dsh是由 DeepSeek‑AI 开源、基于Cordis 微内核打造的新一代AI‑Agent 智能体运行时框架MIT 开源协议目前处于开发者预览阶段。核心设计理念一切皆插件。模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件组合而成可以自由替换和灵活重组。本文档介绍内容和提前安装工具Node.js 的安装与版本选择pnpm 的安装与版本介绍DeepSeek Harness 的安装与模型配置方法2. Node.js 安装与版本介绍2.1 版本要求DeepSeek Harness 在package.json中声明了 Node.js 的版本范围node: ^22.19.0 || 24.0.0。具体含义如下版本状态说明Node.js 22.19.0–22.x支持满足^22.19.0推荐使用Node.js 23.x不支持不在 ^22.19.0Node.js 24.0.0 及以上支持满足24.0.0本项目要求使用Node.js 22.19.0–22.x 或 24.0.0 及以上版本即满足^22.19.0 || 24.0.0。请注意Node.js 23.x 不在支持范围内。推荐通过nvm安装并切换到符合要求的版本避免依赖安装或运行阶段出现兼容问题。安装完成后可以通过以下命令查看版本node-vnpm-v预期输出示例v22.19.0 10.x2.2 安装方式Linux 或 macOS 推荐使用nvm管理多个 Node.js 版本# 安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh|bash# 重新加载环境变量source~/.bashrc# 安装并启用 Node.js 22.19.0满足 ^22.19.0nvminstall22.19.0 nvm use22.19.0# 或者安装并启用 24.x 及以上版本满足 24.0.0nvminstall24nvm use24Windows 用户可以直接从官网下载安装包https://nodejs.org/zh-cn下载 LTS 版本双击安装即可安装完成后需要重新打开终端使环境变量生效。3. pnpm 安装与版本介绍3.1 什么是 pnpmpnpm 是高性能的 Node.js 包管理器通过硬链接和内容寻址存储显著节省磁盘空间并提升依赖安装速度。DeepSeek Harness 使用 pnpm 管理依赖和运行脚本因此需要先完成 pnpm 的安装。3.2 版本要求版本状态说明pnpm 8.x可用稳定版本满足基本需求pnpm 9.x推荐当前主流稳定版本pnpm 10.x推荐更新版本需要 Node.js 18.12 以上建议使用pnpm 9 或以上版本。如果使用 Node.js 20 或更高版本可以直接使用最新版 pnpm。查看版本pnpm-v3.3 安装方式Node.js 自带的corepack是安装 pnpm 的最简单方式# 启用 corepackcorepackenable# 准备并激活指定版本的 pnpmcorepack prepare pnpm9.12.0--activate也可以使用独立脚本安装npminstall-gpnpm或者使用官方脚本适用于 Linux/macOScurl-fsSLhttps://get.pnpm.io/install.sh|sh-4. 安装 DeepSeek Harness4.1 克隆项目并安装依赖在确认 Node.js 与 pnpm 版本符合要求后按照以下步骤从源码安装并构建 DeepSeek Harness# 克隆官方仓库gitclone https://github.com/deepseek-ai/deepseek-harnesscddeepseek-harness# 安装依赖pnpminstall# 构建项目pnpmrun build如果希望跳过可选依赖以加快安装速度可以执行pnpminstall--no-optional构建完成后启动 DeepSeek Harness Web 服务pnpmdsh web启动成功后可访问本地 Web 服务http://127.0.0.1:3080/。浏览器显示页面5. Web‑UI 可视化基础配置打开页面后进入设置 → 模型页面即可配置各类大模型服务商。5.1 添加 DeepSeek 官方模型在 DeepSeek 卡片的 API 密钥输入框填入你的密钥点击保存。密钥为只写字段保存后页面只会展示脱敏标识不会回显明文密钥。凭据文件存储位置Mac / Linux 默认路径~/.dsh/.credentials.yamlWindows 默认路径%USERPROFILE%\.dsh\.credentials.yaml⚠️ 安全提醒请勿将.credentials.yaml文件提交到 Git 代码仓库密钥明文保存在本地。5.2 添加目录内置服务商选择「添加提供方」列表内置 Anthropic、OpenAI 等服务商输入对应平台的 API‑Key 保存即可。注意Bedrock、Vertex、Azure 这类云服务商不能仅填写 API 密钥还需要配置区域、项目 ID、OAuth 凭证等原生认证参数。5.3 添加自定义提供方自建网关、第三方兼容接口适用于私有化部署、公司中转网关、不在内置目录中的服务商。Provider ID填写小写唯一标识会话记录、配置都会引用该 ID。如后续需要改名请新建提供方后删除旧配置。基础 URL模型接口地址。API 协议选择对应协议OpenAI‑Compatible 最常用。凭据填入接口密钥添加至少一个可用模型标识。保存配置。保存前可点击「获取可用模型」测试连通性预览返回的模型列表草稿配置不会自动保存。6. 常见问题依赖安装失败确认 Node.js 版本是否满足^22.19.0 || 24.0.0注意 Node.js 23.x 不在范围内同时确认 pnpm 版本是否为 9 以上必要时删除node_modules和pnpm-lock.yaml后重新执行pnpm install。