图形化安装器 loxuesen/dsh-Installation

dsh-Installation

对每个人都更好。

一条龙安装 DeepSeek Harness 的图形化安装器

中文 · English · 日本語

这是什么

DeepSeek Harness（命令为 dsh）是一个“一切皆插件”的智能体框架，本身是 Node 应用，官方只提供 npx 与源码构建两种装法。对不熟悉命令行的用户，以及网络环境受限的国内用户来说，门槛不低。

dsh-Installation 把这些步骤包成了一个图形化安装器：双击一个 exe，跟着向导弹几下就装完，装完自动进入主菜单，之后启动、查插件、查更新都在这里完成。

界面按 Material Design 3 基线配色实现，走 Android 12+ 的观感：无边框窗口 + 自绘应用栏、胶囊形列表项、填充式卡片、圆角对话框。

功能

安装向导（六步）

| 步骤 | 做什么 |
| 欢迎 | 说明安装器会做什么 |
| 配置检测 | 对照最低/推荐配置检查系统、架构、CPU、内存、磁盘。只提示不拦截，不达标也能继续装 |
| 环境检测 | 检测 Node.js / Git / pnpm；缺的可以交给安装器自动补齐，不会改动你的系统环境变量 |
| 安装位置 | 分别指定主程序目录、harness 目录与 DSH_HOME，实时校验磁盘空间并预览目录结构 |
| 安装方式 | npm 安装或源码构建二选一；对全部镜像源实测延迟，挑最快的用 |
| 开始安装 | 分阶段进度条 + 实时日志，可随时取消；装完自动进主菜单 |

其中 pnpm 无论本机有没有、无论选哪种安装方式都会装一份——dsh plugin 本身就是转发给 pnpm 执行的，缺了它插件管理直接用不了。

主菜单（装完自动进入）

- 概览 — 选 profile 一键启动 / 停止 harness，运行中可直接打开 Web 界面
- 插件 — 按 profile 列出实际装载的组合包与第三方插件
- 更新 — 对比镜像源上的最新版本，可原地升级
- 设置 — 默认 profile、镜像源、安装位置，以及单独卸载 harness 运行时

卸载

主程序目录下的 Uninstall.exe 提供三种范围：

1. 仅卸载 DeepSeek Harness —— 清掉 Node 运行时、harness 本体与 dsh 启动器，主程序与快捷方式保留
2. 仅卸载主启动程序 —— 删掉主程序与快捷方式，harness 运行时留在磁盘上，重装后可直接复用
3. 将两者一起卸载 —— 完整移除

配置与插件数据（DSH_HOME）是否删除独立选择，默认保留。第 1 种范围在「设置 → 卸载 harness 运行时」里也能直接触发。

为国内网络做的适配

安装器内置了可测速的镜像源，全程不依赖直连 GitHub：

| 类型 | 内置源 |
| npm | npmmirror 阿里云（默认）、腾讯云、华为云、npm 官方 |
| GitHub 加速 | ghfast.top（默认）、gh-proxy.com、ghproxy.net、hk.gh-proxy.com、官方直连 |
| 运行时下载 | Node.js 与 MinGit 走 npmmirror 二进制镜像 |

安装前会实测各源延迟，也可以在向导里手动指定。实测中 GitHub 官方直连通常不可用，这也是默认走代理的原因。

使用

1. 从 Releases 下载 DeepSeekHarness-Installer-.exe
2. 双击运行 —— 它是一个便携程序，不需要先安装，直接进入向导
3. 跟着向导走完，最后会自动进入主菜单

安装器会把主程序复制到你选定的目录，创建桌面与开始菜单快捷方式，并生成卸载器。

安装后的目录布局：

\
├── DeepSeekHarness.exe
├── Uninstall.exe 主程序的一个副本，靠文件名进入卸载流程 └── resources\icon.ico

\
├── node\ 便携版 Node（仅当系统没有可用的 Node 时） ├── git\ 便携版 MinGit（仅源码方式且系统没有 Git 时） ├── pnpm\ pnpm，两种方式都会装 ├── harness\ npm 方式安装的 dsh ├── source\ 源码方式克隆并构建的仓库 ├── bin\dsh.cmd 统一启动器 ├── .cache\ 下载过的安装包缓存 └── home\ DSH_HOME（可另选位置）

bin\dsh.cmd 会把 DSH_HOME 与工具链 PATH 设好再调用 dsh，不依赖任何系统环境变量的改动。

从源码构建

需要 Node.js 20+。首次构建建议在管理员权限下进行（原因见下）。

npm install # 依赖与 Electron 二进制均走 npmmirror，见 .npmrc
npm run dev # 开发模式，改代码热更新
npm run typecheck # 主进程 + 渲染层类型检查
npm run dist # 打包成单个便携 exe，产出到 release/

两个注意点

需要管理员权限（或开发者模式）。 打包时 electron-builder 会下载 winCodeSign 包，其中含 macOS 符号链接条目，解压需要「创建符号链接」权限；没有权限时会报 Cannot create symbolic link 并中断整个打包。在管理员 PowerShell 里执行 npm run dist，或开启 Windows 开发者模式即可。
图标。 仓库内的 build/icon.ico 是由 scripts/make-icon.ps1 生成的七档多尺寸图标（16/24/32/48/64/128/256）。单档 256 的 ico 在任务栏与资源管理器里会被硬缩，明显发虚，所以这一步不能省。要换成自己的图，把源图传给那个脚本重新生成即可。

目录结构

src/
├── shared/ 主进程与渲染层共享的契约（类型、常量、IPC API） ├── main/ Electron 主进程 │ ├── services/ 环境检测、镜像测速、工具链补齐、安装引擎、 │ │ harness 运行时、主程序自安装与卸载 │ └── utils/ 进程执行、下载、版本比较 ├── preload/ contextBridge 桥接 └── renderer/src/ React + MUI 界面（Material Design 3） └── screens/ 安装向导 / 主菜单 / 卸载

测试

scripts/ 下的脚本直接驱动真实的安装引擎与界面，不是 mock。

bun scripts/smoke.ts # 端到端安装：镜像测速 → 环境检测 → 补装 Node → 安装 dsh → 校验
bun scripts/smoke.ts source # 源码构建方式（慢很多）
bun scripts/smoke-provision.ts # 专测便携 Node / MinGit 的下载解压
bun scripts/inspect-plugins.ts [profile] [安装目录]

scripts/ui-shots.ps1 通过 Chrome DevTools Protocol 驱动打包后的应用、按文字点击并逐屏截图，支持 -Install（真跑一遍安装）与 -UninstallMode （驱动卸载器）。

开发中踩到的坑记录在 docs/NOTES.md。

说明

- 本项目是第三方工具，与 DeepSeek 官方无隶属关系。DeepSeek Harness 本体由官方仓库分发。
- 界面用图由项目所有者提供，不在本仓库的 MIT 许可范围内。
- 未配置代码签名证书，exe 未签名，Windows 首次运行可能显示 SmartScreen 提示。

许可

MIT