packServer/extension/src/background.js
liufumingren 11ebb33966 feat(extension): 插件配置集中管理 + 桌面端策略安装 + 跨网下载修复
- 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension;
  插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效)
- 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成)
- 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布
- 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证);
  跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe
- 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包),
  nginx 对 /download/extension/updates.xml 关缓存

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:26 +08:00

254 lines
9.6 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.

'use strict';
/**
* 云仓视频溯源 · background(MV3 service worker)
*
* 两件事:
* 1. 把 content script 算好的目标地址打开(见下);
* 2. **拉取服务器下发配置**:每小时一次 + 插件启动/安装时一次 + 用户点「立即同步」。
* 识别前缀、生效站点、跳转模板全由后台维护,插件只负责执行(不提供编辑/试跑/导入导出)。
*/
importScripts('lib/rules.js');
/** 服务器配置接口(可用 chrome.storage.local.pstConfigUrl 临时覆盖,调试用) */
const CONFIG_URL = 'https://pack.wms.gztbyc.com/api/web/extension/config';
/**
* 桌面端安装包版本信息(和网页顶栏「下载桌面端」同一份)
*
* 后台**不需要维护安装包地址**:每次同步都读一次这个文件,永远是最新发布版本;
* 后台配置里的 `downloadUrl` 非空时才作为覆盖值(例如临时指到内网镜像)。
*/
const VERSION_URL = 'https://pack.wms.gztbyc.com/download/version.json';
/**
* 定时拉取的 alarm 名 + 周期(分钟)
*
* 5 分钟:后台一改配置,最多 5 分钟就生效(服务端对配置结果缓存 1 小时,
* 后台保存时会立刻删缓存,所以这里拉得勤不会把数据库打垮)。
*/
const SYNC_ALARM = 'pst:config-sync';
const SYNC_PERIOD_MINUTES = 5;
/** 同步状态(选项页/弹窗展示用;与配置分开存,免得改配置时把错误信息冲掉) */
const SYNC_STATE_KEY = 'pstSyncState';
/**
* 只干一件事:把 content script 算好的目标地址打开。
*
* 为什么把「打开」放在这里而不是 content script 里?
* - content script 调 window.open 会被宿主页的弹窗拦截器干掉;
* - chrome.tabs.create / chrome.windows.create 不受页面策略影响;
* - 顺带可以钉住 windowId,保证新标签页开在用户当前这个窗口里。
*
* 地址由 content script 算(它手里有配置和 {code}),这里只做协议白名单校验。
*/
chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
if (!msg) return;
// 探测本机软件是否在跑(协议唤起到底成没成,靠它判断)
if (msg.type === 'pst:probe') {
probeLocalService().then(sendResponse, () => sendResponse({ online: false }));
return true;
}
// 手动同步配置(选项页 / 弹窗的「立即同步」)
if (msg.type === 'pst:sync') {
syncConfig('manual').then(sendResponse, err => {
sendResponse({ ok: false, error: String((err && err.message) || err) });
});
return true;
}
if (msg.type !== 'pst:open') return;
openTarget(msg, sender).then(sendResponse, err => {
sendResponse({ ok: false, message: String((err && err.message) || err) });
});
return true; // 异步响应
});
/**
* 探测本机软件是否在跑。
*
* 为什么不去看「页面有没有失焦」:软件已经在跑时,协议只是把参数转给已有实例,
* 窗口可能不抢焦点;冷启动也可能超过几秒 —— 两种都会误报「没打开」。
* 但软件只要在跑就一定监听 17300,**任何 HTTP 响应(200/400/401)都算成功**。
*/
async function probeLocalService(timeoutMs = 1500) {
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), timeoutMs);
try {
const res = await fetch('http://localhost:17300/api/query/', {
cache: 'no-store',
signal: controller.signal,
});
return { online: true, status: res.status };
} catch (_) {
return { online: false };
} finally {
clearTimeout(timer);
}
}
async function openTarget(msg, sender) {
const url = String(msg.url || '').trim();
if (!/^https?:\/\//i.test(url)) {
return { ok: false, message: '只允许打开 http/https 地址:' + url };
}
const mode = msg.mode === 'window' ? 'window' : 'tab';
const windowId = sender && sender.tab ? sender.tab.windowId : undefined;
if (mode === 'window') {
await chrome.windows.create({
url,
type: 'popup',
width: 1280,
height: 860,
focused: true,
...(windowId != null ? { } : {}), // windows.create 没有 windowId 概念,忽略
});
} else {
const opts = { url, active: true };
if (windowId != null) opts.windowId = windowId;
if (sender && sender.tab && sender.tab.id != null) opts.openerTabId = sender.tab.id;
await chrome.tabs.create(opts);
}
return { ok: true, url, mode };
}
/* ------------------------------------------------------------ 配置同步 */
const R = globalThis.PSTRules;
chrome.runtime.onInstalled.addListener(() => {
ensureSyncAlarm();
void syncConfig('installed');
});
chrome.runtime.onStartup.addListener(() => {
ensureSyncAlarm();
void syncConfig('startup');
});
chrome.alarms.onAlarm.addListener(alarm => {
if (alarm.name === SYNC_ALARM) void syncConfig('alarm');
});
/**
* alarm 不会自动续命:浏览器重启 / 扩展更新后要重新建。
* `delayInMinutes: 1` 让安装后一分钟内就有第一次定时同步(上面另外还会立刻拉一次)。
*/
function ensureSyncAlarm() {
chrome.alarms.get(SYNC_ALARM, current => {
// 同名 create 会覆盖:周期改过(比如 60 → 5 分钟)时要重建,否则老用户升级后还是旧周期
if (current && current.periodInMinutes === SYNC_PERIOD_MINUTES) return;
chrome.alarms.create(SYNC_ALARM, { delayInMinutes: 1, periodInMinutes: SYNC_PERIOD_MINUTES });
});
}
/** 配置接口地址(允许用 storage 覆盖,方便联调环境) */
async function resolveConfigUrl() {
try {
const stored = await chrome.storage.local.get('pstConfigUrl');
const custom = stored && stored.pstConfigUrl;
if (custom) return String(custom);
} catch (_) { /* 读不到就用默认 */ }
return CONFIG_URL;
}
/**
* 读最新桌面端安装包地址(`/download/version.json`,不是 `{ok,data}` 包装,直接是 JSON)
*
* 失败一律返回 null:安装包地址拿不到不该影响配置同步本身。
*/
async function resolveLatestInstaller() {
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), 5000);
try {
const res = await fetch(VERSION_URL, { cache: 'no-store', signal: controller.signal });
if (!res.ok) return null;
const data = await res.json();
const url = data && typeof data.downloadUrl === 'string' ? data.downloadUrl.trim() : '';
if (!url) return null;
return { url, version: String((data && data.version) || '') };
} catch (_) {
return null;
} finally {
clearTimeout(timer);
}
}
async function readSyncState() {
try {
const stored = await chrome.storage.local.get(SYNC_STATE_KEY);
return (stored && stored[SYNC_STATE_KEY]) || {};
} catch (_) {
return {};
}
}
async function writeSyncState(patch) {
const next = Object.assign({}, await readSyncState(), patch);
try {
await chrome.storage.local.set({ [SYNC_STATE_KEY]: next });
} catch (_) { /* 状态写不进去不影响配置 */ }
}
/**
* 拉一次服务器配置
*
* - 版本没变就**不写 storage**(避免每小时让所有页面重扫一遍);
* - 失败**保留旧配置**(断网也照常工作),错误写进同步状态给选项页看;
* - 成功后内容脚本会收到 storage 变更通知,自己重扫当前页面。
*/
async function syncConfig(reason) {
const url = await resolveConfigUrl();
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), 8000);
try {
const res = await fetch(url, { cache: 'no-store', signal: controller.signal });
if (!res.ok) throw new Error('HTTP ' + res.status);
const payload = await res.json();
const remote = payload && payload.data ? payload.data : payload;
if (!remote || typeof remote !== 'object') throw new Error('服务器返回的配置格式不对');
if (!remote.pattern) throw new Error('服务器返回的配置缺少 pattern(后台还没配前缀?)');
const previous = await R.loadConfig();
// 安装包地址:**优先用最新发布版本**(/download/version.json,和网页顶栏同一份),
// 版本号没变但发了新包时也能跟上;拿不到(断网/还没发布过)才退回后台配置值、再退回上次的值,
// 免得把「下载安装」按钮弄没了。
const latest = await resolveLatestInstaller();
const downloadUrl = (latest && latest.url)
|| String(remote.downloadUrl || '').trim()
|| String(previous.downloadUrl || '');
const known = (previous.remote && previous.remote.version) || 0;
const sameConfig = known && Number(remote.version) === Number(known);
const sameInstaller = String(previous.downloadUrl || '') === downloadUrl;
if (sameConfig && sameInstaller) {
await writeSyncState({ at: new Date().toISOString(), error: '', reason, version: Number(remote.version) });
return { ok: true, unchanged: true, version: Number(remote.version), at: previous.remote.syncedAt };
}
const next = R.applyRemote(previous, Object.assign({}, remote, { downloadUrl }));
const saved = await R.saveConfig(next);
if (!saved.ok) throw new Error(saved.message || '配置保存失败');
await writeSyncState({ at: next.remote.syncedAt, error: '', reason, version: next.remote.version });
return { ok: true, version: next.remote.version, at: next.remote.syncedAt, unchanged: false };
} catch (err) {
const message = String((err && err.message) || err);
await writeSyncState({ at: new Date().toISOString(), error: message, reason });
return { ok: false, error: message };
} finally {
clearTimeout(timer);
}
}