Files
sideQuest-cn/engine.js
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

270 lines
9.3 KiB
JavaScript
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.
/* ============================================================================
* 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 });
})();