SideQuest 简体中文汉化工具包

把官方 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)、无线、
全部弹窗、命令面板、日期与相对时间。内嵌商店为远程服务端渲染,不在范围内。
This commit is contained in:
2026-10-11 18:09:36 +08:00
commit d3db80c27b
19 changed files with 3988 additions and 0 deletions
Executable
+141
View File
@@ -0,0 +1,141 @@
#!/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