这是一个 Windows 图形化安装管理器,用于下载安装 DeepSeek Harness,并配置成当前用户登录后自动启动。
普通用户只需要双击:
DeepSeekHarnessSetup.exe
这是一个真正的 Windows 图形界面程序,启动时不会出现控制台窗口。
- 支持用户选择安装目录。
- 检查 Node.js、npm、npx。
- 缺少 Node.js 时安装 Node.js LTS。
- 将
@deepseek-ai/dsh@latest安装到本地运行目录。 - 将配置、日志、下载缓存、npm cache 写入用户指定安装目录。
- 优先创建计划任务
DeepSeekHarness,当前用户登录后自动启动。 - 如果系统策略拒绝创建计划任务,自动退到当前用户
HKCU Run自启动项。 - 启动后最多等待 120 秒检测
http://127.0.0.1:3080,服务 ready 后再打开浏览器。
DeepSeek Harness 官方快速启动方式:
npx @deepseek-ai/dsh web本工具围绕这条官方启动命令做 Windows 安装、自启动和依赖处理。
DeepSeekHarnessSetup.exe:最终用户入口,双击运行;已内置后台启动脚本。DeepSeekHarnessSetup.cs:图形界面程序源码。Build.ps1:维护者构建脚本,用于重新生成 exe。Start-DeepSeekHarness.ps1:维护者构建资源,编译时会嵌入 exe。manager-settings.json:运行后自动生成到%LOCALAPPDATA%\DeepSeekHarnessSetup,记录上次选择的安装目录。
- 打开
deepseek-harness-setup。 - 双击
DeepSeekHarnessSetup.exe。 - 默认安装目录是
D:\deepseek-harness,也可以手动选择其他目录。 - 点击
Install and Start。 - 如果安装 Node.js 时弹出 UAC,请允许。
- 安装期间界面会显示动态进度条,并每隔一段时间输出 still running 状态。
- 管理器检测到 Web UI ready 后会自动打开
http://127.0.0.1:3080。
用户选择的安装目录会保存:
config.json:DeepSeek Harness 启动配置。logs\latest.log:最新运行日志。logs\deepseek-harness-*.log:历史运行日志。logs\dsh-web*.log:DeepSeek Harness 自身生成的 Web 服务日志。downloads\:Node.js MSI 下载缓存。npm-cache\:npm 下载包缓存。runtime\:本地安装的@deepseek-ai/dsh运行目录。
Node.js 本身仍按 Windows 标准方式安装到系统目录,例如:
C:\Program Files\nodejs
这是因为 Node.js MSI 和 winget 都是系统级运行时安装器。用户指定目录用于 DeepSeek Harness 数据、缓存和日志,不用于强行搬迁 Node.js 运行时。
- 支持 Windows 10/11 和常见 Windows Server 桌面环境。
- 图形程序基于 .NET Framework 4.x,Windows 10/11 通常已内置。
- 需要 Windows PowerShell 5.1,用于计划任务后台启动脚本。
- 需要能访问
nodejs.org和 npm registry。 - 如果系统有 winget,会优先尝试
winget install OpenJS.NodeJS.LTS。 - 如果 winget 不可用或失败,会从
nodejs.org下载最新 LTS MSI 安装。 - winget、npm、node 输出会按 UTF-8 读取,避免安装日志中的中文乱码。
- npm/npx 随 Node.js 安装。
- 不需要 Git、pnpm、Python 或 Visual Studio。
- Node.js 刚安装完成后,安装器会给 npm 子进程显式注入 Node.js 路径,避免依赖构建脚本提示
node不是内部或外部命令。
管理器会优先创建计划任务。
计划任务名称:
DeepSeekHarness
触发器:
当前用户登录时启动
动作格式:
powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "<安装目录>\Start-DeepSeekHarness.ps1" -InstallDir "<用户选择的安装目录>"
计划任务启动时不会显示控制台窗口。
Start-DeepSeekHarness.ps1 已经打包在 DeepSeekHarnessSetup.exe 里。安装器运行时会自动释放到用户选择的安装目录,再让计划任务引用这个释放出来的脚本。
启动脚本会优先调用:
<安装目录>\runtime\node_modules\.bin\dsh.cmd web
只有本地运行目录缺失时,才会退回 npx --yes @deepseek-ai/dsh@latest web。
如果创建计划任务时遇到 拒绝访问,通常是当前 Windows 用户、公司策略或系统任务计划程序权限限制导致。管理器会自动退到当前用户注册表自启动项:
HKCU\Software\Microsoft\Windows\CurrentVersion\Run\DeepSeekHarness
这个兜底方式不需要管理员权限,也不会显示控制台窗口。
界面提供 Restart as Admin 按钮。
适用场景:
- 当前 Windows 用户本身是管理员账号,但程序不是以管理员权限启动。
- 创建计划任务被 UAC 或本机权限限制拦截。
不建议的场景:
- 当前 Windows 用户是标准用户,并且需要输入另一个管理员账号提权。这种情况下计划任务可能会创建到那个管理员账号名下,不一定能在当前用户登录时启动。
因此管理器不会强制自动提权。计划任务创建失败时,会先退到当前用户 HKCU Run 自启动项,保证普通用户也能完成自启动配置。
如果移动了 DeepSeekHarnessSetup.exe,不会影响已经创建好的计划任务。若修改了安装目录,请重新打开 DeepSeekHarnessSetup.exe 并点击 Create Autostart,让自启动入口指向新的安装目录。
普通用户不需要执行此步骤。
如需重新生成 DeepSeekHarnessSetup.exe:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Build.ps1构建脚本使用 Windows 自带或 .NET Framework 附带的 csc.exe,输出类型为 winexe,因此生成的程序没有控制台窗口。
- Web 页面打不开:点击
Refresh Status,确认Autostart不是not created;再点击Open Logs查看latest.log和dsh-web*.log。 - npm 下载失败:检查代理、防火墙或公司网络是否允许访问 npm registry。
npm warn deprecated node-domexception...:这是上游依赖警告,不代表安装失败。- Node.js 安装后仍提示未找到:关闭程序后重新打开,或重启 Windows 让 PATH 刷新。
- 不想自启动:点击
Remove Task,会同时尝试删除计划任务和 HKCU Run 兜底项。