把官方 SideQuest 桌面版(基线 1.4.1)汉化为简体中文,并产出可覆盖安装的 deb。 不修改任何上游源码:所有改动集中在 build.js 的补丁层,作用于已编译产物 (dist-electron 与 dist/sidequest-desktop),因此本工具包可独立于上游代码工作。 主要内容: - 运行时汉化引擎 engine.js + 主进程统一注入 hook tail.js (应用有 7 个 data:text/html overlay 页且带严格 CSP,故用主进程 hook 一次覆盖全部窗口) - 词典 1806 条(dict-a…i.json)+ 动态规则 137 条(rules.json) - 纯 Node 实现的 asar 打包/解包 asar.js,零外部依赖 - 构建/试运行/安装/校验脚本 覆盖范围:主页、侧载、文件、应用、串流、设备设置、调试(Logcat)、无线、 全部弹窗、命令面板、日期与相对时间。内嵌商店为远程服务端渲染,不在范围内。
142 lines
5.4 KiB
Bash
Executable File
142 lines
5.4 KiB
Bash
Executable File
#!/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 <<EOF
|
||
|
||
============================================================
|
||
安装完成。请重新启动 SideQuest 查看中文界面。
|
||
|
||
回滚到官方英文版:
|
||
sudo dpkg -i $WORK/backup/<原始 deb>
|
||
# 或恢复 app.asar:
|
||
sudo cp $WORK/backup/app.asar.before-install-* $ASAR
|
||
|
||
临时恢复官方自动更新(会被官方版本覆盖汉化):
|
||
SQ_ZH_ALLOW_UPDATES=1 sidequest
|
||
============================================================
|
||
EOF
|