macOS 上 DeepSeek Harness 报错：launchd 找不到 node 与 exFAT 安装失败的修复

macOS 上 DeepSeek Harness 两个典型报错：launchd 开机自启崩溃循环（launchd 不继承 shell 的 PATH、找不到 node）与 exFAT 卷安装失败（exFAT 无 inode 归属检查、pnpm 装依赖报错）。 分别用「plist 写全 PATH」与「换 APFS/本地卷安装」解决，再验证。

两个现象：DeepSeek Harness 自启崩溃循环与 exFAT 卷安装失败

两个现象互不相同：自启崩溃是进程管理问题、安装失败是文件系统问题。 逐一说明（来源）：

1. launchd 找不到 node、自启崩溃循环——设为开机自启后，启动即崩、反复重启；手动在终端执行却正常；
2. exFAT 卷安装失败——把项目放到外置 exFAT 卷（或移动硬盘）上安装，pnpm 报错（如 lefthook 相关 inode 校验失败）；
3. 手动执行正常、只有自启崩 → launchd 问题；只有特定磁盘卷装不上 → 文件系统问题。

DeepSeek Harness 报错根因：launchd 不继承 PATH、exFAT 无 inode 归属检查

两条根因：launchd 启动的服务不带 shell 的 PATH 环境变量；exFAT 文件系统没有 inode 归属检查，pnpm 依赖安装校验失败。 展开说：

1. launchd 不继承 shell PATH——launchd 是系统级进程管理器，启动的服务不经过 shell，不继承 .zshrc 里的 PATH；node 装在 /opt/homebrew/bin 等非默认目录时找不到（来源）；
2. exFAT 无 inode 归属检查——exFAT 面向移动存储设计，缺少 POSIX 的 inode 归属/权限元数据，pnpm 安装依赖时校验失败（来源）；
3. 两条都在官方仓库有对应讨论与修复记录（来源）。

解决 DeepSeek Harness 报错：plist 写全 PATH、换 APFS/本地卷安装

按现象分流：自启崩修 plist 环境变量，装不上换 APFS 或本地卷。 逐步操作：

1. 查出 node 实际路径（供 plist 使用）：
   bash

   which node
   # 例如 /opt/homebrew/bin/node（Apple Silicon Homebrew）
   

2. 在 launchd plist 写全 PATH——编辑 plist，在 dict 里加 EnvironmentVariables：
   xml

   <key>EnvironmentVariables</key>
   <dict>
     <key>PATH</key>
     <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
   </dict>
   

   保存后重载：
   bash

   launchctl unload <plist路径>
   launchctl load <plist路径>
   # 新版系统可用 bootout/bootstrap 等价命令
   

   用 launchctl print <label> 确认 PATH 已生效（来源）。
3. 换 APFS/本地卷安装（解决 exFAT 安装失败）：
   • 把项目从外置 exFAT 卷复制到系统磁盘（APFS）或本地卷；
   • 删除卷上残留的 node_modules 与 .pnpm-store，避免残留元数据干扰；
   • 在 APFS 路径下重新执行安装（pnpm install 或 dsh plugin ... add）。
4. 验证：
   • 自启：重启后服务自动拉起、不再崩溃循环；
   • 安装：pnpm install 与依赖安装全部成功，dsh web 正常启动。

DeepSeek Harness 修复后怎么验证？PATH 生效、自启恢复与安装完整三查

修复后三查确认：plist PATH 已生效、自启不再崩溃循环、APFS 路径安装全绿——三查全过才算修好。 按顺序执行：

1. 确认 plist PATH 生效——查 launchd 里的环境变量：

   bash

   launchctl print <label> | grep PATH
   

   输出里能看到 /opt/homebrew/bin（含 node 路径）即生效；只有默认 PATH 说明 plist 没写对，回上节第 2 步。

2. 自启回归验证——手动拉起服务，确认不再崩溃循环：

   bash

   launchctl kickstart -k gui/$(id -u)/<label>
   

   服务能持续运行、进程不反复退出重启；有条件就重启系统，开机后服务应自动拉起。

3. 确认项目在 APFS/本地卷——查看当前工作目录所在卷的文件系统类型：

   bash

   mount | grep "<卷路径或工作目录>"
   # 输出应为 apfs、hfs+ 等本地格式；是 exfat 则继续迁移
   

4. 重装验证——在 APFS 路径下执行安装：

   bash

   pnpm install
   

   依赖安装全绿、不再报 inode/lefthook 校验类错误。

5. 整链验证——dsh web 启动正常、发一条对话收到回复，且自启场景重启后服务自动运行，即 macOS 平台问题闭环。

注意事项：先分清是 launchd 问题还是文件系统问题

1. 手动执行正常、只有自启崩，一定先查 launchd 的 PATH，别怀疑安装本身。
2. plist 写 PATH 时用 which node 的真实路径，不同安装方式路径不同。
3. 外置 exFAT 盘适合存数据备份，不适合装依赖；依赖装到 APFS/本地卷。
4. 换卷后重装前先清残留的 node_modules，避免旧文件系统元数据干扰。
5. 其他安装报错可参考安装报错排查。

来源：dshbase 常见问题排错、Apple developer documentation（launchd.plist）、DeepSeek Harness 官方仓库