visionA/local-tool/installer/linux/build-appimage.sh
jim800121chen 8cd5751ce3 feat(local-tool): M8 重構 — Wails 控制台 + 瀏覽器 Web UI(R5 決策)
依 R5 五輪決策把 visionA-local 從「Wails 內嵌 Next.js」重構為「Wails
本機伺服器控制台 + 瀏覽器 Web UI」模式(類比 Docker Desktop / Ollama)。

程式碼變動
  - M8-1 砍 yt-dlp 全套(後端 resolver / URL handler / 前端 URL tab /
    Makefile vendor / installer / bootstrap / CI workflow,-555 行)
  - M8-2 砍 Mock 模式全套(driver/mock、mock_camera、Settings runtimeMode、
    VISIONA_MOCK 環境變數,-528 行)
  - M8-3 ffmpeg 從 GPL 切換到 LGPL 混合方案:Windows/Linux 用 BtbN 現成
    LGPL binary,macOS 自 build minimal decoder-only 進 git
    (vendor/ffmpeg/macos/ffmpeg 5.7MB + ffprobe 5.6MB,比 GPL 版省 85% 空間)
  - M8-4 Wails Server Controller:state machine、log ring buffer 2000 行、
    preferences.json atomic write、boot-id、Gin SkipPaths、shutdown 7+1 秒、
    notify_*.go 三平台 OS 通知、watchServer 改 Error state 不 os.Exit
  - M8-4b 啟動階段管線 R5-E:6 階段進度 event、20s soft / 60s hard timeout、
    stage 5/6 skip 規則、sentinel file、RestartStartupSequence 5 步驟
  - M8-5 Wails 控制台 vanilla HTML/JS/CSS(9 檔 ~2012 行)取代 M7-B splash:
    state 視覺、log panel、startup progress panel、Stage 6 manual CTA
    pulse、shutdown modal、Settings、Dark Mode、i18n 中英雙語
  - M8-6 上傳影片副檔名擴充(mp4/avi/mov/mpeg/mpg)
  - M8-7 Web UI Server Offline Overlay(role=alertdialog + focus trap +
    wsEverConnected 容錯 + Page Visibility)
  - M8-8 CORS middleware(127.0.0.1/localhost only + suffix attack 防護)+
    ws/origin.go 獨立 WebSocket CheckOrigin 避 package cycle
  - MAJ-4 server:shutdown-imminent WebSocket broadcast 機制
    (/ws/system endpoint + notifyShutdownImminent helper)
  - M8-9 Boot-ID + 瀏覽器 tab 自動重連(sessionStorage loop guard)

品質
  - ~105+ 新 unit test + race detector (-count=2) 全綠
  - 10 個 milestone 全部通過 Reviewer 審查
  - 三方 v2 + v2.1 文件(PRD / Design Spec / TDD)+ 交叉互審紀錄
    收錄在 .autoflow/

交付前待處理(M8-10)
  - 重跑 make payload-macos 把舊 GPL 77MB binary 換成新 LGPL
  - 三平台 end-to-end build 驗證

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 17:57:54 +08:00

156 lines
5.5 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env bash
# visionA-local Linux AppImage builder
#
# 必須在 Linux x86_64 跑GitHub Actions ubuntu-latest 即可)。
# 需要的工具appimagetool、wails CLI、go 1.26+、pnpm、curl
#
# 前置payload/linux/ 應已由 `make payload-linux` 產出,
# visiona-local/build/bin/visiona-localWails app binary應已由 `make wails-linux` 產出。
#
# 用法:
# VERSION=0.1.0 bash installer/linux/build-appimage.sh
#
# 產物dist/visiona-local-${VERSION}-linux-x64.AppImage
set -euo pipefail
PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
APPDIR="$PROJECT_ROOT/dist/visiona-local.AppDir"
VERSION="${VERSION:-0.1.0}"
# 平台守門:只能在 Linux 跑
if [ "$(uname -s)" != "Linux" ]; then
echo "❌ build-appimage.sh 只能在 Linux 上執行(目前:$(uname -s)"
exit 1
fi
echo "==> 清理舊 AppDir"
rm -rf "$APPDIR"
mkdir -p "$APPDIR/usr/bin" \
"$APPDIR/usr/lib/visiona-local/data" \
"$APPDIR/usr/lib/visiona-local/scripts" \
"$APPDIR/usr/lib/visiona-local/python" \
"$APPDIR/usr/lib/visiona-local/wheels" \
"$APPDIR/usr/share/applications" \
"$APPDIR/usr/share/icons/hicolor/256x256/apps"
echo "==> 複製 Wails app binary"
WAILS_BIN="$PROJECT_ROOT/visiona-local/build/bin/visiona-local"
if [ ! -f "$WAILS_BIN" ]; then
echo "❌ 找不到 Wails binary$WAILS_BIN"
echo " 請先執行make wails-linux"
exit 1
fi
cp "$WAILS_BIN" "$APPDIR/usr/bin/visiona-local"
chmod +x "$APPDIR/usr/bin/visiona-local"
echo "==> 複製 server binary + 工具(從 payload/linux/"
PAYLOAD_LINUX="$PROJECT_ROOT/payload/linux"
if [ ! -d "$PAYLOAD_LINUX" ]; then
echo "❌ 找不到 payload/linux/請先執行make payload-linux"
exit 1
fi
# server binary
if [ -f "$PAYLOAD_LINUX/bin/visiona-local-server" ]; then
cp "$PAYLOAD_LINUX/bin/visiona-local-server" "$APPDIR/usr/bin/visiona-local-server"
else
echo "⚠️ payload/linux/bin/visiona-local-server 不存在(需要在 Linux 上 go build server"
fi
# ffmpeg / ffprobe
# ffmpeg 為 LGPL v3 buildBtbN n7.1v2 TDD §4
for tool in ffmpeg ffprobe; do
if [ -f "$PAYLOAD_LINUX/bin/$tool" ]; then
cp "$PAYLOAD_LINUX/bin/$tool" "$APPDIR/usr/bin/$tool"
else
echo "⚠️ payload/linux/bin/$tool 不存在"
fi
done
chmod +x "$APPDIR/usr/bin/"* 2>/dev/null || true
# 把 ffmpeg 授權條款放到 AppImage 的 share/doc/
mkdir -p "$APPDIR/usr/share/doc/visiona-local"
if [ -f "$PAYLOAD_LINUX/bin/ffmpeg-LICENSE.txt" ]; then
cp "$PAYLOAD_LINUX/bin/ffmpeg-LICENSE.txt" "$APPDIR/usr/share/doc/visiona-local/ffmpeg-LICENSE.txt"
fi
echo "==> 複製資料、腳本、Python runtime、wheels"
[ -d "$PAYLOAD_LINUX/data" ] && cp -R "$PAYLOAD_LINUX/data/." "$APPDIR/usr/lib/visiona-local/data/" || true
[ -d "$PAYLOAD_LINUX/scripts" ] && cp -R "$PAYLOAD_LINUX/scripts/." "$APPDIR/usr/lib/visiona-local/scripts/" || true
[ -f "$PAYLOAD_LINUX/python/python.tar.gz" ] && \
cp "$PAYLOAD_LINUX/python/python.tar.gz" "$APPDIR/usr/lib/visiona-local/python/" || \
echo "⚠️ python tarball 不存在"
if ls "$PAYLOAD_LINUX/wheels/"*.whl >/dev/null 2>&1; then
cp "$PAYLOAD_LINUX/wheels/"*.whl "$APPDIR/usr/lib/visiona-local/wheels/"
else
echo "⚠️ wheels 目錄為空"
fi
# 複製 udev rule 到 lib 供 Wails app 首次啟動時使用
if [ -f "$PROJECT_ROOT/installer/linux/99-kneron.rules" ]; then
cp "$PROJECT_ROOT/installer/linux/99-kneron.rules" "$APPDIR/usr/lib/visiona-local/"
fi
if [ -f "$PROJECT_ROOT/installer/linux/install-udev.sh" ]; then
cp "$PROJECT_ROOT/installer/linux/install-udev.sh" "$APPDIR/usr/lib/visiona-local/"
chmod +x "$APPDIR/usr/lib/visiona-local/install-udev.sh"
fi
echo "==> 寫入 .desktop 與 icon"
cat > "$APPDIR/visiona-local.desktop" <<'DESKTOP'
[Desktop Entry]
Type=Application
Name=visionA-local
Comment=Local-first Edge AI development tool for Kneron KL520/KL720
Exec=visiona-local
Icon=visiona-local
Categories=Development;
Terminal=false
StartupWMClass=visionA-local
DESKTOP
cp "$APPDIR/visiona-local.desktop" "$APPDIR/usr/share/applications/"
# Icon (256x256 PNG),從 visiona-local/build/appicon.png 複製
APPICON="$PROJECT_ROOT/visiona-local/build/appicon.png"
if [ -f "$APPICON" ]; then
cp "$APPICON" "$APPDIR/visiona-local.png"
cp "$APPICON" "$APPDIR/usr/share/icons/hicolor/256x256/apps/visiona-local.png"
else
echo "⚠️ 找不到 appicon.pngAppImage 將無 icon"
fi
echo "==> 寫入 AppRun"
cat > "$APPDIR/AppRun" <<'APPRUN'
#!/bin/bash
# AppRun — AppImage 啟動 entry point
HERE="$(dirname "$(readlink -f "${0}")")"
export PATH="${HERE}/usr/bin:${PATH}"
export LD_LIBRARY_PATH="${HERE}/usr/lib:${LD_LIBRARY_PATH:-}"
# visionA-local 專屬環境變數:讓 Wails app 定位 bundle 內檔案
export VISIONA_BUNDLE_BIN_DIR="${HERE}/usr/bin"
export VISIONA_BUNDLE_LIB_DIR="${HERE}/usr/lib/visiona-local"
exec "${HERE}/usr/bin/visiona-local" "$@"
APPRUN
chmod +x "$APPDIR/AppRun"
echo "==> 檢查 appimagetool"
if ! command -v appimagetool &> /dev/null; then
echo "❌ appimagetool 未安裝。"
echo " 下載https://github.com/AppImage/AppImageKit/releases/latest/download/appimagetool-x86_64.AppImage"
echo " 安裝chmod +x appimagetool-x86_64.AppImage && sudo mv appimagetool-x86_64.AppImage /usr/local/bin/appimagetool"
exit 1
fi
echo "==> 用 appimagetool 打包"
mkdir -p "$PROJECT_ROOT/dist"
OUTPUT="$PROJECT_ROOT/dist/visiona-local-${VERSION}-linux-x64.AppImage"
ARCH=x86_64 appimagetool "$APPDIR" "$OUTPUT"
echo ""
echo "==> 完成:$OUTPUT"
ls -lh "$OUTPUT"