#!/usr/bin/env bash # ============================================================================ # SideQuest 简体中文汉化版 —— 覆盖安装脚本 # # 用法: sudo bash ./install.sh [deb路径] # # 行为: # 1. 校验安装包哈希(与构建时一致才继续) # 2. 退出正在运行的 SideQuest 并清理单实例锁残留 # 3. 备份当前 app.asar(可事后回滚) # 4. dpkg -i 覆盖安装(同包名 sidequest-desktop,dpkg 识别为升级) # 5. 安装后逐项校验版本、asar 哈希、汉化标记、启动器 # # 不会触碰 ~/.config/SideQuestDesktop(登录态 / 设备绑定 / 已记住的无线设备)。 # ============================================================================ set -euo pipefail TOOL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" WORK="${SQ_ZH_HOME:-$HOME/.sidequest-zh}" INSTALL_DIR="/opt/SideQuest" ASAR="$INSTALL_DIR/resources/app.asar" say() { printf '\n\033[1m== %s ==\033[0m\n' "$*"; } ok() { printf ' \033[32m✓\033[0m %s\n' "$*"; } bad() { printf ' \033[31m✗\033[0m %s\n' "$*"; } die() { bad "$*"; exit 1; } [ "$(id -u)" -eq 0 ] || die "请用 sudo 运行: sudo bash $TOOL_DIR/install.sh" # sudo 下 $HOME 可能是 /root,用 SUDO_USER 还原真实用户 if [ -n "${SUDO_USER:-}" ]; then USER_HOME="$(getent passwd "$SUDO_USER" | cut -d: -f6)" else USER_HOME="$HOME" fi WORK="${SQ_ZH_HOME:-$USER_HOME/.sidequest-zh}" DATA_DIR="$USER_HOME/.config/SideQuestDesktop" DEB="${1:-}" if [ -z "$DEB" ]; then DEB="$(ls -1 "$WORK"/dist/SideQuest-*-zh.*-amd64.deb 2>/dev/null | sort -V | tail -1 || true)" fi [ -n "$DEB" ] && [ -f "$DEB" ] || die "找不到安装包(请先执行 node build.js all,或把 deb 路径作为参数传入)" say "1. 待安装内容" dpkg-deb -f "$DEB" Package Version Architecture | sed 's/^/ /' echo " 当前已安装:" dpkg-query -W -f=' ${Package} ${Version} ${Status}\n' sidequest-desktop 2>/dev/null || echo " (未安装)" say "2. 校验安装包哈希" SHA_FILE="$DEB.sha256" if [ -f "$SHA_FILE" ]; then ACT="$(sha256sum "$DEB" | awk '{print $1}')" EXP="$(awk '{print $1}' "$SHA_FILE")" [ "$ACT" = "$EXP" ] && ok "deb sha256 与构建时一致" || die "deb 哈希不匹配(期望 $EXP,实际 $ACT)" else bad "缺少 $SHA_FILE,跳过 deb 哈希校验" fi say "3. 校验包内 app.asar" # 期望值来自 build.js 的产物记录;不存在则跳过 EXP_ASAR_FILE="$WORK/dist/app.asar.zh.sha256" if [ -f "$EXP_ASAR_FILE" ]; then EXP_ASAR="$(awk '{print $1}' "$EXP_ASAR_FILE")" PKG_ASAR="$(dpkg-deb --fsys-tarfile "$DEB" | tar -xO -f - ./opt/SideQuest/resources/app.asar 2>/dev/null | sha256sum | awk '{print $1}')" [ "$PKG_ASAR" = "$EXP_ASAR" ] && ok "包内 app.asar 与实测通过的版本一致" || die "包内 app.asar 哈希不符" else bad "缺少 $EXP_ASAR_FILE,跳过 asar 哈希校验" fi say "4. 退出正在运行的 SideQuest" if pgrep -f "$INSTALL_DIR/sidequest" >/dev/null 2>&1; then pkill -f "$INSTALL_DIR/sidequest" 2>/dev/null || true for _ in $(seq 1 10); do pgrep -f "$INSTALL_DIR/sidequest" >/dev/null 2>&1 || break sleep 0.5 done if pgrep -f "$INSTALL_DIR/sidequest" >/dev/null 2>&1; then pkill -9 -f "$INSTALL_DIR/sidequest" 2>/dev/null || true sleep 1 fi ok "已退出" else ok "未在运行" fi rm -f "$DATA_DIR"/Singleton* 2>/dev/null || true say "5. 备份当前 app.asar" mkdir -p "$WORK/backup" if [ -f "$ASAR" ]; then STAMP="$(date +%Y%m%d-%H%M%S)" cp -f "$ASAR" "$WORK/backup/app.asar.before-install-$STAMP" ok "已备份到 $WORK/backup/app.asar.before-install-$STAMP" fi say "6. 安装(dpkg -i 覆盖升级)" dpkg -i "$DEB" say "7. 安装后校验" NEW_VER="$(dpkg-query -W -f='${Version}' sidequest-desktop 2>/dev/null || echo '?')" echo " 已安装版本: $NEW_VER" case "$NEW_VER" in *zh*) ok "汉化版已就位" ;; *) bad "版本号不含 zh,可能装错了包" ;; esac ASAR_SHA="$(sha256sum "$ASAR" 2>/dev/null | awk '{print $1}')" if [ -f "$EXP_ASAR_FILE" ] && [ "$ASAR_SHA" = "$(awk '{print $1}' "$EXP_ASAR_FILE")" ]; then ok "app.asar 与构建产物一致" else bad "app.asar 哈希为 $ASAR_SHA(请核对)" fi for pair in "简体中文汉化:汉化注入 hook" "SQ_ZH_ALLOW_UPDATES:自动更新已禁用" "vrwanba.com:默认站点 vrwanba" "一月:日期本地化"; do needle="${pair%%:*}"; label="${pair##*:}" grep -qa -- "$needle" "$ASAR" 2>/dev/null && ok "$label" || bad "$label 缺失" done [ -x "$INSTALL_DIR/sidequest" ] && ok "主程序可执行" || bad "主程序缺失" [ -e /usr/bin/sidequest ] && ok "启动器 /usr/bin/sidequest" || bad "启动器缺失" [ -f /usr/share/applications/sidequest.desktop ] && ok "桌面项存在" || bad "桌面项缺失" say "8. 用户数据(应保持不变)" if [ -d "$DATA_DIR" ]; then ok "用户数据目录存在: $DATA_DIR" du -sh "$DATA_DIR" | sed 's/^/ /' else bad "用户数据目录不存在(异常)" fi cat < # 或恢复 app.asar: sudo cp $WORK/backup/app.asar.before-install-* $ASAR 临时恢复官方自动更新(会被官方版本覆盖汉化): SQ_ZH_ALLOW_UPDATES=1 sidequest ============================================================ EOF