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 版本选择、更新检查频率、可多选的 DSH 检查标签（latest 固定勾选）、包下载镜像、端口设置、一键重启与菜单栏控制。
• DshForMac 应用每天检查一次 GitHub 发布版本；发现新版后可稍后提醒、忽略此版本，或直接安装并重启。设置和菜单栏均可手动检查应用更新，失败时可打开 GitHub 发布页面手动安装。
• 设置中可一键启用或禁用推荐插件：已安装的 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 会显示在主窗口中。常用操作如下：

• 菜单栏顶部显示 DshForMac 版本和 DSH 状态；操作区可显示主窗口（⌘0）、重新加载页面（⌘R）、重启 DSH（⇧⌘R）或打开设置（⇧⌘,），下方集中放置 DSH 与应用更新检查。⌘, 留给 DSH 自带的设置快捷键。关闭主窗口后，DSH 服务继续运行。
• 主窗口会记住上次的大小和位置；外接显示器断开后若原位置不可见，下次启动会将窗口移回可见区域。
• Mac 唤醒后会检查本机 DSH 连接；确认断线时自动重试，恢复后重新加载页面。若仍无法恢复，可在页面上点击“重新连接”或使用工具栏重启 DSH。
• 在设置中的 DshForMac 版本号旁，或菜单栏中选择“检查 DshForMac 更新”。应用自动检查每天至多一次，安装前由用户确认；若自动安装失败，可从设置打开 GitHub 发布页面手动下载。请先将应用从 DMG 拖入“应用程序”，不要直接从 DMG 运行。
• 通过“设置…”修改服务端口、下载镜像、DSH 版本和 DSH 更新检查频率；latest 始终检查，可额外选择 alpha 或 next 标签。“运行状态”旁可点击“检查 DSH 更新”，检查结果及“下载”入口显示在同一栏；DSH 版本旁可打开已安装版本目录。每天、每周和每月检查在应用持续运行时也会到期触发；发现 DSH 新版本后工具栏立即提示。本地所选版本过低时，应用会在启动前提示升级，不会因这次检查删除该版本。普通保存后设置窗口保持打开；确认立即重启 DSH 时会关闭设置窗口。
• 在“设置 → 推荐插件”中启用或禁用 DSH Market 与“拖入文件夹添加工作区”；变更会写入 DSH 的 web profile 并自动重启 DSH。
• 在“设置 → 推荐插件”中可启用“后台任务提醒”。随应用提供的本地插件会加入 DSH web profile，要求 DSH 0.1.5-rc.3 或更高版本。应用在后台运行时，任务结束或需要审批、回答问题、审阅计划会显示一张短暂的应用内提醒卡片；看到时点击“打开会话”可返回对应会话。勾选后可点击“发送测试提醒”检查卡片展示；这只测试应用界面，不验证 DSH 插件事件。提醒只包含通用文案，不含会话正文。
• 与 macOS 系统通知的区别：任务提醒由 DshForMac 自己显示，无需 Apple 开发者签名或系统通知授权；它不会出现在通知中心或锁屏，也不受系统专注模式管理。卡片约 8 秒后消失，错过后没有待处理列表或历史记录。应用退出或 Mac 睡眠时无法提醒；仅在应用仍运行时显示，关闭主窗口不影响提醒。当前未签名发布包无法在 macOS 26.6.2 获取系统通知授权，因此不提供系统通知。
• 当端口已被其他非 DshForMac 管理的服务占用时，请停止该服务或在设置中更换端口。
• 点击 DSH 中的产出物文件，会在右侧以只读方式预览受支持的内容；不受支持的文件可确认后使用默认应用打开。

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

从源码构建

项目使用 Swift Package Manager：

开发需 Xcode 15.2（Swift 5.9）或更新版本；macOS 13 可使用 Xcode 15.2。本地与较新 Xcode 均使用同一套 XCTest 测试，应用的最低运行系统仍为 macOS 11。

swift test
swift run DshForMac

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

./scripts/package-dmg.sh

输出文件位于 dist/，且为未签名产物。打包脚本不会覆盖同名 DMG；重新构建同一版本前，需要先处理已有产物或更新版本号。源码直接运行时没有可替换的 .app，应用更新只在打包后的应用中启用。

自动发布

推送形如 v0.1.0 的语义化 Git 标签会触发 GitHub Actions。工作流在 Intel 和 Apple Silicon Runner 分别构建与测试，在 macOS Runner 合成一个通用 DMG，并生成带 EdDSA 签名的 appcast.xml；两者共同发布到 GitHub Release。应用通过固定的 releases/latest/download/appcast.xml 地址检查稳定版，不调用 GitHub Releases API。预发布标签生成的 Release 不会成为默认稳定版更新源。

每次发布时，CHANGELOG.md 对应版本条目必须包含独立一行“最低兼容 DSH 版本”，格式为 - 最低兼容 DSH 版本：`版本号`。。版本号须与应用中的 AppMetadata.minimumSupportedDSHVersion 一致。发布工作流会校验此行，并把该版本条目原样用作 GitHub Release Notes。

发布前需将与 Packaging/Info.plist 中 SUPublicEDKey 对应的 Sparkle 私钥，保存为仓库 Actions 密钥 SPARKLE_PRIVATE_KEY；缺失时工作流会停止发布。当前公钥对应的私钥保存在本机钥匙串账号 cn.hpyer.dshformac 中。已安装并登录 GitHub CLI 时，可执行：

key_dir="$(mktemp -d)"
.build/artifacts/sparkle/Sparkle/bin/generate_keys --account cn.hpyer.dshformac -x "$key_dir/private-key"
gh secret set SPARKLE_PRIVATE_KEY < "$key_dir/private-key"
rm -f "$key_dir/private-key"
rmdir "$key_dir"

也可通过 GitHub 仓库设置添加密钥。不要将私钥提交到仓库；请另行安全备份钥匙串中的密钥。Sparkle 的更新包签名与 Apple Developer ID 签名不同；发布的应用仍未经过 Apple 签名或公证。

发布前请同步更新 Packaging/Info.plist 的 CFBundleShortVersionString、AppMetadata.version 和 CHANGELOG.md 中的版本号，并递增 CFBundleVersion；工作流会校验前两者必须与标签一致。已安装的旧版本不含应用更新器，需要手动安装一次加入此功能的新版本。新版本的应用包标识为 cn.hpyer.dshformac；首次启动时会迁移旧标识下的偏好设置。

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

本地 DSH 插件

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

License

This project is licensed under the MIT License.