Windows 一键安装器 senyonhu/DeepSeekHarnessInstaller

DeepSeek Harness Windows 安装器

一个面向 Windows 的 DeepSeek Harness 图形安装器与启动器。它从官方发布渠道准备 Harness 运行环境，支持在线安装、制作离线安装包、启动管理和受限的 AI 故障修复。

社区项目，非 DeepSeek 官方产品。本仓库公开的是安装器源码；不包含 DeepSeek Harness 运行包、Node、编译工具链、生成的 EXE 或用户数据。

快速启动（Windows x64）

1. 下载整个仓库 ZIP 并解压，或克隆仓库。不要只单独下载启动文件。
2. 双击 Start-DeepSeekHarness.cmd。
3. 如果已经安装，它会打开已安装的启动器；否则会打开本地安装器。首次从源码运行且尚无安装器时，脚本会自动准备私有 Rust/LLVM 工具链、构建后台与安装器，再打开安装向导。
4. 在安装向导中选择目录和下载源，填写自己的 DeepSeek API Key 并完成安装。以后仍可双击同一个文件快速启动。

首次源码构建和在线安装需要网络连接，并可能耗时较长；离线包安装只在已取得完整离线 EXE 时可用。该快捷入口不会将 Key 写入仓库，也不会改动系统级 PowerShell 执行策略。

功能

- 图形化安装：选择安装目录和依赖下载源，填写自己的 DeepSeek API Key；安装后创建桌面快捷方式，并在浏览器打开 Harness。
- 离线安装包：把已经准备好的官方运行环境封装为单个 EXE。接收者仍需自己的 API Key；模型对话需要联网。
- 安全更新与恢复：候选版本在独立目录预检，完成真实模型对话验证后才切换；切换前备份数据，失败可回退，并提供手动恢复入口。
- 受限 AI 排障：安装或启动失败时，后台 Agent 可读取受限安装信息、检查环境、请求指定修复并重新验证。安装器只执行白名单工具，不把模型输出直接当作 PowerShell 命令。
- 凭据与数据保护：Key 在本机以 Windows DPAPI 加密保存；离线包不收录 Key、用户配置、会话和日志。诊断记录会脱敏。

安装器默认模型配置为 deepseek-flash、high。AI 排障及模型对话使用用户自己的 DeepSeek API 额度。

当前进度

截至 2026-09-23，在一台 Windows 11 x64 开发机上已验证基本对话、真实模型参与的受限修复、坏更新候选拦截、恢复包操作，以及关闭最后一个浏览器页面后的服务退出。安装器自动检查通过 68 项；Rust 后台的格式、Clippy 和测试亦已通过。

当前适合有限试用。 最终 EXE 的完整图形首装、桌面快捷方式重开、空白 Windows 电脑上的离线安装、成功升级到新版本以及真实插件迁移，仍需端到端验收。已测试的一个预览版候选无法完成模型对话，现会被预检拒绝。不要把“有更新入口”理解为所有上游版本都兼容。

目前只针对 Windows x64；EXE 未做 Authenticode 签名。若你需要可直接下载的安装包，当前仓库尚未发布 GitHub Release。

从源码构建

在 Windows x64 上运行 PowerShell。构建 WPF 安装器使用系统 .NET Framework C# 编译器；构建 Rust 排障后台需要 Rust 1.89.0 和 Windows GNU 链接工具。脚本会把这些工具放在本项目的 build-tools/，不会修改系统 PATH。

.\prepare-backend-tools.ps1
.\build-backend.ps1 -Checks
.\build.ps1 -Tests

生成的在线安装器位于 artifacts/DeepSeekHarness-Setup.exe。首次准备工具链和官方运行资源需要联网。仅重建安装器时，已有后台 EXE 可以直接运行 .\build.ps1 -Tests。

构建产物不会进入 Git 仓库。维护者可以用以下命令在隔离目录准备运行环境并制作离线 EXE：

.\artifacts\DeepSeekHarness-Setup.exe --prepare latest
.\artifacts\DeepSeekHarness-Setup.exe --pack
.\artifacts\DeepSeekHarness-Setup.exe --test-offline

项目结构

| 路径 | 内容 |
| src/ | C# / WPF 安装器、启动器、更新和恢复逻辑 |
| tests/ | 安装器单元与集成检查、离线网络守卫 |
| vendor/deepseek-cli/ | 基于 model-clis/deepseek 的本地适配后台源码；上游固定提交及改动见 INSTALLER-FORK.md，原项目采用 MIT 许可 |
| BACKEND_INTEGRATION.md | 后台排障的工具边界、凭据传递及验证说明 |

.build/、build-tools/、artifacts/、test-results/、日志、缓存、用户配置和密钥均不纳入仓库。

与上游的关系

Harness 本体来自 deepseek-ai/deepseek-harness 及其官方 npm 发布包；此项目不修改或重新发布 Harness 源码。第三方排障后台的原始代码及 MIT 许可保留在 vendor/deepseek-cli/。

问题反馈请附上复现步骤、Windows 版本及脱敏后的诊断摘要；不要提交 API Key、会话内容、完整用户目录或未经检查的日志。