macOS 菜单栏控制器qingtan-labs/deepseek-harness-macos

适用于 macOS 的 DeepSeek Harness

一个原生的 Dock 与菜单栏控制器，用于 DeepSeek Harness（DSH）。

English (default) · 简体中文

下载 DeepSeek Harness 1.0.2 DMG

适用于 macOS 的 DeepSeek Harness 是一个由社区构建的配套工具，集成了 Dock 启动器、菜单栏控制、本地服务管理以及可选的应用程序内窗口。点击 Dock 图标时，会尽可能聚焦到已有的 Harness 页面或窗口；它不会每次都刻意新建一个标签页。

该控制器仅管理 http://127.0.0.1:3080。它不会存储、代理或上传你的 DeepSeek 凭据。

[!IMPORTANT]
这是一个独立的社区项目，并非 DeepSeek 官方应用程序，与 DeepSeek 无关联。DeepSeek 名称、徽标和商标归其各自所有者所有。

可信的项目链接

| 用途 | 链接 |
| --- | --- |
| 产品系列 | DeepSeek Harness Desktop |
| 源代码 | github.com/qingtan-labs/deepseek-harness-macos |
| 下载 | GitHub Releases |
| 帮助与错误报告 | GitHub Issues |
| 安全报告 | 私密漏洞报告 |

该项目免费且开源。它绝不会要求你通过 Issue 发送 API 密钥、密码或登录验证码。

产品导览

以下预览仅使用演示内容，重点展示 macOS 控制器自身的交互。

Dock 与菜单栏，协同工作（交互预览）

DeepSeek Harness 共享的 Dock 与菜单栏控制器
Dock 图标和菜单栏鲸鱼控制同一个应用程序。菜单包括外部服务状态、打开/聚焦、一次性备用窗口、已保存的打开方式、服务控制、经用户确认的 DSH 更新检查、静默登录启动、用户指南、版本信息，以及仅退出控制器而让外部启动的服务继续运行的显式退出选项。

聚焦现有浏览器标签页（工作流预览）

DeepSeek Harness 复用现有浏览器标签页

当所选浏览器允许检查时，点击 Dock 图标会聚焦现有的本地 Harness 页面，而不是打开重复页面。

可选的应用内窗口（工作流预览）

DeepSeek Harness 原生应用内窗口

原生 WebKit 窗口保持一个本地会话。关闭窗口不会退出菜单栏鲸鱼，也不会停止 Harness。预览仅展示控制器拥有的窗口外壳和 WebView 容器；它不会虚构 DSH 产品控件。

为什么使用它？

- 一个应用，两个入口。 Dock 图标和菜单栏鲸鱼属于同一个进程；无需启动第二个实用程序。
- 先复用，再打开。 浏览器模式会检查受支持的 Safari 和 Chromium 系列浏览器中是否已有本地 Harness 标签页。应用内模式会恢复同一个窗口和 Web 会话。
- 记住我的选择。 浏览器或应用内模式可保存为默认方式，并可随时从菜单中更改。
- 感知服务的操作。 页面和插件资源健康检查、过期加载器恢复、端口冲突保护以及所有权记录，确保启动可靠，同时不会停止无关进程。
- 优先使用现有环境。 用户已安装且达到或高于测试基线的可用 DSH 会被原样复用。如果仅缺少 DSH，则会复用现有的 Node.js 22.19.0+ 和 npm；仅在必要时才下载私有 Node.js。
- 在干净的 Mac 上也能运行。 当不存在兼容环境时，应用可以在无需管理员权限的情况下，设置私有的、按用户隔离的 Node.js 和 DSH 运行时。
- 更新由你掌控。 “服务”菜单可以检查官方 npm latest 版本，并且仅在确认后才安装。不存在静默的后台 DSH 更新。
- 安静的登录启动。 macOS 登录项辅助程序会启动菜单栏控制器，而不打开页面。
- 原生本地化和外观。 包含英语和简体中文；原生 UI 会自动跟随 Mac 的浅色/深色外观。
- 通用 Mac 构建。 一个软件包同时支持 Apple 芯片和 Intel Mac。

要求

| 要求 | 值 |
| --- | --- |
| macOS | 13 Ventura 或更高版本 |
| Mac | Apple 芯片或 Intel |
| 网络 | 仅在缺少兼容的本地组件时，或进行已确认的更新时需要 |
| 本地端点 | http://127.0.0.1:3080 |
| 可复用 Node.js | 版本 22.19.0 或更高 |
| 私有回退 Node.js | 22.21.1 |
| 可复用 DSH | 工作版本 0.1.1-rc.2 或更高 |
| 已测试的干净安装 DSH | @deepseek-ai/dsh@0.1.1-rc.2 |

安装

1. 从 GitHub Releases 下载最新的 DMG。
2. 打开 DMG，将 DeepSeek Harness 拖到 Applications 上。
3. 按住 Control 键点按已安装的应用，选择 Open，然后确认 Open。
4. 首次正常启动会将应用添加到 Dock，并启动共享的 Dock/菜单栏控制器。要升级，请替换 Applications 中的现有应用；偏好设置和 Harness 数据将保持不变。

该应用会首先发现并运行兼容的现有 DSH/Node 安装，包括常见的 Homebrew、npm、nvm、fnm、Volta、asdf、mise、nodenv、MacPorts、bun 和 pnpm 位置。它会记录所选的绝对路径，以便之后从 Finder、Dock 或登录启动时不依赖交互式 shell 的 PATH。它绝不会修改外部 DSH 或 Node 安装。

如果 DSH 缺失、损坏或早于已测试的基线，该应用只会安装一个隔离的 DSH 副本。它会复用可用的 Node.js 22.19.0+ 及 npm；只有 Node 缺失、损坏或版本过旧时，才会触发下载经过验证的私有 Node.js 22.21.1。~/.dsh 下的配置文件、会话、插件和凭据绝不会被替换。干净安装可能需要几分钟，因为 DSH 有庞大的依赖树；请保持应用打开直到完成。在安装期间，该应用会根据 Mac 的物理内存选择 3–8 GB 的 Node.js 堆限制，而不是依赖 npm 较小的默认值。

已测试的默认版本被有意设定为精确版本，以便每次全新安装都从同一个顶层 DSH 版本开始，该版本已针对此控制器及其插件加载行为进行验证。它是兼容性基线，而非永久锁定：选择 Service → Check for DSH Updates… 与 npm latest 进行比较，查看版本变更，并明确更新。在激活之前，更新候选版本必须使用当前 Profile 启动，并提供所有已公布的插件资源；验证失败将保留之前可用的托管运行时。

1.0.2 的 Gatekeeper 提示

版本 1.0.2 为临时签名，未经 Apple 公证。因此 macOS 可能会显示未识别开发者的警告。请在 Applications 中按住 Control 键点按该应用并选择 Open，或者在 macOS 阻止首次尝试后前往 System Settings → Privacy & Security → Open Anyway。

请勿全局禁用 Gatekeeper。未来的版本需要 Apple Developer ID 和公证才能移除此首次运行警告。

验证下载

下载 DMG 旁可选的 .sha256 文件，将两个文件放在同一目录中，然后运行：

shasum -a 256 -c DeepSeek-Harness-1.0.2-macOS.dmg.sha256

日常使用

- 点击 Dock 图标以使用你保存的打开方式。
- 点击菜单栏鲸鱼图标打开 Harness，使用一次备用方法，更改默认设置，检查服务状态，检查 DSH 更新，重启/停止服务，复制诊断信息，或配置登录时启动。
- 在浏览器模式下，会聚焦一个现有的受支持的本地标签页；只有在无法验证任何标签页时才会创建新标签页。
- 在应用内模式下，关闭窗口会将其隐藏。菜单栏鲸鱼图标和 Harness 服务仍然可用。
- 选择退出 DeepSeek Harness 会退出控制器。服务操作保持明确且独立。

首次浏览器复用操作可能会触发 macOS 自动化权限请求。该权限仅用于查找并聚焦本地 127.0.0.1:3080 标签页。如果无法可靠地检查浏览器，请选择应用内窗口或保存所提供的备用方案。

详情请参阅用法、安装和故障排除。

隐私与安全

- 不包含任何分析、遥测、广告或后台更新跟踪器。
- 控制器与本地 Harness 端点通信。仅当必须安装缺失的 DSH 组件或你明确选择检查 DSH 更新…时，才会联系官方 npm 注册表；仅当需要私有 Node 备用方案时，才会联系 nodejs.org。
- 从菜单复制的诊断信息包含操作信息。在公开发布之前请先审查。
- Harness 身份验证保留在本地 Harness 页面内。切勿将凭据粘贴到公开 Issue 中。

从源代码构建

无需 Xcode 项目或第三方构建系统。在安装了命令行工具的 macOS 13+ 上：

git clone https://github.com/qingtan-labs/deepseek-harness-macos.git
cd deepseek-harness-macos
./scripts/build-release.command

通用、临时签名的 DMG 和校验和会写入 dist/。构建过程会验证 plist、签名、架构和磁盘映像完整性。请参阅架构、维护和发布流程。

贡献与支持

欢迎通过 GitHub Issues 提交错误报告和功能请求。在贡献之前，请阅读 CONTRIBUTING.md、SUPPORT.md、行为准则和安全政策。

Windows 配套版本计划作为单独的仓库，以便平台特定的打包和行为保持清晰。目前尚未承诺发布日期。

许可证

源代码在 MIT 许可证下提供。第三方名称、徽标、软件包和商标仍受其所有者条款的约束。