Files
MonkeyCode/.github/workflows/desktop-linux.yml
xiaomakuaiz 1c7d225841 fix(desktop): AppImage 捆全 GStreamer,根治桌宠页 WebProcess 崩溃隐身
AppImage 里桌宠窗口在位(诊断日志 visible=true)但整页空白:linuxdeploy
打包会连带捆入 GStreamer 核心库,而 bundleMediaFramework=false 不捆插件,
运行时"捆芯 + 零插件"(装了系统 gstreamer 也没用,bundled 核心不认系统
插件)。pet.html 一进页就 new Audio ×5,WebKit 初始化媒体后端时 appsink
缺失 → 该页 WebKitWebProcess 直接崩,透明窗里什么都不画,桌宠隐身。
主窗口不碰 Audio 所以完好——与"AppImage 没桌宠、cargo run 有"完全吻合。

修复:bundleMediaFramework=true 捆入成套插件(mpg123 解码 + pulse/auto
sink,+12M);CI 构建机与 Makefile 前置检查补齐 gstreamer 插件与 patchelf
依赖(缺 patchelf 时 gstreamer 插件会在 release 编译完之后才报错)。

本地实测:修复前 AppImage 桌宠页 WebProcess 报 GLib CRITICAL 后消失、
60s 仍空白;修复后两个 WebProcess 常驻、GStreamer 报错清零,桌宠正常
渲染在右下角(Xvfb 截图确认)。deb/rpm 全程系统库自洽,不受影响。
2026-07-27 13:49:25 +00:00

130 lines
6.0 KiB
YAML

name: Desktop Linux Build
on:
push:
# 发布只认 vYYMMDDNN tag,例如 v26072208。
tags: ["v[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]"]
# 引擎版本 = agent/ submodule 的 gitlink(仓库内单一来源);
# 升级引擎 = bump submodule(配合壳的 system/ready 能力握手)
#
# 三种产物一次构建产出:deb / rpm / AppImage。
# 只有 AppImage 能自更新(updater 在 Linux 是原地替换 AppImage 文件),
# deb/rpm 交给 apt/dnf,壳侧对非 AppImage 运行不提示更新(main.rs updater_supported)。
jobs:
build:
# 用最老的受支持 runner:glibc 向前兼容不向后,构建机的 glibc 决定了
# 产物能跑的最低发行版。
runs-on: ubuntu-22.04
steps:
- uses: actions/checkout@v4
# webkit2gtk-4.1 + gtk3 是构建依赖;librsvg2/patchelf 是 bundler 需要;
# xdg-utils 不能省——AppImage bundler 会把系统的 xdg-open 复制进包,
# 缺了会在 release 编译跑完之后才报 "xdg-open binary not found"
# (实测:仅把 xdg-open 放进 PATH 不够,bundler 按系统路径找)。
# gstreamer 插件供 AppImage 的 bundleMediaFramework 捆入包内:
# linuxdeploy 会连带捆入 GStreamer 核心库,插件必须成套跟上——
# 捆芯无插件时桌宠页 new Audio 初始化媒体后端即崩 WebProcess,
# 整页空白(桌宠隐身的根因,见 Makefile check-linux 注释)。
- name: Install Tauri system dependencies
run: |
sudo apt-get update
sudo apt-get install -y --no-install-recommends \
libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev \
librsvg2-dev patchelf xdg-utils rpm \
gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
gstreamer1.0-libav gstreamer1.0-alsa
- uses: actions/setup-go@v5
with:
go-version: stable
- uses: dtolnay/rust-toolchain@stable
- uses: actions/setup-node@v4
with:
node-version: 22
- uses: swatinem/rust-cache@v2
with:
workspaces: desktop
# 仓库内版本只作开发占位;发布构建以 tag 为唯一真值。
- name: Set release version from tag
working-directory: desktop
run: python3 scripts/set_release_version.py "${GITHUB_REF_NAME}"
# 浏览器扩展:随包分发(tauri bundle.resources 引用 dist,缺失会打包失败)
- name: Build browser extension
working-directory: browser-extension
run: |
npm ci
npm run build
# 引擎 sidecar:源码来自 agent/ submodule(私库,checkout 默认
# GITHUB_TOKEN 无跨库权限 → 用 OHMYAGENT_REPO_TOKEN;.gitmodules
# 是 ssh URL,经 insteadOf 重写为带 token 的 https)。引擎必须进包,
# 凭据缺失直接失败而非静默出无引擎包
- name: Build ohmyagent sidecar (agent/ submodule)
env:
OHMYAGENT_REPO_TOKEN: ${{ secrets.OHMYAGENT_REPO_TOKEN }}
run: |
[ -n "$OHMYAGENT_REPO_TOKEN" ] || { echo "::error::OHMYAGENT_REPO_TOKEN 未配置,引擎无法进包"; exit 1; }
git config --global url."https://x-access-token:${OHMYAGENT_REPO_TOKEN}@github.com/".insteadOf "git@github.com:"
git submodule update --init agent
cd agent
AGENT_VERSION="$(git rev-parse --short HEAD)"
echo "ohmyagent version: ${AGENT_VERSION}"
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath \
-ldflags "-s -w -X main.Version=${AGENT_VERSION}" \
-o "$GITHUB_WORKSPACE/desktop/binaries/ohmyagent-x86_64-unknown-linux-gnu" ./cmd/ohmyagent
- name: Check bundle config contract
working-directory: desktop
run: python3 scripts/check_bundle_configs.py
# secret 就绪时走发布构建(额外产出签名的 AppImage + latest-linux.json),
# 否则回退普通打包,CI 不红
- name: Build deb / rpm / AppImage
working-directory: desktop
env:
TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
# 装机/使用统计的上报地址,编译期内联(desktop/src/telemetry.rs)。
# 只加在 release 工作流上:开发机 cargo run / cargo build 拿不到它,
# 因此开发过程不会往生产数据里灌噪声。secret 未配置时是空串 =
# 不上报,构建照常不红。
#
# 走 secret 不是把它当密钥(装了包的人 strings 一下就能拿到),而是
# 不把它摆在公开仓库里:端点免鉴权公开可写,而这套数据的全部意义
# 就是装机计数——谁都能 curl 循环随机塞 _id 把装机量刷成任意数字。
# 降低发现门槛没有收益,提高一点是免费的。
MC_MATOMO_URL: ${{ secrets.MC_MATOMO_URL }}
MC_MATOMO_SITE_ID: ${{ secrets.MC_MATOMO_SITE_ID }}
run: |
if [ -n "$TAURI_SIGNING_PRIVATE_KEY" ]; then
npx --yes @tauri-apps/cli@^2 build \
--config bundle.linux.conf.json --config tauri.release.conf.json
python3 scripts/gen-latest-json.py linux
else
echo "::warning::TAURI_SIGNING_PRIVATE_KEY 未配置,跳过 updater 产物"
npx --yes @tauri-apps/cli@^2 build --config bundle.linux.conf.json
fi
RELEASE_VERSION="${GITHUB_REF_NAME#v}"
for f in \
"target/release/bundle/deb/MonkeyCode_${RELEASE_VERSION}.0.0_amd64.deb" \
"target/release/bundle/rpm/MonkeyCode-${RELEASE_VERSION}.0.0-1.x86_64.rpm" \
"target/release/bundle/appimage/MonkeyCode_${RELEASE_VERSION}.0.0_amd64.AppImage"; do
test -f "$f" || { echo "::error::产物缺失或版本未与 tag 对齐: $f"; exit 1; }
done
- uses: actions/upload-artifact@v4
with:
name: MonkeyCode-linux-x64-${{ github.ref_name }}
path: |
desktop/target/release/bundle/deb/*.deb
desktop/target/release/bundle/rpm/*.rpm
desktop/target/release/bundle/appimage/*.AppImage
desktop/target/release/bundle/updater/*