dsh-desktop

# DeepSeek Harness 桌面版

把 DeepSeek Harness 的 WebUI 变成真正的桌面应用程序： 无浏览器、无控制台，双击即用，支持多会话分离窗口、系统托盘、自适应安装包（MSI）。

功能一览：

• 🪟 桌面窗口：基于 Microsoft Edge WebView2，无地址栏/标签栏，双击启动即用；
• 🖥️ 多会话分离：把左侧会话拖出侧边栏即弹出新窗口，同时查看多个会话；
• 🗂️ 单实例 + 托盘：重复启动只唤起现有窗口；点 X 最小化到托盘，托盘菜单退出；
• 📦 自适应安装：MSI 安装向导自动检测本机 DeepSeek Harness，未安装时可一键帮助安装或手动指定路径；
• 🔌 完全离线可用：除首次安装 dsh 外不依赖网络。

快速开始

1. 启动 DeepSeek Harness 的 Web 服务（dsh web，后台运行、全程无控制台窗口）；
2. 自动打开 WebUI —— 不是浏览器标签页，而是一个独立的桌面窗口 （dsh-desktop\DSH Desktop.exe，基于 Microsoft Edge WebView2 内核，无地址栏/标签栏）；
3. 单实例运行：无论双击多少次启动器/快捷方式，都只会有一个主窗口—— 程序已在运行时，再次启动只是唤起现有窗口（若它在托盘里则恢复显示），不会弹出第二个窗口， 系统托盘里也始终只有一个图标；
4. 点击窗口的 X（关闭） 默认最小化到托盘：程序在后台继续运行，服务保持开启； 双击托盘图标（或右键菜单"显示窗口"）可恢复窗口；
5. 退出程序请使用托盘右键菜单的 「退出」：关闭所有窗口，并停止本次启动的服务 （服务若是别处启动的则不受影响）；
6. 多会话同时显示（拖拽分离窗口）：在左侧会话列表里按住一个会话并向右拖出侧边栏 （拖到主区域再松手），程序会新开一个窗口显示该会话——从此可以同时查看多个会话；
   • 如果拖出的是当前会话：新窗口显示它，原窗口自动切到新会话界面；
   • 拖出的不是当前会话：原窗口保持不变；
   • 新窗口也是完整的 Harness 窗口（同样支持再次拖出、关闭等操作）；
   • 不想分离时，把会话拖回列表内松手即可（这是原本的排序功能）。

如果服务已经在运行（例如你另开了一个终端跑 dsh web），启动器会直接打开窗口， 并且不会关闭那个已有的服务。

入口说明：.vbs 双击后完全没有控制台窗口（推荐，桌面快捷方式已指向它）。 启动器本身运行在隐藏窗口里，服务进程也没有窗口。 本机装有火绒/360 等安全软件，它们会拦截并删除「启动隐藏 PowerShell 的 .cmd 批处理」， 因此不再提供 .cmd 入口——请使用 .vbs 或桌面快捷方式。

Linux 版（deepin / Ubuntu / Debian）

Windows 版的完整功能已移植到 Linux（GTK + WebKitGTK 原生窗口）：

• 源码与说明：linux/ 目录（dsh-desktop 启动器 + dsh-desktop.py 窗口 + install.sh 免 root 安装）；
• 安装包：Release 附件中的 dsh-desktop_1.1.0_amd64.deb（apt 安装）与 dsh-desktop-linux-1.1.0.tar.gz（免 root）；
• 功能对照与已知差异见 linux/README.md；
• 已修复：软链启动路径、Deepin 密钥环弹窗（ephemeral WebContext）。

  MSI 安装包（推荐分发方式）

DeepSeek Harness 桌面版 1.1.0.msi（文件名带版本号；安装向导欢迎页亦显示版本，旧版本双击新包即自动升级） 是标准 Windows 安装程序（per-user 安装，无需管理员权限）。 双击即进入安装向导：

1. 欢迎 → 选择安装目录（默认 %LOCALAPPDATA%\Programs\DSH Desktop\）；
2. DeepSeek Harness 检测页（自动检测本机已安装的 DeepSeek Harness）：
   • 已检测到 → 直接【下一步】；
   • 未检测到 → 三个选项：
     • 帮助我安装 DeepSeek Harness：自动检测 Node.js 并执行 npm install -g @deepseek-ai/dsh（日志 %TEMP%\dsh-msi-npm.log），完成后返回欢迎页，再点【下一步】即可看到最新检测结果；
     • 手动输入路径：【验证路径】检查输入位置是否存在 dsh 程序（bin.js/包目录/node_modules 等），验证后返回欢迎页，再点【下一步】查看验证结果；有效则后续安装会写入 dsh-path.config；
     • 直接【下一步】跳过：安装后程序首次启动时会自动扫描 dsh；
3. 确认 → 安装 → 完成。

安装内容与便携版一致（启动器 + 两个入口 vbs + WebView2 桌面程序），并创建 桌面/开始菜单快捷方式（带自定义图标）和控制面板卸载入口。

• 卸载：控制面板 → 程序 → 卸载「DeepSeek Harness 桌面版」（或 msiexec /x {A4B2060C-55E7-4F8F-870A-3C8725054A4E}，随版本变化，以控制面板为准）；
• 升级：直接运行新版 MSI 即可覆盖安装；
• 安装前请先退出正在运行的 DeepSeek Harness 桌面版窗口（否则程序文件被占用会导致安装失败）；
• 向导的自定义操作使用 VBScript（Windows 11 24H2+ 若已停用 VBScript 需在"可选功能"中启用）。

安装程序（自适应，可分发到其他电脑）

双击 安装 DeepSeek Harness 桌面版.vbs 即可把桌面版安装到本机 （%LOCALAPPDATA%\Programs\DSH Desktop\），并创建桌面与开始菜单快捷方式。 安装程序会自动适应 DeepSeek Harness 在目标电脑上的安装情况：

1. 自动扫描已安装的 DeepSeek Harness：
   • npx 缓存（任意 hash 目录）
   • npm 全局安装（%APPDATA%\npm、Program Files\nodejs 等）
   • $DSH_HOME\profiles\node_modules（随 profile 安装的 dsh）
   • PATH 上的 dsh 命令 找到 → 直接安装桌面版。
2. 未找到 → 询问用户：
   • 「请帮助我安装好 DeepSeek Harness」：检测 Node.js 依赖 → npm install -g @deepseek-ai/dsh → 安装成功后继续装桌面版；
   • 手动输入路径：验证输入路径下是否存在 dsh 程序（支持 bin.js 文件、包目录、node_modules 目录、 @deepseek-ai 作用域目录等形式）；不存在 → 提醒用户，可重新输入 / 仍然安装（执意）/ 取消。
3. 手动指定路径时会把路径写入 dsh-path.config（启动器优先使用；若该路径日后失效，启动器会自动回退扫描）。
4. 执意安装（提供路径下没有 dsh）时，安装完成后会再次警告"桌面版可能无法正常使用"， 并告知卸载程序路径：%LOCALAPPDATA%\Programs\DSH Desktop\卸载 DeepSeek Harness 桌面版.vbs。

卸载：运行安装目录里的 卸载 DeepSeek Harness 桌面版.vbs（或重跑安装包内卸载入口）， 会删除桌面版文件与快捷方式（不影响 DeepSeek Harness 服务本身及其数据）。

启动器自身也是自适应的：优先读取 dsh-path.config，否则依次扫描 npx 缓存、全局 npm、 $DSH_HOME\profiles、PATH；node.exe 同样支持 PATH 与常见安装位置（含 nvm-windows）。

文件说明

桌面上的 DeepSeek Harness.lnk 快捷方式：指向安装目录（或本文件夹）中的 .vbs， 图标为自定义图标（.vbs 文件本身无法携带自定义图标）。 安装后桌面/开始菜单快捷方式指向 %LOCALAPPDATA%\Programs\DSH Desktop\， 本文件夹仍可作为便携版直接使用。

更换程序图标

程序默认图标已内嵌于 DSH Desktop.exe（源图在 dsh-desktop\icon-source.png）。 想换成自己的图标：准备一张 PNG，重新生成并编译：

powershell -NoProfile -ExecutionPolicy Bypass -File make-icon.ps1 -Source <新PNG路径>
cd /d "dsh-desktop"
"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /nologo /target:winexe /platform:x64 /optimize+ ^
  /out:"DSH Desktop.exe" /win32icon:app.ico /win32manifest:app.manifest ^
  /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll ^
  /r:Microsoft.Web.WebView2.Core.dll /r:Microsoft.Web.WebView2.WinForms.dll ^
  App.cs

生成脚本已修正 ICO 的 DIB 行序（GDI+ 内存行序与 ICO 文件要求相反）， 生成的图标不会再上下颠倒。

工作原理

• 服务地址固定为 http://127.0.0.1:3080（与 dsh web 的默认端口一致）。
• 启动器先探测该地址是否已返回 Harness 页面（包含 __DSH_BOOT__ 特征），未运行才启动服务； 这样重复双击不会拉起第二个服务实例。
• 桌面窗口是用 WebView2（Windows 10/11 自带或随 Edge 安装）嵌入的本地窗口， 与浏览器完全隔离：独立的用户数据目录、无标签页、无地址栏。
• 单实例由 DSH Desktop.exe 用命名互斥体实现：重复启动时向现有实例发送"显示"信号并以 退出码 42 结束；启动器识别 42 后不会停止服务（否则第二次双击会误杀第一次启动的服务）。
• 系统托盘与 X=最小化到托盘由 DSH Desktop.exe 实现；托盘菜单「退出」后启动器的 WaitForExit 返回，随即停止它本次启动的服务进程（服务不是启动器拉起的则不动）。
• 回退链：找不到 DSH Desktop.exe 时改用 Edge/Chrome 的“应用模式”（--app=，同样是无边框独立窗口）， 再不行才用默认浏览器打开（该回退下服务会保持运行）。

重新编译桌面包装程序（可选）

不需要安装 .NET SDK，Windows 自带的 .NET Framework C# 编译器即可：

cd /d "dsh-desktop"
"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /nologo /target:winexe /platform:x64 /optimize+ ^
  /out:"DSH Desktop.exe" /win32icon:app.ico /win32manifest:app.manifest ^
  /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll ^
  /r:Microsoft.Web.WebView2.Core.dll /r:Microsoft.Web.WebView2.WinForms.dll ^
  App.cs

常见问题

• 双击后没反应？ 检查 logs\server.err.log；最常见原因是 3080 端口被其他程序占用， 或 dsh 尚未安装（先运行一次 npx @deepseek-ai/dsh web 或全局安装 @deepseek-ai/dsh）。
• 想改端口？ 编辑 launcher.ps1 顶部的 $Url（服务端口会自动跟随该地址）。
• 第一次打开较慢？ WebView2 首次启动会初始化独立用户数据目录，属正常现象。
• 程序不见了但服务还在？ 点 X 或最小化时默认进入系统托盘（关闭即最小化），双击托盘图标即可恢复窗口； 彻底退出请用托盘右键菜单的「退出」。
• 双击了很多次只有两个窗口？ 单实例模式下重复启动只会唤起现有窗口；若仍出现多个窗口， 说明有旧版本进程残留，可在任务管理器中结束所有 DSH Desktop.exe 后重试。