DeepSeek Harness 安装配置教程

DeepSeek Harness 安装配置教程DeepSeek HarnessDSH是 DeepSeek AI 开源的 Agent 运行框架支持大模型读写本地文件、执行命令和任务拆分 。以下是详细的安装配置流程。一、环境准备1.1 Node.js 环境安装DeepSeek Harness 基于 Node.js 开发需要 Node.js v22.19.0 或更高版本 。Windows 系统推荐使用 nvm 管理 Node.js 版本# 1. 安装 nvm-windows# 从 https://github.com/coreybutler/nvm-windows/releases 下载 nvm-setup.exe 安装# 2. 安装 Node.js v22.19.0nvm install 22.19.0# 3. 使用指定版本nvm use 22.19.0# 4. 验证安装node--version# 应显示 v22.19.0npm--version# 应显示对应版本macOS/Linux 系统# 使用 fnm 或 nvm 管理 Node.jscurl-fsSLhttps://fnm.vercel.app/install|bashfnminstall22.19.0 fnm use22.19.01.2 环境验证# 检查 Node.js 和 npm 版本nodev# 应 22.19.0npm-v# 应 10.0.0# 检查 Python某些插件可能需要python--version二、安装 DeepSeek Harness2.1 快速启动方式推荐使用 npx 直接运行无需全局安装 npx cordisjs/harness首次运行会自动下载依赖并启动服务访问地址http://127.0.0.1:3080。2.2 全局安装方式如需频繁使用可全局安装# 全局安装npminstall-gcordisjs/harness# 启动服务dsh# 或harness2.3 桌面版安装macOS/Windows对于桌面用户可下载桌面客户端 平台下载文件安装方式macOSDeepSeek Harness Desktop.dmg拖拽到 Applications 文件夹WindowsDeepSeek Harness Desktop Setup.exe双击运行安装向导桌面版启动后会在系统托盘显示图标点击可打开 Web 界面 。三、API 配置3.1 获取 DeepSeek API Key访问 DeepSeek 开放平台注册/登录账号进入 “API Keys” 页面点击 “Create new API key” 生成密钥3.2 配置模型供应商在 Harness Web 界面http://127.0.0.1:3080进行配置# 配置示例结构providers:name:deepseektype:openaiconfig:apiKey:sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbaseURL:https://api.deepseek.com具体操作步骤打开 Harness 设置面板进入 “模型供应商” 或 “Providers” 选项卡点击 “添加供应商” 或 “Add Provider”选择 “OpenAI 兼容” 类型填写配置信息 配置项值说明供应商名称deepseek自定义标识名称API 类型OpenAI Compatible选择 OpenAI 兼容Base URLhttps://api.deepseek.comDeepSeek API 地址API Keysk-xxxxxxxxxx从平台获取的密钥模型列表deepseek-chat, deepseek-coder可用模型名称3.3 配置第三方 API 供应商可选Harness 支持 30 大模型提供商如 llapi.org、OpenRouter 等 # llapi.org 配置示例name:llapitype:openaiconfig:apiKey:your-llapi-keybaseURL:https://api.llapi.org/v1四、工作区与插件配置4.1 创建工作区# 在 Harness 界面中操作# 1. 点击 工作区 或 Workspace# 2. 选择 创建新工作区# 3. 设置工作区名称和路径# 4. 配置默认模型供应商4.2 插件管理Harness 采用 Cordis 插件架构支持功能扩展 // 插件安装示例// 在 Harness 插件市场或通过命令行安装# 查看可用插件 dsh plugin list # 安装文件操作插件 dsh plugin install cordisjs/plugin-filesystem # 安装命令执行插件 dsh plugin install cordisjs/plugin-commands4.3 OpenClaw 图形化配置可选对于复杂配置可使用 OpenClaw 辅助工具 # 安装 OpenClawnpminstall-gopenclaw# 启动配置向导openclaw config五、服务测试与验证5.1 启动服务验证# 启动 Harness 服务npx cordisjs/harness# 或使用桌面版直接启动# 检查服务状态curlhttp://127.0.0.1:3080/health5.2 API 连接测试在 Harness 界面中进入 “测试” 或 “Playground” 选项卡选择配置的模型供应商发送测试消息如 “Hello, world!”验证是否收到正常响应5.3 任务派发测试// 示例任务文件读取任务描述读取当前目录下的README.md 文件并总结内容// Harness 应能自动调用文件系统插件执行六、常见问题解决问题原因解决方案端口 3080 被占用其他服务占用端口修改 Harness 配置端口或停止冲突服务API Key 无效密钥错误或过期重新生成 API Key 并更新配置Node.js 版本过低版本 22.19.0使用 nvm/fnm 升级 Node.js插件加载失败网络或权限问题检查网络连接以管理员权限重试桌面版无法启动系统兼容性问题确认系统版本尝试兼容模式运行七、高级配置7.1 自定义配置文件创建harness.config.js进行高级配置// harness.config.jsmodule.exports{port:3080,host:127.0.0.1,providers:[{name:deepseek,type:openai,config:{apiKey:process.env.DEEPSEEK_API_KEY,baseURL:https://api.deepseek.com}}],plugins:[cordisjs/plugin-filesystem,cordisjs/plugin-commands]};7.2 环境变量配置# 设置环境变量Linux/macOSexportDEEPSEEK_API_KEYskxxxxxxxxxx# Windows PowerShell$env:DEEPSEEK_API_KEYsk-xxxxxxxxxx# 启动时引用环境变量npx cordisjs/harness--config./harness.config.js7.3 服务自启动配置# 使用 systemdLinuxsudonano/etc/systemd/system/deepseek-harness.service# 服务文件内容[Unit]DescriptionDeepSeek Harness ServiceAfternetwork.target[Service]TypesimpleUseryourusernameWorkingDirectory/path/to/harnessEnvironmentDEEPSEEK_API_KEYsk-xxxxxxxxxxExecStart/usr/bin/npx cordisjs/harnessRestartalways[Install]WantedBymulti-user.target八、安全注意事项API Key 保护不要将 API Key 提交到版本控制系统使用环境变量管理本地运行风险Harness 具有文件读写和命令执行权限仅在自己信任的环境运行网络隔离生产环境建议在防火墙后运行限制外部访问定期更新关注官方更新及时升级版本获取安全修复安装完成后即可通过 Web 界面创建 AI Agent配置工具插件开始使用 DeepSeek 大模型进行任务自动化处理 。