桌面客户端having5548/deepseek-harness-desktop

🌐 致英文读者： 英文版在此 → README_en.md

🚀 DeepSeek Harness 桌面客户端（Windows）

把 DeepSeek Harness 装进一个原生 Windows 窗口 —— 装完即用，像用普通软件一样简单。

版本
平台
框架
运行时
许可证

基于 WinUI 3 + WebView2 打造的原生桌面壳，把 DeepSeek Harness 的 Web UI（dsh web）
包装成 Windows 应用。它会在本地悄悄拉起一个 dsh web 服务进程，再用 WebView2 把
http://127.0.0.1:/?token=... 的界面嵌进原生窗口；退出应用时自动收尾，不留一丝残留进程。

✨ 亮点速览

| | |
|---|---|
| 🪄 零 CLI 前置 | 安装包自带 Node.js；首次启动自动联网安装最新版 dsh（多源测速选最快），无需手动装任何东西 |
| 🧩 安装即自动绑定 | dsh 自动装到独立目录（应用所在盘 DeepSeek Harness 文件夹），装完即被定位并复用，升级/重装应用也不受影响 |
| 🖥️ 原生体验 | 现代 WinUI 3 窗口 + WebView2 渲染，拥有独立于系统 Edge 的用户数据目录 |
| 🔌 插件市场 | 多来源（DSH Market / npm / npmmirror）发现并一键安装插件，装完服务自动重启 |
| 🩹 崩溃自愈 | 插件搞崩服务？自动屏蔽 + 安全配置重启，弹窗展示日志，一键恢复 |
| 🎛️ 贴心工具栏 | 后退 / 前进 / 刷新 / 浏览器打开 / 检查更新 / 插件管理 / 设置，一应俱全 |

更多细节

- 首次启动时若检测不到 dsh：自动从 npm 官方 / npmmirror / 腾讯云 / 华为云 中 ping 出
延迟最低的源，安装 latest，并把进度实时显示在黑底启动日志控制台里
- 若 dsh 已存在则直接复用（不重复下载）；想升级就点工具栏「检查更新」，可手动升到最新版
- 自动以 --no-open --port 0 启动 dsh web，由系统分配空闲端口，永不冲突
- 完整捕获 dsh web 输出的鉴权 URL（含 ?token=...），WebView 加载不会触发认证失败
- 插件加载失败时：自动卸载报错插件 → 安全配置重启 → 弹窗告知插件名与报错日志，
支持「一键重启」或「恢复该插件」
- 一体化标题栏：内容延伸到标题栏，导航与应用操作合并为一条可拖动的现代顶栏
- 设置中可手动指定 dsh 可执行文件路径作为备用方案
- 退出应用时用 taskkill /T /F 终止整棵子进程树，绝不残留
- Inno Setup 安装器：开始菜单 + 桌面快捷方式 + 卸载程序，无需管理员权限

📥 安装

双击 artifacts/DshDesktop-Setup-0.7.2.exe，按向导一路「下一步」即可，无需管理员权限。
安装时若检测到缺少 WebView2 Runtime 会给出提示。

免安装版：artifacts/win-x64/DshDesktop.exe，解压即用。

🚀 快速开始

1. 配置 API Key：在用户主目录（C:\Users\）创建 .env：

DEEPSEEK_API_KEY=sk-xxxx

2. 启动应用：双击桌面图标。首次启动需要联网，应用会自动下载安装最新的
@deepseek-ai/dsh（自动选择最快镜像源），安装进度会实时显示在黑底启动日志里；
装完立即自动启动 Web UI。之后每次启动都会直接复用已安装的 dsh。

📍 dsh 会被安装到应用所在盘的 DeepSeek Harness 文件夹
（例如应用装在 H:\...，则 dsh 装到 H:\DeepSeek Harness），自动创建。
如果自动安装失败（如无网络 / 盘根无写权限），应用会阻止启动并提示重试，
你也可以在「设置」里手动指定 dsh 路径（dsh.cmd / dsh.exe / bin.js）。

3. 安装插件：点击工具栏「插件」按钮，从 DSH Market / npm 等多来源列表选择安装，
完成后服务自动重启。若某插件导致服务崩溃，应用会自动屏蔽并卸载它、弹窗展示报错日志，
你可以选择「一键重启」或「恢复该插件」。

🛠️ 从源码构建

构建机环境要求

| 项目 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10 / 11 | |
| .NET SDK | 8.0+ | 需 dotnet 命令可用 |
| Node.js + npm | 18+ | 需 node / npm 命令可用（用于生成捆绑的 node/npm 运行时） |
| Inno Setup | 7 | 需 iscc 命令可用（见下方说明） |

⚠️ 重要：构建脚本通过 PATH 定位工具

所有构建脚本（build.ps1 / build-all.cmd / build-publish.cmd / prepare-runtime.cmd）
都不再写死工具安装路径，而是直接从系统 PATH 解析 dotnet、node、npm、iscc。

构建前请先确认这些命令在终端里可以直接敲出来：

dotnet --version   # 能输出版本号即可
node --version
npm --version

💡 关于 Inno Setup：iscc 默认不在 PATH 里。构建脚本会优先从 PATH 解析，
找不到时会自动探测常见安装目录（C:\Program Files\Inno Setup 7\... 等）。
想一劳永逸，也可以手动把 ISCC.exe 所在目录加入 PATH。

若某条命令缺失，脚本会给出明确的 xxx_NOT_FOUND 提示，不会静默失败。

一键构建（推荐）

全流程：准备捆绑 node/npm 运行时 + publish 自包含 + 拷贝 runtime + Inno Setup 安装器
powershell -ExecutionPolicy Bypass -File scripts/build.ps1
或
scripts\build-all.cmd

产物：
- artifacts/win-x64/DshDesktop.exe — 免安装直接运行（含捆绑的 node/npm 运行时）
- artifacts/DshDesktop-Setup-0.7.2.exe — 安装器

仅需开发调试：

dotnet build DshDesktop/DshDesktop.csproj

📂 目录结构

desktop/
├── DshDesktop/                # WinUI 3 应用（C# / .NET 8）
│   ├── MainWindow.xaml        #   主窗口：一体化标题栏 + WebView2 + 启动日志/状态层
│   ├── Services/
│   │   ├── DshHostProcess.cs  #   dsh web 子进程管理（解析鉴权 URL、崩溃检测、退出清理）
│   │   ├── DshLocator.cs      #   dsh 定位（自动安装目录 → 手动路径 → PATH/npm 全局）
│   │   ├── DshUpdater.cs      #   dsh 安装/升级（多源测速 + npm 安装 + 进度/取消/超时）
│   │   ├── DshPaths.cs        #   路径常量（捆绑 node/npm 与 dsh 安装根）
│   │   ├── PluginManager.cs   #   插件管理（dsh plugin 命令）
│   │   ├── PluginDialog.cs    #   多来源插件市场对话框
│   │   ├── AppSettings.cs     #   用户设置（settings.json）
│   │   └── SettingsDialog.cs  #   设置对话框（手动指定 dsh 路径）
│   ├── Assets/                #   应用图标
│   └── runtime/               #   捆绑的 node/npm/pnpm 运行时（构建时生成，不含 dsh）
├── installer/setup.iss        # Inno Setup 7 安装脚本
├── scripts/
│   ├── build-all.cmd          #   一键全流程构建（prepare-runtime → publish → runtime → 安装器）
│   ├── build-publish.cmd      #   仅 publish + 拷贝 runtime + 安装器（假设运行时已就绪）
│   ├── build.ps1              #   一键构建（PowerShell 版，自动从 PATH 定位工具）
│   ├── prepare-runtime.cmd    #   准备捆绑运行时（node + npm 发行版 + pnpm，不含 dsh）
│   ├── verify-artifacts.cmd   #   验证产物（捆绑 node/npm + 安装器时间戳）
│   └── generate-icon.ps1      #   生成应用图标
└── artifacts/                 # 构建产物（win-x64/ 发布目录 + Setup exe）

分步构建

1. 准备捆绑运行时（拷贝 node + 捆绑 npm/pnpm，需 Node.js 联网；不安装 dsh）
scripts\prepare-runtime.cmd

2. 构建发布目录与安装器（publish + 拷贝 runtime + Inno Setup）
scripts\build-publish.cmd

3. （可选）验证产物：打印捆绑 node 版本、检查安装器与主程序时间戳
scripts\verify-artifacts.cmd

📝 说明：runtime/ 目录（Node.js + npm/pnpm）由 prepare-runtime.cmd 生成，属于构建产物，
已通过 .gitignore 排除，不会提交到仓库。dsh 不在此目录——它由应用在最终用户机器上
首次启动时自动安装到独立目录。

❓ 常见问题

- 首次启动提示「正在自动安装 dsh」后失败：需要联网；若所有 npm 源（官方 + 国内镜像）
都不可达，或安装目录（应用所在盘根 DeepSeek Harness）无写权限，会安装失败。请检查网络 /
换到有写权限的盘，再点工具栏「重新加载」重试，或在「设置」中手动指定 dsh 路径。
- 提示「dsh web authentication required」：请升级到 v0.7.0（旧版本未捕获 dsh 0.1.2 的
鉴权 token）。若仍出现，多半是安装了过旧的 dsh，可在「检查更新」里升级。
- 更新 dsh 后启动报错，以前只能删光安装目录重装：v0.7.1 起已修复。旧版用 npm 的
latest 标签安装，而 dsh 的 latest 可能比 next 更旧、其依赖范围却被 npm 解析到更新的
版本，于是 CLI 与插件包版本不一致（版本偏斜）。现在改为安装确切版本，并采用
「暂存安装 → 校验 → 整体替换」的方式更新；启动时若发现已安装的 dsh 不一致，还会自动重装修复。
- 升级后插件树要不要刷新：dsh 的插件树在 ~/.dsh/profiles/web，由它自己的 pnpm 锁文件管理，
升级 CLI 不会自动重解析。若升级后仍报插件相关错误，可在「设置」里确认已开启
「升级 dsh 后刷新插件树」（默认开启），或手动在该目录执行 pnpm update
（等价于 dsh plugin --profile web update）。
- 插件安装 / 恢复需要联网：dsh plugin 通过 pnpm 从 npm registry 安装，需联网。
- 插件导致崩溃被自动屏蔽：应用会卸载报错插件并以安全配置重启。可在「插件」对话框
「已屏蔽」分区里选择「恢复」重新安装尝试。
- 提示缺少 WebView2 Runtime：到
安装 Evergreen 版本。
- 界面空白 / 服务异常：状态栏会显示服务日志摘要；也可点「在系统浏览器中打开」用浏览器
访问同一地址排查。

🔬 技术说明

- 目标框架 net8.0-windows10.0.19041.0，WindowsPackageType=None（unpackaged）
- WindowsAppSDKSelfContained=true + --self-contained true：运行时全部随应用分发
- 捆绑运行时：runtime/node.exe（含 VC++ 运行库）+ runtime/node_modules/npm + pnpm
（不含 dsh）
- dsh 安装根：Path.GetPathRoot(应用目录) + "DeepSeek Harness"，npm 装到其
node_modules/@deepseek-ai/dsh；启动时先在此定位，找不到且未手动指定则自动安装 latest
- dsh 解析顺序：自动安装目录 → 用户设置路径 → PATH / npm 全局
- dsh 安装/升级：对 4 个 npm 源（官方 / npmmirror / 腾讯云 / 华为云）并行 ping 选最低延迟，
用捆绑 npm 安装，支持实时进度、取消与 15 分钟超时兜底
- WebView2 使用独立用户数据目录（%LOCALAPPDATA%\DshDesktop\WebView2），与系统 Edge 互不影响
- 新窗口（target=_blank）交给系统默认浏览器打开

📄 许可证

MIT