macOS 上跑 DeepSeek Harness：Homebrew、PATH 与完全磁盘访问

macOS 不是另一款产品

在 macOS 上跑 DeepSeek Harness，仍然是 Node.js + npx @deepseek-ai/dsh web，再用浏览器打开 http://127.0.0.1:3080/。命令与 安装清单、npx 快速开始 一致。变的是 Mac 外围环境：Homebrew／官方 pkg／nvm 谁在 PATH、哪个终端会话生效，以及系统隐私（TCC）会不会静默挡住工作区写入。

本文是 macOS 专用补充，对应 Windows 上的 DeepSeek Harness。若进程根本没绑上端口、或 3080 被占，请直接去 npx / 3080 阶梯，别反复读系统一句话说明。

精确开关仍以上游为准。官方 README 与本页冲突时，以 README 为准。产品叙事也在 deepseek.com/harness——本站写的是本地 npx 操作路径，不是第二家桌面应用商店。

选定一条 Node 安装路径并坚持用

同一台 Mac 上可能同时有 Homebrew Node、nodejs.org 官方包、nvm/fnm，以及过旧的 Xcode 命令行 node。每个终端标签页看到的二进制可以完全不同。

1. 第一个小时先决定怎么管 Node。Homebrew（brew install node）或官方 pkg 都行；用 nvm/fnm 就在同一个窗口里 nvm use / fnm use 再跑 npx。
2. 只在那个窗口执行 node -v 与 npm -v。上游预览要求 Node ^22.19.0 或 >=24.0.0。
3. 社区若提示早期 Node 24.0/24.1 有静默退出类问题，优先 ^22.19 或较新的 24.x，并以 upstream engines 为准——别一上来就怪「Mac 特有」。
4. 不要混用：Homebrew 装完，却在仍指向 Node 18 的旧 nvm 标签页里跑 npx。

Apple Silicon 与 Intel 很少改变 npx 命令本身，改变的是你下到的是哪套二进制。若某个架构切片里 node -v 失败（Rosetta 终端 vs 原生），先修 Node 安装，不要发明第二个 Harness 包名。

从可丢弃项目目录启动

1. 装好或选好版本范围内的 Node，然后退出并重开终端，让 PATH 刷新。
2. cd 进可丢弃仓库（例如 ~/scratch/dsh-demo），不要指向整个用户主目录。
3. 执行：

npx @deepseek-ai/dsh web

保持终端运行。关掉它就等于停服务。首次拉包在慢网上像卡住——镜像与缓存问题见 排错。

完全磁盘访问不是第一天必选项

Agent 触碰工作区时，macOS 可能弹出文件夹权限，这正常。完全磁盘访问（系统设置 → 隐私与安全性）权限更宽——以后特殊工具或许用得上，但不要「以防万一」第一天就开。

• 先用允许读写的可丢弃仓库。
• UI 看起来正常却写不进文件时，查 Terminal／浏览器相关的 TCC 提示，不要只盯聊天框报错。
• 第一会话不要指向 ~，也不要混着还在学 Trajectory 时就把工作区丢进 iCloud 同步的文稿目录。
• 企业 MDM 若拦截未签名 npm 脚本，会像产品故障——先核 Node 与 registry。

UI 起来后：在设置里粘贴 DeepSeek 平台密钥，选可丢弃工作区，发一个低风险提示（列顶层文件）。本地 UI 多半是控制面，不是离线权重。

本机回环上的 3080

默认 Web UI 是 http://127.0.0.1:3080/。查占用：

lsof -iTCP:3080 -sTCP:LISTEN

结束该进程，或按上游文档换端口。第一次请留在 localhost——绑 0.0.0.0 是安全决策。终端健康但页面空白：换干净浏览器配置试试；扩展有时会拦本地脚本。

桌面封装是可选路径，不是默认

搜「DeepSeek Harness Mac」会看到社区或官方桌面安装器，有的用户可以跳过 Node。本文记录的是与 安装页 一致的 npx / CLI Web UI 路径。若你用封装 App，仍请收窄工作区，并把能拉起 Shell 的工具当软件评审——见 插件安全清单。

本文不是什么

• 不是第二篇完整快速开始——叙事安装仍在 npx 快速开始。
• 不是每一种启动失败的决策树——见 修好 npx 与端口 3080。
• 不是 Windows PATH 专文——那是 Windows 上跑 DSH。
• 不是给任何第三方 Mac 应用商店克隆站台。

接下来去哪

1. 系统一键与验证步骤：安装。
2. 第一小时剧本：npx 快速开始。
3. 症状阶梯：排错 与 3080 文章。
4. 跑通后再选 模式，再堆社区插件。