deepseek-harness-desktop

非官方桌面封装：把 DeepSeek Harness（dsh）的 Web GUI 变成原生 macOS 应用。一键安装、启动台双击即用、Dock 右键退出即停。

下载：最新安装包 Release，或本仓库根目录的 deepseek-harness-installer.zip / 单文件 deepseek-harness-installer.command。

快速开始

1. 下载并解压 deepseek-harness-installer.zip，双击 deepseek-harness-installer.command
   • 若提示「无法验证开发者」：右键该文件 → 打开 → 仍要打开
2. 脚本自动完成：Node.js 检测（缺失可一键经 Homebrew 安装）→ dsh 检测/持久安装 → 组装应用 → 签名 → 注册到启动台
3. 启动台（Launchpad）双击「DeepSeek Harness」黑鲸鱼图标即可使用

特性

• 原生窗口：WKWebView 封装，不再依赖浏览器标签页
• 关窗不退出：点 ✕ 只隐藏窗口，Dock 图标常驻并监督服务
• 停止即退出：Dock 图标右键 → 退出，服务随之停止
• 剪贴板快捷键：Cmd+C / Cmd+V / Cmd+X / Cmd+A 可用
• 右键在 Finder 中显示：Web 界面内对文件路径按钮右键可直接定位文件
• 双架构：universal 二进制，Intel 与 Apple Silicon 通用
• 命令行控制：dsh-control start|stop|status
• 无需 sudo：全部安装到用户目录

要求

• macOS 11+
• Node.js 22+（安装器自动检测，缺失时引导安装）

卸载

• 把 ~/Applications/DeepSeek Harness.app 移入废纸篓
• 控制命令：rm ~/.local/bin/dsh-control
• 用户数据在 ~/.dsh/，按需保留或删除

---

DeepSeek Harness 桌面启动器 — 使用说明

本应用由一键安装脚本自动部署。安装完成后即可使用：

启动 / 停止（只有两个操作）

启动：打开启动台（Launchpad），双击「DeepSeek Harness」（黑鲸鱼图标）。 服务随之启动，浏览器自动打开，程序坞（Dock）会出现常驻的黑鲸鱼图标。

停止：在程序坞（Dock）对黑鲸鱼图标右键 → 退出。 服务会随之停止（无论服务是谁启动的）。

终端备选命令（已安装到 ~/.local/bin）：

dsh-control start   # 启动
dsh-control stop    # 停止
dsh-control status  # 查看运行状态

行为说明

双击启动台图标时的状态	行为
服务未运行	启动服务，Dock 常驻监督
服务已在运行（任意来源）	接管并常驻监督
已有监督者在跑（且服务在）	只打开浏览器

API key 配置（三选一）

1. 推荐：打开 Web 界面后，进入 设置 → Models 页面填写（写入 ~/.dsh/.credentials.yaml）
2. 在 ~/.dsh/.env 中写入（每次启动自动加载）：

   DEEPSEEK_API_KEY=sk-xxxx
   

3. 在 ~/.dsh/launcher.env 中写入（Finder 双击启动也会加载）：

   export DEEPSEEK_API_KEY=sk-xxxx
   

日志与排查

• 服务日志：~/Library/Logs/DeepSeekHarness/dsh-web.log（超过 5MB 自动轮转）
• 启动失败：查看上述日志尾部
• 修改插件/MCP 配置后：dsh-control stop 再双击启动即可生效

常见问题

• 双击没反应 / 找不到 dsh：终端执行 npm install --prefix "$HOME" @deepseek-ai/dsh 后重试
• Node.js 版本过低：需要 Node.js 22+，brew install node 后重启应用
• 端口被占用：设置 DSH_PORT 环境变量换端口（默认 3080）

手动安装依赖（未使用安装器 / 换新机器时）

依次执行以下两条脚本即可把 Node.js 和 dsh 装好，然后再运行一键安装器：

1. 安装 Node.js 22+（推荐 Homebrew）

# 首次使用需先安装 Homebrew（已装可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js（约 1–3 分钟）
brew install node

# 验证：版本需 ≥ v22
node -v

不用 Homebrew 也可以到官网下载安装包：https://nodejs.org/

2. 安装 dsh（持久安装到用户目录，免 sudo）

npm install --prefix "$HOME" @deepseek-ai/dsh

# 验证
"$HOME/node_modules/.bin/dsh" --version

• 安装位置：$HOME/node_modules/.bin/dsh
• 若提示 npm: command not found：先完成上面第 1 步，并重开终端
• 若提示网络错误：检查代理/防火墙后重试；也可先执行 npx -y @deepseek-ai/dsh --version 预热验证仓库可达性

卸载

• 删除应用：把 ~/Applications/DeepSeek Harness.app 移入废纸篓
• 用户数据（凭据、会话记录）在 ~/.dsh/，按需保留或删除
• 控制命令：rm ~/.local/bin/dsh-control