Mac 桌面常驻版YuhaoYeSteve/deepseek-harness-desktop-mac

DeepSeek Harness Desktop (Mac)

原版 DeepSeek Harness，一条命令装进 Mac Dock。
原版 DeepSeek Harness，不改源码。一条命令完成安装与常驻，之后直接从 Mac Dock 打开。

中文 · English

一条命令，常驻 Dock

curl -fsSL https://raw.githubusercontent.com/YuhaoYeSteve/deepseek-harness-desktop-mac/v1.1.0/install.sh | bash

安装一次，之后无需保留终端窗口。Harness 会在登录时启动，日常使用直接点击 Dock 中的鲸鱼图标。

| 原版 Harness | 登录即常驻 | Dock 一键打开 |
|---|---|---|
| 安装官方 Harness 包，不修改源码，也不重新实现界面。 | 当前用户的 LaunchAgent 在登录时启动服务，并重新拉起异常退出的受管进程。 | 完成下方两步 Chrome 设置后，从 Dock 打开或聚焦原版 Harness。 |

为什么是 Desktop (Mac)

Desktop (Mac) 为原版 DeepSeek Harness 补上 macOS 安装、服务常驻和 Dock 入口，Harness 本身仍由官方 npm 包提供。

安装前请确认：

- macOS 13+，支持 Apple Silicon 与 Intel。
- 已安装 Google Chrome。
- 127.0.0.1:3080 未被其他应用占用；服务只监听这个本机地址，不监听局域网地址。
- 安装不需要 Homebrew 或 sudo。
- 安装器会下载私有 Node.js 22.19.0，并安装官方 @deepseek-ai/dsh@0.1.1-rc.2 的锁定依赖闭包。

30 秒开始

运行上方固定到 v1.1.0 的命令。脚本会验证发布包、Node.js 和 npm 依赖完整性，再创建当前用户的 LaunchAgent。若 3080 端口属于其他进程，安装会停止且不会结束该进程。

安装成功后，脚本会用 Google Chrome 打开 http://127.0.0.1:3080/。接着人工完成两步：

1. 在 Chrome 中把当前 Harness 页面安装为 Chrome 网页应用。
2. 启动该应用，右键 Dock 中的鲸鱼图标，选择 选项 → 在程序坞中保留。

Chrome 管理网页应用和 Dock 项；安装器不伪造应用窗口或 Dock 图标。

它如何工作

安装器为当前用户部署锁定版本的运行时，并用 LaunchAgent 管理原版 Harness。DeepSeek Harness Desktop 管理的 Web 服务仅监听 127.0.0.1:3080，不监听局域网。安装下载和用户配置的模型 API 仍可正常出站。

为保证 v1.0.0 用户原地升级，下列内部路径和服务标识继续保留旧名称；这不会改变对外项目名。

| 项目 | 位置或行为 |
|---|---|
| 私有 Node.js 与 Harness | ~/Library/Application Support/DeepSeek Harness App/releases/ |
| 当前版本链接 | ~/Library/Application Support/DeepSeek Harness App/current |
| 用户 LaunchAgent | ~/Library/LaunchAgents/io.github.yuhaoyesteve.deepseek-harness-app.plist |
| LaunchAgent 服务标识 | io.github.yuhaoyesteve.deepseek-harness-app |
| Harness 数据 | 继续由 Harness 保存到 ~/.dsh |
| 回滚快照 | 需要保留时，把整个 ~/.dsh 的仅当前用户可访问副本保存到 ~/Library/Application Support/DeepSeek Harness App/backups/latest |
| 持久锁守卫 | 空文件 ~/Library/Application Support/.deepseek-harness-app.install-lock，用于串行执行安装和卸载，卸载后保留 |
| 监听地址 | 仅 127.0.0.1:3080 |

LaunchAgent 的工作目录只是服务启动时的空备用目录。新会话仍按 Harness 自身流程选择工作目录；安装器不会替你固定项目目录。

配置原版 DeepSeek API

首次打开后，按照官方 Harness 自身的原版 DeepSeek API 配置流程完成模型设置。本仓库不说明或处理其他模型服务的配置。安装器完全模型中立：不解析、不上传、也不配置模型凭证，不会主动更改 provider 或默认模型，并保留现有 Harness 设置。

日常使用
点击 Dock 图标即可打开或聚焦 Harness。如需查看不含凭证、会话或原始日志的允许清单状态，运行：

curl -fsSL https://raw.githubusercontent.com/YuhaoYeSteve/deepseek-harness-desktop-mac/v1.1.0/install.sh | bash -s -- doctor

输出只包含应用版本、架构、服务标签、PID、端口和 HTTP 状态。

手动升级

升级只在你显式运行目标版本的安装命令时发生。要安装或修复 v1.1.0，运行：

curl -fsSL https://raw.githubusercontent.com/YuhaoYeSteve/deepseek-harness-desktop-mac/v1.1.0/install.sh | bash

重复运行同一 tag 会修复安装器拥有的文件并保留 ~/.dsh；安装器不会在后台替换版本。

卸载

curl -fsSL https://raw.githubusercontent.com/YuhaoYeSteve/deepseek-harness-desktop-mac/v1.1.0/install.sh | bash -s -- uninstall

默认卸载删除安装器拥有的 LaunchAgent、运行时、日志、临时安装锁目录和快照，但保留 ~/.dsh、Google Chrome、Chrome 网页应用与 Dock 项。

空的持久锁守卫文件会保留，用于串行执行后续安装和卸载：~/Library/Application Support/.deepseek-harness-app.install-lock。

删除 Chrome 网页应用或 Dock 项需要在 Chrome 或 macOS 中另行操作；非空备用工作目录也会保留并报告。

隐私与安全

安装器不上传会话，也不把 Harness 暴露到局域网。为了支持事务回滚，安装或升级可能会把整个 ~/.dsh 复制到仅当前用户可访问的本地快照；该副本可能包含凭证、设置和会话。最近一个需要保留的快照位于 ~/Library/Application Support/DeepSeek Harness App/backups/latest，回滚可能恢复该快照。

诊断命令不输出环境变量、~/.dsh 内容或原始日志。提交漏洞前请阅读 SECURITY.md；不要把凭证、会话、~/.dsh 或未检查的日志贴到公开 Issue。

故障排查

- Chrome 没有打开：先确认 Google Chrome 位于 /Applications 或当前用户的 Applications 目录，再访问 http://127.0.0.1:3080/。
- doctor 显示 HTTP 不可用：等待 10 秒后重试；LaunchAgent 会重新拉起异常退出的受管进程。
- 端口被占用：关闭你确认拥有的 3080 监听程序后重新安装。安装器不会结束无法确认为自身的进程。
- Dock 图标消失：启动 Chrome 网页应用，再次选择 选项 → 在程序坞中保留。

社区与许可

问题与兼容性报告请使用 GitHub Issues；参与开发前阅读 CONTRIBUTING.md。DeepSeek、DeepSeek Harness、官方 npm 包、鲸鱼图标与产品截图归各自权利人所有。本仓库只提供社区安装、服务监管与文档。

社区安装器代码以 MIT License 发布。上游软件继续适用其自身许可。