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
+87
View File
@@ -0,0 +1,87 @@
/* ============================================================================
* SideQuest 简体中文汉化 —— 主进程统一注入 hook
* 由 l10n-zh 构建脚本追加到 dist-electron/main.js 末尾(不改动上游任何逻辑)。
* 作用:为每个「本地页面」(file:// 与 data:text/html)注入汉化引擎。
* 远程内容(内嵌商店 sidequestvr.com、Steam 等 https 页面)不会被注入。
* 卸载:删除 main.js 末尾本段即可完全还原。
* ==========================================================================*/
(function () {
'use strict';
var TAG = '[l10n-zh]';
try {
var fs = require('fs');
var path = require('path');
var electron = require('electron');
var app = electron.app;
var SOURCE = fs.readFileSync(path.join(__dirname, 'l10n-zh-inject.js'), 'utf8');
/** 只处理本地页面;远程 https 页面保持原样 */
function isLocalPage(url) {
return (
typeof url === 'string' &&
(url.indexOf('file://') === 0 || url.indexOf('data:text/html') === 0)
);
}
/** 注入一次;失败时少量重试 */
function runOnce(wc, retries) {
if (!wc || wc.isDestroyed()) return;
var url = '';
try {
url = wc.getURL();
} catch (e) {
url = '';
}
if (!isLocalPage(url)) return;
try {
var p = wc.executeJavaScript(SOURCE, false);
if (p && typeof p.catch === 'function') {
p.catch(function (err) {
if (retries > 0) {
setTimeout(function () {
runOnce(wc, retries - 1);
}, 150);
} else {
console.warn(TAG + ' 注入失败: ' + ((err && err.message) || err));
}
});
}
} catch (e) {
console.warn(TAG + ' 注入异常: ' + e.message);
}
}
function attach(wc) {
try {
wc.on('dom-ready', function () {
runOnce(wc, 2);
});
wc.on('did-finish-load', function () {
runOnce(wc, 1);
});
if (!wc.isLoadingMainFrame()) {
runOnce(wc, 2);
}
} catch (e) {
/* ignore */
}
}
app.on('web-contents-created', function (_event, wc) {
attach(wc);
});
app.whenReady().then(function () {
try {
electron.webContents.getAllWebContents().forEach(attach);
} catch (e) {
/* ignore */
}
});
console.log(TAG + ' 简体中文汉化已启用');
} catch (e) {
console.error(TAG + ' 初始化失败:', e);
}
})();