Dshdesk 基于 Tauri 2 将官方 dsh web 封装为 Windows 桌面应用，实现双击安装、双击启动，无需配置运行环境。

一、项目简介

DeepSeek Harness（以下简称 DSH）预览期仅提供 dsh web 命令行启动方式，对普通用户存在以下使用门槛：

• 需预先安装 Node.js 运行环境

• 需通过终端执行命令启动

• 终端关闭后进程随之终止，需重复操作

• 可能出现端口占用、Node 进程残留等问题

Dshdesk 即为解决上述问题而开发。它是一个基于 Tauri 2 的桌面应用壳，将官方 dsh web 封装为标准 Windows 应用：用户通过双击图标即可启动，操作方式与常规桌面软件一致，无需使用命令行。

项目地址：https://github.com/w-zjj/dshdesk

二、主要特性

Dshdesk 在设计中遵循"克制"原则，具备以下核心特性：

1. 零运行依赖

便携版 Node 已打包进安装包，用户无需自行安装 Node.js。Windows 11 系统自带 WebView2 运行时，安装完成后即可直接运行，无需任何前置环境配置。

2. 不修改 DSH 源码，插件机制完整保留

Dshdesk 为纯外层封装，仅调用官方 dsh web 命令，不对 DSH 任何文件进行修改或补丁处理。具体保障如下：

• DSH 插件机制完全保留

• dsh plugin --profile web add <package> 等命令可正常使用

• 用户安装的插件存储于独立数据目录，升级 Dshdesk 时不会丢失

3. 优雅退出机制

应用关闭时，Dshdesk 会向 Node 进程发送 SIGINT 信号，给予 DSH 5 秒时间完成请求排空与状态保存；若 Tauri 主进程异常退出，系统将通过 Job Object 机制自动回收整个进程树——避免端口被僵尸进程占用的情况发生。

4. 版本锁定策略

DSH 预览版仍处于迭代阶段，官方新版本若存在问题将影响所有用户。Dshdesk 采用版本锁定机制（DSH_PINNED_VERSION 常量），仅将经过验证的稳定版本通过重新打包的方式分发。

5. 单实例运行与数据目录访问

• 二次启动时自动聚焦已有窗口，避免重复启动 DSH 实例

• 应用菜单提供"打开数据目录"入口，便于用户在文件管理器中查看 profile、插件及日志

6. 资源 zip 打包，安装体验优化

Dshdesk 将便携 Node 与 dsh bundle 分别压缩为 zip 打入安装包，相比早期散文件打包方案，安装耗时由约 10 分钟降至秒级，安装包体积约 100MB。

三、安装指南

第一步：下载安装包

前往 GitHub Releases 页面下载最新版本安装包：

https://github.com/w-zjj/dshdesk/releases

请下载 NSIS 安装包（Dshdesk_0.1.0_x64-setup.exe），当前版本为 v0.1.0。

安装包体积约 100MB（便携 Node zip 约 37MB + dsh bundle zip 约 73MB + 主程序约 11MB），此为实现"零运行依赖"所需的空间成本。

第二步：执行安装

双击运行安装包，按照安装向导提示完成安装。安装流程与常规 Windows 软件一致，安装过程通常在数秒内完成。

第三步：启动与配置

1. 双击桌面快捷方式启动应用

2. 应用将首先显示 splash 启动页

3. 首次启动时，应用会在后台将两个 zip 资源解压至用户数据目录（约 20-30 秒，取决于 CPU 与磁盘性能），启动页会显示"正在准备运行环境…"提示进度

4. 解压完成后自动跳转至 DSH 主界面

5. 进入 Settings → Models 配置 DeepSeek API Key

6. 配置完成即可开始使用

首启解压为一次性操作，后续启动将直接加载已解压资源，启动速度恢复至秒级（DSH 进程加载 node_modules 的固有开销除外）。

安装验证

可通过以下清单确认安装是否正常：

• 窗口标题显示为 "Dshdesk"
• 启动时先显示 splash 页面，随后跳转至 dsh UI
• 可正常配置 API Key 并执行任务
• 点击关闭按钮后，6 秒内进程退出（任务管理器中不再显示 node.exe）
• 再次双击图标时，聚焦已有窗口而非启动新实例

四、使用说明

1. 数据存储位置

Dshdesk 的数据目录位于：

 %APPDATA%\DeepSeekHarness\dsh-home

目录内容包含：

• bundle/：首启解压的 dsh 运行时

• node/：首启解压的便携 Node

• .bundle.ver：版本门控文件，用于判断是否需要重新解压

• profiles/web/：用户 profile 配置与插件

• dsh-<时间戳>.log：运行日志（最多保留 30 个）

可通过应用菜单 → "打开数据目录" 直接访问该路径。

2. 版本升级

当前 Dshdesk 对 DSH 与 Node 版本进行了锁定。当发布新版本安装包时，重新下载安装即可——数据目录将予以保留，用户的会话、凭据及插件均不会丢失。

若新版本内置的 DSH 或 Node 版本发生变化，应用首启时会通过 .bundle.ver 版本门控自动重新解压资源，用户数据不受影响。

3. 启动时自动检查更新

v0.1 版本起，应用启动时会自动检查是否存在新版本，并在有更新时予以提示。

五、项目定位与限制

Dshdesk 为阶段性过渡项目，需明确以下事项：

• 平台支持：当前仅支持 Windows x64，Mac 与 Linux 暂不支持

• Node 版本锁定：不随用户系统 Node 版本升级（与 DSH 版本锁定策略保持一致）

• 维护周期：当 DeepSeek 推出官方桌面版后，本项目将停止维护。官方版本在原生集成、更新通道及品牌一致性方面具备天然优势，届时项目 README 将置顶迁移公告，引导用户切换至官方版本

简言之，Dshdesk 仅在官方未提供桌面版的过渡期内，为普通用户提供零门槛使用 DSH 的解决方案。

六、总结

对于 DSH 的普通用户而言，若希望避免命令行操作，Dshdesk 提供了以下价值：

• 零依赖：无需安装 Node，双击即可使用

• 零侵入：不修改 DSH 源码，插件生态完整保留

• 零残留：优雅退出机制配合 Job Object 兜底，确保进程清理干净

• 零风险：版本锁定策略，避免官方新版本潜在问题影响

• 体验优化：资源 zip 打包方案，安装秒级完成，首启解压一次性投入

---

项目地址：https://github.com/w-zjj/dshdesk 下载地址：https://github.com/w-zjj/dshdesk/releases 开源协议：MIT 当前版本：v0.1.0

如本项目对您有所帮助，欢迎在 GitHub 给予 star 支持。如遇 bug 或有功能需求，请通过 Issues 提交反馈。