[BUG] mac x64 桌面端 1.0.0 启动即崩:包内只带 @lydell/node-pty-darwin-arm64,缺 darwin-x64 平台包 #15

已关闭
由 willwang 于 2026-11-10 17:45:57 +08:00创建 · 4 评论

现象

从 releases 的 desktop-stable(2026-11-08)下载 octopus-desktop-mac-x64.dmg,装到 Intel Mac 上打开即显示:

内置服务启动失败
sidecar exited unexpectedly (code 1); auto-restart budget exhausted

点「重启内置服务」无效,重试预算耗尽后只能停在错误页。

环境

项 值
macOS 12.7.6 (21H1320)
CPU Intel Core i5-6267U(uname -m = x86_64,非 Apple Silicon、非 Rosetta)
安装包 octopus-desktop-mac-x64.dmg(desktop-stable,2026-11-08 构建)
应用 /Applications/Octopus.app,CFBundleShortVersionString = 1.0.0
宿主二进制 Contents/MacOS/Octopus = Mach-O 64-bit executable x86_64(架构本身正确)
日志 ~/Library/Application Support/@octopus-ai/desktop/logs/sidecar.log

Octopus Beta.app(2026-11-07 构建)同样复现,同一份日志里两类错误共 31 次,说明不是单次偶发。

根因

x64 的 dmg 里,sidecar 的原生依赖只打进了 arm64 版本,缺 darwin-x64 的平台包。

  • Contents/Resources/sidecar/package.json 只声明了一个平台包:
{
  "name": "octopus-sidecar-bundle",
  "dependencies": {
    "@lydell/node-pty": "*",
    "@lydell/node-pty-darwin-arm64": "*",
    ...
  }
}
  • 因此包内目录只有 arm64:
Contents/Resources/sidecar/node_modules/@lydell/
├── node-pty
└── node-pty-darwin-arm64        ← 只有这个
  • 而 @lydell/node-pty(1.2.0-beta.10)的 index.js 在运行时按宿主平台 require 对应包,x64 上要的就是 @lydell/node-pty-darwin-x64,找不到即 throw,进程以 code 1 退出:
Error: The @lydell/node-pty package supports your platform (darwin-x64), but it could not find the platform-specific package for it: @lydell/node-pty-darwin-x64
  • 包内唯一的 .node 也确实是 arm64,即使能加载也无法在 Intel 上运行:
node_modules/@lydell/node-pty-darwin-arm64/prebuilds/darwin-arm64/pty.node
  → Mach-O 64-bit bundle arm64

推测成因:打包机是 Apple Silicon,npm install 按宿主机平台只落盘 optionalDependencies 里的 arm64 分支,随后用这份 node_modules 去产 x64 的 dmg(mac.target.arch=x64 只换了 Electron 外壳,没有换 sidecar 的原生依赖)。

报错日志(sidecar.log 尾部,节选)

(node:5885) [DEP0040] DeprecationWarning: The `punycode` module is deprecated.
(Use `Octopus Helper --trace-deprecation ...` to show where the warning was created)
/Applications/Octopus.app/Contents/Resources/sidecar/node_modules/@lydell/node-pty/index.js:19
      throw new Error(
            ^

Error: The @lydell/node-pty package supports your platform (darwin-x64), but it could not find the platform-specific package for it: @lydell/node-pty-darwin-x64

This can happen if you use the "--omit=optional" (or "--no-optional") npm flag.
The "optionalDependencies" package.json feature is used to install the correct
binary executable for your current platform. Remove that flag to use @lydell/node-pty.

This can also happen if the "node_modules" folder was copied between two operating systems
that need different binaries - including "virtual" operating systems like Docker and WSL.
If so, try installing with npm rather than copying "node_modules".
    at requirePlatformSpecificPackage (.../node_modules/@lydell/node-pty/index.js:19:13)
    at Object.<anonymous> (.../node_modules/@lydell/node-pty/index.js:47:18)
    ...
  [cause]: Error: Cannot find module '@lydell/node-pty-darwin-x64'
    code: 'MODULE_NOT_FOUND'
    requireStack: ['.../node_modules/@lydell/node-pty/index.js']
}

Node.js v24.19.0

完整日志(含 31 次崩溃重试)已作为附件上传。

修复建议(按优先级)

  1. 构建期:产 x64 包时显式拉齐两个平台的 pty 包,别依赖宿主机解析。例如打包前执行
    npm i --include=optional --os=darwin --cpu=x64 @lydell/node-pty@1.2.0-beta.10 @lydell/node-pty-darwin-x64@1.2.0-beta.10,
    或直接把 @lydell/node-pty-darwin-x64 写进 sidecar/package.json 的 dependencies(arm64 同理),两个包都进 Resources/sidecar/node_modules/@lydell/。
    更稳的做法:x64 包在 x64 runner 上打(macos-13),arm64 在 macos-14 上打。
  2. 发布期加门禁:打包后断言 Resources/sidecar/node_modules/@lydell/ 存在与 mac.target.arch 一致的平台包,并用 file 校验 pty.node 的架构;不一致直接 fail CI。这类错在 Intel 机器上一启动就 100% 命中,值得卡在流水线上。
  3. 运行期兜底:桌面端在 spawn sidecar 前做一次原生依赖自检(platform/arch 对不上时给出「该安装包与当前 CPU 不匹配,请下载 xx 版本」的可读提示),而不是让用户看到 auto-restart budget exhausted 这种内部机制文案。

临时绕过(供其他 Intel 用户参考,不改官方包)

手动把 @lydell/node-pty-darwin-x64@1.2.0-beta.10(npm 上 30KB 的 tarball,x86_64 的 pty.node + spawn-helper)解压进
/Applications/Octopus.app/Contents/Resources/sidecar/node_modules/@lydell/node-pty-darwin-x64 即可恢复启动;该应用带
com.apple.security.cs.disable-library-validation 权限,未签名的 .node 可直接加载,不必重签。

## 现象 从 releases 的 `desktop-stable`(2026-11-08)下载 **`octopus-desktop-mac-x64.dmg`**,装到 Intel Mac 上打开即显示: ``` 内置服务启动失败 sidecar exited unexpectedly (code 1); auto-restart budget exhausted ``` 点「重启内置服务」无效,重试预算耗尽后只能停在错误页。 ## 环境 | 项 | 值 | |---|---| | macOS | 12.7.6 (21H1320) | | CPU | Intel Core i5-6267U(`uname -m` = `x86_64`,非 Apple Silicon、非 Rosetta) | | 安装包 | `octopus-desktop-mac-x64.dmg`(desktop-stable,2026-11-08 构建) | | 应用 | `/Applications/Octopus.app`,CFBundleShortVersionString = 1.0.0 | | 宿主二进制 | `Contents/MacOS/Octopus` = Mach-O 64-bit executable **x86_64**(架构本身正确) | | 日志 | `~/Library/Application Support/@octopus-ai/desktop/logs/sidecar.log` | `Octopus Beta.app`(2026-11-07 构建)同样复现,同一份日志里两类错误共 31 次,说明不是单次偶发。 ## 根因 **x64 的 dmg 里,sidecar 的原生依赖只打进了 arm64 版本,缺 `darwin-x64` 的平台包。** - `Contents/Resources/sidecar/package.json` 只声明了一个平台包: ```json { "name": "octopus-sidecar-bundle", "dependencies": { "@lydell/node-pty": "*", "@lydell/node-pty-darwin-arm64": "*", ... } } ``` - 因此包内目录只有 arm64: ``` Contents/Resources/sidecar/node_modules/@lydell/ ├── node-pty └── node-pty-darwin-arm64 ← 只有这个 ``` - 而 `@lydell/node-pty`(1.2.0-beta.10)的 `index.js` 在运行时按宿主平台 `require` 对应包,x64 上要的就是 `@lydell/node-pty-darwin-x64`,找不到即 `throw`,进程以 code 1 退出: ``` Error: The @lydell/node-pty package supports your platform (darwin-x64), but it could not find the platform-specific package for it: @lydell/node-pty-darwin-x64 ``` - 包内唯一的 `.node` 也确实是 arm64,即使能加载也无法在 Intel 上运行: ``` node_modules/@lydell/node-pty-darwin-arm64/prebuilds/darwin-arm64/pty.node → Mach-O 64-bit bundle arm64 ``` 推测成因:打包机是 Apple Silicon,`npm install` 按宿主机平台只落盘 `optionalDependencies` 里的 arm64 分支,随后用这份 `node_modules` 去产 x64 的 dmg(`mac.target.arch=x64` 只换了 Electron 外壳,没有换 sidecar 的原生依赖)。 ## 报错日志(sidecar.log 尾部,节选) ``` (node:5885) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. (Use `Octopus Helper --trace-deprecation ...` to show where the warning was created) /Applications/Octopus.app/Contents/Resources/sidecar/node_modules/@lydell/node-pty/index.js:19 throw new Error( ^ Error: The @lydell/node-pty package supports your platform (darwin-x64), but it could not find the platform-specific package for it: @lydell/node-pty-darwin-x64 This can happen if you use the "--omit=optional" (or "--no-optional") npm flag. The "optionalDependencies" package.json feature is used to install the correct binary executable for your current platform. Remove that flag to use @lydell/node-pty. This can also happen if the "node_modules" folder was copied between two operating systems that need different binaries - including "virtual" operating systems like Docker and WSL. If so, try installing with npm rather than copying "node_modules". at requirePlatformSpecificPackage (.../node_modules/@lydell/node-pty/index.js:19:13) at Object.<anonymous> (.../node_modules/@lydell/node-pty/index.js:47:18) ... [cause]: Error: Cannot find module '@lydell/node-pty-darwin-x64' code: 'MODULE_NOT_FOUND' requireStack: ['.../node_modules/@lydell/node-pty/index.js'] } Node.js v24.19.0 ``` 完整日志(含 31 次崩溃重试)已作为附件上传。 ## 修复建议(按优先级) 1. **构建期**:产 x64 包时显式拉齐两个平台的 pty 包,别依赖宿主机解析。例如打包前执行 `npm i --include=optional --os=darwin --cpu=x64 @lydell/node-pty@1.2.0-beta.10 @lydell/node-pty-darwin-x64@1.2.0-beta.10`, 或直接把 `@lydell/node-pty-darwin-x64` 写进 `sidecar/package.json` 的 dependencies(arm64 同理),两个包都进 `Resources/sidecar/node_modules/@lydell/`。 更稳的做法:x64 包在 x64 runner 上打(`macos-13`),arm64 在 `macos-14` 上打。 2. **发布期加门禁**:打包后断言 `Resources/sidecar/node_modules/@lydell/` 存在与 `mac.target.arch` 一致的平台包,并用 `file` 校验 `pty.node` 的架构;不一致直接 fail CI。这类错在 Intel 机器上一启动就 100% 命中,值得卡在流水线上。 3. **运行期兜底**:桌面端在 spawn sidecar 前做一次原生依赖自检(platform/arch 对不上时给出「该安装包与当前 CPU 不匹配,请下载 xx 版本」的可读提示),而不是让用户看到 `auto-restart budget exhausted` 这种内部机制文案。 ## 临时绕过(供其他 Intel 用户参考,不改官方包) 手动把 `@lydell/node-pty-darwin-x64@1.2.0-beta.10`(npm 上 30KB 的 tarball,x86_64 的 `pty.node` + `spawn-helper`)解压进 `/Applications/Octopus.app/Contents/Resources/sidecar/node_modules/@lydell/node-pty-darwin-x64` 即可恢复启动;该应用带 `com.apple.security.cs.disable-library-validation` 权限,未签名的 `.node` 可直接加载,不必重签。
作者

补充两份附件:

  • 界面截图:内置服务启动失败
  • 完整 sidecar.log(gzip,含 31 次崩溃重试;未压缩约 1.2MB):sidecar.log.gz

复现口径:全新安装 octopus-desktop-mac-x64.dmg(desktop-stable)→ 首次启动即失败,与用户数据/旧配置无关;Octopus Beta.app(11-07 构建)同因复现。若需要我配合验证修复版,直接在本单回复即可。

补充两份附件: - 界面截图:![内置服务启动失败](https://eightarms.net/attachments/86f31e6e-7d40-481a-9499-5cd1791e778a) - 完整 sidecar.log(gzip,含 31 次崩溃重试;未压缩约 1.2MB):[sidecar.log.gz](https://eightarms.net/attachments/78d5c266-f3a3-458c-bc1a-9d93b2284d02) 复现口径:全新安装 `octopus-desktop-mac-x64.dmg`(desktop-stable)→ 首次启动即失败,与用户数据/旧配置无关;`Octopus Beta.app`(11-07 构建)同因复现。若需要我配合验证修复版,直接在本单回复即可。
ZJZ 于 2026-11-10 18:55:44 +08:00 指派给自己
成员

claim 认领(ZJZ)。根因方向已确认在打包侧:x64 切片复用了 arm64 构建的 sidecar 暂存目录,其中只装了 @lydell/node-pty-darwin-arm64。修复方案与发布计划见后续回帖。

**claim** 认领(ZJZ)。根因方向已确认在打包侧:x64 切片复用了 arm64 构建的 sidecar 暂存目录,其中只装了 `@lydell/node-pty-darwin-arm64`。修复方案与发布计划见后续回帖。
成员

修复已发布:v1.0.1(desktop-stable)

根因修复链

  1. 打包架构门禁(PR #7071):electron-builder afterPack 挂 Mach-O cputype 探针,mac 产物逐 arch 校验 sidecar 必须含匹配的 @lydell/node-pty-darwin-<arch>/prebuilds/.../pty.node,缺包 fail-loud(附 24 个复刻事故姿势的测试)。本次 1.0.1 构建已过该门禁。
  2. 版本热修 1.0.0 → 1.0.1(PR #7073),mac 双 arch(arm64 + x64)全管线重打。

本次 x64 产物验证(构建机四重证据 + 修复本体确认)

  • 宿主 Contents/MacOS/Octopus:x86_64 ✓
  • sidecar 内 @lydell/node-pty-darwin-x64 就位,pty.node = x86_64 ✓(即 #15 缺的那个包)
  • codesign ai.octopus.desktop(Team 35L272URMA)✓ / Gatekeeper Notarized Developer ID accepted ✓ / stapler validate ✓

请 willwang 实测

直链(desktop-stable,2026-11-11 构建):

https://eightarms.net/Octopus/octopus-release/releases/download/desktop-stable/octopus-desktop-mac-x64.dmg

口径建议与你复现时一致:全新安装(卸载旧版后装 1.0.1),首次启动应直接进入正常界面;如需看日志,sidecar.log 里不应再出现 Cannot find module .../node-pty-darwin-x64 类错误。

注意:prod 通道自动更新当前处于灰度 allowlist 门控(rollout.json),存量 1.0.0 用户暂不会收到自动更新提示,请先手动下载上面的 dmg 验证;验证通过后我们再放量。

arm64 产物(Apple Silicon)不受本次问题影响,也已随 1.0.1 一并重打上架。win/linux 侧产物与本次根因无关,仅为版本一致性在同步发 1.0.1 feed。

**修复已发布:v1.0.1(desktop-stable)** ## 根因修复链 1. **打包架构门禁**(PR #7071):electron-builder `afterPack` 挂 Mach-O cputype 探针,mac 产物逐 arch 校验 sidecar 必须含匹配的 `@lydell/node-pty-darwin-<arch>/prebuilds/.../pty.node`,缺包 fail-loud(附 24 个复刻事故姿势的测试)。本次 1.0.1 构建已过该门禁。 2. **版本热修 1.0.0 → 1.0.1**(PR #7073),mac 双 arch(arm64 + x64)全管线重打。 ## 本次 x64 产物验证(构建机四重证据 + 修复本体确认) - 宿主 `Contents/MacOS/Octopus`:`x86_64` ✓ - sidecar 内 `@lydell/node-pty-darwin-x64` 就位,`pty.node` = `x86_64` ✓(**即 #15 缺的那个包**) - codesign `ai.octopus.desktop`(Team 35L272URMA)✓ / Gatekeeper `Notarized Developer ID` accepted ✓ / `stapler validate` ✓ ## 请 willwang 实测 直链(desktop-stable,2026-11-11 构建): https://eightarms.net/Octopus/octopus-release/releases/download/desktop-stable/octopus-desktop-mac-x64.dmg 口径建议与你复现时一致:**全新安装**(卸载旧版后装 1.0.1),首次启动应直接进入正常界面;如需看日志,`sidecar.log` 里不应再出现 `Cannot find module .../node-pty-darwin-x64` 类错误。 > 注意:prod 通道自动更新当前处于灰度 allowlist 门控(rollout.json),存量 1.0.0 用户暂不会收到自动更新提示,请先手动下载上面的 dmg 验证;验证通过后我们再放量。 arm64 产物(Apple Silicon)不受本次问题影响,也已随 1.0.1 一并重打上架。win/linux 侧产物与本次根因无关,仅为版本一致性在同步发 1.0.1 feed。
成员

收尾关闭。修复链已全部交付并验证:

  • 根因修复:打包架构门禁(PR Octopus/octopus#7071,afterPack Mach-O cputype 对账,24 测试)
  • 修复版本:v1.0.1(tag 8f3e3273f)已上线 desktop-stable;后续 v1.1.0(2026-11-12,tag d72b2d91c)同样携带该门禁,x64 sidecar 含 @lydell/node-pty-darwin-x64(pty.node=x86_64 构建机已验证)
  • feed 三平台 4/4 PASS(latest-mac 4 资产 + rollout canary 名单在位)

Intel Mac 用户请直接下载最新 dmg:https://eightarms.net/Octopus/octopus-release/releases/download/desktop-stable/octopus-desktop-mac-x64.dmg (现指向 v1.1.0)。如仍有问题请重开本单并附 sidecar.log。

**收尾关闭**。修复链已全部交付并验证: - 根因修复:打包架构门禁(PR Octopus/octopus#7071,afterPack Mach-O cputype 对账,24 测试) - 修复版本:v1.0.1(tag 8f3e3273f)已上线 desktop-stable;后续 v1.1.0(2026-11-12,tag d72b2d91c)同样携带该门禁,x64 sidecar 含 `@lydell/node-pty-darwin-x64`(pty.node=x86_64 构建机已验证) - feed 三平台 4/4 PASS(latest-mac 4 资产 + rollout canary 名单在位) Intel Mac 用户请直接下载最新 dmg:https://eightarms.net/Octopus/octopus-release/releases/download/desktop-stable/octopus-desktop-mac-x64.dmg (现指向 v1.1.0)。如仍有问题请重开本单并附 sidecar.log。
ZJZ 于 2026-11-12 16:00:20 +08:00 关闭此工单
登录 并参与到对话中。
未选择标签
2 名参与者
通知
截止日期
未设置截止日期。
依赖工单

未设置依赖工单。

引用:Octopus/release#15