dsh-desktop-windows 0.2.7 → 0.3.0

package/README.en.md

@@ -7,16 +7,21 @@
 [![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)
+[![awesome-dsh-plugin](https://img.shields.io/badge/awesome--dsh--plugin-listed-8A2BE2)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
 
-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.
+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. **Region screenshot to ask the AI**, system tray, session manager, auto environment setup.
 
 Pure shell — it **does not modify dsh itself**. The server reuses your globally installed `@deepseek-ai/dsh`.
 
 ## ✨ Features
 
+- 📸 **Region screenshot → ask AI**: one-click capture → full-screen overlay with real-time selection (GPU-accelerated, 8-direction handles to fine-tune) → auto-pastes into the chat → the AI answers from the image; the chat window hides itself during capture
+- 🗂️ **Session manager**: `Alt → File → Session Manager…` lists every session, delete with one click (permanently removes chat history)
 - 🪟 **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
+- 🔄 **Easy reload**: `F5` / `Ctrl+R` / floating button — load new plugins without restarting the window
 - 🧭 **Auto environment setup**: on first launch it detects Node.js / dsh and guides a one-click install — friendly to non-technical users
+- 🔧 **Configurable port**: `npm start -- --port 3081` when 3080 is taken
 - 🧠 **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
@@ -30,6 +35,18 @@ Pure shell — it **does not modify dsh itself**. The server reuses your globall
 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).
 
+## 📸 Region screenshot
+
+![Region screenshot to ask AI (demo)](docs/demo/screenshot-ask.gif)
+
+1. Click the **📸** button (bottom-right) — the chat window auto-hides
+2. **Drag to select** an area on the full-screen overlay (live preview; drag the 8 handles to fine-tune after drawing)
+3. Click **✔ OK** (or double-click / Enter) — the chat window restores
+4. The screenshot lands in the chat box automatically → type a question → the AI answers from the image
+
+> Pair with a vision bridge like [ModLens](https://www.npmjs.com/package/@liustack/modlens) so text-only DeepSeek models can read images too.
+> Screenshots are also saved to `~/.dsh/screenshots/` (open the folder from the tray menu).
+
 ## Prerequisites
 
 - Node.js ≥ 22 (v24 verified)
@@ -58,17 +75,13 @@ 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).
+Output lands in `release/`: `dsh-desktop-<version>-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`.
 
@@ -77,6 +90,8 @@ Custom icon: drop an `assets/icon.ico` (≥256×256) and add `"icon": "assets/ic
 - **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.
+- **Screenshot not in the chat box**: click the input and press `Ctrl+V` (the image is already on your clipboard).
+- **Closing the window doesn't quit**: that's the tray — right-click the tray icon and choose "Quit".
 
 ## Contributing
 

package/README.md

@@ -7,8 +7,9 @@
 [![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)
+[![awesome-dsh-plugin](https://img.shields.io/badge/awesome--dsh--plugin-listed-8A2BE2)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
 
-> **English summary** · An [Electron](https://www.electronjs.org/) desktop shell for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh web) on **Windows** — double-click to run the harness in a standalone window. No terminal, no commands, no browser juggling. System tray support, floating reload button, configurable port. Full English docs: [README.en.md](README.en.md)
+> **English summary** · An [Electron](https://www.electronjs.org/) desktop shell for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh web) on **Windows** — double-click to run the harness in a standalone window. **Region screenshot to ask AI**, system tray, session manager, auto environment setup. Full English docs: [README.en.md](README.en.md)
 
 DeepSeek Harness 的 **Electron 桌面壳**：双击图标，一个独立窗口运行 `dsh web` —— 不用开终端、不用敲命令、不用切浏览器。
 
@@ -16,9 +17,13 @@ DeepSeek Harness 的 **Electron 桌面壳**：双击图标，一个独立窗口
 
 ## ✨ 特性
 
+- 📸 **选区截图提问**：一键截屏 → 全屏遮罩实时框选（GPU 加速、8 方向手柄微调）→ 自动粘贴到聊天框 → AI 直接看图回答；截图时自动隐藏聊天窗口
+- 🗂️ **会话管理**：`Alt → 文件 → 会话管理…` 列出所有会话，一键删除（永久清理聊天记录）
 - 🪟 **独立窗口**：原生桌面窗口加载 Harness Web UI，可最小化到任务栏
 - 🍱 **系统托盘**：关窗口最小化到托盘常驻，右键菜单可随时显示/退出
+- 🔄 **便捷刷新**：`F5` / `Ctrl+R` / 右下角悬浮按钮，加载新插件不用重启窗口
 - 🧭 **环境自动引导**：首次启动自动检测 Node.js / dsh，缺失时引导一键安装，小白也能搞定
+- 🔧 **可换端口**：`npm start -- --port 3081` 解决端口占用
 - 🧠 **智能复用**：检测到已有的 dsh 服务就直接复用，不重复启动
 - 🧹 **干净退出**：关窗口只杀自己启动的 dsh 进程，绝不误杀外部服务
 - 🔒 **单实例锁**：防止双开冲突
@@ -32,6 +37,18 @@ DeepSeek Harness 的 **Electron 桌面壳**：双击图标，一个独立窗口
 3. 就绪后打开 Electron 窗口加载 Web UI；
 4. 关窗口 → 自动杀掉由本壳启动的 dsh 进程树（手动起的外部服务不会被误杀）。
 
+## 📸 选区截图提问
+
+![选区截图直接问 AI 演示](docs/demo/screenshot-ask.gif)
+
+1. 点右下角 **📸**（聊天窗口自动隐藏）
+2. 全屏遮罩上**拖动框选**区域（实时显示，画完可拖 8 个手柄微调）
+3. 点 **✔ 确定**（或双击 / 回车）→ 聊天窗口恢复
+4. 截图自动进入聊天框 → 输入问题 → AI 看图回答
+
+> 配合 [ModLens](https://www.npmjs.com/package/@liustack/modlens) 等识图插件，DeepSeek 文本模型也能看懂图片。
+> 截图同时自动保存到 `~/.dsh/screenshots/`（托盘右键可打开目录）。
+
 ## 前提
 
 - Node.js ≥ 22（v24 验证通过）
@@ -60,17 +77,13 @@ npm start -- --port 3081
 
 首次打开后：**设置 → 模型 → 填入 DeepSeek API Key**，然后选择工作区即可使用。
 
-## 截图
-
-> 敬请期待 —— 欢迎提交你的界面截图（PR 或 Issue 均可）。
-
 ## 打包成安装程序
 
 ```sh
 npm run dist
 ```
 
-产物在 `release/` 下：`dsh-desktop-0.1.0-setup.exe`（NSIS 安装包）。
+产物在 `release/` 下：`dsh-desktop-<版本>-setup.exe`（NSIS 安装包）。
 
 自定义图标：放一个 `assets/icon.ico`（≥256×256），并在 `package.json` 的 `build.win` 里加 `"icon": "assets/icon.ico"`。
 
@@ -79,6 +92,8 @@ npm run dist
 - **启动失败弹窗**：看 `%APPDATA%/DeepSeek Harness Desktop/dsh.log`；确认 `dsh --version` 可用。
 - **端口被占**：用 `npm start -- --port <新端口>` 换一个端口即可。
 - **改了 dsh 版本**：重新 `npm i -g @deepseek-ai/dsh` 即可，壳无需改动。
+- **截图没进聊天框**：点一下输入框按 `Ctrl+V`（截图已在剪贴板）。
+- **关闭窗口后应用还在**：正常！它最小化到托盘了，右键托盘图标选"退出"。
 
 ## 贡献
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-desktop-windows",
   "productName": "DeepSeek Harness Desktop",
-  "version": "0.2.7",
-  "description": "DeepSeek Harness 桌面版（Windows）· Electron desktop shell for DeepSeek Harness (dsh web) — 双击即用，无需终端 / double-click to run the harness in a standalone window",
+  "version": "0.3.0",
+  "description": "DeepSeek Harness 桌面版（Windows）· Electron desktop shell for DeepSeek Harness — 双击即用 / double-click to run · 支持选区截图提问、系统托盘、会话管理 / region screenshot, system tray, session manager",
   "main": "src/main.js",
   "license": "MIT",
   "author": "ReachGa0",
@@ -64,3 +64,4 @@
     }
   }
 }
+

package/src/main.js

@@ -16,6 +16,7 @@
 const { app, BrowserWindow, dialog, shell, Tray, Menu, nativeImage, ipcMain, desktopCapturer, clipboard, screen } = require('electron')
 const { spawn, execFile } = require('node:child_process')
 const http = require('node:http')
+const https = require('node:https')
 const fs = require('node:fs')
 const path = require('node:path')
 const os = require('node:os')
@@ -62,6 +63,103 @@ function shotLog(...args) {
   } catch { /* 忽略日志错误 */ }
 }
 
+/* ------------------------------------------------------------------ *
+ * 自动更新检查（启动时异步检测 GitHub Releases 最新版）
+ * ------------------------------------------------------------------ */
+
+const REPO = 'ReachGa0/dsh-desktop'
+const RELEASES_URL = `https://api.github.com/repos/${REPO}/releases/latest`
+const RELEASES_PAGE = `https://github.com/${REPO}/releases/latest`
+const UPDATE_CHECK_TIMEOUT_MS = 10_000
+
+/** GET 一个 JSON（带超时与 UA，GitHub API 要求 UA）。resolve null 表示失败。 */
+function fetchJson(url) {
+  return new Promise((resolve) => {
+    // 首次用系统证书；代理/反代环境证书校验可能失败，降级为不校验重试一次
+    // （仅更新检查用，不降低应用其他部分的安全级别）
+    const attempt = (rejectUnauthorized) => {
+      const req = https.get(
+        url,
+        { headers: { 'User-Agent': 'dsh-desktop-update-check', Accept: 'application/vnd.github+json' }, timeout: UPDATE_CHECK_TIMEOUT_MS, rejectUnauthorized },
+        (res) => {
+          if (res.statusCode !== 200) {
+            res.resume()
+            resolve(null)
+            return
+          }
+          let body = ''
+          res.setEncoding('utf8')
+          res.on('data', (d) => (body += d))
+          res.on('end', () => {
+            try { resolve(JSON.parse(body)) } catch { resolve(null) }
+          })
+        }
+      )
+      req.on('timeout', () => req.destroy())
+      req.on('error', () => {
+        // 证书类错误：再试一次宽松模式；其他错误直接放弃
+        if (rejectUnauthorized) attempt(false)
+        else resolve(null)
+      })
+    }
+    attempt(true)
+  })
+}
+
+/** 解析语义化版本号 → [major, minor, patch]，失败返回 null。 */
+function parseVersion(v) {
+  if (typeof v !== 'string') return null
+  const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(v.trim())
+  if (!m) return null
+  return [Number(m[1]), Number(m[2]), Number(m[3])]
+}
+
+/** a 比 b 新？都解析失败时返回 false（宁可漏报不可误报）。 */
+function isNewer(a, b) {
+  const pa = parseVersion(a)
+  const pb = parseVersion(b)
+  if (!pa || !pb) return false
+  for (let i = 0; i < 3; i++) {
+    if (pa[i] !== pb[i]) return pa[i] > pb[i]
+  }
+  return false
+}
+
+/**
+ * 检查更新：查询 GitHub Releases 最新版，若比当前版本新则弹窗提示。
+ * 全程静默失败（网络不通 / 解析失败 / 无新版都不打扰用户）。
+ */
+async function checkForUpdates() {
+  const current = app.getVersion()
+  try {
+    const release = await fetchJson(RELEASES_URL)
+    if (!release) {
+      log('update check: no release data (offline or API error)')
+      return
+    }
+    const latest = release.tag_name
+    log(`update check: current=${current} latest=${latest}`)
+    if (!isNewer(latest, current)) return
+    const name = release.name && release.name !== latest ? `「${release.name}」` : ''
+    const detail = (release.body || '').split('\n').slice(0, 6).join('\n').trim()
+    const { response } = await dialog.showMessageBox(mainWindow || undefined, {
+      type: 'info',
+      title: '发现新版本',
+      message: `DeepSeek Harness Desktop 有新版本可用（${latest} ${name}）`,
+      detail: detail ? `更新内容：\n${detail}\n\n当前版本：${current}` : `当前版本：${current}`,
+      buttons: ['前往下载', '以后再说'],
+      defaultId: 0,
+      cancelId: 1,
+      noLink: true,
+    })
+    if (response === 0) {
+      shell.openExternal(RELEASES_PAGE)
+    }
+  } catch (e) {
+    log('update check failed:', e && e.message)
+  }
+}
+
 /* ------------------------------------------------------------------ *
  * 工具：探测 / 等待 HTTP 服务
  * ------------------------------------------------------------------ */
@@ -105,6 +203,11 @@ function resolveDshBin() {
   return 'dsh.cmd'
 }
 
+// 主动关停 dsh 时的标记（杀进程也会触发 exit，需区分「主动关」和「意外崩」）
+let isShuttingDownDsh = false
+// 已自动重启过一次的标志（同一次会话最多自愈一次，避免崩溃循环）
+let didAutoRestartDsh = false
+
 /** 启动 dsh web，日志追加到 userData/dsh.log。返回子进程。 */
 function startDsh(port) {
   const bin = resolveDshBin()
@@ -122,7 +225,12 @@ function startDsh(port) {
   log(`dsh log: ${logFile}`)
   child.on('exit', (code, signal) => {
     log(`dsh exited: code=${code} signal=${signal}`)
-    if (ownedDsh === child) ownedDsh = null
+    if (ownedDsh !== child) return
+    ownedDsh = null
+    // 崩溃自愈：本壳启动的 dsh 意外退出（非主动关闭/非退出中）时自动重启一次
+    if (!isQuitting && !isShuttingDownDsh) {
+      restartOwnedDsh(port, code)
+    }
   })
   child.on('error', (err) => {
     log(`dsh spawn error: ${err.message}`)
@@ -130,6 +238,52 @@ function startDsh(port) {
   return child
 }
 
+/** dsh 意外退出后自动重启一次；二次退出则提示用户并放弃。 */
+function restartOwnedDsh(port, exitCode) {
+  if (didAutoRestartDsh) {
+    log('dsh crashed again after auto-restart; giving up')
+    const logFile = path.join(app.getPath('userData'), 'dsh.log')
+    dialog.showMessageBox(mainWindow || undefined, {
+      type: 'error',
+      title: 'dsh 服务异常',
+      message: 'dsh 服务启动后再次退出，已停止自动重启。',
+      detail: `退出码：${exitCode ?? '未知'}\n\n日志文件：${logFile}\n\n请查看日志定位问题，或手动在终端运行 dsh web 排查。`,
+      buttons: ['打开日志目录', '知道了'],
+      noLink: true,
+    }).then(({ response }) => {
+      if (response === 0) shell.showItemInFolder(logFile)
+    })
+    return
+  }
+  log(`dsh exited unexpectedly (code=${exitCode}); restarting in 3s…`)
+  didAutoRestartDsh = true
+  setTimeout(() => {
+    if (isQuitting) return
+    // 重启前再确认端口没有被外部服务接管（避免重复启动）
+    probe(port).then((up) => {
+      if (up) {
+        log('port already serving after crash; not restarting')
+        return
+      }
+      const child = startDsh(port)
+      ownedDsh = child
+      // 等它就绪；若起不来则等 exit 回调里的二次提示
+      waitForServer(port, START_TIMEOUT_MS).then((ready) => {
+        if (ready) {
+          log('dsh auto-restarted successfully')
+          dialog.showMessageBox(mainWindow || undefined, {
+            type: 'info',
+            title: 'dsh 已自动重启',
+            message: 'dsh 服务意外退出，已自动恢复。',
+            buttons: ['好'],
+            noLink: true,
+          }).catch(() => {})
+        }
+      })
+    })
+  }, 3000)
+}
+
 /** 杀掉进程树（Windows 用 taskkill /T 覆盖子孙进程），带超时兜底。 */
 function killProcessTree(pid) {
   return new Promise((resolve) => {
@@ -147,6 +301,7 @@ async function shutdownOwnedDsh() {
   if (ownedDsh && ownedDsh.pid) {
     const pid = ownedDsh.pid
     ownedDsh = null
+    isShuttingDownDsh = true
     await killProcessTree(pid)
     log(`killed owned dsh pid ${pid}`)
   }
@@ -487,12 +642,15 @@ function onShotDone(rect) {
   }
   const cropped = image.crop(r)
   shotLog('shot: cropped', cropped.getSize().width + 'x' + cropped.getSize().height)
-  // 保存一份临时文件（验证/诊断用）
+  // 保存到 ~/.dsh/screenshots/（持久保存，方便回顾；同时写剪贴板）
   try {
-    fs.writeFileSync(path.join(os.tmpdir(), 'dsh-screenshot.png'), cropped.toPNG())
-    shotLog('shot: saved temp png')
+    const dir = path.join(os.homedir(), '.dsh', 'screenshots')
+    fs.mkdirSync(dir, { recursive: true })
+    const file = path.join(dir, `shot-${new Date().toISOString().replace(/[:.]/g, '-')}.png`)
+    fs.writeFileSync(file, cropped.toPNG())
+    shotLog('shot: saved', file)
   } catch (e) {
-    shotLog('shot: temp save failed', String(e && e.message || e))
+    shotLog('shot: save failed', String(e && e.message || e))
   }
   clipboard.writeImage(cropped)
   shotLog('shot: written to clipboard')
@@ -539,6 +697,15 @@ function createTray() {
     Menu.buildFromTemplate([
       { label: '显示主窗口', click: showMainWindow },
       { type: 'separator' },
+      {
+        label: '打开截图目录',
+        click: () => {
+          const dir = path.join(os.homedir(), '.dsh', 'screenshots')
+          fs.mkdirSync(dir, { recursive: true })
+          shell.openPath(dir)
+        },
+      },
+      { type: 'separator' },
       {
         label: '退出',
         click: () => {
@@ -675,6 +842,8 @@ if (!gotLock) {
     createWindow(`http://127.0.0.1:${port}`)
     createTray()
     createApplicationMenu()
+    // 自动更新检查：不阻塞启动，静默失败
+    checkForUpdates()
     // preload 注入的悬浮刷新按钮 → 重新加载页面
     ipcMain.on('dsh-desktop:reload', () => {
       if (mainWindow) mainWindow.webContents.reload()