DeepSeek Harness 插件

dsh-desktop-ahikl

A dsh desktop bundle: an Electron shell over the dsh Web UI with a system tray and a dsh-styled custom title bar.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
ahikl/dsh-desktop
最近更新
2026年8月16日
分类
插件开发工具
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/ahikl/dsh-desktop
插件名:dsh-desktop-ahikl
作者:ahikl

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.md来源说明 · 只读预览
README 语言

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](./LICENSE)