hpyer/dsh-for-mac

DshForMac

DshForMac（DeepSeek Harness for Mac） 是 DeepSeek Harness（DSH） 的原生 macOS 启动器与本地容器。它负责检测本机 Node.js、下载和管理经过校验的 DSH 版本、启动本地 DSH Web 服务，并在应用窗口中显示 DSH 界面。

它不是 DSH 的分叉实现，不会重定向 DSH 的用户数据，也不会修改全局 npm、pnpm、Node.js 或 shell 配置。

项目初衷：网上其实有很多Mac桌面端了，但是基本都要求最新的系统或者支持到14/15系统就算好的了，但我觉得应该还是有部分用户仍在使用旧系统（包括我还有台13系统的）。所以，只要你电脑能装dsh必须的22.19或24以上版本的nodejs，那么你就可以安装这个应用。

功能

- 自动检测 Node.js、npm、npx，以及可选的 pnpm/Corepack；支持手动选择 node 可执行文件。
- Node.js 可用后自动启动 DSH；首次运行会下载 @deepseek-ai/dsh 的精确版本并校验完整性。
- 为每个 DSH 版本建立独立运行时目录；启动健康检查通过后才切换当前版本，默认保留最新五个受管版本，并额外保护当前运行或用户固定的版本。
- 使用内嵌 WebView 打开本机 DSH 服务，默认地址为 http://127.0.0.1:3080；端口可在设置中修改。
- 提供 DSH 版本选择、更新检查频率、可显式启用的 alpha/beta/next 预发布标签、包下载镜像、端口设置、一键重启与菜单栏控制。
- 设置中可一键启用或禁用推荐插件：已安装的 DSH Market 会自动识别；启用“拖入文件夹添加工作区”后，Finder 文件夹拖到左侧栏会创建 DSH 工作区，右侧仍按 DSH 原逻辑添加对话附件。
- 可在应用右侧只读预览 DSH 产出的文本、Markdown、图片和 SVG 文件。 DSH 0.1.5-alpha.1 开始已经内置右侧预览窗口，此功能不再迭代，只留作兼容旧聊天内的链接。等DSH正式版发布后将移除相关代码。

系统要求

- macOS 11 或更高版本。
- 可用的 Node.js：v22.19 或更高的 v22，或 v24 及更高版本。
- 与 Node.js 配套的 npm 和 npx。
- 能访问所选 npm registry。默认使用腾讯云镜像：https://mirrors.cloud.tencent.com/npm/。

应用不包含 Node.js。若未检测到兼容版本，DshForMac 会给出说明并可打开 Node.js 官网；安装完成后回到应用重新检测即可。

安装与首次启动

1. 打开发布的 DshForMac--unsigned.dmg。
2. 将 DshForMac.app 拖入“应用程序”（/Applications）文件夹。
3. 打开 DshForMac。检测到兼容的 Node.js 后，应用会自动下载、校验并启动 DSH；首次启动需要保持网络可用。

当前应用未签名。若 macOS 的 Gatekeeper 阻止打开，请先在“系统设置 → 隐私与安全性”中选择“仍要打开”，或在终端执行下面的命令移除应用的隔离属性：

sudo xattr -rd com.apple.quarantine /Applications/DshForMac.app

执行后再次打开应用。该命令仅应针对你信任来源获得的 DshForMac 应用使用。

使用说明

首次成功启动后，DSH 会显示在主窗口中。常用操作如下：

- 在菜单栏或应用菜单选择“一键重启 DSH”，重启当前 DSH 版本。
- 通过“设置…”修改服务端口、下载镜像、DSH 版本和更新检查频率；latest 始终检查，勾选启用后可额外选择 alpha、beta 或 next 标签。可打开已安装版本目录或立即检查更新。每天、每周和每月检查在应用持续运行时也会到期触发；发现新版本后工具栏立即提示，在设置的状态说明旁点击“下载”才会下载更新。
- 在“设置 → 推荐插件”中启用或禁用 DSH Market 与“拖入文件夹添加工作区”；变更会写入 DSH 的 web profile 并自动重启 DSH。
- 当端口已被其他非 DshForMac 管理的服务占用时，请停止该服务或在设置中更换端口。
- 点击 DSH 中的产出物文件，会在右侧以只读方式预览受支持的内容；不受支持的文件可确认后使用默认应用打开。

DSH 的配置、会话和插件仍由 DSH 使用其上游默认用户数据路径管理。DshForMac 只在 ~/Library/Application Support/DshForMac/runtimes/ 下保存受管 DSH 版本。

从源码构建

项目使用 Swift Package Manager：

swift test
swift run DshForMac

如需生成通用 macOS DMG，请运行：

./scripts/package-dmg.sh

输出文件位于 dist/，且为未签名产物。打包脚本不会覆盖同名 DMG；重新构建同一版本前，需要先处理已有产物或更新版本号。

自动发布

推送形如 v0.1.0 的语义化 Git 标签会触发 GitHub Actions。工作流会在 macos-15-intel 和 Apple Silicon macos-15 Runner 分别构建、测试和打包，向同一个 GitHub Release 上传两个架构专用 DMG。Release 标题使用去除 v 前缀后的版本号，说明内容从 CHANGELOG.md 中同一版本的章节提取。

发布前请同步更新 Packaging/Info.plist、AppMetadata.version 和 CHANGELOG.md 中的版本号；工作流会校验它们必须与标签一致。

更多实现细节见 架构文档。

本地 DSH 插件

项目自研的 DSH 插件位于 dsh-plugins/，该目录本身是 pnpm
workspace 根目录。它们与原生壳分开开发和验证，尚未发布为正式 npm 包。

License

This project is licensed under the MIT License.