dsh-clean-desktop-shell 0.1.0

package/LICENSE

@@ -0,0 +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.

package/README.en.md

@@ -0,0 +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.

package/README.md

@@ -0,0 +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) 的壳/内核分离设计。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# 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

@@ -0,0 +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
+}

package/electron/main.js

@@ -0,0 +1,117 @@
+/**
+ * dsh-clean-desktop-shell — Electron main process entry.
+ *
+ * Shell/core decoupling:
+ *  - default target: http://127.0.0.1:3080 (existing web profile, zero migration)
+ *  - configurable remote target (settings file)
+ *  - local backend auto-start on launch; full manual control from the tray
+ *
+ * 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 { createTray, refreshTrayMenu } from './tray.js'
+import { loadConfig, saveConfig } from './config.js'
+import { detect, start } from './service.js'
+
+const isMac = process.platform === 'darwin'
+
+// Windows: pin the AppUserModelId so the taskbar shows our whale icon
+// instead of the generic Electron icon.
+if (process.platform === 'win32') {
+  app.setAppUserModelId('com.icather.dsh-clean-desktop-shell')
+}
+
+/** Single instance: a second launch just focuses the existing window. */
+const gotLock = app.requestSingleInstanceLock()
+if (!gotLock) {
+  app.quit()
+} else {
+  let mainWindow = null
+  let tray = null
+
+  app.on('second-instance', () => {
+    if (mainWindow) {
+      if (mainWindow.isMinimized()) mainWindow.restore()
+      mainWindow.focus()
+    }
+  })
+
+  async function createWindow() {
+    const config = loadConfig()
+    const target = config.targetUrl || 'http://127.0.0.1:3080'
+
+    mainWindow = createMainWindow({ target })
+    mainWindow.on('closed', () => {
+      mainWindow = null
+    })
+    mainWindow.on('close', (event) => {
+      // Close hides to tray unless we are actually quitting.
+      if (!app.isQuitting && config.closeToTray !== false) {
+        event.preventDefault()
+        mainWindow?.hide()
+      }
+    })
+
+    return mainWindow
+  }
+
+  /** Launch-time backend bootstrap: detect, and auto-start when local. */
+  async function bootstrapBackend() {
+    const config = loadConfig()
+    const target = config.targetUrl || 'http://127.0.0.1:3080'
+    const isLocalDefault = target === 'http://127.0.0.1:3080'
+    if (!isLocalDefault || config.autoStartService === false) return
+
+    const url = await detect()
+    if (!url) {
+      // Not running — try to start it, but never block window opening.
+      try {
+        await start({ backendPath: config.backendPath })
+      } catch {
+        // Backend unavailable; window still opens, tray shows the error.
+      }
+    }
+    // Reflect the post-detect state in the tray menu.
+    refreshTrayMenu()
+  }
+
+  app.whenReady().then(async () => {
+    await createWindow()
+    tray = createTray({
+      onShow: () => {
+        if (!mainWindow) return createWindow()
+        mainWindow.show()
+        mainWindow.focus()
+      },
+      onToggleAutoStart: (enabled) => {
+        const config = loadConfig()
+        saveConfig({ ...config, autoLaunch: enabled })
+        app.setLoginItemSettings({ openAtLogin: enabled })
+      },
+      onQuit: () => {
+        app.isQuitting = true
+        app.quit()
+      },
+    })
+
+    // Backend bootstrap in background (never delays the window).
+    bootstrapBackend().catch(() => {})
+
+    app.on('activate', () => {
+      if (BrowserWindow.getAllWindows().length === 0) createWindow()
+      else mainWindow?.show()
+    })
+  })
+
+  app.on('window-all-closed', () => {
+    // Keep the app alive in the tray (like a normal desktop utility).
+    if (!isMac && !app.isQuitting) {
+      // do not quit — tray keeps running
+    }
+  })
+
+  app.on('before-quit', () => {
+    app.isQuitting = true
+  })
+}

package/electron/preload.js

@@ -0,0 +1,36 @@
+/**
+ * Preload: makes the frameless window draggable.
+ *
+ * A frameless window has no title bar, so dragging is provided by a
+ * `-webkit-app-region: drag` strip along the top of the loaded page.
+ * The right side is left for the native window-controls overlay.
+ *
+ * The strip is a transparent overlay, so it never changes page layout —
+ * but it sits above the page top edge, so page top-bar buttons can be
+ * reached by the strip being only 1px tall at the very edge... Instead we
+ * use a pragmatic height and rely on the page's own top padding for the
+ * DSH top bar area. Overlap is acceptable: the strip is click-through for
+ * everything except dragging (app-region drag areas swallow mouse events).
+ */
+window.addEventListener('DOMContentLoaded', () => {
+  const platform = process.platform
+  const isWin = platform === 'win32'
+  const dragHeight = isWin ? 32 : 28
+  // Width reserved for native window controls (Win caption buttons / mac
+  // traffic lights live at the top-right / top-left).
+  const rightReserve = isWin ? 138 : 80
+  const leftReserve = isWin ? 0 : 80
+
+  const strip = document.createElement('div')
+  strip.id = 'dsh-clean-shell-drag'
+  strip.style.cssText = `
+    position: fixed;
+    top: 0;
+    left: ${leftReserve}px;
+    right: ${rightReserve}px;
+    height: ${dragHeight}px;
+    -webkit-app-region: drag;
+    z-index: 2147483647;
+  `
+  document.body.appendChild(strip)
+})

package/electron/service.js

@@ -0,0 +1,281 @@
+/**
+ * Local dsh web backend supervision.
+ *
+ * The shell owns the lifecycle of the dsh backend from the tray:
+ *  - detect(): probe configured paths + default port
+ *  - start() / stop() / restart()
+ *  - status: 'running' | 'stopped' | 'starting' | 'error'
+ *
+ * Shell/core decoupling: when a remote target URL is configured, no local
+ * backend is ever touched — this module only manages the local dsh CLI.
+ */
+import { spawn } from 'node:child_process'
+import { access } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { loadConfig } from './config.js'
+
+const DEFAULT_PORT = 3080
+
+let child = null
+let currentStatus = 'stopped'
+let lastError = null
+let startResolver = null
+
+export function getStatus() {
+  return {
+    status: currentStatus,
+    port: DEFAULT_PORT,
+    url: `http://127.0.0.1:${DEFAULT_PORT}`,
+    error: lastError,
+    pid: child?.pid ?? null,
+  }
+}
+
+/** Simple HTTP probe — true when something responds on the port. */
+export async function probe(url, timeoutMs = 1500) {
+  try {
+    const controller = new AbortController()
+    const timer = setTimeout(() => controller.abort(), timeoutMs)
+    const res = await fetch(url, { signal: controller.signal, redirect: 'follow' })
+    clearTimeout(timer)
+    return res.status < 500
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Detect a reachable local dsh web service.
+ * Returns the URL when something already listens on the port,
+ * or null when the backend is down.
+ */
+export async function detect() {
+  const url = `http://127.0.0.1:${DEFAULT_PORT}`
+  const up = await probe(url)
+  if (up) {
+    currentStatus = 'running'
+    return url
+  }
+  currentStatus = 'stopped'
+  return null
+}
+
+/**
+ * Start the local dsh backend. Resolves once the service answers
+ * (or a spawned CLI prints its ready line). Throws on failure.
+ */
+export async function start({ backendPath } = {}) {
+  // Already up?
+  const up = await detect()
+  if (up) return up
+
+  // Backend path: explicit config → common locations → PATH.
+  const resolved = await resolveDshCommand(backendPath)
+  if (!resolved) {
+    lastError = '未找到 dsh 后端。请在托盘「设置后端文件夹」中指定 dsh CLI 所在目录。'
+    currentStatus = 'error'
+    throw new Error(lastError)
+  }
+
+  currentStatus = 'starting'
+  lastError = null
+  child = spawn(resolved.command, [...resolved.args, 'web'], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    windowsHide: true,
+    env: { ...process.env, ...(resolved.env || {}) },
+  })
+
+  child.on('error', (err) => {
+    lastError = err.message
+    currentStatus = 'error'
+    if (startResolver) {
+      startResolver.reject(new Error(lastError))
+      startResolver = null
+    }
+  })
+
+  child.on('exit', (code) => {
+    child = null
+    if (currentStatus === 'starting' && startResolver) {
+      lastError = `dsh 后端异常退出 (code ${code})`
+      currentStatus = 'error'
+      startResolver.reject(new Error(lastError))
+      startResolver = null
+    } else if (currentStatus !== 'stopped') {
+      currentStatus = 'stopped'
+    }
+  })
+
+  // Wait for the ready line with a timeout.
+  return await new Promise((resolve, reject) => {
+    startResolver = { resolve, reject }
+    let stdout = ''
+    let stderr = ''
+    const timer = setTimeout(() => {
+      child?.kill()
+      startResolver = null
+      lastError = 'dsh 后端启动超时（45s）'
+      currentStatus = 'error'
+      reject(new Error(lastError))
+    }, 45000)
+
+    const onData = () => {
+      const text = stdout + stderr
+      const m = text.match(/http:\/\/127\.0\.0\.1:(\d+)/)
+      if (m && startResolver) {
+        clearTimeout(timer)
+        currentStatus = 'running'
+        startResolver.resolve(`http://127.0.0.1:${m[1]}`)
+        startResolver = null
+      }
+    }
+    child.stdout.on('data', (d) => {
+      stdout += d.toString()
+      onData()
+    })
+    child.stderr.on('data', (d) => {
+      stderr += d.toString()
+      onData()
+    })
+  })
+}
+
+/** Stop the local backend (spawned by us). External instances are left alone. */
+export async function stop() {
+  if (!child) {
+    currentStatus = 'stopped'
+    return
+  }
+  const proc = child
+  child = null
+  currentStatus = 'stopped'
+  await new Promise((resolve) => {
+    proc.once('exit', resolve)
+    proc.kill()
+    setTimeout(resolve, 3000)
+  })
+}
+
+/** Restart the local backend. */
+export async function restart(options) {
+  await stop()
+  return await start(options)
+}
+
+/**
+ * Check whether a folder contains a usable dsh CLI.
+ * Returns the resolved executable path, or null.
+ */
+export async function findDshInFolder(folder) {
+  if (!folder) return null
+  const candidates = [
+    joinCmd(folder, 'dsh.cmd'),
+    joinCmd(folder, 'dsh'),
+    joinCmd(folder, 'bin', 'dsh.cmd'),
+    joinCmd(folder, 'node_modules', '.bin', 'dsh.cmd'),
+  ]
+  for (const c of candidates) {
+    if (await exists(c)) return c
+  }
+  return null
+}
+
+/**
+ * Auto-detect the dsh install folder (the folder that contains the dsh
+ * CLI), following the same resolution order used to start the backend:
+ * PATH → common Windows install locations. Returns the folder path or null.
+ */
+export async function detectInstallFolder() {
+  // 1) Explicit backend folder from config.
+  const cfgPath = getConfiguredBackendPath()
+  if (cfgPath) {
+    const found = await findDshInFolder(cfgPath)
+    if (found) return dirOf(found)
+  }
+
+  // 2) `dsh` on PATH → resolve where it actually lives.
+  const onPath = await commandPath('dsh')
+  if (onPath) return dirOf(onPath)
+
+  // 3) Common locations.
+  if (process.platform === 'win32') {
+    const candidates = [
+      'D:\\deepseek-harness\\prod\\node_modules\\.bin\\dsh.cmd',
+      `${process.env.USERPROFILE}\\AppData\\Roaming\\npm\\dsh.cmd`,
+    ]
+    for (const c of candidates) {
+      if (await exists(c)) return dirOf(c)
+    }
+  }
+  return null
+}
+
+/** Locate a usable dsh CLI. */
+async function resolveDshCommand(backendPath) {
+  // 1) Explicit backend folder from config — look for dsh(.cmd/.exe) inside.
+  if (backendPath) {
+    const found = await findDshInFolder(backendPath)
+    if (found) return { command: found, args: [] }
+  }
+
+  // 2) `dsh` on PATH
+  if (await commandExists('dsh')) return { command: 'dsh', args: [] }
+
+  // 3) Common locations (dev convenience).
+  if (process.platform === 'win32') {
+    const candidates = [
+      'D:\\deepseek-harness\\prod\\node_modules\\.bin\\dsh.cmd',
+      `${process.env.USERPROFILE}\\AppData\\Roaming\\npm\\dsh.cmd`,
+    ]
+    for (const c of candidates) {
+      if (await exists(c)) return { command: c, args: [] }
+    }
+  }
+  return null
+}
+
+function joinCmd(...parts) {
+  return parts.join(process.platform === 'win32' ? '\\' : '/')
+}
+
+function dirOf(p) {
+  return dirname(p)
+}
+
+function getConfiguredBackendPath() {
+  try {
+    return loadConfig().backendPath || null
+  } catch {
+    return null
+  }
+}
+
+/** Resolve a command on PATH to its absolute path (Windows: where.exe). */
+function commandPath(cmd) {
+  return new Promise((resolve) => {
+    const finder = process.platform === 'win32' ? 'where' : 'which'
+    const c = spawn(finder, [cmd], { windowsHide: true })
+    let out = ''
+    c.stdout.on('data', (d) => {
+      out += d.toString()
+    })
+    c.on('error', () => resolve(null))
+    c.on('exit', () => {
+      const line = out.split(/\r?\n/).map((s) => s.trim()).find(Boolean)
+      resolve(line || null)
+    })
+  })
+}
+
+function commandExists(cmd) {
+  return new Promise((resolve) => {
+    const finder = process.platform === 'win32' ? 'where' : 'which'
+    const c = spawn(finder, [cmd], { stdio: 'ignore', windowsHide: true })
+    c.on('error', () => resolve(false))
+    c.on('exit', (code) => resolve(code === 0))
+  })
+}
+
+function exists(p) {
+  return new Promise((resolve) => access(p, (err) => resolve(!err)))
+}

package/electron/tray.js

@@ -0,0 +1,183 @@
+/**
+ * System tray: window show/hide, backend management, auto-launch, quit.
+ *
+ * All backend controls live here (tray only) — the main window stays a
+ * pure shell with no backend chrome.
+ */
+import { Tray, Menu, dialog, nativeImage } from 'electron'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { loadConfig, saveConfig } from './config.js'
+import { getStatus, start, stop, restart, detect, findDshInFolder, detectInstallFolder } from './service.js'
+import { checkForUpdate, openRepo, openUrl } from './update.js'
+
+const trayIconPath = join(
+  fileURLToPath(new URL('.', import.meta.url)),
+  'assets',
+  process.platform === 'win32' ? 'tray-16.png' : 'tray-32.png',
+)
+
+let trayInstance = null
+let handlers = null
+
+export function createTray({ onShow, onToggleAutoStart, onQuit }) {
+  const icon = nativeImage.createFromPath(trayIconPath)
+
+  handlers = { onShow, onToggleAutoStart, onQuit }
+
+  trayInstance = new Tray(icon)
+  trayInstance.setToolTip('DSH Clean Desktop Shell')
+  trayInstance.on('click', onShow)
+
+  refreshTrayMenu()
+  return trayInstance
+}
+
+/** Rebuild the context menu (call after backend state changes). */
+export function refreshTrayMenu() {
+  if (!trayInstance || !handlers) return
+  const { onShow, onToggleAutoStart, onQuit } = handlers
+  const config = loadConfig()
+  const st = getStatus()
+  const label = statusLabel(st)
+
+  const menu = Menu.buildFromTemplate([
+    { label: '显示 / 打开窗口', click: onShow },
+    { type: 'separator' },
+    { label: `后端：${label}`, enabled: false },
+    {
+      label: '启动后端',
+      enabled: st.status !== 'running' && st.status !== 'starting',
+      click: async () => {
+        try {
+          await start({ backendPath: loadConfig().backendPath })
+        } catch (err) {
+          dialog.showErrorBox('后端启动失败', err.message)
+        }
+        refreshTrayMenu()
+      },
+    },
+    {
+      label: '重启后端',
+      enabled: st.status === 'running' || st.status === 'starting',
+      click: async () => {
+        try {
+          await restart({ backendPath: loadConfig().backendPath })
+        } catch (err) {
+          dialog.showErrorBox('后端重启失败', err.message)
+        }
+        refreshTrayMenu()
+      },
+    },
+    {
+      label: '关闭后端',
+      enabled: st.status === 'running' || st.status === 'starting',
+      click: async () => {
+        await stop()
+        refreshTrayMenu()
+      },
+    },
+    { type: 'separator' },
+    {
+      label: '自动探测后端',
+      click: async () => {
+        await detect()
+        refreshTrayMenu()
+      },
+    },
+    {
+      label: '设置后端安装文件夹…',
+      click: async () => {
+        // Default location: auto-detect the dsh install folder first.
+        const detected = await detectInstallFolder()
+        const defaultFolder = detected || config.backendPath || undefined
+        const result = await dialog.showOpenDialog({
+          title: '选择dsh后端安装文件夹，默认安装用自动探测',
+          buttonLabel: '选择此文件夹',
+          message: '默认安装用自动探测。可手动指定 dsh 后端安装文件夹（包含 dsh 可执行文件）。',
+          properties: ['openDirectory'],
+          defaultPath: defaultFolder,
+        })
+        if (!result.canceled && result.filePaths[0]) {
+          const folder = result.filePaths[0]
+          saveConfig({ ...loadConfig(), backendPath: folder })
+          const found = await findDshInFolder(folder)
+          if (found) {
+            dialog.showMessageBox({
+              type: 'info',
+              title: '后端安装文件夹已设置',
+              message: `已找到 dsh：\n${found}`,
+            })
+          } else {
+            dialog.showMessageBox({
+              type: 'warning',
+              title: '未在此文件夹找到 dsh',
+              message:
+                '此文件夹内未找到 dsh 可执行文件。已保存该路径，但启动后端时可能失败——\n' +
+                '请确认选择的是包含 dsh（dsh.cmd / bin/dsh.cmd / node_modules/.bin/dsh.cmd）的文件夹。',
+            })
+          }
+        }
+        refreshTrayMenu()
+      },
+    },
+    { type: 'separator' },
+    {
+      label: '检查更新…',
+      click: async () => {
+        const r = await checkForUpdate()
+        if (r.hasUpdate) {
+          const choice = dialog.showMessageBoxSync({
+            type: 'info',
+            title: '发现新版本',
+            message: `当前版本 ${r.current}，最新版本 ${r.latest}。`,
+            detail: '是否前往 GitHub Releases 页面下载？',
+            buttons: ['前往下载', '取消'],
+            defaultId: 0,
+            cancelId: 1,
+          })
+          if (choice === 0) openUrl(r.url)
+        } else if (r.latest) {
+          dialog.showMessageBoxSync({
+            type: 'info',
+            title: '已是最新版本',
+            message: `当前版本 ${r.current} 已是最新（${r.latest}）。`,
+          })
+        } else {
+          dialog.showMessageBoxSync({
+            type: 'warning',
+            title: '检查更新失败',
+            message: '无法连接 GitHub 检查更新，请检查网络后重试。',
+          })
+        }
+      },
+    },
+    {
+      label: '仓库主页',
+      click: () => openRepo(),
+    },
+    { type: 'separator' },
+    {
+      label: '开机自启',
+      type: 'checkbox',
+      checked: !!loadConfig().autoLaunch,
+      click: (item) => onToggleAutoStart(item.checked),
+    },
+    { type: 'separator' },
+    { label: '退出', click: onQuit },
+  ])
+  trayInstance.setContextMenu(menu)
+}
+
+function statusLabel(st) {
+  switch (st.status) {
+    case 'running':
+      return `运行中 (PID ${st.pid ?? '外部'})`
+    case 'starting':
+      return '启动中…'
+    case 'error':
+      return `错误：${st.error || '未知'}`
+    default:
+      return '未运行'
+  }
+}

package/electron/update.js

@@ -0,0 +1,74 @@
+/**
+ * Version check and repo links.
+ *
+ * Checks the latest GitHub release of dsh-clean-desktop-shell against the
+ * local app version (from app.getVersion()). Network failures are treated
+ * as "no update" — never block or error in the tray.
+ */
+import { app, shell } from 'electron'
+
+const REPO_URL = 'https://github.com/Icather/dsh-clean-desktop-shell'
+const RELEASES_API = 'https://api.github.com/repos/Icather/dsh-clean-desktop-shell/releases/latest'
+
+/** Parse "v1.2.3" / "1.2.3" → [1,2,3]; null when malformed. */
+function parseVersion(v) {
+  if (!v) return null
+  const m = String(v).replace(/^v/i, '').trim().match(/^(\d+)\.(\d+)\.(\d+)/)
+  return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null
+}
+
+/** True when a is strictly newer than b. */
+function isNewer(a, b) {
+  if (!a || !b) return false
+  for (let i = 0; i < 3; i++) {
+    if (a[i] !== b[i]) return a[i] > b[i]
+  }
+  return false
+}
+
+/**
+ * Check for a newer release.
+ * @returns {{ hasUpdate: boolean, latest?: string, current: string, url: string }}
+ */
+export async function checkForUpdate() {
+  const current = app.getVersion()
+  let latest = null
+  let tag = null
+  let url = REPO_URL
+
+  try {
+    const controller = new AbortController()
+    const timer = setTimeout(() => controller.abort(), 8000)
+    const res = await fetch(RELEASES_API, {
+      signal: controller.signal,
+      headers: { Accept: 'application/vnd.github+json' },
+    })
+    clearTimeout(timer)
+    if (res.ok) {
+      const data = await res.json()
+      tag = data.tag_name || null
+      latest = parseVersion(tag)
+      if (data.html_url) url = data.html_url
+    }
+  } catch {
+    // Network error — no update known.
+  }
+
+  const currentV = parseVersion(current)
+  return {
+    hasUpdate: isNewer(latest, currentV),
+    latest: tag,
+    current,
+    url,
+  }
+}
+
+/** Open the repository homepage in the default browser. */
+export function openRepo() {
+  shell.openExternal(REPO_URL)
+}
+
+/** Open an arbitrary URL in the default browser. */
+export function openUrl(url) {
+  shell.openExternal(url)
+}

package/electron/window.js

@@ -0,0 +1,69 @@
+/**
+ * Clean window creation — no frosted-glass materials.
+ *
+ * Pure shell philosophy: the window is a normal native frame with
+ * window-controls overlay (Win) / hiddenInset (mac), and nothing else.
+ * No Mica, no vibrancy — keep it clean.
+ */
+import { BrowserWindow } from 'electron'
+import { fileURLToPath } from 'node:url'
+import { join } from 'node:path'
+
+export const WINDOWS_TITLEBAR_HEIGHT = 32
+
+const PRELOAD_PATH = fileURLToPath(new URL('./preload.js', import.meta.url))
+// Black-whale app icon (matches the DSH web favicon).
+const ICON_PATH = fileURLToPath(new URL('../build/icon.png', import.meta.url))
+
+export function createMainWindow({ target }) {
+  const platform = process.platform
+  const isWin = platform === 'win32'
+  const isMac = platform === 'darwin'
+
+  const base = {
+    width: 1280,
+    height: 800,
+    minWidth: 760,
+    minHeight: 520,
+    show: false,
+    title: 'DeepSeek Harness',
+    backgroundColor: '#10131A',
+    icon: isWin ? ICON_PATH : undefined,
+    webPreferences: {
+      preload: PRELOAD_PATH,
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+      webSecurity: true,
+    },
+  }
+
+  let options = { ...base }
+
+  if (isMac) {
+    options = {
+      ...base,
+      titleBarStyle: 'hiddenInset',
+      trafficLightPosition: { x: 16, y: 16 },
+    }
+  } else if (isWin) {
+    options = {
+      ...base,
+      autoHideMenuBar: true,
+      titleBarStyle: 'hidden',
+      titleBarOverlay: {
+        color: '#00000000',
+        symbolColor: '#7f858f',
+        height: WINDOWS_TITLEBAR_HEIGHT,
+      },
+    }
+  }
+  // Linux / other: keep the native frame.
+
+  const win = new BrowserWindow(options)
+  win.loadURL(target)
+
+  win.once('ready-to-show', () => win.show())
+
+  return win
+}

package/lib/client.js

@@ -0,0 +1,10 @@
+/**
+ * dsh-clean-desktop-shell — client half (web browser bundle).
+ *
+ * Registers a settings row so the shell's target URL / material options
+ * are editable from Settings → General. This is a minimal placeholder:
+ * real UI wiring lands with the Electron shell work.
+ */
+export function apply() {
+  // placeholder: settings-row wiring arrives with the shell implementation
+}

package/lib/index.js

@@ -0,0 +1,13 @@
+/**
+ * dsh-clean-desktop-shell — host half (plugin loader entry).
+ *
+ * The desktop shell is an Electron client; the host half only registers
+ * the plugin so it mounts cleanly into a dsh profile and exposes its
+ * settings surface. Window material (Mica / vibrancy) lives in the
+ * Electron main process (see src/main/).
+ */
+export function apply(ctx) {
+  ctx.on('ready', () => {
+    ctx.logger.info('[clean-desktop-shell] mounted (host half)')
+  })
+}

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "dsh-clean-desktop-shell",
+  "version": "0.1.0",
+  "description": "Clean desktop shell for DeepSeek Harness (DSH) as a DSH plugin — reuses your web profile, tray/single-instance/auto-launch, zero visual changes. DSH 插件形态的纯净桌面壳：复用现有 web profile，托盘管理后端，零视觉改造。",
+  "type": "module",
+  "main": "lib/index.js",
+  "files": [
+    "lib/",
+    "electron/",
+    "src/",
+    "scripts/",
+    "build/icon.png",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "LICENSE",
+    "version.txt"
+  ],
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "check": "node --check lib/index.js",
+    "dev": "electron electron/main.js",
+    "icons": "node scripts/gen-icons.mjs",
+    "pack": "electron-builder --win nsis",
+    "pack:mac": "electron-builder --mac dmg"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-theme"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh": "*"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "electron": "^33.0.0",
+    "electron-builder": "^25.0.0",
+    "png-to-ico": "^3.0.2",
+    "sharp": "^0.35.3"
+  },
+  "build": {
+    "appId": "com.icather.dsh-clean-desktop-shell",
+    "productName": "DSH Clean Desktop Shell",
+    "asar": true,
+    "files": [
+      "electron/**/*",
+      "lib/**/*",
+      "src/**/*",
+      "build/icon.png",
+      "package.json",
+      "cordis.patch.yml"
+    ],
+    "extraMetadata": {
+      "main": "electron/main.js"
+    },
+    "win": {
+      "target": [
+        {
+          "target": "nsis",
+          "arch": [
+            "x64"
+          ]
+        }
+      ],
+      "icon": "build/icon.ico",
+      "signAndEditExecutable": false
+    },
+    "mac": {
+      "target": [
+        "dmg"
+      ],
+      "category": "public.app-category.developer-tools"
+    },
+    "nsis": {
+      "oneClick": false,
+      "allowToChangeInstallationDirectory": true,
+      "createDesktopShortcut": true,
+      "createStartMenuShortcut": true
+    }
+  },
+  "license": "MIT",
+  "allowScripts": {
+    "electron@33.4.11": true
+  }
+}

package/scripts/build.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// Minimal zero-dependency build: copies src → lib.
+// Real bundling (tsdown/vite) lands with the Electron shell work.
+import { cpSync, mkdirSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = dirname(dirname(fileURLToPath(import.meta.url)))
+mkdirSync(join(root, 'lib'), { recursive: true })
+cpSync(join(root, 'src', 'host', 'index.js'), join(root, 'lib', 'index.js'))
+cpSync(join(root, 'src', 'client', 'client.js'), join(root, 'lib', 'client.js'))
+console.log('[dsh-clean-desktop-shell] built lib/ from src/')

package/scripts/gen-icons.mjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * Generate app icons from the DSH favicon whale SVG.
+ *  - build/icon.png    256x256 (source for ICO and README)
+ *  - build/icon.ico    multi-size (16/24/32/48/64/128/256) for electron-builder win
+ *  - build/icon.icns   (mac; generated by electron-builder if missing — we emit a
+ *                       placeholder note; real icns needs mac tooling)
+ *  - electron/assets/tray.png 16x16 + 32x32 white-on-transparent for the tray
+ */
+import sharp from 'sharp'
+import pngToIco from 'png-to-ico'
+import { mkdirSync, writeFileSync, rmSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = dirname(dirname(fileURLToPath(import.meta.url)))
+const buildDir = join(root, 'build')
+const assetsDir = join(root, 'electron', 'assets')
+mkdirSync(buildDir, { recursive: true })
+mkdirSync(assetsDir, { recursive: true })
+
+const SVG = join(buildDir, 'favicon-source.svg')
+
+// Dark variant: white whale on transparent (for dark tray / dark backgrounds).
+const svgLight = `<svg xmlns="http://www.w3.org/2000/svg" width="50" height="50" viewBox="0 0 50 50">
+  <path d="M48.8354 10.0479C48.3232 9.79199 48.1025 10.2798 47.8032 10.5278C47.7007 10.6079 47.6143 10.7119 47.5273 10.8076C46.7793 11.624 45.9048 12.1597 44.7622 12.0957C43.0923 12 41.666 12.5356 40.4058 13.8398C40.1377 12.2319 39.2476 11.272 37.8926 10.6558C37.1836 10.3359 36.4668 10.0156 35.9702 9.31982C35.6235 8.82373 35.5293 8.27197 35.356 7.72754C35.2456 7.3999 35.1353 7.06396 34.7651 7.00781C34.3633 6.94385 34.2056 7.2876 34.0479 7.57568C33.418 8.75195 33.1733 10.0479 33.1973 11.3599C33.2524 14.312 34.4736 16.6641 36.8999 18.3359C37.1758 18.5278 37.2466 18.7197 37.1597 19C36.9946 19.5757 36.7974 20.1357 36.624 20.7119C36.5137 21.0801 36.3486 21.1597 35.9624 21C34.6309 20.4321 33.481 19.5918 32.4644 18.5757C30.7393 16.8721 29.1792 14.9917 27.2334 13.52C26.7764 13.1758 26.3193 12.856 25.8467 12.5518C23.8618 10.584 26.1069 8.96777 26.627 8.77588C27.1704 8.57568 26.8159 7.8877 25.0591 7.896C23.3022 7.90381 21.6953 8.50391 19.647 9.30371C19.3477 9.42383 19.0322 9.51172 18.7095 9.58398C16.8501 9.22363 14.9199 9.14355 12.9033 9.37598C9.10596 9.80762 6.07275 11.6396 3.84326 14.7681C1.16455 18.5278 0.53418 22.7998 1.30664 27.2559C2.11768 31.9521 4.46582 35.8398 8.07373 38.8799C11.8159 42.0322 16.1255 43.5762 21.041 43.2803C24.0269 43.104 27.3516 42.6963 31.1016 39.4561C32.0469 39.936 33.0396 40.1279 34.686 40.272C35.9546 40.3921 37.1758 40.208 38.1211 40.0078C39.6021 39.688 39.4995 38.2881 38.9639 38.0322C34.623 35.9678 35.5762 36.8081 34.71 36.1279C36.9155 33.4639 40.2402 30.6958 41.54 21.728C41.6426 21.0161 41.5557 20.5679 41.54 19.9917C41.5322 19.6396 41.6108 19.5039 42.0049 19.4639C43.0923 19.3359 44.1479 19.0317 45.1167 18.4878C47.9292 16.9199 49.064 14.3438 49.3315 11.2559C49.3711 10.7837 49.3237 10.2959 48.8354 10.0479ZM24.3262 37.8398C20.1196 34.4639 18.0791 33.3521 17.2358 33.3999C16.4482 33.4482 16.5898 34.3682 16.7632 34.9678C16.9443 35.5601 17.1812 35.9683 17.5117 36.4878C17.7402 36.832 17.8979 37.3442 17.2832 37.728C15.9282 38.584 13.5728 37.4399 13.4624 37.3838C10.7207 35.7358 8.42822 33.5601 6.81348 30.584C5.25342 27.7197 4.34766 24.6479 4.19775 21.3677C4.1582 20.5757 4.38672 20.2959 5.15869 20.1519C6.17529 19.96 7.22314 19.9199 8.23926 20.0718C12.5327 20.7119 16.1885 22.6719 19.2529 25.7759C21.002 27.5439 22.3252 29.6558 23.6885 31.7202C25.1377 33.9121 26.6978 36 28.6831 37.7119C29.3843 38.312 29.9434 38.7681 30.479 39.104C28.8643 39.2881 26.1699 39.3281 24.3262 37.8398ZM26.3433 24.6001C26.3433 24.248 26.6191 23.9678 26.9658 23.9678C27.0444 23.9678 27.1152 23.9839 27.1782 24.0078C27.2651 24.04 27.3438 24.0879 27.4067 24.1602C27.5171 24.272 27.5801 24.4321 27.5801 24.6001C27.5801 24.9521 27.3042 25.2319 26.9575 25.2319C26.6108 25.2319 26.3433 24.9521 26.3433 24.6001ZM32.6064 27.8799C32.2046 28.0479 31.8027 28.1919 31.4165 28.208C30.8179 28.2397 30.1641 27.9922 29.8096 27.688C29.2583 27.2158 28.8643 26.9521 28.6987 26.1279C28.6279 25.7759 28.6675 25.2319 28.7305 24.9199C28.8721 24.248 28.7144 23.8159 28.2495 23.4238C27.8716 23.104 27.3911 23.0161 26.8633 23.0161C26.666 23.0161 26.4849 22.9277 26.3511 22.856C26.1304 22.7441 25.9492 22.4639 26.1226 22.1201C26.1777 22.0078 26.4458 21.7358 26.5088 21.688C27.2256 21.272 28.0527 21.4077 28.8169 21.7197C29.5259 22.0161 30.0615 22.5601 30.834 23.3281C31.6216 24.2559 31.7632 24.5117 32.2124 25.208C32.5669 25.752 32.8901 26.312 33.1104 26.9521C33.2446 27.3521 33.0713 27.6802 32.6064 27.8799Z" fill="#fff" fill-opacity="1.000000" fill-rule="nonzero"/>
+</svg>`
+
+async function main() {
+  // 512px app icon (black whale — matches DSH dark theme). macOS requires
+  // >=512px for the app icon.
+  await sharp(SVG, { density: 300 })
+    .resize(512, 512, { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } })
+    .png()
+    .toFile(join(buildDir, 'icon.png'))
+
+  // Multi-size ICO — capped at 256: NSIS's installer icon loader rejects
+  // 512px frames ("invalid icon file size"), and Windows doesn't need them.
+  const sizes = [16, 24, 32, 48, 64, 128, 256]
+  const pngs = []
+  for (const s of sizes) {
+    const f = join(buildDir, `icon-${s}.png`)
+    await sharp(SVG, { density: 300 })
+      .resize(s, s, { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } })
+      .png()
+      .toFile(f)
+    pngs.push(f)
+  }
+  const ico = await pngToIco(pngs)
+  writeFileSync(join(buildDir, 'icon.ico'), ico)
+  for (const f of pngs) rmSync(f)
+
+  // Tray: white whale 16 and 32 (visible on dark tray).
+  for (const s of [16, 32]) {
+    await sharp(Buffer.from(svgLight), { density: 300 })
+      .resize(s, s, { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } })
+      .png()
+      .toFile(join(assetsDir, `tray-${s}.png`))
+  }
+
+  console.log('icons generated:')
+  console.log('  build/icon.png (512)')
+  console.log('  build/icon.ico (16..256, NSIS-safe)')
+  console.log('  electron/assets/tray-16.png, tray-32.png (white whale)')
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/src/client/client.js

@@ -0,0 +1,10 @@
+/**
+ * dsh-clean-desktop-shell — client half (web browser bundle).
+ *
+ * Registers a settings row so the shell's target URL / material options
+ * are editable from Settings → General. This is a minimal placeholder:
+ * real UI wiring lands with the Electron shell work.
+ */
+export function apply() {
+  // placeholder: settings-row wiring arrives with the shell implementation
+}

package/src/host/index.js

@@ -0,0 +1,13 @@
+/**
+ * dsh-clean-desktop-shell — host half (plugin loader entry).
+ *
+ * The desktop shell is an Electron client; the host half only registers
+ * the plugin so it mounts cleanly into a dsh profile and exposes its
+ * settings surface. Window material (Mica / vibrancy) lives in the
+ * Electron main process (see src/main/).
+ */
+export function apply(ctx) {
+  ctx.on('ready', () => {
+    ctx.logger.info('[clean-desktop-shell] mounted (host half)')
+  })
+}

package/version.txt

@@ -0,0 +1 @@
+0.1.0