Files
sideQuest-cn/install.sh
T
cat-shark d3db80c27b 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)、无线、
全部弹窗、命令面板、日期与相对时间。内嵌商店为远程服务端渲染,不在范围内。
2026-10-11 18:09:36 +08:00

142 lines
5.4 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
# ============================================================================
# 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