Local Harness Launcher

一个独立、开源的 macOS 启动器。点击应用图标后，它会在本机启动兼容的 Agent Harness Web UI，并用默认浏览器打开页面。

English

[!IMPORTANT] 本项目是独立开发的第三方 macOS 启动器，仅用于在本机启动并打开 DeepSeek Harness 的 Web UI。本项目并非 DeepSeek AI 官方产品，也不由 DeepSeek AI 开发、维护、赞助、认可或提供支持。

“DeepSeek”“DeepSeek Harness”“DSH”及相关名称和品牌资产归其各自权利人所有。本文仅以纯文本说明兼容对象，不主张对这些名称或资产拥有任何权利，也不暗示双方存在隶属、合作或授权关系。

它解决什么问题

上游官方入口是终端命令：

npx @deepseek-ai/dsh web

这个项目把启动过程做成一个普通的 macOS 应用图标：

• 从“应用程序”、Spotlight 或 Dock 点击打开。
• 自动启动本地 Web 服务，再打开 http://127.0.0.1:3080/。
• 重复点击只复用同一个后台服务。
• 端口被其他程序占用时显示清楚的中文提示，不会强行结束其他进程。
• 服务仅绑定 127.0.0.1，并默认关闭 Harness 遥测。
• API Key、账号登录和模型配置全部留在 Harness 页面中由用户自行完成。

安装

1. 准备 Node.js

需要 macOS 14 或更高版本，并满足上游要求：Node.js ^22.19.0 || >=24.0.0。推荐使用 Node.js 24 LTS。

确认版本：

node --version
npm --version

2. 下载并安装启动器

git clone https://github.com/chuanfan-ai/local-harness-launcher.git
cd local-harness-launcher
./install.sh

安装脚本会：

1. 检查 macOS、Node.js 和系统工具。
2. 按仓库提交的 lockfile 从官方 npm registry 安装 @deepseek-ai/dsh 及其固定依赖图。
3. 在本机编译并临时签名 Local Harness Launcher.app。
4. 安装到 ~/Applications/Local Harness Launcher.app。

首次安装需要联网，npm 依赖可能包含原生模块的安装脚本。项目不会要求管理员权限，也不会读取你的 API Key。

3. 打开

按 Command + Space 搜索：

Local Harness Launcher

需要常驻快捷入口时，可以从 ~/Applications 把应用拖到 Dock。

也可以运行：

open -a "Local Harness Launcher"

随后在 Harness 页面中自行配置 API Key、模型和工作区。

更新

cd local-harness-launcher
git pull --ff-only
./install.sh

安装器可以重复运行；更新时会替换应用和固定版本的运行时，但保留 Harness 用户数据。

请分享本 GitHub 仓库，不要直接转发你本机生成的 .app。应用中包含当前用户的 Node.js 与数据目录绝对路径，每位使用者都需要在自己的 Mac 上运行 ./install.sh。

卸载

./uninstall.sh

卸载脚本会停止后台服务并移除应用、运行时和启动日志。它会保留 Harness 的用户数据目录，避免误删会话与凭据：

~/Library/Application Support/Local Harness Launcher/dsh-home

如确实需要删除这些数据，请先确认其中没有需要保留的会话或凭据，再由你手动处理。

文件位置

内容	默认位置
应用	~/Applications/Local Harness Launcher.app
Harness 运行时	~/Library/Application Support/Local Harness Launcher/runtime
npm 隔离缓存	~/Library/Application Support/Local Harness Launcher/npm-cache
Harness 用户数据	~/Library/Application Support/Local Harness Launcher/dsh-home
启动日志	~/Library/Application Support/Local Harness Launcher/logs

日志与数据目录使用仅当前用户可读写的权限。启动器不会把 API Key 写入应用包、命令参数或 Git 仓库。

上游依赖与兼容性

本启动器不会取代 DeepSeek Harness；安装时会从 npm 获取上游官方包，并打开其本地 Web UI。

• 固定运行时：@deepseek-ai/dsh@0.1.0-rc.6，完整依赖图记录在 runtime/package-lock.json
• 上游源码测试基线：0.1.0-rc.5，提交 47f943859bef60e4160492346772ded9b24f765a
• 核对日期：2026-08-13
• 上游 Node.js 要求：^22.19.0 || >=24.0.0
• 本项目实机测试：Apple Silicon，macOS 26

DeepSeek Harness 仍处于 Developer Preview，上游明确说明未来会出现破坏兼容性的变更。启动器版本与 Harness 版本彼此独立；遇到问题时请同时报告两者的实际版本。

名称与图标

本项目使用独立设计的名称和中性启动器图标。仓库及安装包不包含 DeepSeek 的 Logo、鱼形标志、官方 wordmark 或其他官方品牌资产。上游名称仅用于准确说明兼容对象。

安全说明

• 安装器不使用 curl | bash，建议先查看源码再运行本地脚本。
• 后台服务只监听 127.0.0.1，不会绑定所有网络接口。
• 127.0.0.1 限制网络范围，但不提供身份认证；请只在可信 Mac 上使用，也不要代理或转发 3080 端口。
• 关闭浏览器不会停止后台服务；它会在退出、重启或卸载时停止。
• 端口 3080 被未知程序占用时，启动器会停止并提示，不会结束占用程序。
• 启动器不会自动执行 git pull、自动升级上游或上传本机数据。
• Harness 本身可以读取或修改你选定的工作区并执行命令；请根据任务选择合适的访问模式和批准策略。
• 目前没有 Apple Developer ID 公证发行包，因此安装器会在你的 Mac 上本地构建和临时签名应用。

安全问题请参见 SECURITY.md。

支持

启动器自身的问题请提交到本仓库。DeepSeek Harness 上游问题请先在官方仓库核实后，按其社区渠道反馈。请勿将本项目描述为官方 macOS 客户端，也不要向上游提交仅由本启动器造成的问题。

上游链接

• DeepSeek Harness 官方仓库
• 官方运行说明
• Web UI 指南
• 上游 MIT License
• 官方 npm 包

许可证与归属

本仓库中的启动器代码和独立图标按 MIT License 发布。

DeepSeek Harness 是独立的上游项目，Copyright (c) 2026 DeepSeek，采用 MIT License。本项目不改变、替代或再许可上游及其依赖的原始许可证。详细归属见 THIRD_PARTY_NOTICES.md。