dsh-desktop

by ahikl

1 UI 增强github 检测到 manifest package.json#dsh收录于 08-16

DeepSeek Harness 桌面端插件：基于 Electron 的 dsh Web UI 桌面外壳。| An Electron desktop shell for the DeepSeek Harness Web UI, with a system tray and a custom title bar.

安装

$ dsh plugin --profile web add github:ahikl/dsh-desktop

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络，DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单，不构成兼容性或安全审查；安装前请审阅源码，不熟悉的插件先在不含密钥的环境试用。

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