DSH Desktop

DeepSeek Harness（DSH）的桌面版启动器：自动拉起/复用 dsh web，以原生窗口打开， 并内嵌一个跟随当前工作区的 Files 文件边栏。

特性

• 独立启动：无需手动先开 dsh；端口上已有 DSH 实例则直接复用
• 原生窗口：iframe 嵌入 DSH 应用 + 右侧 Files 工作区文件边栏（懒加载目录树、 点击文件用系统程序打开、深色主题跟随）
• 工作区跟随：读取 DSH 界面当前激活会话，自动切换边栏目录（约 2 秒内）， 并记住最后工作区，重启后自动恢复
• 系统托盘：显示/隐藏、Files 切换、重新加载、开发者工具、退出（默认关窗隐藏到托盘）
• 单实例锁、外部链接走系统浏览器、崩溃可重载、自动清理自己拉起的 dsh 进程

环境要求

• Node.js >= 18（建议 20+）
• 已安装 DeepSeek Harness：npm install -g @deepseek-ai/dsh

快速开始

npm install
npm start

首次启动 dsh web 需 10~30 秒（profile 初始化、服务启动），期间显示加载页。

配置（可选）

复制 settings.example.json 为 settings.json：

{
  "host": "127.0.0.1",      // 监听主机（勿设 0.0.0.0）
  "port": 3080,             // 端口；设 0 让系统分配
  "executable": "",         // dsh 完整路径，留空自动查找
  "workspace": "",          // 显式固定工作区；留空则自动跟随
  "trustedHosts": [],       // 额外信任的 Host
  "closeToTray": true       // 关窗隐藏到托盘而非退出
}

环境变量覆盖：DSH_HOST、DSH_PORT、DSH_EXECUTABLE、DSH_WORKSPACE、DSH_NODE。

dsh 查找顺序：显式 executable > PATH（Windows 选 .cmd）> node <dsh包>/lib/bin.js （~/node_modules → npm root -g → 本地）。

打包

npm run pack        # release/win-unpacked（免安装版）
npm run dist:lite   # NSIS 安装包（推荐）
npm run dist        # 完整打包（需可创建符号链接：管理员或开启开发者模式）

国内网络构建前请设置镜像：

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_BINARIES_MIRROR = "https://npmmirror.com/mirrors/electron-builder-binaries/"

产物：release/win-unpacked/DSH Desktop.exe、release/DSH Desktop Setup <版本>.exe。 构建时 scripts/set-icons.js（afterPack 钩子）会用 rcedit 把鲸鱼图标写入 exe。

目录结构

dsh-desktop/
├── main.js                  # 主进程：服务管理、窗口、托盘、工作区跟随、IPC
├── shell.html               # 容器页：iframe 嵌入 DSH + 右侧 Files 边栏
├── preload.js               # contextBridge（工作区/主题/事件桥）
├── loading.html             # 启动加载页
├── settings.example.json    # 配置模板
├── scripts/
│   ├── generate-icon.ps1    # 生成图标（透明底黑鲸鱼，BMP ico）
│   └── set-icons.js         # 打包后写入 exe 图标（rcedit）
└── build/                   # icon.png / icon.ico / icon.svg

声明

• 本项目的鲸鱼图标取自 DeepSeek Harness 官方前端资源（@deepseek-ai/dsh-web-frontend）， 仅作启动器品牌展示使用；DeepSeek 及鲸鱼标识归 DeepSeek 所有。 本项目与 DeepSeek 官方无关联，亦非官方产品。
• 启动器调用 DSH CLI（@deepseek-ai/dsh）运行其 Web 界面，DSH 本体及其插件生态 归 DeepSeek 所有，遵循其自身的 MIT 协议。

许可

MIT