离线安装器 xxyhya/dsh-installer

DeepSeek Harness 一键离线安装包（Windows x64）

本安装包为社区制作的非官方离线安装程序，与 DeepSeek 官方无关。
下载安装包请前往 Releases 页面；本仓库只存放安装器的构建源码与脚本（构建方法见下文）。

本目录是 DeepSeek Harness 离线安装程序的构建工程。构建产物：

- out\DeepSeekHarness-Setup-0.1.0-rc.6-x64.exe —— 单文件安装程序（约 164 MB）
- out\DeepSeekHarness-Setup-0.1.0-rc.6-x64.exe.sha256 —— 校验和

安装程序说明

- 一键安装：双击运行，弹出中文安装界面，可浏览选择安装目录（默认 %LOCALAPPDATA%\Programs\DeepSeekHarness），点击“安装”后自动解压安装，并创建桌面/开始菜单快捷方式与卸载入口（设置 → 应用）。
- 完全离线：内置 Node.js v24.19.0、DeepSeek Harness 0.1.0-rc.6 及其全部依赖（含 pnpm 11），安装与日常运行均不需要网络，适配中国境内网络环境。
- 无第三方运行时依赖：安装器用 .NET Framework 4.x 编写（WinForms）， Windows 10/11 自带该运行时；用 Windows 自带的 csc.exe 编译，未引入任何外部安装框架。
- 安装内容：node\（Node.js 运行时）、app\（dsh 程序与依赖）、 dsh.cmd（命令行）、Start DeepSeek Harness.cmd（一键启动 Web UI）、 uninstall.exe、README-install.txt。
- 静默安装（可选）：DeepSeekHarness-Setup-*.exe --install D:\目标目录 [--no-shortcuts]。
- 要求管理员权限（UAC 提示），以便支持安装到 Program Files。

构建产物验证（已通过的自动化冒烟测试）

build\smoke-test.ps1 对安装包做端到端验证：静默安装 → 目录/注册表校验 →
dsh --version → 启动 dsh web 并确认 Web UI 返回 HTTP 200 → 运行卸载器并确认
目录与注册表清理。build\gui-test.ps1 验证图形界面能正常打开与关闭。

构建原理

1. stage\payload\ 是待打包的安装内容：
- node\ —— 官方 node-v24.19.0-win-x64 发行版解压（https://nodejs.org/dist/）。
- app\ —— 用 pnpm 安装的 @deepseek-ai/dsh@0.1.0-rc.6 + pnpm （pnpm add "@deepseek-ai/dsh@0.1.0-rc.6" pnpm --save-exact --ignore-scripts）。
pnpm 的目录联接（junction）被保留，由安装器在解压后重建。
2. build\make-payload.mjs —— 把 stage\payload 打成自研容器格式 payload.dshpkg.gz（gzip；记录普通文件 + 相对目录联接），无需外部解压器。
3. build\installer.cs —— WinForms 安装器（C# 4.0 兼容）：内嵌 payload、卸载器、图标；解压时用 .NET 自带的 GZipStream 流式解压，mklink /J 重建
pnpm 目录联接（失败自动回退为复制），并写入启动脚本、快捷方式、注册表。
4. build\uninstaller.cs —— 卸载器：删快捷方式、注册表，自删除安装目录（无写权限时自动请求提权）。
5. build\make-icon.ps1 —— 用 Edge 无头模式把官网 whale logo（favicon.svg）栅格化并封装成多尺寸 .ico。
6. build\build.ps1 —— 编排：自检（内嵌 node/dsh 可运行）→ 打包 → 编译卸载器 → 用 csc.exe /resource: 把 payload、卸载器、图标嵌入安装器 exe → 生成校验和。
-NoManifest 可构建免 UAC 的测试版；-SkipPayload 复用已有 payload。

重建（升级 dsh 版本时）

1. 更新 payload 里的 dsh（在 stage\payload\app 下）
pnpm add "@deepseek-ai/dsh@" --save-exact --ignore-scripts

2. 同步 installer.cs 里的 ProductInfo.Version / NodeVersion（如更换）

3. 重新构建（-Version 只影响文件名） powershell -NoProfile -ExecutionPolicy Bypass -File build\build.ps1 -Version

构建仅需：Windows 10/11、PowerShell 5.1、pnpm、Node.js、7-Zip（解压 Node 包时）。
编译 C# 用的是系统自带 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe，注意必须带 /codepage:65001（源码为无 BOM 的 UTF-8）。