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

DeepSeek Harness for macOS

One native Dock and menu bar controller for DeepSeek Harness (DSH).

English (default) · 简体中文

Download the DeepSeek Harness 1.0.3 DMG

DeepSeek Harness for macOS 是社区打造的配套应用，把 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 key、密码或登录验证码。

产品导览

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

Dock 与菜单栏，一起看（交互预览）

DeepSeek Harness shared Dock and menu bar controller
Dock 图标和菜单栏鲸鱼控制同一个应用。菜单包含外部服务状态、Open/Focus、一次性备用窗口、已保存的打开方式、服务控制、需用户确认的 DSH 更新检查、静默登录启动、用户指南、版本信息，以及仅退出控制器的显式退出——外部启动的服务会继续运行。

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

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

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

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

DeepSeek Harness 原生应用内窗口

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

为什么用它？

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

要求

| 要求 | 值 |
| macOS | 13 Ventura 或更高版本 |
| Mac | Apple silicon 或 Intel |
| 网络 | 仅在缺少兼容的本地组件，或确认要更新时需要 |
| 本地端点 | http://127.0.0.1:3080 |
| 可复用的 Node.js | 22.19.0 或更高版本 |
| 私有兜底 Node.js | 22.21.1 |
| 可复用的 DSH | 可用版本 0.2.0-rc.2 或更高 |
| 已验证全新安装的 DSH | @deepseek-ai/dsh@0.2.0-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 启动，并serve 所有对外声明的插件资源；验证失败则保留之前可用的受管运行时。

1.0.3 的 Gatekeeper 提示

1.0.3 版本为 ad-hoc 签名，未经 Apple 公证。因此 macOS 可能显示「无法验证开发者」的警告。在 Applications 里按住 Control 点击应用并选择 Open，或者在 macOS 首次拦截后前往 System Settings → Privacy & Security → Open Anyway。

不要全局关闭 Gatekeeper。未来版本需要 Apple Developer ID 和公证，才能去掉这个首次运行警告。

校验下载文件

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

sh
shasum -a 256 -c DeepSeek-Harness-1.0.3-macOS.dmg.sha256

日常使用

- 点击 Dock 图标，按你保存的打开方式启动。
- 点击菜单栏鲸鱼，可以打开 Harness、临时改用另一种方式、修改默认方式、查看服务状态、检查 DSH 更新、重启或停止服务、复制诊断信息，或者配置登录时启动。
- 在浏览器模式下，会聚焦已有的受支持本地标签页；只有在无法确认任何标签页时才会新建。
- 在应用内模式下，关闭窗口只是隐藏它。菜单栏鲸鱼和 Harness 服务仍然可用。
- 选择 Quit DeepSeek Harness 会退出控制器。服务操作始终单独执行，需要你明确触发。

第一次复用浏览器标签页时，可能触发 macOS 的自动化权限请求。这个权限只用来查找并聚焦本地 127.0.0.1:3080 标签页。如果无法可靠地检查浏览器，就选择应用内窗口，或者保存提示的备用方式。

详见 Usage、Installation 和 Troubleshooting。

隐私与安全

- 不包含任何分析、遥测、广告或后台更新追踪。
- 控制器只与本地 Harness 端点通信。只有在需要安装缺失的 DSH 组件，或者你明确选择 Check for DSH Updates… 时，才会访问官方 npm registry；只有在需要私有 Node 备用方案时，才会访问 nodejs.org。
- 从菜单复制的诊断信息包含运行信息。公开发布前请先检查。
- Harness 身份验证始终在本地 Harness 页面内完成。切勿把凭据粘贴到公开 Issue 中。

从源码构建

不需要 Xcode 工程，也不需要第三方构建系统。在 macOS 13+ 上装好 Command Line Tools 即可： sh
git clone https://github.com/qingtan-labs/deepseek-harness-macos.git
cd deepseek-harness-macos
./scripts/build-release.command

通用架构、ad-hoc 签名的 DMG 和校验和会写入 dist/。构建过程会校验 plist、签名、架构和磁盘映像完整性。详见 Architecture、Maintenance 和 Release process。

贡献与支持

欢迎通过 GitHub Issues 提交 Bug 报告和功能请求。贡献之前，请阅读 CONTRIBUTING.md、SUPPORT.md、Code of Conduct 和 Security Policy。

Windows 配套版本计划放在单独的仓库，这样各平台的打包方式和行为都能保持清晰。目前还没有承诺发布日期。

许可证

源代码基于 MIT License 提供。第三方名称、徽标、包和商标仍受各自所有者的条款约束。