'use strict';
/**
* 云仓视频溯源 · 扫码入口注入 —— 规则引擎(零构建,浏览器/扩展通用)
*
* 这个文件同时被三处引入:
* - content script(manifest.content_scripts.js,跑在第三方页面里)
* - 配置页 options.html
* - 弹窗 popup.html
* 所以不能写成 ES module(没有打包步骤),统一挂在 globalThis.PSTRules 上。
*
* 职责边界:
* 本文件只做「纯逻辑」——配置归一化、正则编译、文本命中、DOM 标记、地址拼接。
* 与 chrome.* 打交道的部分集中在 loadConfig / saveConfig 两个函数里。
*/
(function (root) {
const STORAGE_KEY = 'pstConfig';
// 网页模板(openMode = window / tab 时用):打开本机软件的公共页
const DEFAULT_URL_TEMPLATE = 'http://localhost:7301/local?code={code}';
// 协议模板(openMode = app 时用):**直接唤起本机软件**并带上单号
// ⚠️ 自定义协议拿不到任何结果(成功/没装/用户点取消在网页侧一模一样),
// 所以 content script 必须配合超时兜底(弹「下载安装 / 在网页中查看」)。
const DEFAULT_APP_URL_TEMPLATE = 'yuncang://open?code={code}';
/** 兜底页:协议唤不起时「去网页看看」(页面里会提示下载安装、并能在浏览器里直接查) */
const DEFAULT_FALLBACK_URL = 'http://localhost:7301/local?code={code}';
/** 点击后的打开方式:app = 协议唤起本机软件;window = 独立小窗;tab = 新标签页 */
const OPEN_MODES = ['app', 'window', 'tab'];
const DEFAULT_BUTTON_TEXT = '查看打包视频';
const MARK_STYLES = ['underline', 'highlight', 'chip'];
/**
* 加工方式:
* button(默认)—— 完全不动命中元素,只在它旁边插一个按钮;
* chip —— 命中元素本身可点(加类名 / 改 title / 接管点击)。
*/
const ACTION_MODES = ['button', 'chip'];
/** 这些元素的文本不参与匹配(避免破坏表单/脚本/媒体) */
const SKIP_TAGS = new Set([
'SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT', 'OPTION',
'TITLE', 'HEAD', 'BUTTON', 'LABEL', 'IFRAME', 'CANVAS', 'VIDEO', 'AUDIO',
'OBJECT', 'EMBED',
]);
/**
* 单号前缀表(**要维护就改这一行**):新出现的快递公司前缀直接往数组里加就行,
* 只要是以前没出现过、又确实出现在单号开头的,加进来即可 —— 通用文本规则就靠它认单号。
* ⚠️ 数字前缀(如 32 / 77)最容易把内部 ID、订单号一起点亮,发现误标再回来调整。
*/
const EXPRESS_PREFIXES = [ 'YT', 'SF', 'JD', 'ZTO', 'YTO', 'STO', 'EMS', 'DBL', '32', '77' ];
/** 通用运单号文本规则:前缀 + 10~16 位数字 */
const EXPRESS_PATTERN = '\\b(?:' + EXPRESS_PREFIXES.join('|') + ')\\d{10,16}\\b';
/** 上一版 express 的正则:只有用户没改过它时,才在升级时跟着换新 */
const LEGACY_EXPRESS_PATTERN = '\\b(?:YT|SF|JD|ZTO|YTO|STO|EMS|DBL)\\d{10,16}\\b';
/** 已经移除的示例规则 id(老配置升级时从用户的规则里剔掉) */
const REMOVED_RULE_IDS = [ 'wms-waybill', 'numeric', 'legacy-postnum', 'dom-attr' ];
/** 配置版本:升版本号 = 下次打开页面时跑一次 upgradeRules() */
const CONFIG_VERSION = 4;
/**
* 内置规则:**只留这一条通用文本规则**。
* (2026-10-17 起把 WMS 选择器 / 纯数字 / legacy postNum / data-attr 这四条示例规则都删了 ——
* 实测「前缀 + 10~16 位数字」已经盖住真实页面的运单号,不够用再加前缀即可。)
*
* 前缀表见 EXPRESS_PREFIXES:新前缀往那里加,不用改正则本身。
*/
const DEFAULT_RULES = [
{
id: 'express',
name: '快递单号(YT / SF / JD / ZTO / YTO / STO / EMS / 32 / 77… 通用文本规则)',
enabled: true,
match: 'text',
pattern: EXPRESS_PATTERN,
flags: 'gi',
exclude: '',
selector: '',
attr: '',
hostPatterns: ['*'],
actionMode: '', // 空 = 跟随全局(默认 button:旁边插按钮,不碰宿主元素)
style: '',
urlTemplate: '',
},
];
/* ---------------------------------------------------------------- 配置 */
function defaultConfig() {
return JSON.parse(JSON.stringify({
version: CONFIG_VERSION,
enabled: true,
hosts: ['*'],
urlTemplate: DEFAULT_URL_TEMPLATE,
appUrlTemplate: DEFAULT_APP_URL_TEMPLATE,
fallbackUrl: DEFAULT_FALLBACK_URL,
downloadUrl: '', // 软件安装包/下载页;空 = 兜底卡片只给「去网页查看」
openMode: 'app', // app = 直接唤起本机软件(默认);window = 独立小窗;tab = 新标签页
actionMode: 'button', // button = 旁边插按钮(默认,不碰宿主元素);chip = 元素本身可点
buttonText: DEFAULT_BUTTON_TEXT,
markStyle: 'underline',
showIcon: true,
scanDelay: 400, // DOM 变动后延迟多久重扫(毫秒)
maxNodes: 5000, // 单次扫描最多看多少个文本节点
maxMarks: 400, // 单页最多标记多少处
rules: DEFAULT_RULES,
}));
}
function normalizeConfig(raw) {
const dft = defaultConfig();
const src = raw && typeof raw === 'object' ? raw : {};
const cfg = Object.assign(dft, src);
cfg.version = CONFIG_VERSION;
cfg.enabled = cfg.enabled !== false;
cfg.hosts = toStrArray(cfg.hosts, ['*']);
cfg.urlTemplate = String(cfg.urlTemplate || '').trim() || DEFAULT_URL_TEMPLATE;
cfg.appUrlTemplate = String(cfg.appUrlTemplate || '').trim() || DEFAULT_APP_URL_TEMPLATE;
cfg.fallbackUrl = String(cfg.fallbackUrl || '').trim() || DEFAULT_FALLBACK_URL;
cfg.downloadUrl = String(cfg.downloadUrl || '').trim();
cfg.openMode = OPEN_MODES.indexOf(cfg.openMode) >= 0 ? cfg.openMode : 'app';
// v3 把「协议模板」当成了 urlTemplate 的默认值(当时没有 openMode=app 这个概念);
// 升到 v4:模板还原成网页模板,改用 openMode='app' 表达「直接唤起」,行为不变。
if (Number(src.version || 1) < 4 && String(src.urlTemplate || '').trim() === DEFAULT_APP_URL_TEMPLATE) {
cfg.urlTemplate = DEFAULT_URL_TEMPLATE;
cfg.openMode = 'app';
}
cfg.actionMode = ACTION_MODES.indexOf(cfg.actionMode) >= 0 ? cfg.actionMode : 'button';
cfg.buttonText = String(cfg.buttonText == null ? '' : cfg.buttonText).trim() || DEFAULT_BUTTON_TEXT;
cfg.markStyle = MARK_STYLES.indexOf(cfg.markStyle) >= 0 ? cfg.markStyle : 'underline';
cfg.showIcon = cfg.showIcon !== false;
cfg.scanDelay = clampInt(cfg.scanDelay, 0, 5000, 400);
cfg.maxNodes = clampInt(cfg.maxNodes, 100, 50000, 5000);
cfg.maxMarks = clampInt(cfg.maxMarks, 1, 5000, 400);
// rules 缺失(首次安装 / 数据损坏)才回落到内置规则;用户主动删空就保持空
if (!Array.isArray(src.rules)) {
cfg.rules = dft.rules;
} else {
cfg.rules = src.rules.map(normalizeRule).filter(Boolean);
// 老版本的配置(version < CONFIG_VERSION)跟着扩展升级一次:删掉已移除的示例规则、刷新内置规则的前缀表
if (Number(src.version || 1) < CONFIG_VERSION) cfg.rules = upgradeRules(cfg.rules);
}
return cfg;
}
/**
* 配置升级(只在 version 变高时跑一次):
* 1. 剔掉已经移除的内置示例规则(REMOVED_RULE_IDS);
* 2. 内置的 express 若还是老正则(用户没自己改过),就换成带新前缀表的正则。
* 用户自己加的规则一律不动。
*/
function upgradeRules(rules) {
return rules
.filter(rule => REMOVED_RULE_IDS.indexOf(rule.id) < 0)
.map(rule => {
if (rule.id !== 'express') return rule;
if (String(rule.pattern).trim() !== LEGACY_EXPRESS_PATTERN) return rule; // 用户改过就尊重他的
return Object.assign({}, rule, {
name: DEFAULT_RULES[0].name,
match: 'text',
pattern: EXPRESS_PATTERN,
flags: 'gi',
});
});
}
function normalizeRule(raw) {
if (!raw || typeof raw !== 'object') return null;
return {
id: String(raw.id || '').trim() || 'r-' + Math.random().toString(36).slice(2, 8),
name: String(raw.name == null ? '' : raw.name).trim() || '未命名规则',
enabled: raw.enabled === true,
match: raw.match === 'selector' ? 'selector' : 'text',
pattern: String(raw.pattern == null ? '' : raw.pattern),
flags: String(raw.flags == null ? '' : raw.flags),
exclude: String(raw.exclude == null ? '' : raw.exclude),
selector: String(raw.selector == null ? '' : raw.selector),
attr: String(raw.attr == null ? '' : raw.attr).trim(),
hostPatterns: toStrArray(raw.hostPatterns, ['*']),
actionMode: ACTION_MODES.indexOf(raw.actionMode) >= 0 ? raw.actionMode : '', // 空 = 跟随全局
style: MARK_STYLES.indexOf(raw.style) >= 0 ? raw.style : '',
urlTemplate: String(raw.urlTemplate == null ? '' : raw.urlTemplate).trim(),
};
}
/* -------------------------------------------------------- 规则编译 */
/**
* 把配置里的规则编译成「可直接跑」的形态,编译失败的规则会被跳过并收集原因
* (而不是让整页注入挂掉)。
* @returns {{rules: Array, errors: Array<{id:string,name:string,message:string}>}}
*/
function compileRules(rules) {
const list = [];
const errors = [];
for (const rule of Array.isArray(rules) ? rules : []) {
if (!rule || rule.enabled === false) continue;
try {
const ptn = String(rule.pattern || '').trim();
const ex = String(rule.exclude || '').trim();
const excludeRe = ex ? new RegExp(ex, 'g') : null;
let re = null;
if (rule.match === 'selector') {
const sel = String(rule.selector || '').trim();
if (!sel) throw new Error('CSS 选择器不能为空');
if (typeof document !== 'undefined') {
// 仅做语法校验:非法选择器会让 querySelector 直接抛异常
document.createDocumentFragment().querySelector(sel);
}
// 选择器模式下正则是**可选**的:填了就用来从取到的属性值/文本里再抽一次编号。
// 典型场景:
// —— 编号藏在 href 里,整条属性值不能当编号,必须再抽一层。
if (ptn) re = new RegExp(ptn, normalizeFlags(rule.flags));
} else {
if (!ptn) throw new Error('正则表达式不能为空');
re = new RegExp(ptn, normalizeFlags(rule.flags));
}
list.push({ rule, re, excludeRe });
} catch (e) {
errors.push({ id: rule.id, name: rule.name, message: shortMessage(e) });
}
}
return { rules: list, errors };
}
/** 只保留安全 flag,并且强制带上 g(exec 循环依赖它) */
function normalizeFlags(flags) {
const keep = [];
for (const ch of String(flags || '').toLowerCase()) {
if ('imsug'.indexOf(ch) >= 0 && keep.indexOf(ch) < 0) keep.push(ch);
}
if (keep.indexOf('g') < 0) keep.push('g');
return keep.join('');
}
/* ---------------------------------------------------------- 文本匹配 */
function extractCode(m) {
const picked = m.length > 1 && m[1] != null ? m[1] : m[0];
return String(picked == null ? '' : picked).trim();
}
/**
* 在一段文本里找出所有命中(多条规则合并,按位置排序,重叠的只保留最靠前的那个)
* @param {string} text
* @param {{rules:Array}} compiled compileRules() 的结果
* @param {number} [maxPerNode] 单个文本节点最多取多少条,默认 20
*/
function matchText(text, compiled, maxPerNode) {
const out = [];
if (!text) return out;
const cap = maxPerNode || 20;
for (const c of (compiled && compiled.rules) || []) {
if (!c.re) continue;
const re = c.re;
re.lastIndex = 0;
let m;
while ((m = re.exec(text)) !== null) {
if (!m[0]) { re.lastIndex++; continue; } // 零宽匹配兜底,否则死循环
const code = extractCode(m);
if (!code) continue;
if (c.excludeRe) {
c.excludeRe.lastIndex = 0;
if (c.excludeRe.test(m[0])) continue;
}
out.push({ rule: c.rule, code, text: m[0], index: m.index });
if (out.length >= cap) break;
}
}
// 长的优先,避免短规则把长规则切碎
out.sort((a, b) => (a.index - b.index) || (b.text.length - a.text.length));
const kept = [];
let end = -1;
for (const h of out) {
if (h.index < end) continue;
kept.push(h);
end = h.index + h.text.length;
}
return kept;
}
function acceptTextNode(node, markClass) {
const v = node.nodeValue;
if (!v || !v.trim()) return false;
const p = node.parentElement;
if (!p) return false;
// 跳过 SVG / MathML —— 超出 HTML 命名空间,插 HTML 元素会出问题
if (p.namespaceURI && p.namespaceURI !== 'http://www.w3.org/1999/xhtml') return false;
if (SKIP_TAGS.has(p.tagName)) return false;
if (p.isContentEditable) return false;
// 已经加工过的(chip 标记 / text 模式的定位 span / 按钮)都不再处理:
// 一律看 data-pst-code —— button 模式不会给宿主元素加类名,只看类名会漏。
if (p.closest && p.closest('.' + markClass + ', [data-pst-code], [data-pst-skip]')) return false;
return true;
}
/* ---------------------------------------------------------- DOM 标记 */
/**
* 扫描 rootEl 并按规则「二次加工」,= 两种匹配 × 两种加工方式:
*
* 匹配:text 规则(遍历文本节点按正则找) / selector 规则(CSS 选择器命中元素)
* 加工:button(默认)= **完全不碰命中元素**,只在它旁边插一个兄弟按钮
* chip = 命中元素本身可点(会加类名 / 改 title / 接管点击)
*
* button 方式下宿主元素只被写两个 data-* 属性当「已处理」记号,
* 类名 / title / role / tabindex 一律不动 —— 所以元素的外观和它自己的点击行为都不受影响。
* 自己新建的元素一律带 data-pst-code,acceptTextNode 见到就跳过,保证不会自我嵌套。
*
* @param {Element|Document} rootEl
* @param {{rules:Array}} compiled
* @param {object} opts 见下方 o.* 读取处
* @returns {{items:Array, marks:Array, truncated:boolean}}
* items —— 去重后的命中清单(给 popup 展示)
* marks —— 新建/标记的元素(配置页试跑用来取 outerHTML 预览)
*/
function applyMarks(rootEl, compiled, opts) {
const o = opts || {};
const doc = (rootEl && rootEl.ownerDocument) || (typeof document !== 'undefined' ? document : null);
const markClass = o.markClass || 'pst-trace-mark';
const maxNodes = clampInt(o.maxNodes, 100, 50000, 5000);
const maxMarks = clampInt(o.maxMarks, 1, 5000, 400);
const defaultAction = ACTION_MODES.indexOf(o.defaultActionMode) >= 0 ? o.defaultActionMode : 'button';
const buttonText = String(o.buttonText == null ? '' : o.buttonText).trim() || DEFAULT_BUTTON_TEXT;
const items = [];
const marks = [];
const seen = new Set();
let truncated = false;
if (!rootEl || !doc) return { items, marks, truncated };
function urlFor(rule, code) {
// 「直接唤起本机软件」:用协议模板(规则级的网页模板不参与)
if (o.openMode === 'app') {
return buildUrl(o.appUrlTemplate || DEFAULT_APP_URL_TEMPLATE, code, o.host);
}
const tpl = rule.urlTemplate || o.urlTemplate || DEFAULT_URL_TEMPLATE;
return buildUrl(tpl, code, o.host);
}
function pushItem(rule, code, text, url) {
const key = rule.id + '\u0000' + code;
if (seen.has(key)) return;
seen.add(key);
if (items.length < 60) {
items.push({ ruleId: rule.id, ruleName: rule.name, code, text, url });
}
}
/** 这条规则用哪种加工方式(规则自己没写就跟随全局) */
function actionOf(rule) {
return ACTION_MODES.indexOf(rule.actionMode) >= 0 ? rule.actionMode : defaultAction;
}
/** 「查看打包视频」按钮:自己带 markClass,所以点击处理和命中计数都跟 chip 模式走同一条路 */
function makeButton(rule, code) {
const btn = doc.createElement('button');
btn.type = 'button';
btn.className = markClass + ' pst-trace-btn';
btn.textContent = buttonText;
btn.setAttribute('data-pst-code', code);
btn.setAttribute('data-pst-rule', rule.id);
const url = urlFor(rule, code);
if (url) {
btn.setAttribute('data-pst-url', url);
btn.title = url;
}
return btn;
}
/** 按钮插到哪儿:命中元素自己;它若在 里则退到那个 之后(