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