@ahikl/dsh-desktop

Readme

# dsh-desktop

[English](README.en.md) | 简体中文

> DeepSeek Harness 桌面端插件：使用 Electron 包装 dsh Web UI，提供系统托盘与自定义标题栏。

## 简介

`dsh-desktop` 是一个 out-of-tree 桌面端插件，不修改 dsh 源码，也不把 Electron 引入 dsh 依赖树。

## 功能

- 使用 Electron 加载 dsh Web UI
- 无边框窗口 + dsh 风格标题栏，自动跟随主题
- 系统托盘：显示主窗口、打开浏览器、退出
- 关闭窗口时最小化到托盘
- URL 解析优先级：`--url` > Web Server 端口 > 自动启动 `dsh web`

## 工作原理

通过 `cordis.patch.yml` 挂载两个插件：

- **desktop-startup**：解析 `dsh desktop` 参数，提供 `webStartup` / `desktopStartup` 服务
- **desktop-runner**：等待树稳定后，解析 URL 和 Electron 路径；没有现成 Web UI 时自动启动 `dsh web`，再以子进程方式启动 Electron

## 使用
> `0.3.1` 及以下版本已废弃，请使用最新版。


```sh
dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop

dsh --profile desktop desktop --url http://127.0.0.1:3080
```

最简单的启动方式（没有安装 `dsh-web-app` 时，桌面插件会自动启动官方 Web UI）：

```sh
dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop
```

如果已经安装了 `dsh-web-app`，桌面插件会自动复用其 Web Server：

```sh
dsh plugin --profile desktop add @ahikl/dsh-desktop @deepseek-ai/dsh-web-app electron
dsh --profile desktop desktop
```

## 配置

```yaml
- id: desktop-runner
  config:
    url: https://example.com
    electronPath: /opt/electron/electron
    width: 1280
    height: 800
    electronArgs: ["--no-sandbox", "--disable-gpu"]
```

## 开发

```sh
pnpm install
pnpm run typecheck
pnpm run test        # 单元测试
pnpm run build       # 构建到 lib/
```

## 目录结构

```text
dsh-desktop/
├── cordis.patch.yml        # bundle patch
├── src/
│   ├── index.ts            # desktop-runner 插件
│   ├── launcher.ts         # Electron 解析与启动逻辑
│   └── startup.ts          # desktop-startup 插件
├── electron-main.cjs       # Electron 主进程
├── preload.cjs             # 自定义标题栏预加载脚本
├── dashboard.html          # 兜底页面
├── tests/                  # 单元测试
└── package.json
```

## 许可证

[MIT](./LICENSE)