把官方 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)、无线、 全部弹窗、命令面板、日期与相对时间。内嵌商店为远程服务端渲染,不在范围内。
88 lines
3.0 KiB
JavaScript
88 lines
3.0 KiB
JavaScript
/* ============================================================================
|
|
* 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);
|
|
}
|
|
})();
|