dsh-clean-desktop-shell 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Icather
-
-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.
+MIT License
+
+Copyright (c) 2026 Icather
+
+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

@@ -1,91 +1,91 @@
-<div align="center">
-
-# dsh-clean-desktop-shell
-
-**A clean desktop shell for DeepSeek Harness, shipped as a DSH plugin**
-
-Does exactly one thing: wraps your already-configured DSH Web in a clean native desktop window — system tray, single instance, auto-launch, just like a normal app. No frosted glass, no fancy materials. **Clean.**
-
-[English](README.en.md) · [中文](README.md)
-
-[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-0078D6?logo=windows&logoColor=white)](https://github.com/Icather/dsh-clean-desktop-shell)
-[![License](https://img.shields.io/badge/License-MIT-22c55e)](LICENSE)
-[![Release](https://img.shields.io/github/v/release/Icather/dsh-clean-desktop-shell?color=blue)](https://github.com/Icather/dsh-clean-desktop-shell/releases/latest)
-[![DSH](https://img.shields.io/badge/DeepSeek_Harness-rc.7-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
-
-</div>
-
-## What is this
-
-`dsh-clean-desktop-shell` is a **DSH-plugin-shaped clean desktop shell**: it wraps an already-running DSH Web (default `http://127.0.0.1:3080`) in a native desktop window — system tray, single instance, auto-launch, so it behaves like any normal desktop app. **No visual changes at all**: no frosted glass, no skinning — purely a window shell.
-
-Key differences from other desktop clients in the ecosystem:
-
-| | Other desktop clients (e.g. dsh-desktop family) | This plugin |
-|:--|:--|:--|
-| **Form** | Standalone Electron app with its own profile | **DSH plugin** mounted into your existing profile |
-| **Profile** | New `desktop` profile, plugins/config must be reinstalled | **Reuses your web profile**, zero migration |
-| **Visual changes** | Custom title bar / frosted glass etc. | **None** — pure window shell |
-| **Upstream** | Pinned version | **Tracks rc.7** |
-
-## Architecture
-
-```
-        ┌─────────────────── Core (dsh web / headless service) ───────────────────┐
-        │  Sessions · Agent · Plugins · Memory live here, decoupled from UI       │
-        └─────────────────────────────────────────────────────────────────────────┘
-                              ▲
-              ┌───────────────┴───────────────┐
-              │   dsh-clean-desktop-shell      │
-              │   Electron shell (client)      │
-              │   tray · single-instance ·     │
-              │   auto-launch                  │
-              └────────────────────────────────┘
-```
-
-- **Default**: loads the local `127.0.0.1:3080` (your configured web profile, zero migration).
-- **Remote-capable**: configure any remote DSH address; the shell is just a window. Phones / Linux / other devices can reach the core via browser or PWA — the shell is never bound to a local service.
-
-### Platform matrix
-
-| Platform | Shell | Status |
-|:--|:--|:--|
-| Windows | ✅ Electron (frameless + native window buttons) | First release target |
-| macOS | ✅ Electron (hiddenInset) | Planned |
-| Linux | — (browser / PWA to the core) | Not planned |
-| Termux / phone / tablet | — (headless / PWA to the core) | Covered by remote core access |
-
-## Install
-
-```sh
-dsh plugin --profile web add dsh-clean-desktop-shell
-```
-
-Restart `dsh web`, then launch the shell from the tray / shortcut.
-
-> The shell needs a reachable `dsh web` service (local or configured remote address). See Usage.
-
-## Usage
-
-1. Start `dsh web` (or configure a remote service address).
-2. Launch the shell: it auto-detects local 3080; if not running it starts the service per configuration.
-3. Drag the window by its top area (right side reserved for native buttons); close minimizes to tray by default.
-
-## Development
-
-```sh
-npm install
-npm run build   # build the plugin bundle
-npm run dev     # launch the shell (dev mode)
-npm run pack    # package NSIS (Win) / DMG (mac)
-```
-
-## Changelog
-
-### 0.1.0
-- Initial release: Electron shell skeleton, system tray / single instance / auto-launch, DSH plugin mounting.
-
-## Credits
-
-- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — the core.
-- Architecture inspired by [Hermes Agent Desktop](https://github.com/NousResearch/hermes-agent)'s shell/core separation.
+<div align="center">
+
+# dsh-clean-desktop-shell
+
+**A clean desktop shell for DeepSeek Harness, shipped as a DSH plugin**
+
+Does exactly one thing: wraps your already-configured DSH Web in a clean native desktop window — system tray, single instance, auto-launch, just like a normal app. No frosted glass, no fancy materials. **Clean.**
+
+[English](README.en.md) · [中文](README.md)
+
+[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-0078D6?logo=windows&logoColor=white)](https://github.com/Icather/dsh-clean-desktop-shell)
+[![License](https://img.shields.io/badge/License-MIT-22c55e)](LICENSE)
+[![Release](https://img.shields.io/github/v/release/Icather/dsh-clean-desktop-shell?color=blue)](https://github.com/Icather/dsh-clean-desktop-shell/releases/latest)
+[![DSH](https://img.shields.io/badge/DeepSeek_Harness-rc.7-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
+
+</div>
+
+## What is this
+
+`dsh-clean-desktop-shell` is a **DSH-plugin-shaped clean desktop shell**: it wraps an already-running DSH Web (default `http://127.0.0.1:3080`) in a native desktop window — system tray, single instance, auto-launch, so it behaves like any normal desktop app. **No visual changes at all**: no frosted glass, no skinning — purely a window shell.
+
+Key differences from other desktop clients in the ecosystem:
+
+| | Other desktop clients (e.g. dsh-desktop family) | This plugin |
+|:--|:--|:--|
+| **Form** | Standalone Electron app with its own profile | **DSH plugin** mounted into your existing profile |
+| **Profile** | New `desktop` profile, plugins/config must be reinstalled | **Reuses your web profile**, zero migration |
+| **Visual changes** | Custom title bar / frosted glass etc. | **None** — pure window shell |
+| **Upstream** | Pinned version | **Tracks rc.7** |
+
+## Architecture
+
+```
+        ┌─────────────────── Core (dsh web / headless service) ───────────────────┐
+        │  Sessions · Agent · Plugins · Memory live here, decoupled from UI       │
+        └─────────────────────────────────────────────────────────────────────────┘
+                              ▲
+              ┌───────────────┴───────────────┐
+              │   dsh-clean-desktop-shell      │
+              │   Electron shell (client)      │
+              │   tray · single-instance ·     │
+              │   auto-launch                  │
+              └────────────────────────────────┘
+```
+
+- **Default**: loads the local `127.0.0.1:3080` (your configured web profile, zero migration).
+- **Remote-capable**: configure any remote DSH address; the shell is just a window. Phones / Linux / other devices can reach the core via browser or PWA — the shell is never bound to a local service.
+
+### Platform matrix
+
+| Platform | Shell | Status |
+|:--|:--|:--|
+| Windows | ✅ Electron (frameless + native window buttons) | First release target |
+| macOS | ✅ Electron (hiddenInset) | Planned |
+| Linux | — (browser / PWA to the core) | Not planned |
+| Termux / phone / tablet | — (headless / PWA to the core) | Covered by remote core access |
+
+## Install
+
+```sh
+dsh plugin --profile web add dsh-clean-desktop-shell
+```
+
+Restart `dsh web`, then launch the shell from the tray / shortcut.
+
+> The shell needs a reachable `dsh web` service (local or configured remote address). See Usage.
+
+## Usage
+
+1. Start `dsh web` (or configure a remote service address).
+2. Launch the shell: it auto-detects local 3080; if not running it starts the service per configuration.
+3. Drag the window by its top area (right side reserved for native buttons); close minimizes to tray by default.
+
+## Development
+
+```sh
+npm install
+npm run build   # build the plugin bundle
+npm run dev     # launch the shell (dev mode)
+npm run pack    # package NSIS (Win) / DMG (mac)
+```
+
+## Changelog
+
+### 0.1.0
+- Initial release: Electron shell skeleton, system tray / single instance / auto-launch, DSH plugin mounting.
+
+## Credits
+
+- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — the core.
+- Architecture inspired by [Hermes Agent Desktop](https://github.com/NousResearch/hermes-agent)'s shell/core separation.

package/README.md

@@ -1,90 +1,90 @@
-<div align="center">
-
-# dsh-clean-desktop-shell
-
-**DeepSeek Harness 的纯净桌面壳（DSH 插件形态）**
-
-只做一件事：给已配置好的 DSH Web 加一层干净的桌面窗口——系统托盘、单实例、开机自启、像普通软件一样用。无毛玻璃、无花哨材质，**纯净**。
-
-[English](README.en.md) · [中文](README.md)
-
-[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-0078D6?logo=windows&logoColor=white)](https://github.com/Icather/dsh-clean-desktop-shell)
-[![License](https://img.shields.io/badge/License-MIT-22c55e)](LICENSE)
-[![Release](https://img.shields.io/github/v/release/Icather/dsh-clean-desktop-shell?color=blue)](https://github.com/Icather/dsh-clean-desktop-shell/releases/latest)
-[![DSH](https://img.shields.io/badge/DeepSeek_Harness-rc.7-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
-
-</div>
-
-## 这是什么
-
-`dsh-clean-desktop-shell` 是一个 **DSH 插件形态** 的纯净桌面壳：它给已经跑起来的 DSH Web（默认 `http://127.0.0.1:3080`）套一层原生桌面窗口——系统托盘、单实例、开机自启，像普通桌面软件一样使用。**不做任何视觉改造**：不加毛玻璃、不改界面，纯粹是"窗口壳"。
-
-与生态里其他桌面端方案的最大区别：
-
-| | 其他桌面端（如 dsh-desktop 系列） | 本插件 |
-|:--|:--|:--|
-| **形态** | 独立 Electron 应用，自带独立 profile | **DSH 插件**，挂载进现有 profile |
-| **Profile** | 新建 desktop profile，插件/配置要重装 | **复用现有 web profile**，零迁移 |
-| **视觉改造** | 自绘标题栏 / 毛玻璃等 | **零改造**，纯净窗口壳 |
-| **跟随上游** | 固定版本 | **跟随 rc.7** |
-
-## 架构
-
-```
-        ┌──────────────────── 内核（dsh web / headless 服务） ────────────────────┐
-        │  会话 · Agent · 插件 · 记忆 都在这层，与界面解耦                          │
-        └─────────────────────────────────────────────────────────────────────────┘
-                              ▲
-              ┌───────────────┴───────────────┐
-              │   dsh-clean-desktop-shell      │
-              │   Electron 壳（客户端）          │
-              │   托盘 · 单实例 · 开机自启       │
-              └────────────────────────────────┘
-```
-
-- **默认**：加载本地 `127.0.0.1:3080`（已配置好的 web profile，零迁移）。
-- **可配远程**：在设置里填入任意远程 DSH 地址，壳只当窗口——手机 / Linux / 其他设备通过浏览器或 PWA 也能接入内核，壳本身不绑定本地服务。
-
-### 平台矩阵
-
-| 平台 | 壳 | 状态 |
-|:--|:--|:--|
-| Windows | ✅ Electron（无边框 + 原生窗口按钮） | 首发目标 |
-| macOS | ✅ Electron（hiddenInset） | 规划中 |
-| Linux | —（浏览器 / PWA 直连内核） | 不做 |
-| Termux / 手机 / 平板 | —（headless / PWA 直连内核） | 由内核远程访问支持 |
-
-## 安装
-
-```sh
-dsh plugin --profile web add dsh-clean-desktop-shell
-```
-
-重启 `dsh web` 后，从系统托盘/快捷方式启动桌面壳即可。
-
-> 桌面壳需要本机有可用的 `dsh web` 服务（或配置的远程地址）。见下方「使用」。
-
-## 使用
-
-1. 启动 `dsh web`（或配置远程服务地址）。
-2. 启动桌面壳：自动检测本地 3080；未运行时按配置拉起服务。
-3. 窗口顶部（右侧留系统按钮）可拖动窗口；关闭默认缩到托盘。
-
-## 开发
-
-```sh
-npm install
-npm run build   # 构建插件 bundle
-npm run dev     # 启动壳（开发模式）
-npm run pack    # 打包 NSIS (Win) / DMG (mac)
-```
-
-## 更新历史
-
-### 0.1.0
-- 初始版本：Electron 壳骨架，系统托盘/单实例/开机自启，DSH 插件挂载。
-
-## 致谢
-
-- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) —— 内核本体。
-- 架构参考 [Hermes Agent Desktop](https://github.com/NousResearch/hermes-agent) 的壳/内核分离设计。
+<div align="center">
+
+# dsh-clean-desktop-shell
+
+**DeepSeek Harness 的纯净桌面壳（DSH 插件形态）**
+
+只做一件事：给已配置好的 DSH Web 加一层干净的桌面窗口——系统托盘、单实例、开机自启、像普通软件一样用。无毛玻璃、无花哨材质，**纯净**。
+
+[English](README.en.md) · [中文](README.md)
+
+[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-0078D6?logo=windows&logoColor=white)](https://github.com/Icather/dsh-clean-desktop-shell)
+[![License](https://img.shields.io/badge/License-MIT-22c55e)](LICENSE)
+[![Release](https://img.shields.io/github/v/release/Icather/dsh-clean-desktop-shell?color=blue)](https://github.com/Icather/dsh-clean-desktop-shell/releases/latest)
+[![DSH](https://img.shields.io/badge/DeepSeek_Harness-rc.7-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
+
+</div>
+
+## 这是什么
+
+`dsh-clean-desktop-shell` 是一个 **DSH 插件形态** 的纯净桌面壳：它给已经跑起来的 DSH Web（默认 `http://127.0.0.1:3080`）套一层原生桌面窗口——系统托盘、单实例、开机自启，像普通桌面软件一样使用。**不做任何视觉改造**：不加毛玻璃、不改界面，纯粹是"窗口壳"。
+
+与生态里其他桌面端方案的最大区别：
+
+| | 其他桌面端（如 dsh-desktop 系列） | 本插件 |
+|:--|:--|:--|
+| **形态** | 独立 Electron 应用，自带独立 profile | **DSH 插件**，挂载进现有 profile |
+| **Profile** | 新建 desktop profile，插件/配置要重装 | **复用现有 web profile**，零迁移 |
+| **视觉改造** | 自绘标题栏 / 毛玻璃等 | **零改造**，纯净窗口壳 |
+| **跟随上游** | 固定版本 | **跟随 rc.7** |
+
+## 架构
+
+```
+        ┌──────────────────── 内核（dsh web / headless 服务） ────────────────────┐
+        │  会话 · Agent · 插件 · 记忆 都在这层，与界面解耦                          │
+        └─────────────────────────────────────────────────────────────────────────┘
+                              ▲
+              ┌───────────────┴───────────────┐
+              │   dsh-clean-desktop-shell      │
+              │   Electron 壳（客户端）          │
+              │   托盘 · 单实例 · 开机自启       │
+              └────────────────────────────────┘
+```
+
+- **默认**：加载本地 `127.0.0.1:3080`（已配置好的 web profile，零迁移）。
+- **可配远程**：在设置里填入任意远程 DSH 地址，壳只当窗口——手机 / Linux / 其他设备通过浏览器或 PWA 也能接入内核，壳本身不绑定本地服务。
+
+### 平台矩阵
+
+| 平台 | 壳 | 状态 |
+|:--|:--|:--|
+| Windows | ✅ Electron（无边框 + 原生窗口按钮） | 首发目标 |
+| macOS | ✅ Electron（hiddenInset） | 规划中 |
+| Linux | —（浏览器 / PWA 直连内核） | 不做 |
+| Termux / 手机 / 平板 | —（headless / PWA 直连内核） | 由内核远程访问支持 |
+
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-clean-desktop-shell
+```
+
+重启 `dsh web` 后，从系统托盘/快捷方式启动桌面壳即可。
+
+> 桌面壳需要本机有可用的 `dsh web` 服务（或配置的远程地址）。见下方「使用」。
+
+## 使用
+
+1. 启动 `dsh web`（或配置远程服务地址）。
+2. 启动桌面壳：自动检测本地 3080；未运行时按配置拉起服务。
+3. 窗口顶部（右侧留系统按钮）可拖动窗口；关闭默认缩到托盘。
+
+## 开发
+
+```sh
+npm install
+npm run build   # 构建插件 bundle
+npm run dev     # 启动壳（开发模式）
+npm run pack    # 打包 NSIS (Win) / DMG (mac)
+```
+
+## 更新历史
+
+### 0.1.0
+- 初始版本：Electron 壳骨架，系统托盘/单实例/开机自启，DSH 插件挂载。
+
+## 致谢
+
+- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) —— 内核本体。
+- 架构参考 [Hermes Agent Desktop](https://github.com/NousResearch/hermes-agent) 的壳/内核分离设计。

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh bundle patch: inserts this plugin into a profile's layer stack.
-- insert:
-    - id: clean-desktop-shell
-      name: 'dsh-clean-desktop-shell'
+# dsh bundle patch: inserts this plugin into a profile's layer stack.
+- insert:
+    - id: clean-desktop-shell
+      name: 'dsh-clean-desktop-shell'

package/electron/config.js

@@ -1,48 +1,48 @@
-/**
- * Shell config persistence (userData/config.json).
- *
- * Fields:
- *  - targetUrl:       default 'http://127.0.0.1:3080' — set to any remote
- *                     DSH address to run the shell as a pure window.
- *  - autoStartService: default true — only applies to the local default URL.
- *  - closeToTray:      default true.
- *  - windowMode:       'advanced' (mica/vibrancy) | 'compatibility'.
- *  - autoLaunch:       open at login.
- */
-import { app } from 'electron'
-import { readFileSync, writeFileSync, mkdirSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-
-const DEFAULTS = {
-  targetUrl: 'http://127.0.0.1:3080',
-  autoStartService: true,
-  closeToTray: true,
-  windowMode: 'advanced',
-  autoLaunch: false,
-  backendPath: null,
-}
-
-let cached = null
-
-function configPath() {
-  return join(app.getPath('userData'), 'config.json')
-}
-
-export function loadConfig() {
-  if (cached) return cached
-  try {
-    const raw = readFileSync(configPath(), 'utf8')
-    cached = { ...DEFAULTS, ...JSON.parse(raw) }
-  } catch {
-    cached = { ...DEFAULTS }
-  }
-  return cached
-}
-
-export function saveConfig(next) {
-  cached = { ...DEFAULTS, ...next }
-  const file = configPath()
-  mkdirSync(dirname(file), { recursive: true })
-  writeFileSync(file, JSON.stringify(cached, null, 2), 'utf8')
-  return cached
-}
+/**
+ * Shell config persistence (userData/config.json).
+ *
+ * Fields:
+ *  - targetUrl:       default 'http://127.0.0.1:3080' — set to any remote
+ *                     DSH address to run the shell as a pure window.
+ *  - autoStartService: default true — only applies to the local default URL.
+ *  - closeToTray:      default true.
+ *  - windowMode:       'advanced' (mica/vibrancy) | 'compatibility'.
+ *  - autoLaunch:       open at login.
+ */
+import { app } from 'electron'
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+
+const DEFAULTS = {
+  targetUrl: 'http://127.0.0.1:3080',
+  autoStartService: true,
+  closeToTray: true,
+  windowMode: 'advanced',
+  autoLaunch: false,
+  backendPath: null,
+}
+
+let cached = null
+
+function configPath() {
+  return join(app.getPath('userData'), 'config.json')
+}
+
+export function loadConfig() {
+  if (cached) return cached
+  try {
+    const raw = readFileSync(configPath(), 'utf8')
+    cached = { ...DEFAULTS, ...JSON.parse(raw) }
+  } catch {
+    cached = { ...DEFAULTS }
+  }
+  return cached
+}
+
+export function saveConfig(next) {
+  cached = { ...DEFAULTS, ...next }
+  const file = configPath()
+  mkdirSync(dirname(file), { recursive: true })
+  writeFileSync(file, JSON.stringify(cached, null, 2), 'utf8')
+  return cached
+}

package/electron/error.html

@@ -0,0 +1,113 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8" />
+  <meta http-equiv="Content-Security-Policy" content="default-src 'self'; style-src 'unsafe-inline'; script-src 'unsafe-inline'" />
+  <title>后端未连接</title>
+  <style>
+    html, body {
+      height: 100%;
+      margin: 0;
+      background: #10131A;
+      color: #9aa3b2;
+      font-family: system-ui, "Segoe UI", "Microsoft YaHei", sans-serif;
+      -webkit-user-select: none;
+      user-select: none;
+    }
+    .wrap {
+      height: 100%;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      gap: 10px;
+    }
+    .whale {
+      width: 72px;
+      height: 72px;
+      border-radius: 18px;
+      background: #1b2330;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 22px;
+      font-weight: 700;
+      letter-spacing: 0.5px;
+      color: #cdd3de;
+      filter: drop-shadow(0 8px 24px rgba(0, 0, 0, 0.45));
+    }
+    h2 {
+      margin: 0;
+      font-size: 17px;
+      font-weight: 600;
+      color: #e8eaf0;
+    }
+    p {
+      margin: 0;
+      font-size: 13px;
+    }
+    button {
+      padding: 9px 22px;
+      font-size: 13px;
+      color: #e8eaf0;
+      background: #232d3d;
+      border: 1px solid #33405a;
+      border-radius: 8px;
+      cursor: pointer;
+    }
+    button:hover { background: #2b3750; }
+    button:active { background: #202a3c; }
+    .actions {
+      display: flex;
+      gap: 10px;
+      margin-top: 4px;
+    }
+    .folder-btn {
+      margin-top: 2px;
+      padding: 4px 8px;
+      font-size: 12px;
+      color: #6b7686;
+      background: none;
+      border: none;
+      border-radius: 6px;
+      text-decoration: underline;
+    }
+    .folder-btn:hover { color: #9aa3b2; background: none; }
+    .hint {
+      font-size: 12px;
+      opacity: 0.55;
+    }
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <div class="whale">DSH</div>
+    <h2>后端未连接</h2>
+    <p>请启动 dsh 后端，或使用下方按钮</p>
+    <button id="retry">重新加载</button>
+    <div class="actions">
+      <button id="start">启动后端</button>
+      <button id="detect">自动探测后端</button>
+    </div>
+    <button id="folder" class="folder-btn">设置后端安装文件夹</button>
+    <p class="hint">后端启动后本窗口会自动刷新</p>
+  </div>
+  <script>
+    // Injected by preload (sandbox-safe). Falls back to a plain reload.
+    var api = window.shellAPI || {};
+    document.getElementById('retry').addEventListener('click', function () {
+      if (api.reload) api.reload();
+      else location.reload();
+    });
+    var startBtn = document.getElementById('start');
+    if (api.startBackend) startBtn.addEventListener('click', api.startBackend);
+    else startBtn.style.display = 'none';
+    var detectBtn = document.getElementById('detect');
+    if (api.detectBackend) detectBtn.addEventListener('click', api.detectBackend);
+    else detectBtn.style.display = 'none';
+    var folderBtn = document.getElementById('folder');
+    if (api.chooseBackendFolder) folderBtn.addEventListener('click', api.chooseBackendFolder);
+    else folderBtn.style.display = 'none';
+  </script>
+</body>
+</html>

package/electron/main.js

@@ -9,7 +9,7 @@
  * The main window is a pure shell — all backend controls live in the tray.
  */
 import { app, BrowserWindow } from 'electron'
-import { createMainWindow } from './window.js'
+import { createMainWindow, reloadWindow } from './window.js'
 import { createTray, refreshTrayMenu } from './tray.js'
 import { loadConfig, saveConfig } from './config.js'
 import { detect, start } from './service.js'
@@ -89,6 +89,11 @@ if (!gotLock) {
         saveConfig({ ...config, autoLaunch: enabled })
         app.setLoginItemSettings({ openAtLogin: enabled })
       },
+      onReload: () => {
+        if (mainWindow && !mainWindow.isDestroyed()) {
+          reloadWindow(mainWindow, loadConfig().targetUrl || 'http://127.0.0.1:3080')
+        }
+      },
       onQuit: () => {
         app.isQuitting = true
         app.quit()