原生桌面客户端mel0nyrame/deepseek-harness-desktop

DSH Desktop

deepseek-harness-desktop 将 DeepSeek Harness 打包为原生 Electron 应用 DSH Desktop。桌面外壳是本项目专属的产品层；内置 dsh 运行时继续保留插件系统、Session、工具、PTY、持久化、CLI 身份与文档术语。

使用隔离临时配置与预制会话，从已安装 macOS 应用包捕获的原生窗口，并以中性背景呈现。

原生 macOS 体验

紧凑原生框架内容铺满窗口，控件与红绿灯区域自然衔接，并保留原生拖动与全屏行为。

会记住偏好的玻璃侧栏浅色、深色与跟随系统外观匹配 macOS；玻璃偏好可以持久化，并兼容“减少透明度”的不透明回退。

零宽专注模式完全收起侧栏，让会话占满窗口宽度；再次展开时恢复上次可用的侧栏宽度。

桌面外壳，完整 harness

内置运行时安装后的应用会启动自己的应用级 DSH 子进程，不要求系统提供 Node.js，也不要求另行安装 DSH CLI。
私有桌面载体沙箱化 renderer 通过上下文隔离的 preload 桥和经过校验的 IPC 访问 DSH；desktop profile 不会打开面向浏览器的 HTTP 监听。

原生 macOS 外壳Electron main 持有目录选择、路径打开、紧凑窗口框架与原生拖动、恢复和进程树清理；侧栏使用已保存的玻璃侧栏偏好。
共享 DSH 状态DSH Desktop 与 CLI 使用同一个 ~/.dsh 主目录，因此两者都能访问 Session、profile 与配置。

工作原理

React 客户端继续使用与 Web 产品相同、与传输无关的 Connection 接口。Electron main 持有原生窗口并监管一个专用 DSH 子进程；该子进程持有 Cordis、Session、插件、模型执行、PTY、持久化与子进程。

解耦前的载体与生命周期约定仍可在冻结的旧版桌面参考中查阅。当前外壳与桌面 Provider 约定位于 apps/desktop 和 packages/。

安装

Homebrew（推荐）

brew tap mel0nyrame/dsh
brew install --cask dsh-desktop

Cask 会为当前 Mac 选择 arm64 或 x64 构建，并在安装后移除隔离属性。稳定版发布后会自动更新 Cask；预发布版仅在 GitHub 提供。

GitHub Releases

从 GitHub Releases 下载适合当前 Mac 的 DMG（Apple 芯片选择 arm64，Intel 选择 x64），使用相邻的 .sha256 文件校验后，将 DSH Desktop 拖入“应用程序”。

发行 DMG 使用 ad-hoc 签名且未经公证。因此，直接下载 DMG 后可能需要在 macOS 上执行一次右键 → 打开；通过 Homebrew 安装时，Cask 会完成相应的隔离属性处理。

从源码启动

在当前仓库 checkout 中运行：

pnpm install
pnpm run check

运行 pnpm run package 可构建可安装且经过 ad-hoc 签名的应用与 DMG。
该命令会装配精确的已发布运行时、在 Electron 下验证原生 addon、校验应用身份与嵌入式运行时，并把产物写入 apps/desktop/dist/。运行
DSH_DESKTOP_PACKAGE_REQUIRED=1 pnpm run test:package 可执行安装态产品门禁。

项目边界

- DSH Desktop 外壳 — Electron 外壳角色及其边界。
- 桌面产品包 — @dsh-desktop/* 的归属与依赖方向规则。
- 冻结的解耦前 monorepo — 仅供历史对比与恢复。
- 冻结的旧版桌面参考 — 解耦前发布的 Electron 架构、安全、生命周期、打包、验收与限制。
- 固定的上游源码 — dsh-v0.1.0-rc.8 处锁定的官方 DeepSeek Harness 源码，仅用于源码检视与兼容性工作。
- 上游仓库 — 本桌面仓库直接基于的原始 DeepSeek Harness 项目。

状态与分发

- 仓库与应用仍在积极开发中，未来仍可能出现破坏兼容性的变更。
- 产品发行版分别提供 arm64 与 x64 macOS DMG，并附带 SHA-256 校验文件。
- 尚未配置 Developer ID 签名与公证；直接下载时可能需要执行上文所述的一次性右键 → 打开。再次分发产物前请阅读旧版桌面限制。

开发

CI 按变更风险分级：普通 pull request 运行快速工作区检查（.github/workflows/ci.yml），打包相关输入运行 macOS 打包门禁（.github/workflows/packaging.yml），带 release 标签的 pull request、版本标签或手动触发运行 arm64/x64 release 证据工作流（.github/workflows/release.yml）。以本分支为默认分支所需的晋升证据、受保护的手动真实 API 验收命令与晋升清单见 docs/promotion/promotion.md。

内核贡献流程以 AGENTS.md 为准；冻结的开发指南与 CONTRIBUTING.md 记录了解耦前的贡献流程。桌面端专属实现位于 apps/desktop 与桌面 Provider 包（packages/）中。

许可证

MIT

解耦前产品的第三方依赖及其许可证仍可在冻结的 THIRD_PARTY_NOTICES.md 中查阅。