ahikl / dsh-desktop

dsh-desktop

English | 简体中文

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 及以下版本已废弃，请使用最新版。

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）：

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

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

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

配置

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

开发

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

目录结构

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