macOS 原生启动器FlyXingByte/deepseek-harness-macos

macOS 版 DeepSeek Harness

让官方 DeepSeek Harness，真正住进程序坞。
非官方启动器 · 独立窗口 · 本机工作区

↓ 下载 v3.0.0

安装说明
· 官方 Harness ↗

Apple Silicon · macOS 12+ · Node.js 22.19–22.x 或 24.0+（不支持 23.x）

[!WARNING]
v3.0.0 尚未公证。 首次打开：在访达中右键 App → 打开 → 再确认；不要关闭 Gatekeeper。

一个窗口。不是一个浏览器标签。

这是一个轻量的原生 macOS 启动器。它默认启动经过验证的官方 DeepSeek Harness 版本，也可以在你确认后选择 npm 官方发布的新版，并把工作台显示在独立窗口中。

- 从程序坞打开：独立窗口、菜单栏和 App 图标。
- 原生窗口交互：拖动标题栏移动窗口；Command + / Command - 调整字体，Command 0 恢复默认大小。
- 没有浏览器痕迹：标题栏与工作台背景融为一体并跟随明暗主题；右键只保留原生编辑命令，控件不再出现网页手型光标与文字选中，整页橡皮筋回弹和网页滚动条也一并去掉。
- 默认 / Alpha 双更新通道：默认通道读取 npm 官方 latest / next；显式启用实验通道后才读取 alpha。每次切换都会记录旧版本并保留自动回退点。
- 归档的会话可以真正删除：官方内核只把会话隐藏，启动器可以把这些记录移入废纸篓，并同时清干净侧边栏里的残留条目。
- 服务留在本机：Harness Web UI 仅监听 127.0.0.1:3080。
- 工作区由你选择：使用隔离的默认目录，或切换到自己的项目文件夹。

v3.0.0 主版本更新：完整支持 dsh 0.1.2-alpha.3

官方 alpha.3 给本机 Web UI 增加了本次启动浏览器令牌，并把 Session 投影缓存从单文件改成逐会话文件。旧启动器只改版本号会得到 401，同时把令牌原样写进日志。v3.0.0 以主版本升级补齐了这条兼容链：

- 启动器从自己创建的进程输出中严格识别本机认证 URL，只在内存中交给 WKWebView 完成 303 / HttpOnly Cookie 交换。
- 所有日志写入都先脱敏，token= 后的值不会进入 harness-web.log、弹窗或 UserDefaults。
- 401 被识别为“已有需要认证的外部 Harness”，不会误判端口空闲后再启动第二个服务。
- 新版未能通过最终 HTTP 200 和页面验证时，自动恢复上一个已知可用内核。
- 更新菜单新增 Alpha 实验通道；普通 latest / next 通道仍不会静默跨入 alpha。
- 归档清理同时兼容旧 session_projcache.json 与 alpha.3 的 session_projcache/sessions/.json，未知格式、软链接或备份失败都会停止清理。

本版本默认推荐 @deepseek-ai/dsh@0.1.2-alpha.3，已验证回退点为 0.1.1-rc.2，历史最低保留到 0.1.0-rc.6。alpha.3 已移除可选 SQLite Session 后端；自定义 SQLite Profile 必须先在旧版导出。默认 JSONL Session 不受影响。

v2.7.0 重点更新：归档之后，可以真正删除

官方 Harness 的会话列表只提供归档：会话从侧边栏消失，但完整记录仍然留在 ~/.dsh/sessions 里，一个字节都没少。想腾出空间、或者让某段对话真正消失，就只能自己去翻目录。

v2.7.0 把这最后一步交给启动器。App 菜单里多了一项 清除已归档的会话…（N 个）：

- 标题里直接写明有多少个可清；没有归档会话时置灰，不会出现点了等于没点的情况。
- 确认框先算清楚这次会清掉几个会话、多少体积，确认之后才动手。
- 会话记录移入废纸篓而不是直接抹掉，误清可以拖回来。
- 同时清理 workspace.json 的归档集合与工作区成员，以及 session_projcache.json 的标题和统计缓存，侧边栏不留残影。
- 改写这两个列表文件前自动备份到 ~/Library/Logs/DeepSeek Harness/storage-backups/，只保留最近 5 份。

内核会把会话列表常驻内存并回写，所以清除时会先停止再重启 Harness 内核；工作台里未发送的内容可能丢失。如果 127.0.0.1:3080 是你在终端里启动的服务，启动器只提示你先停掉它，不会擅自终止外部进程。

删除范围也画得很死：只动 /sessions// 这一层，路径形状不符即跳过并报告；某个目录没能移入废纸篓时保留它的列表条目，不会产生看不见的孤儿记录。子代理会话记录不参与清除，因为父子关系只存在于 zstd 压缩的日志头内，启动器不做猜测。

v2.6.0 重点更新：内核回退，一次退一步
v2.4.0 让你可以自己跟进官方内核，但当时的回退只有一个目的地——随 App 内置的默认版本。如果你已经连着更新过好几次，一次回退就会把中间那些能用的版本全部跳过。

v2.6.0 改成按历史逐级回退：

- 每次切换内核前，启动器都会把正在使用的那一版记入历史（最多 10 条）。
- 菜单项从「恢复内置内核」变成 回退到上一版内核 …，标题里直接写明这次会退回哪个版本。
- 连续点击就会沿着历史一路往回退，最终回到内置版本；没有可回退的目标时，菜单项是灰色的，不会再出现点了等于没点的情况。
- 回退目标会按 SemVer 校验，且永远不会低于内置的 0.1.0-rc.6，所以以后升级启动器也不会在历史里留下跑不起来的版本。

版本历史从本次发布开始累积，更早的切换记录无法追溯。

v2.5.0 重点更新：像 App 一样打开，不再弹出 Safari

Harness 的工作台本质仍由官方 Web UI 提供，macOS 启动器继续使用 WKWebView 承载它。v2.5.0 改进的是呈现和启动方式：保留 Web UI 的完整能力，同时去掉会让独立窗口看起来像浏览器标签页的交互痕迹。

- 标准 macOS 标题栏与工作台背景融为一体，并跟随页面的明暗主题。
- 控件使用普通箭头光标，导航与按钮文字不再被误选；输入框和编辑区仍保留文本光标与原生复制粘贴。
- 右键菜单只保留剪切、复制、粘贴、撤销、重做等编辑命令，不再显示重新载入、后退、前进或检查元素。
- 关闭整页橡皮筋回弹、链接预览和资源拖拽，并让滚动条更接近 macOS 的轻量样式。
- 启动官方 Harness 时加入 --no-open，因此从程序坞打开 App 不会再自动弹出同一个 127.0.0.1:3080 Safari 页面；真正的外部链接仍交给默认浏览器。

v2.4.0 重点更新：Harness 内核可以自己跟进官方版本

以前，启动器和 Harness 内核版本绑定在一起：即使 DeepSeek 官方已经发布新内核，也要等启动器重新打包。v2.4.0 把这两件事拆开了——macOS App 继续提供稳定的原生窗口，Harness 内核则可以由你主动检查并切换。

打开 macOS 屏幕顶部的 DeepSeek Harness 菜单，你会看到：

- Harness 内核：0.1.0-rc.6：显示当前选择的内核版本。
- 检查并更新 Harness 内核…：一键读取 npm 官方 latest 与 next，通过 SemVer 自动选择更高版本。
- 回退到上一版内核 0.1.0-rc.6：新版出现兼容问题时，可以回退到切换之前正在使用的那一版；连续更新过多次时，可以逐级往回退，最终回到内置的默认版本。

更新过程保留了一道人为确认：发现新版后，App 会先显示当前版本和目标版本，只有点击 更新并重启 才会切换。这不是后台静默升级，因为 Harness 仍处于 Developer Preview，新版本可能包含破坏兼容性的变化。

安全边界也没有扩大：

- 更新信息只来自固定的 npm 官方 dist-tags 地址，异常或不合法的版本号会被拒绝。
- App 只重启由它自己启动的 Harness 进程；如果 127.0.0.1:3080 是其他终端启动的服务，只保存新版选择，不会擅自结束外部进程。
- 更新只改变以后由 npx 获取的官方 @deepseek-ai/dsh 版本，不读取、迁移或修改 Harness 的 API Key、会话与工作区数据。

三步安装

1. 下载 v3.0.0 DMG，打开后把 DeepSeek Harness.app 拖入 Applications。
2. 在“应用程序”中右键 App，选择 打开，然后在 macOS 提示中再次确认。
3. v3.0.0 首次启动时确认通过 npx 获取默认推荐的官方 @deepseek-ai/dsh@0.1.2-alpha.3，等待安全浏览器会话建立。

首次获取需要联网。请先从 Node.js 官网 安装 Node.js；Harness 与 Node.js 均不包含在 DMG 中。

第一次使用

1. 打开右上角 Settings → Models，配置 Provider 与 API Key。
2. 保存设置，并在模型选择器中选中刚配置的模型。
3. 点击 Choose workspace，选择一个独立的项目文件夹。
4. 新建会话，选择合适的权限，再输入任务。

查看官方 Web UI 快速指南 ↗

开始第一个任务与权限建议

建议先用 Read Only 做一个小任务：

只读分析这个项目。告诉我它解决什么问题、主要文件在哪里，以及下一步最值得做的三件事。不要修改文件。

- Read Only：阅读、总结、审查，不修改文件。
- Workspace Write：普通开发、修改文件和运行项目内命令。
- Full access：仅在明确需要超出工作区时使用，并逐项确认风险。

边界很清楚

- Launcher：本仓库提供，包含在 DMG 中，负责窗口、程序坞图标和启动管理。
- DeepSeek Harness：由 DeepSeek 官方维护，不包含在 DMG 中；首次启动经你确认后获取。
- Node.js：由用户安装，用于运行 npx 与 Harness。

[!NOTE]
DeepSeek Harness 仍处于 Developer Preview，可能出现破坏兼容性的变化。v3.0.0 默认推荐并在首次下载前明确警告 @deepseek-ai/dsh@0.1.2-alpha.3，已知可用回退点为 0.1.1-rc.2。后续继续跟进 npm Alpha 通道必须显式启用；每次切换前的版本都会记入历史。回退会恢复执行版本，但不会自动逆转上游已经写入的数据格式变化。

这是 FlyX 独立制作的非官方启动器，与 DeepSeek 或 Apple Inc. 无隶属、赞助或背书关系。名称仅用于说明兼容性；鲸鱼图标与主视觉不是官方素材。

工作区与数据
- 默认工作区为 ~/Documents/DeepSeek Harness Workspace；也可从 App 菜单切换。
- 模型凭据由官方 Harness 管理；启动器自身不存储或迁移 API Key。
- Web UI 只监听本机，但模型请求仍会发送给你配置的 Provider。
- 外接盘建议使用 APFS；exFAT 可能因受保护写入能力不足出现 ENOTSUP。
- 会话记录由官方 Harness 保存在 $DSH_HOME/sessions（默认 ~/.dsh/sessions）；归档只是隐藏，可用菜单里的「清除已归档的会话…」把它们移入废纸篓。
- 启动日志位于 ~/Library/Logs/DeepSeek Harness/harness-web.log。

安全细节与官方参考

外部 HTTP/HTTPS 链接交给默认浏览器；未知自定义协议会被阻止。插件、MCP 和其他第三方组件可能执行外部代码，安装前请单独审查来源与权限。Harness 通过 Models 页面保存的 Key 位于 $DSH_HOME/.credentials.yaml，页面不会回显明文。

权限预设 · 沙箱边界 · 操作审批 · 凭据管理 · 本地 Web Server · 会话遥测

更多 DeepSeek Harness 官方资料

- DeepSeek Harness 官方页面
- 官方 GitHub 仓库
- 中文快速启动
- 官方文档主页
- 模型与 Provider 配置
- 权限预设说明
- CLI 模式说明（中文）
- CLI 精确行为参考（中文）

常见问题

macOS 提示无法验证开发者？ 这是未公证的公开测试版。请在访达中右键 App → 打开 → 再确认；不要关闭 Gatekeeper。

提示找不到 Node.js 或 npx？ 从 Node.js 官网 安装 Node.js 22.19–22.x 或 24.0+（不支持 23.x），然后重新打开 App。

输入框不可用？ 先在 Settings → Models 配置并选择模型，再点击 Choose workspace 选择工作区。

怎样更新 Harness 内核？ 打开菜单栏中的 DeepSeek Harness → 检查并更新 Harness 内核…。若官方存在更高版本，启动器会自动选中并请求确认；若当前 3080 服务由其他终端启动，只保存选择，不会擅自终止外部进程。

为什么默认通道看不到 alpha？ 默认通道只读取 latest / next。需要测试官方实验版时，先勾选 使用 Alpha 实验更新通道，再检查更新。

新内核不好用怎么办？ 打开 DeepSeek Harness → 回退到上一版内核 …，菜单里直接显示会回退到哪个版本。启动器最多记录 10 次切换历史，可以连续回退；没有可回退的版本时该菜单项为灰色。

验证下载文件与本地构建

下载 SHA-256 文件 后，在终端运行：

cd ~/Downloads
shasum -a 256 -c DeepSeek-Harness-v3.0.0-macOS-arm64.dmg.sha256

本地构建与验证：

./scripts/build.sh
./scripts/create-dmg.sh
./scripts/verify-release.sh
脚本只进行 ad-hoc hardened runtime 签名；无警告分发仍需要 Developer ID Application 证书和 Apple notarization。

v3.0.0 · 更新历史 · DSH 0.1.2-alpha.3 · arm64 · MIT · NOTICE · Issues