kuangre123/deepseek-harness-mac

适用于 Mac 的 DeepSeek Harness

将开源项目 deepseek-ai/deepseek-harness
包装成可直接安装运行的原生 macOS 应用。

直接在 release 里下载安装即可。
https://github.com/kuangre123/deepseek-harness-mac/releases

已实现

- 原生 SwiftUI 应用壳，使用 WKWebView 承载官方 Harness Web UI。
- App 内置 Node.js 22 LTS 和固定版本 @deepseek-ai/dsh，用户不需要安装 Node、npm 或 pnpm。
- 首次启动中文引导：输入 DeepSeek API Key、选择项目目录，然后自动启动。
- API Key 只保存在 macOS Keychain；子进程通过环境变量读取，不写入项目文件或日志。
- 工作区使用 security-scoped bookmark 记忆，并通过官方 workspace.create RPC 自动注册。
- Harness 数据隔离在 ~/Library/Application Support/DeepSeek Harness。
- 服务只绑定随机的 127.0.0.1 端口；外部链接由系统浏览器打开。
- 上游遥测显式关闭；本地 Runtime 日志会脱敏 API Key。
- 提供 .app、.dmg 构建与 ad-hoc 签名验证脚本。

架构

flowchart LR
A["SwiftUI 首次启动引导"] --> B["macOS Keychain"]
A --> C["工作区 Bookmark"]
A --> D["内置 Node.js 22"]
D --> E["固定版 @deepseek-ai/dsh web"]
E --> F["127.0.0.1 随机端口"]
F --> G["WKWebView 官方 Web UI"]
A -->|"workspace.create / settings.mutate"| E

构建

需要 macOS 13+、Xcode Command Line Tools、网络连接（只在构建时下载固定运行时）。

./scripts/build-app.sh
./scripts/verify.sh

产物：

- .build/release-app/DeepSeek Harness.app
- .build/release-app/DeepSeek-Harness-arm64.dmg（或 x86_64）

构建脚本固定：

- Node.js 22.23.2
- @deepseek-ai/dsh 0.1.0-rc.6

可通过环境变量覆盖版本、架构、签名身份：

NODE_VERSION=22.23.2 \
TARGET_ARCH=arm64 \
SIGN_IDENTITY="Developer ID Application: Example" \
./scripts/build-app.sh

默认使用 ad-hoc 签名（SIGN_IDENTITY=-），适合本地测试。对外分发需使用 Developer ID
签名并额外完成 Apple notarization；仓库不会保存证书或 App Store Connect 凭据。

开发

Swift Package 便于在完整 Xcode 工具链下开发：

swift test
swift run DeepSeekHarnessMac

部分仅安装 Command Line Tools 的预览版 macOS 环境不附带 SwiftUI/Testing 的编译器插件，
此时请使用 scripts/build-app.sh 和 scripts/verify.sh；完整 Xcode 环境可直接运行 swift test。

直接 swift run 不包含运行时资源。开发时可指向已安装的 Node 和临时 dsh：

DSH_MAC_NODE=/absolute/path/to/node \
DSH_MAC_ENTRY=/absolute/path/to/node_modules/@deepseek-ai/dsh/lib/bin.js \
swift run DeepSeekHarnessMac

数据与隐私

- API Key：macOS Keychain，service 为 io.github.kuangre123.deepseek-harness-mac。
- Harness 配置/会话：~/Library/Application Support/DeepSeek Harness。
- 运行日志：~/Library/Logs/DeepSeek Harness/runtime.log，写入前会替换当前 API Key。
- 工作区路径：UserDefaults 中的 security-scoped bookmark。
- Harness 服务：仅 127.0.0.1，由系统分配空闲端口。

上游与许可证

本项目不是 DeepSeek 官方 macOS 客户端。DeepSeek Harness 使用 MIT License；构建产物会包含其
LICENSE、第三方 notices 以及 Node.js LICENSE。上游目前属于 developer preview，未来版本可能产生
破坏性变更，因此运行时在发行时必须固定并重新验证。

欢迎通过 Issue 报告问题或提交 Pull Request。参与前请阅读 CONTRIBUTING.md。