macOS 桌面封装 aibinghe/deepseek-harness-macos

DeepSeek Harness · macOS 桌面封装

用原生 Swift + WebKit 把 DeepSeek Harness 封装成一个真正的 macOS 原生应用，而不是在浏览器标签页里使用。

✨ 特性

| 🖥️ 原生窗口 | 独立菜单栏、全屏、缩放、重载快捷键，标准 macOS 桌面体验 |
| 🚀 一键启动 | 打开 App 即自动启动本地 DeepSeek Harness 服务并加载界面 |
| 💾 原生下载 | 文件直接保存到「下载」文件夹，完成后用「访达」高亮定位 |
| 🗂️ 工作区支持 | 默认使用 ~/Documents/Codex 作为工作区根目录 |
| 📄 文件选择 | 支持原生打开面板选择文件/目录 |
| 🐛 自动日志 | 后端日志自动写入 ~/Library/Application Support/DeepSeek Harness/DeepSeekHarness.log |

📦 它是什么

这个仓库只包含 macOS 桌面封装层 —— 也就是把 DeepSeek Harness 变成原生应用的「壳」。

- 源码：Swift + WebKit 的窗口容器、后端进程管理、菜单与系统集成
- 不包含：DeepSeek Harness 的运行时（@deepseek-ai/dsh）及其 node_modules 依赖

DeepSeek Harness 的运行时代码隶属于 DeepSeek AI 并在其自己的仓库维护。本项目通过构建脚本从你本机已安装的 DeepSeek Harness 中获取并捆绑它，不在此仓库中重新分发该运行时的源码或二进制。

🚀 开始使用

前置要求

- macOS 13.0+

构建

1. 克隆本仓库
git clone https://github.com/aibinghezzz-stack/deepseek-harness-macos.git
cd deepseek-harness-macos

2. 在本机安装 DeepSeek Harness（构建时自动读取其运行时）把 DeepSeek Harness.app 放到 /Applications/ 下

3. 用打包脚本构建 .app（脚本会按需捆绑运行时）详细构建步骤见 scripts/ 下的说明

自动化构建（GitHub Actions 的 macOS workflow）会编译 Swift 源码并产出 .app 产物。

🧱 项目结构

deepseek-harness-macos/
├── Sources/
│ └── DeepSeekHarnessApp.swift # Swift 原生应用入口（窗口/后端/菜单） ├── Resources/ │ ├── DeepSeekHarnessInfo.plist # 应用 Info.plist │ ├── DeepSeekHarnessIcon.png # 应用图标 (PNG) │ ├── DeepSeekHarness.icns # 应用图标 (ICNS) │ └── DeepSeekHarnessIcon.svg # 图标源 (SVG) ├── scripts/ │ └── link-deepseek-workspace.mjs # 运行时捆绑脚本 └── .github/workflows/ # macOS 构建流水线

🛠️ 工作原理

DeepSeekHarnessApp.swift 启动流程：

1. 从 Resources/bin/node 找到随附的 Node.js
2. 以 runtime/lib/bin.js web --host 127.0.0.1 --port 0 启动本地服务
3. 监听后端打印出的 http://127.0.0.1:<port> 端口号
4. 用 WKWebView 加载该本地地址，呈现完整 Harness 界面
5. 提供原生菜单栏、下载管理、JS 弹窗和文件选择集成

注意事项

- 运行时从你本机安装的 DeepSeek Harness 捆绑，因此需要先安装 Harness
- SVG 源图标文件可能带有本机路径引用，正式图标以 PNG / ICNS 为准

📄 许可

MIT © BingHeZAI

DeepSeek Harness 运行时本身受其所属方的许可约束，请遵守其各自条款。