DeepSeek Harness 安装与配置指南

发布时间：2026/9/29 8:08:23

DeepSeek Harness 安装与配置指南本文档说明在Windows上安装、配置 DeepSeek Harnessdsh并设置开机自启的完整流程。1. 简介DeepSeek Harnessdsh是 DeepSeek 提供的 Agent 工作台提供 Web UI 用于对话、任务编排和工具调用。项值包名deepseek-ai/dsh命令dsh默认 Web 地址http://127.0.0.1:3080配置目录%USERPROFILE%\.dsh\2. 环境要求操作系统Windows 10 / 11Node.jsv20 及以上推荐 LTS 或当前稳定版npm随 Node.js 安装检查版本node-v npm-v若未安装 Node.js请从 https://nodejs.org 下载安装。3. 安装 dsh3.1 全局安装推荐npm install-g deepseek-ai/dsh验证安装dsh--version where.exe dsh3.2 临时运行不安装npx deepseek-ai/dsh web4. 启动 Web UIdsh web--no-open--port 3080参数说明参数说明--no-open不自动打开浏览器--port 3080指定监听端口默认 3080启动成功后访问http://127.0.0.1:3080检查服务是否在线curl.exe-sS http://127.0.0.1:3080/-o NUL-wHTTP %{http_code}n返回HTTP 200表示正常。5. 模型配置首次使用需在 Web UI 中完成基础设置打开 http://127.0.0.1:3080进入Settings → Models填入 API Key选择一个Workspace目录5.1 使用 OpenRouter Ox Alpha本机已配置通过 OpenRouter 调用Ox Alphastealth/ox-alpha。配置文件路径%USERPROFILE%\.dsh\settings.yamlllm-pi-ai:providers:openrouter:apiKeyEnv:OPENROUTER_API_KEYapi:openai-completionsbaseURL:https://openrouter.ai/api/v1supportsDeveloperRole:falsemaxTokensField:max_tokensmodels:-id:stealth/ox-alphaname:Ox Alphaagent-default-model:provider:openroutermodel:stealth/ox-alpha5.2 配置 API Key任选一种方式方式 AWeb UI在 Settings → Models 中直接填入 OpenRouter API Key。方式 B环境变量文件创建%USERPROFILE%\.dsh\.envOPENROUTER_API_KEYsk-or-v1-你的密钥请勿将.env提交到 Git 仓库。6. Windows 开机自启以下脚本已部署到%USERPROFILE%\.dsh\文件用途start-dsh-web.ps1检测并启动服务start-dsh-web.cmd实际拉起 node 进程stop-dsh-web.ps1停止服务logs\dsh-web.log运行日志6.1 计划任务已注册计划任务DeepSeekHarness-Web触发条件用户登录后 30 秒失败重试最多 3 次间隔 1 分钟端口3080查看任务状态Get-ScheduledTask-TaskNameDeepSeekHarness-Web6.2 手动注册计划任务若需在新机器上重新配置自启以管理员或当前用户执行$taskNameDeepSeekHarness-Web$scriptPath$env:USERPROFILE\.dsh\start-dsh-web.ps1Unregister-ScheduledTask-TaskName$taskName-Confirm:$false-ErrorAction SilentlyContinue$actionNew-ScheduledTaskAction-Executepowershell.exe-Argument-NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File $scriptPath$triggerNew-ScheduledTaskTrigger-AtLogOn-User$env:USERNAME$trigger.Delay PT30S$settingsNew-ScheduledTaskSettingsSet-AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -RestartCount 3 -RestartInterval(New-TimeSpan-Minutes 1)Register-ScheduledTask-TaskName$taskName-Action$action-Trigger$trigger-Settings$settings-DescriptionAuto-start DeepSeek Harness web UI on port 30806.3 部署自启脚本将以下文件复制到%USERPROFILE%\.dsh\可从本仓库参考实现。start-dsh-web.cmdecho off setlocal set NODEC:\Program Files\nodejs\node.exe set DSH%APPDATA%\npm\node_modules\deepseek-ai\dsh\lib\bin.js set LOG%USERPROFILE%\.dsh\logs\dsh-web.log if not exist %USERPROFILE%\.dsh\logs mkdir %USERPROFILE%\.dsh\logs echo %date% %time% starting dsh web on port 3080%LOG% %NODE% %DSH% web --no-open --port 3080 %LOG% 21start-dsh-web.ps1负责检测 3080 端口是否已有服务校验node.exe和dsh是否存在调用start-dsh-web.cmd后台启动stop-dsh-web.ps1负责结束所有dsh web相关 node 进程。7. 日常运维启动powershell-NoProfile-ExecutionPolicy Bypass-File$env:USERPROFILE\.dsh\start-dsh-web.ps1停止powershell-NoProfile-ExecutionPolicy Bypass-File$env:USERPROFILE\.dsh\stop-dsh-web.ps1查看日志Get-Content$env:USERPROFILE\.dsh\logs\dsh-web.log-Tail 30升级 dshnpm update-g deepseek-ai/dsh dsh--version升级后建议重启服务。卸载# 1. 停止服务powershell-NoProfile-ExecutionPolicy Bypass-File$env:USERPROFILE\.dsh\stop-dsh-web.ps1# 2. 删除计划任务Unregister-ScheduledTask-TaskNameDeepSeekHarness-Web-Confirm:$false# 3. 卸载全局包npm uninstall-g deepseek-ai/dsh# 4. 可选删除配置Remove-Item-Recurse-Force$env:USERPROFILE\.dsh8. 故障排查端口 3080 无法访问确认进程是否存在Get-CimInstanceWin32_Process|Where-Object{$_.CommandLine-matchdeepseek-ai\\dsh\\lib\\bin\.js.*web}|Select-ObjectProcessId,CommandLine查看日志%USERPROFILE%\.dsh\logs\dsh-web.log手动前台启动以观察报错dsh web--no-open--port 3080端口被占用EADDRINUSE说明 3080 已有实例在运行。先停止再启动powershell-NoProfile-ExecutionPolicy Bypass-File$env:USERPROFILE\.dsh\stop-dsh-web.ps1开机后未自动启动检查计划任务是否启用Get-ScheduledTask-TaskNameDeepSeekHarness-Web|Select-ObjectTaskName,State手动触发一次启动脚本验证确认 Node.js 安装在C:\Program Files\nodejs\脚本默认路径模型无法调用确认OPENROUTER_API_KEY已配置检查settings.yaml中 provider / model 名称是否正确在 Web UI → Settings → Models 中重新选择模型9. 当前环境快照项值dsh 版本0.1.1-rc.2Node.js 版本v25.2.1默认模型OpenRouter / Ox Alpha (stealth/ox-alpha)自启任务DeepSeekHarness-WebWeb 地址http://127.0.0.1:308010. 参考链接npm 包https://www.npmjs.com/package/deepseek-ai/dshOpenRouterhttps://openrouter.ai