/* ============================================================================ * 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 }); })();