Oissp/dsh-desktop

DSH Desktop

DSH Desktop 是 DeepSeek Harness 的桌面客户端（Debian / macOS）。应用内置 dsh 引擎，启动后直接加载官方 Web UI；Electron 负责本地运行时、凭证保护、托盘、自动更新和桌面扩展。

非 DeepSeek 官方产品，与 DeepSeek 无附属关系。

功能

- 内置 dsh 引擎，首次初始化后可直接使用
- 官方 Web UI，支持流式回复、思考过程、工作区、模型和会话管理
- 首启向导配置工作区与模型凭证；引擎崩溃进入恢复模式，可回滚配置快照重启
- 归档会话查看（官方插件面板 plugins/dsh-desktop-archived，标题由桌面侧快照兜底）
- 凭证通过 Electron safeStorage 加密保存；启用 CSP、导航限制和单实例锁
- 崩溃环检测 + 配置快照恢复、落盘日志
- 托盘常驻、后台更新检查和下载后安装
- 发布 Debian 13 / amd64 .deb 与 macOS（arm64）.dmg / .zip 安装包

安装

从项目的 GitHub Releases 下载对应平台的安装包：

- Debian 13 / amd64：dsh-desktop__amd64.deb，然后执行：

sudo apt install ./dsh-desktop__amd64.deb

- macOS（arm64 / Apple Silicon）：dsh-desktop--arm64.dmg，打开后把应用拖入 Applications。

首次启动会初始化 dsh Web profile，时间取决于本机网络与依赖缓存。随后在首启向导中配置模型凭证。

开发

要求：Node.js >=22.19.0、pnpm >=9。项目使用 pnpm 11；推荐通过 Corepack 管理。

corepack enable
pnpm install
pnpm dev

常用命令：

pnpm typecheck       # 检查 renderer 与 Electron 两个 TypeScript 项目
pnpm test            # 运行 Vitest
pnpm build           # 构建 renderer 与 Electron 主进程
pnpm dist            # 构建 Debian amd64 .deb 到 out/
pnpm dist:mac        # 构建 macOS dmg + zip 到 out/（需在 macOS 上执行）

pnpm dev 会启动 Vite（5173）与 Electron。正式应用界面由本地 dsh Web 服务提供；Vite 页面用于启动、首启向导和引擎故障回退。

架构

React fallback UI (src/) -> preload -> IPC -> Electron main -> adapter -> dsh web engine

- adapter/：dsh Typert Remote 协议适配（HTTP RPC + WebSocket mux）与事件归一化
- shared/：renderer 与主进程共享的稳定类型和 IPC 契约
- electron/：引擎生命周期、IPC、凭证、profile、托盘、更新和桌面桥接
- src/：React 回退 UI（启动、首启向导、恢复页与引擎就绪过渡占位）
- plugins/：注入官方引擎 UI 的伴随插件（归档会话面板）
- scripts/：打包钩子、校验脚本、原生模块定义

License

MIT