dsh-desktop-windows 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ReachGa0
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,86 @@
+# dsh-desktop
+
+[English](README.en.md) | [中文](README.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Electron](https://img.shields.io/badge/Electron-43-blue)](https://www.electronjs.org/)
+[![dsh](https://img.shields.io/badge/dsh-0.1.0--rc.6-purple)](https://github.com/deepseek-ai/deepseek-harness)
+[![Platform](https://img.shields.io/badge/Platform-Windows-0078D6)]()
+[![Build](https://github.com/ReachGa0/dsh-desktop/actions/workflows/build.yml/badge.svg)](https://github.com/ReachGa0/dsh-desktop/actions)
+
+An **Electron desktop shell** for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): double-click an icon and get a standalone window running `dsh web` — no terminal, no manual commands, no browser tab juggling.
+
+Pure shell — it **does not modify dsh itself**. The server reuses your globally installed `@deepseek-ai/dsh`.
+
+## ✨ Features
+
+- 🪟 **Standalone window**: native desktop window loading the Harness Web UI
+- 🍱 **System tray**: closing the window minimizes to the tray; right-click to show or quit
+- 🧠 **Smart reuse**: reuses an already-running dsh service instead of starting a duplicate
+- 🧹 **Clean shutdown**: only kills the dsh process tree it started — never an external service
+- 🔒 **Single instance**: prevents double-launch conflicts
+- 🎨 **Hardened**: `contextIsolation` + `sandbox` + no Node integration; external links open in your system browser
+- 📦 **One-click installer**: `npm run dist` produces an NSIS setup
+
+## How it works
+
+1. On startup, probes whether a dsh service is already listening on `127.0.0.1:3080`;
+2. If not, spawns `dsh web --port 3080` automatically (logs to `%APPDATA%/DeepSeek Harness Desktop/dsh.log`);
+3. Once ready, opens an Electron window loading the Web UI;
+4. When the window closes, kills only the dsh process tree it started (an externally started service is never touched).
+
+## Prerequisites
+
+- Node.js ≥ 22 (v24 verified)
+- Globally installed dsh: `npm i -g @deepseek-ai/dsh` (0.1.0-rc.6 verified)
+- To override the dsh binary path, set the `DSH_BIN` environment variable (e.g. point it at a source build of `apps/cli/src/bin.ts`)
+
+## Install & run
+
+```sh
+cd dsh-desktop
+npm install
+npm start
+```
+
+> If the Electron binary download is slow or fails (common on some networks), use a mirror:
+> ```sh
+> set "ELECTRON_MIRROR=https://cdn.npmmirror.com/binaries/electron/"
+> npm install
+> ```
+
+**Use a different port** (when 3080 is taken):
+
+```sh
+npm start -- --port 3081
+```
+
+On first launch: go to **Settings → Models**, enter your DeepSeek API Key, then pick a workspace.
+
+## Screenshots
+
+> Coming soon — feel free to submit a screenshot via PR or Issue.
+
+## Package an installer
+
+```sh
+npm run dist
+```
+
+Output lands in `release/`: `dsh-desktop-0.1.0-setup.exe` (NSIS installer).
+
+Custom icon: drop an `assets/icon.ico` (≥256×256) and add `"icon": "assets/icon.ico"` under `build.win` in `package.json`.
+
+## Troubleshooting
+
+- **Launch fails / error dialog**: check `%APPDATA%/DeepSeek Harness Desktop/dsh.log`; make sure `dsh --version` works.
+- **Port already in use**: run `npm start -- --port <new-port>` instead.
+- **After upgrading dsh**: just re-run `npm i -g @deepseek-ai/dsh` — the shell needs no changes.
+
+## Contributing
+
+Issues and PRs are welcome! The project is tiny — all the code lives in `src/`.
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,86 @@
+# dsh-desktop
+
+[中文](README.md) | [English](README.en.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Electron](https://img.shields.io/badge/Electron-43-blue)](https://www.electronjs.org/)
+[![dsh](https://img.shields.io/badge/dsh-0.1.0--rc.6-purple)](https://github.com/deepseek-ai/deepseek-harness)
+[![Platform](https://img.shields.io/badge/Platform-Windows-0078D6)]()
+[![Build](https://github.com/ReachGa0/dsh-desktop/actions/workflows/build.yml/badge.svg)](https://github.com/ReachGa0/dsh-desktop/actions)
+
+DeepSeek Harness 的 **Electron 桌面壳**：双击图标，一个独立窗口运行 `dsh web` —— 不用开终端、不用敲命令、不用切浏览器。
+
+纯壳，**不改动 dsh 本身**。服务端复用全局安装的 `@deepseek-ai/dsh`。
+
+## ✨ 特性
+
+- 🪟 **独立窗口**：原生桌面窗口加载 Harness Web UI，可最小化到任务栏
+- 🍱 **系统托盘**：关窗口最小化到托盘常驻，右键菜单可随时显示/退出
+- 🧠 **智能复用**：检测到已有的 dsh 服务就直接复用，不重复启动
+- 🧹 **干净退出**：关窗口只杀自己启动的 dsh 进程，绝不误杀外部服务
+- 🔒 **单实例锁**：防止双开冲突
+- 🎨 **安全加固**：`contextIsolation` + `sandbox` + 禁用 Node 集成，外部链接走系统浏览器
+- 📦 **一键安装包**：`npm run dist` 生成 NSIS 安装程序
+
+## 原理
+
+1. 启动时探测 `127.0.0.1:3080` 是否已有 dsh 服务；
+2. 没有 → 自动执行 `dsh web --port 3080`（日志在 `%APPDATA%/DeepSeek Harness Desktop/dsh.log`）；
+3. 就绪后打开 Electron 窗口加载 Web UI；
+4. 关窗口 → 自动杀掉由本壳启动的 dsh 进程树（手动起的外部服务不会被误杀）。
+
+## 前提
+
+- Node.js ≥ 22（v24 验证通过）
+- 全局安装 dsh：`npm i -g @deepseek-ai/dsh`（0.1.0-rc.6 验证通过）
+- 如需覆盖 dsh 路径，设置环境变量 `DSH_BIN`（例如指向源码构建的 `apps/cli/src/bin.ts`）
+
+## 安装与运行
+
+```sh
+cd Desktop\deepseek_work\dsh-desktop
+npm install
+npm start
+```
+
+> 国内网络下 Electron 二进制下载可能很慢或失败，用镜像：
+> ```sh
+> set "ELECTRON_MIRROR=https://cdn.npmmirror.com/binaries/electron/"
+> npm install
+> ```
+
+**换端口**（3080 被占用时）：
+
+```sh
+npm start -- --port 3081
+```
+
+首次打开后：**设置 → 模型 → 填入 DeepSeek API Key**，然后选择工作区即可使用。
+
+## 截图
+
+> 敬请期待 —— 欢迎提交你的界面截图（PR 或 Issue 均可）。
+
+## 打包成安装程序
+
+```sh
+npm run dist
+```
+
+产物在 `release/` 下：`dsh-desktop-0.1.0-setup.exe`（NSIS 安装包）。
+
+自定义图标：放一个 `assets/icon.ico`（≥256×256），并在 `package.json` 的 `build.win` 里加 `"icon": "assets/icon.ico"`。
+
+## 常见问题
+
+- **启动失败弹窗**：看 `%APPDATA%/DeepSeek Harness Desktop/dsh.log`；确认 `dsh --version` 可用。
+- **端口被占**：用 `npm start -- --port <新端口>` 换一个端口即可。
+- **改了 dsh 版本**：重新 `npm i -g @deepseek-ai/dsh` 即可，壳无需改动。
+
+## 贡献
+
+欢迎提 Issue 和 PR！项目很小，代码都在 `src/` 里，容易上手。
+
+## License
+
+[MIT](LICENSE)

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "dsh-desktop-windows",
+  "productName": "DeepSeek Harness Desktop",
+  "version": "0.1.2",
+  "description": "Electron desktop shell for DeepSeek Harness (dsh web) on Windows — double-click to run the harness in a standalone window, no terminal needed",
+  "main": "src/main.js",
+  "license": "MIT",
+  "author": "ReachGa0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ReachGa0/dsh-desktop.git"
+  },
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "electron",
+    "desktop",
+    "windows"
+  ],
+  "files": [
+    "src",
+    "assets",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "start": "electron .",
+    "dist": "electron-builder --win nsis",
+    "dist:dir": "electron-builder --dir"
+  },
+  "devDependencies": {
+    "electron": "^43.4.0",
+    "electron-builder": "^26.15.3"
+  },
+  "build": {
+    "appId": "com.dsh.desktop",
+    "productName": "DeepSeek Harness Desktop",
+    "directories": {
+      "output": "release"
+    },
+    "files": [
+      "src/**/*",
+      "assets/**/*",
+      "package.json"
+    ],
+    "win": {
+      "target": [
+        "nsis"
+      ],
+      "artifactName": "dsh-desktop-${version}-setup.${ext}",
+      "icon": "assets/icon.ico"
+    },
+    "nsis": {
+      "oneClick": false,
+      "allowToChangeInstallationDirectory": true,
+      "createDesktopShortcut": true,
+      "shortcutName": "DeepSeek Harness"
+    }
+  }
+}

package/src/main.js

@@ -0,0 +1,343 @@
+'use strict'
+
+/**
+ * dsh-desktop — Electron 壳，包装 DeepSeek Harness Web UI。
+ *
+ * 职责：
+ *   1. 探测 127.0.0.1:3080 是否已有 dsh 服务在跑；
+ *   2. 没有则启动全局 `dsh web --port 3080`（日志写入 userData/dsh.log）；
+ *   3. 等服务就绪后打开 BrowserWindow 加载 Web UI；
+ *   4. 窗口退出时，只杀掉由本壳启动的 dsh 进程树；
+ *   5. 单实例锁，防止双开。
+ *
+ * 不修改 dsh 任何代码；服务端用全局安装的 dsh（可用 DSH_BIN 环境变量覆盖路径）。
+ */
+
+const { app, BrowserWindow, dialog, shell, Tray, Menu, nativeImage, ipcMain } = require('electron')
+const { spawn, execFile } = require('node:child_process')
+const http = require('node:http')
+const fs = require('node:fs')
+const path = require('node:path')
+
+const DEFAULT_PORT = 3080
+const START_TIMEOUT_MS = 90_000
+const POLL_INTERVAL_MS = 500
+const LOG_PREFIX = '[dsh-desktop]'
+
+/** 解析端口：优先命令行 --port <n>，否则用默认值。 */
+function resolvePort() {
+  const idx = process.argv.indexOf('--port')
+  if (idx !== -1 && process.argv[idx + 1]) {
+    const n = Number(process.argv[idx + 1])
+    if (Number.isInteger(n) && n > 0 && n < 65536) return n
+    console.warn(LOG_PREFIX, `invalid --port value "${process.argv[idx + 1]}", fallback to ${DEFAULT_PORT}`)
+  }
+  return DEFAULT_PORT
+}
+
+let mainWindow = null
+let ownedDsh = null // 本壳启动的 dsh 子进程；null 表示复用了外部已有服务
+let tray = null // 系统托盘
+let isQuitting = false // 用户从托盘选择退出时置 true，放行窗口关闭
+
+/* ------------------------------------------------------------------ *
+ * 工具：日志
+ * ------------------------------------------------------------------ */
+
+function log(...args) {
+  console.log(LOG_PREFIX, ...args)
+}
+
+/* ------------------------------------------------------------------ *
+ * 工具：探测 / 等待 HTTP 服务
+ * ------------------------------------------------------------------ */
+
+function probe(port, timeoutMs = 1500) {
+  return new Promise((resolve) => {
+    const req = http.get(
+      { host: '127.0.0.1', port, path: '/', timeout: timeoutMs },
+      (res) => {
+        res.resume()
+        resolve(true)
+      }
+    )
+    req.on('timeout', () => req.destroy())
+    req.on('error', () => resolve(false))
+  })
+}
+
+/** 轮询直到服务就绪或超时。 */
+async function waitForServer(port, timeoutMs) {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (await probe(port)) return true
+    await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS))
+  }
+  return false
+}
+
+/* ------------------------------------------------------------------ *
+ * dsh 服务进程管理
+ * ------------------------------------------------------------------ */
+
+/** 解析 dsh 可执行文件：优先 DSH_BIN，否则走 PATH（Windows 下是 dsh.cmd）。 */
+function resolveDshBin() {
+  if (process.env.DSH_BIN) return process.env.DSH_BIN
+  // 全局 npm 安装的常见位置
+  if (process.env.APPDATA) {
+    const global = path.join(process.env.APPDATA, 'npm', 'dsh.cmd')
+    if (fs.existsSync(global)) return global
+  }
+  return 'dsh.cmd'
+}
+
+/** 启动 dsh web，日志追加到 userData/dsh.log。返回子进程。 */
+function startDsh(port) {
+  const bin = resolveDshBin()
+  const logFile = path.join(app.getPath('userData'), 'dsh.log')
+  const out = fs.openSync(logFile, 'a')
+  // shell:true 时把参数拼进命令字符串（参数均为常量），避免 DEP0190 警告
+  const cmd = `"${bin}" web --port ${port}`
+  const child = spawn(cmd, {
+    shell: true,
+    windowsHide: true,
+    stdio: ['ignore', out, out],
+    env: { ...process.env },
+  })
+  log(`spawned dsh: ${cmd} (pid ${child.pid})`)
+  log(`dsh log: ${logFile}`)
+  child.on('exit', (code, signal) => {
+    log(`dsh exited: code=${code} signal=${signal}`)
+    if (ownedDsh === child) ownedDsh = null
+  })
+  child.on('error', (err) => {
+    log(`dsh spawn error: ${err.message}`)
+  })
+  return child
+}
+
+/** 杀掉进程树（Windows 用 taskkill /T 覆盖子孙进程），带超时兜底。 */
+function killProcessTree(pid) {
+  return new Promise((resolve) => {
+    execFile(
+      'taskkill',
+      ['/pid', String(pid), '/T', '/F'],
+      { windowsHide: true },
+      () => resolve() // 无论成败都继续退出流程
+    )
+    setTimeout(resolve, 2000)
+  })
+}
+
+async function shutdownOwnedDsh() {
+  if (ownedDsh && ownedDsh.pid) {
+    const pid = ownedDsh.pid
+    ownedDsh = null
+    await killProcessTree(pid)
+    log(`killed owned dsh pid ${pid}`)
+  }
+}
+
+/* ------------------------------------------------------------------ *
+ * 窗口
+ * ------------------------------------------------------------------ */
+
+function createWindow(url) {
+  mainWindow = new BrowserWindow({
+    width: 1280,
+    height: 840,
+    minWidth: 960,
+    minHeight: 600,
+    title: 'DeepSeek Harness',
+    autoHideMenuBar: true,
+    icon: path.join(__dirname, '..', 'assets', 'icon.ico'),
+    webPreferences: {
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+      preload: path.join(__dirname, 'preload.js'),
+    },
+  })
+
+  mainWindow.loadURL(url)
+  mainWindow.on('closed', () => {
+    mainWindow = null
+  })
+  // F5 刷新（Ctrl+R 由应用菜单 accelerator 提供）
+  mainWindow.webContents.on('before-input-event', (event, input) => {
+    if (input.type === 'keyDown' && input.key === 'F5') {
+      event.preventDefault()
+      mainWindow.webContents.reload()
+    }
+  })
+  // 关窗口 → 最小化到托盘（不退出应用）；从托盘菜单选"退出"才真正退出
+  mainWindow.on('close', (event) => {
+    if (!isQuitting) {
+      event.preventDefault()
+      mainWindow.hide()
+      log('window hidden to tray')
+    }
+  })
+
+  // 外部链接（非本机）用系统浏览器打开，不在壳内导航
+  mainWindow.webContents.setWindowOpenHandler(({ url: target }) => {
+    if (target.startsWith('http://127.0.0.1') || target.startsWith('http://localhost')) {
+      return { action: 'allow' }
+    }
+    shell.openExternal(target)
+    return { action: 'deny' }
+  })
+
+  mainWindow.webContents.on('will-navigate', (event, target) => {
+    if (!target.startsWith(url)) {
+      event.preventDefault()
+      shell.openExternal(target)
+    }
+  })
+}
+
+/* ------------------------------------------------------------------ *
+ * 系统托盘
+ * ------------------------------------------------------------------ */
+
+function createTray() {
+  const iconPath = path.join(__dirname, '..', 'assets', 'tray.png')
+  const icon = nativeImage.createFromPath(iconPath)
+  tray = new Tray(icon)
+  tray.setToolTip('DeepSeek Harness')
+  tray.setContextMenu(
+    Menu.buildFromTemplate([
+      { label: '显示主窗口', click: showMainWindow },
+      { type: 'separator' },
+      {
+        label: '退出',
+        click: () => {
+          isQuitting = true
+          app.quit()
+        },
+      },
+    ])
+  )
+  tray.on('double-click', showMainWindow)
+}
+
+function showMainWindow() {
+  if (!mainWindow) return
+  mainWindow.show()
+  mainWindow.focus()
+}
+
+/* ------------------------------------------------------------------ *
+ * 应用菜单（autoHideMenuBar 下按 Alt 显示；快捷键始终生效）
+ * ------------------------------------------------------------------ */
+
+function createApplicationMenu() {
+  const template = [
+    {
+      label: '文件',
+      submenu: [
+        {
+          label: '退出',
+          accelerator: 'Alt+F4',
+          click: () => {
+            isQuitting = true
+            app.quit()
+          },
+        },
+      ],
+    },
+    {
+      label: '视图',
+      submenu: [
+        {
+          label: '重新加载',
+          accelerator: 'CmdOrCtrl+R',
+          click: () => {
+            if (mainWindow) mainWindow.webContents.reload()
+          },
+        },
+        {
+          label: '强制重新加载（清缓存）',
+          accelerator: 'CmdOrCtrl+Shift+R',
+          click: () => {
+            if (mainWindow) mainWindow.webContents.reloadIgnoringCache()
+          },
+        },
+        { type: 'separator' },
+        { role: 'togglefullscreen', label: '全屏' },
+        {
+          label: '开发者工具',
+          accelerator: 'F12',
+          click: () => {
+            if (mainWindow) mainWindow.webContents.toggleDevTools()
+          },
+        },
+      ],
+    },
+  ]
+  Menu.setApplicationMenu(Menu.buildFromTemplate(template))
+}
+
+/* ------------------------------------------------------------------ *
+ * 应用生命周期
+ * ------------------------------------------------------------------ */
+
+const gotLock = app.requestSingleInstanceLock()
+if (!gotLock) {
+  app.quit()
+} else {
+  app.on('second-instance', () => {
+    if (mainWindow) {
+      if (mainWindow.isMinimized()) mainWindow.restore()
+      mainWindow.focus()
+    }
+  })
+
+  app.whenReady().then(async () => {
+    // 1) 已有服务（可能是用户手动起的 dsh web）→ 直接复用
+    let port = resolvePort()
+    let external = await probe(port)
+    if (!external) {
+      // 2) 没有 → 自己启动，等就绪
+      ownedDsh = startDsh(port)
+      const ready = await waitForServer(port, START_TIMEOUT_MS)
+      if (!ready) {
+        const logFile = path.join(app.getPath('userData'), 'dsh.log')
+        dialog.showErrorBox(
+          'DeepSeek Harness 启动失败',
+          `dsh web 在 ${START_TIMEOUT_MS / 1000}s 内没有就绪。\n\n` +
+            `日志文件：${logFile}\n\n` +
+            '请确认已全局安装 dsh（npm i -g @deepseek-ai/dsh），或用 DSH_BIN 指定路径。\n' +
+            `若端口 ${port} 被其他程序占用，可换端口启动：dsh-desktop --port <新端口>`
+        )
+        await shutdownOwnedDsh()
+        app.quit()
+        return
+      }
+    }
+
+    createWindow(`http://127.0.0.1:${port}`)
+    createTray()
+    createApplicationMenu()
+    // preload 注入的悬浮刷新按钮 → 重新加载页面
+    ipcMain.on('dsh-desktop:reload', () => {
+      if (mainWindow) mainWindow.webContents.reload()
+    })
+    if (external) log('reusing external dsh service on port ' + port)
+  })
+
+  // 托盘常驻：窗口关闭不退出应用；只有用户从托盘选"退出"才真正退出
+  app.on('window-all-closed', () => {
+    if (isQuitting) {
+      shutdownOwnedDsh().finally(() => app.quit())
+    }
+  })
+
+  app.on('before-quit', (event) => {
+    // 防止退出竞态：先杀掉子进程再放行
+    if (ownedDsh) {
+      event.preventDefault()
+      shutdownOwnedDsh().finally(() => app.quit())
+    }
+  })
+}

package/src/preload.js

@@ -0,0 +1,38 @@
+'use strict'
+
+// 最小 preload：为将来扩展保留的桥接点 + 注入悬浮刷新按钮。
+// 页面（dsh Web UI）直接走 HTTP/WebSocket 与本地服务通信，无需 IPC。
+
+const { ipcRenderer } = require('electron')
+
+// 注入一个悬浮"刷新"按钮（右下角，半透明，鼠标悬停变清晰）
+window.addEventListener('DOMContentLoaded', () => {
+  setTimeout(() => {
+    if (!document.body) return
+    const btn = document.createElement('button')
+    btn.textContent = '⟳'
+    btn.title = '刷新页面（等价 F5）'
+    btn.style.cssText = `
+      position: fixed;
+      right: 14px;
+      bottom: 14px;
+      width: 34px;
+      height: 34px;
+      border-radius: 10px;
+      border: none;
+      background: rgba(30, 41, 59, 0.72);
+      color: #fff;
+      font-size: 18px;
+      line-height: 1;
+      cursor: pointer;
+      box-shadow: 0 2px 10px rgba(0, 0, 0, 0.35);
+      opacity: 0.45;
+      transition: opacity 0.2s;
+      z-index: 2147483647;
+    `
+    btn.onmouseenter = () => (btn.style.opacity = '1')
+    btn.onmouseleave = () => (btn.style.opacity = '0.45')
+    btn.onclick = () => ipcRenderer.send('dsh-desktop:reload')
+    document.body.appendChild(btn)
+  }, 1500)
+})