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
推测成因:打包机是 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
现象
从 releases 的
desktop-stable(2026-11-08)下载octopus-desktop-mac-x64.dmg,装到 Intel Mac 上打开即显示:点「重启内置服务」无效,重试预算耗尽后只能停在错误页。
环境
uname -m=x86_64,非 Apple Silicon、非 Rosetta)octopus-desktop-mac-x64.dmg(desktop-stable,2026-11-08 构建)/Applications/Octopus.app,CFBundleShortVersionString = 1.0.0Contents/MacOS/Octopus= Mach-O 64-bit executable x86_64(架构本身正确)~/Library/Application Support/@octopus-ai/desktop/logs/sidecar.logOctopus Beta.app(2026-11-07 构建)同样复现,同一份日志里两类错误共 31 次,说明不是单次偶发。根因
x64 的 dmg 里,sidecar 的原生依赖只打进了 arm64 版本,缺
darwin-x64的平台包。Contents/Resources/sidecar/package.json只声明了一个平台包:@lydell/node-pty(1.2.0-beta.10)的index.js在运行时按宿主平台require对应包,x64 上要的就是@lydell/node-pty-darwin-x64,找不到即throw,进程以 code 1 退出:.node也确实是 arm64,即使能加载也无法在 Intel 上运行:推测成因:打包机是 Apple Silicon,
npm install按宿主机平台只落盘optionalDependencies里的 arm64 分支,随后用这份node_modules去产 x64 的 dmg(mac.target.arch=x64只换了 Electron 外壳,没有换 sidecar 的原生依赖)。报错日志(sidecar.log 尾部,节选)
完整日志(含 31 次崩溃重试)已作为附件上传。
修复建议(按优先级)
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上打。Resources/sidecar/node_modules/@lydell/存在与mac.target.arch一致的平台包,并用file校验pty.node的架构;不一致直接 fail CI。这类错在 Intel 机器上一启动就 100% 命中,值得卡在流水线上。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可直接加载,不必重签。补充两份附件:
复现口径:全新安装
octopus-desktop-mac-x64.dmg(desktop-stable)→ 首次启动即失败,与用户数据/旧配置无关;Octopus Beta.app(11-07 构建)同因复现。若需要我配合验证修复版,直接在本单回复即可。claim 认领(ZJZ)。根因方向已确认在打包侧:x64 切片复用了 arm64 构建的 sidecar 暂存目录,其中只装了
@lydell/node-pty-darwin-arm64。修复方案与发布计划见后续回帖。修复已发布:v1.0.1(desktop-stable)
根因修复链
afterPack挂 Mach-O cputype 探针,mac 产物逐 arch 校验 sidecar 必须含匹配的@lydell/node-pty-darwin-<arch>/prebuilds/.../pty.node,缺包 fail-loud(附 24 个复刻事故姿势的测试)。本次 1.0.1 构建已过该门禁。本次 x64 产物验证(构建机四重证据 + 修复本体确认)
Contents/MacOS/Octopus:x86_64✓@lydell/node-pty-darwin-x64就位,pty.node=x86_64✓(即 #15 缺的那个包)ai.octopus.desktop(Team 35L272URMA)✓ / GatekeeperNotarized Developer IDaccepted ✓ /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类错误。arm64 产物(Apple Silicon)不受本次问题影响,也已随 1.0.1 一并重打上架。win/linux 侧产物与本次根因无关,仅为版本一致性在同步发 1.0.1 feed。
收尾关闭。修复链已全部交付并验证:
@lydell/node-pty-darwin-x64(pty.node=x86_64 构建机已验证)Intel Mac 用户请直接下载最新 dmg:https://eightarms.net/Octopus/octopus-release/releases/download/desktop-stable/octopus-desktop-mac-x64.dmg (现指向 v1.1.0)。如仍有问题请重开本单并附 sidecar.log。