rogerhorsley/dsh_for_mac

适用于 Mac 的 DSH

Build
License: MIT

一个面向 DeepSeek Harness 的一键式 macOS 桌面客户端。

Electron 外壳会在一个私有回环端口上启动官方的本地 dsh web 配置文件，并在一个加固的 BrowserWindow 中渲染它。因此，dsh 仍然是会话、工具、工作区、模型配置、插件安装以及配置文件补丁层的所有者。桌面客户端不会实现第二套插件系统。

下载

从 Releases 获取最新的 DSH--mac-.dmg。
在 Apple Silicon 上选择 arm64 构建，在 Intel Mac 上选择 universal 构建——或者在不确
定时选择后者，因为它可以在两种架构上原生运行，无需 Rosetta。About 面板会显示正在运行的二进制文件的架构。

开发

npm install
npm run dev

pnpm dev 会启动 Electron，并在首次使用时初始化 dsh 随附的 web 配置文件。所选工作目录默认为 macOS 用户的主目录；可从 DSH UI 中选择或添加工作区。

在开发本地检出的 DeepSeek Harness 时，可使用 DSH_CLI_PATH 代替已发布的启动器：

DSH_CLI_PATH=/absolute/path/to/deepseek-harness/apps/cli/lib/bin.js npm run dev

构建并打开编译后的桌面客户端：

npm start

创建 Apple Silicon 发行版（原生 ARM64，无 Rosetta）：

npm run package:mac:arm64

创建通用发行版（在 Apple Silicon 和 Intel 上均可原生运行）：

npm run package:mac:universal

产物命名为 DSH--mac-arm64 和 DSH--mac-universal。在 Apple Silicon 上优先使用 arm64 构建：通用构建在那里也能原生运行，但下载体积大约翻倍。About 面板会标识正在运行的二进制文件的架构，因此可以诊断不匹配的情况。

CI 工作流在 ARM64 macOS 运行器上运行：arm64 包为原生构建，而 universal 包为交叉编译并经 lipo 合并，因为 GitHub 已于 2025 年 12 月停用其免费的 Intel（macos-13）运行器。推送 v* 标签会构建这两个包，并将其 DMG 和 zip 产物发布到 GitHub Release；包含预发布后缀的标签（例如 v0.1.0-rc.1）会被标记为预发布版本。第一个包未签名。发行分发仍需要 Apple Developer 签名身份、公证、应用图标和更新源。

设计

使用 Electron 43 是因为其当前的启动改进保留了现有的 DSH React UI 和运行时加载的插件生态系统。渲染器没有 Node 集成；所有代理权限都保留在本地 dsh 进程中，BrowserWindow 仅加载其回环源。

贡献
有关开发环境设置以及如何提交更改，请参阅 CONTRIBUTING.md。请按照 SECURITY.md 私下报告安全问题。

许可证

本项目根据 MIT 许可证 授权。