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
+269
View File
@@ -0,0 +1,269 @@
/* ============================================================================
* SideQuest 简体中文运行时汉化引擎 (l10n-zh)
* 通过 Electron 主进程统一注入到所有本地页面(file:// 与 data:text/html)。
* 设计原则:
* - 不修改任何上游业务代码,仅做 DOM 文本/属性替换
* - 幂等:只做「英文 → 中文」单向替换,中文不会被二次翻译
* - 兜底:MutationObserver 捕获 Angular 重渲染产生的新文本
* ==========================================================================*/
(function () {
'use strict';
var NS = window.__SQ_ZH__;
if (!NS || NS.installed) return;
NS.installed = true;
var DICT = NS.dict || {};
var RULES = (NS.rules || []).map(function (r) {
try {
return [new RegExp(r[0]), r[1]];
} catch (e) {
return null;
}
}).filter(Boolean);
/* 不进入的子树 */
var SKIP_TAGS = {
SCRIPT: 1, STYLE: 1, NOSCRIPT: 1, TEMPLATE: 1,
CODE: 1, PRE: 1, KBD: 1, SAMP: 1, TEXTAREA: 1, SVG: 1, MATH: 1
};
/* 图标元素(ligature 字形名绝不能被翻译) */
var ICON_TOKENS = {
'mat-icon': 1, 'material-icons': 1, 'material-icons-outlined': 1,
'material-symbols': 1, 'material-symbols-outlined': 1,
'material-symbols-rounded': 1, 'material-symbols-sharp': 1,
'icon': 1, 'sq-icon': 1, 'fa': 1, 'fas': 1, 'far': 1, 'fab': 1
};
/* 需要翻译的属性 */
var ATTRS = ['placeholder', 'title', 'aria-label', 'aria-description', 'alt', 'data-tooltip'];
var WS = /\s+/g;
var HAS_LATIN = /[A-Za-z]/;
var EDGES = /^(\s*)([\s\S]*?)(\s*)$/;
/* Angular 会把「说明文案」与「(Default: X)」拼进同一个文本节点,
这里先把后缀拆出来,分别翻译后再拼回,避免为每条说明单独写规则。 */
var DEFAULT_RE = /^(.*?)\s*\(Default: ([^()]*)\)$/;
function norm(s) {
return s.replace(WS, ' ').trim();
}
/* 词典 + 规则的纯查表逻辑;无命中返回 null */
function lookupCore(s) {
var t = DICT[s];
if (t !== undefined) return t;
if (!HAS_LATIN.test(s)) return null;
for (var i = 0; i < RULES.length; i++) {
var re = RULES[i][0];
if (re.test(s)) {
var out = s.replace(re, RULES[i][1]);
/* 幂等保证:若替换结果仍会被同一条规则命中,说明会无限增长,则放弃。
这样就能安全处理「英文前缀 + 已汉化尾部」的混排字符串
(如 “1.2.3.4:5555 · last seen 5分钟前”)。 */
if (out !== s && !re.test(out)) return out;
}
}
return null;
}
/* 返回译文;无匹配返回 null */
function look(s) {
var t = lookupCore(s);
if (t !== null) return t;
var m = DEFAULT_RE.exec(s);
if (m) {
var base = lookupCore(m[1]);
var def = lookupCore(m[2]);
if (base !== null || def !== null) {
return (
(base === null ? m[1] : base) +
'(默认:' +
(def === null ? m[2] : def) +
')'
);
}
}
return null;
}
function isIconElement(el) {
if (!el || el.nodeType !== 1) return false;
if (el.tagName === 'MAT-ICON' || el.tagName === 'SVG') return true;
var cls = el.getAttribute('class');
if (cls) {
var parts = cls.split(/\s+/);
for (var i = 0; i < parts.length; i++) {
if (ICON_TOKENS[parts[i]]) return true;
}
}
if (el.hasAttribute('data-sq-zh-skip')) return true;
if (el.getAttribute('translate') === 'no') return true;
return false;
}
function translateTextNode(node) {
var parent = node.parentNode;
if (!parent || parent.nodeType !== 1) return;
if (SKIP_TAGS[parent.tagName]) return;
if (isIconElement(parent)) return;
var orig = node.data;
if (!orig || orig.length > 600 || !HAS_LATIN.test(orig)) return;
var key = norm(orig);
if (key.length < 2) return;
var t = look(key);
if (t === null) return;
var m = EDGES.exec(orig);
var next = (m[1] || '') + t + (m[3] || '');
if (next !== orig) node.data = next;
}
function translateAttrs(el) {
if (!el.getAttribute) return;
if (isIconElement(el)) return;
for (var i = 0; i < ATTRS.length; i++) {
var a = ATTRS[i];
var v = el.getAttribute(a);
if (!v || v.length > 600 || !HAS_LATIN.test(v)) continue;
var t = look(norm(v));
if (t !== null && t !== v) el.setAttribute(a, t);
}
if (el.tagName === 'INPUT' || el.tagName === 'BUTTON') {
var ty = (el.getAttribute('type') || '').toLowerCase();
if (el.tagName === 'INPUT' && ty !== 'button' && ty !== 'submit' && ty !== 'reset') return;
var val = el.getAttribute('value');
if (val && HAS_LATIN.test(val)) {
var tv = look(norm(val));
if (tv !== null && tv !== val) el.setAttribute('value', tv);
}
}
}
function filterNode(n) {
if (n.nodeType === 1) {
if (SKIP_TAGS[n.tagName] || isIconElement(n)) return 2; /* REJECT: 连同子树 */
}
return 1;
}
function walkSubtree(root) {
if (!root) return;
if (root.nodeType === 3) {
translateTextNode(root);
return;
}
if (root.nodeType !== 1 && root.nodeType !== 9) return;
if (root.nodeType === 1) {
if (SKIP_TAGS[root.tagName] || isIconElement(root)) return;
translateAttrs(root);
}
var walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT | NodeFilter.SHOW_ELEMENT, filterNode, false);
var n;
while ((n = walker.nextNode())) {
if (n.nodeType === 3) translateTextNode(n);
else translateAttrs(n);
}
}
function translateTitle() {
var t = document.title;
if (!t || !HAS_LATIN.test(t)) return;
var v = look(norm(t));
if (v !== null && v !== t) document.title = v;
}
/* ---------- 观察器 ---------- */
var observer = null;
var pendingRoots = [];
var scheduled = false;
function startObserving() {
if (observer) return;
observer = new MutationObserver(function (muts) {
var needFull = false;
for (var i = 0; i < muts.length; i++) {
var m = muts[i];
if (m.type === 'characterData') {
translateTextNode(m.target);
} else if (m.type === 'attributes') {
translateAttrs(m.target);
} else {
for (var j = 0; j < m.addedNodes.length; j++) {
var a = m.addedNodes[j];
if (a.nodeType === 1 || a.nodeType === 3) {
if (pendingRoots.length < 500) pendingRoots.push(a);
needFull = true;
}
}
}
}
if (needFull) schedule();
});
observer.observe(document.documentElement, {
childList: true,
subtree: true,
characterData: true,
attributes: true,
attributeFilter: ATTRS
});
}
function stopObserving() {
if (!observer) return;
try {
observer.takeRecords();
observer.disconnect();
} catch (e) { /* ignore */ }
observer = null;
}
function schedule() {
if (scheduled) return;
scheduled = true;
setTimeout(function () {
scheduled = false;
stopObserving();
try {
var roots = pendingRoots;
pendingRoots = [];
for (var i = 0; i < roots.length; i++) {
var r = roots[i];
if (r && r.isConnected) walkSubtree(r);
}
translateTitle();
} finally {
startObserving();
}
}, 30);
}
function fullPass() {
if (!document.documentElement) return;
stopObserving();
try {
walkSubtree(document.documentElement);
translateTitle();
} finally {
startObserving();
}
}
NS.fullPass = fullPass;
function boot() {
fullPass();
/* Angular 首屏是异步渲染的,前几秒多扫几轮兜底 */
[120, 400, 1000, 2500, 5000].forEach(function (d) {
setTimeout(fullPass, d);
});
/* 窗口重新可见时再扫一遍(弹出窗口可能在被展示前不渲染) */
document.addEventListener('visibilitychange', function () {
if (!document.hidden) fullPass();
});
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', fullPass);
}
}
if (document.documentElement) boot();
else document.addEventListener('DOMContentLoaded', boot, { once: true });
})();