Files
goodbuddy/build/loongarch-cross
mesalogo 500f7d2735 feat: add experimental LoongArch desktop preview
GoodBuddy can now be cross-packaged as an isolated Debian loong64 preview with verified Electron, node-pty, and Koffi binaries. The preview remains separate from the standard release matrix and excludes Agent, Remote Runtime, OpenCode, and native Canvas until those dependencies support LoongArch.

The Chinese website identifies GoodBuddy as the first open-source desktop AI assistant with LoongArch support while clearly labeling the independently built package as a preview.

Release note: 新增龙芯 LoongArch 独立编译预览版,并提供完整构建文档;当前预览版不包含 Agent、Remote Runtime、OpenCode 和原生 Canvas。
2026-08-25 18:41:35 +08:00
..

LoongArch cross-compilation probe

This directory defines an isolated Ubuntu 26.04 amd64 environment for probing GoodBuddy's Linux loong64 prerequisites. It does not build Electron or OpenCode.

The image includes:

  • GCC and G++ targeting loongarch64-linux-gnu
  • A LoongArch glibc development sysroot
  • QEMU user-mode execution
  • CMake and Ninja
  • Rust's loongarch64-unknown-linux-gnu target
  • Node.js, npm, and node-gyp

The probe validates:

  • C, C++, CMake, and Rust LoongArch ELF output
  • C, C++, and Rust execution through QEMU
  • A minimal NAPI-RS Rust addon cross-build
  • A Debian package with Architecture: loong64
  • Koffi 3.1.4's published LoongArch glibc binding and the absence of a musl binding
  • The current npm availability of an @napi-rs/canvas LoongArch package
  • A source cross-build of node-pty 1.1.0

The node-pty probe uses its upstream node-gyp 11.4.2 dependency. Ubuntu's distribution node-gyp unconditionally links Linux addons with -lnode, which is appropriate for Ubuntu's shared Node.js package but not for Electron native addons.

Build and run it from this directory on an amd64 Docker host:

docker build \
  --tag goodbuddy-loongarch-cross:ubuntu-26.04 \
  .

mkdir -p results
docker run --rm \
  --volume "$PWD/results:/results" \
  goodbuddy-loongarch-cross:ubuntu-26.04

Each run writes to a new UTC timestamped directory below results. A passing run contains summary.txt, SHA256SUMS, the generated ELF files, and the probe DEB.

QEMU only checks user-mode execution against the cross sysroot. Native Electron loading, PTY behavior, desktop integration, GPU, audio, and packaging must still be validated on a real Debian loong64 host.

Koffi 3.1.4 currently publishes only linux_loong64/koffi.node, not a musl_loong64 binding. That is sufficient for a Debian desktop package but does not satisfy GoodBuddy Agent's current dual-glibc/musl bundle contract.

The NAPI-RS probe confirms that a Rust Node addon can be cross-compiled. It does not build Canvas itself, whose Skia dependency requires a separate port and native validation.

Experimental desktop preview

prepare-input.cjs creates the architecture-neutral GoodBuddy input archive. preview-deb.sh combines it with the verified community Electron 42.3.0 LoongArch shell and produces an isolated goodbuddy-loongarch-preview DEB.

The preview:

  • uses a separate application name and user-data directory;
  • includes the direct model path and Continue runtime;
  • cross-builds node-pty against Electron 42.3.0;
  • includes Koffi's LoongArch glibc binding;
  • does not include GoodBuddy Agent, Remote Runtime, OpenCode, or native Canvas;
  • is not part of the production release matrix.

See docs/development/loongarch-preview-build.md for the complete build and validation procedure.