gacha-calendar-core 0.10.7 → 0.10.8

package/core.mjs

@@ -4,7 +4,7 @@
 		// 用途：缓存里记录"这份数据是哪版插件产出的"。更新插件后首次启动，据此**强制**刷新一次
 		// （不看自动刷新开关）——因为有些改动（悬停格式、来源地址、样式、解析器）不刷新就看不到效果。
 		// 写入时机见 engine-api.js 的 refresh()；判定见 60-helpers.js 的 autoRefreshPlan()。
-		const PLUGIN_VERSION = "0.10.7";
+		const PLUGIN_VERSION = "0.10.8";
 		//#endregion
 
 		//#region config
@@ -61,6 +61,10 @@
 		// 其中 recommend 组含逐期「角色/武器活动唤取」公告，正文带 ✦活动时间✦ 起止
 		const WUWA_NOTICE_ENTRY = "https://aki-gm-resources-back.aki-game.com/gamenotice/G152/76402e5b20be2c39f095a152090afddc/entrypoint.json";
 		const WUWA_BWIKI_URL = "https://wiki.biligame.com/wutheringwaves/api.php?action=parse&page=%E9%A6%96%E9%A1%B5%2F%E8%A7%92%E8%89%B2%E8%BD%AE%E6%8D%A2%E6%B1%A0&prop=text&format=json&formatversion=2";
+		// 鸣潮 Bwiki 活动日历页（已从**默认活动源降级为备选**，2026-10-01）：
+		// 该页仍可解析（parseWuwaCalendar 能抽到 11 条），但**已停更**——最新一条结束于 2026/9/29，
+		// 没有当期 3.7 的活动，所以不改解析器，只把它挪到备选。
+		const WUWA_EVENT_BWIKI_URL = "https://wiki.biligame.com/wutheringwaves/api.php?action=parse&page=%E9%A6%96%E9%A1%B5%2F%E6%B4%BB%E5%8A%A8%E6%97%A5%E5%8E%86&prop=text&format=json&formatversion=2";
 		// 绝区零官网公告（api-takumi-static content_v2_user，经 host 代理；无 CORS、无需登录）：
 		// iChanId=279（公告频道）返回逐条公告正文（sIntro/sContent），其中「X.Y版本限时频段（上/下期）」
 		// 含该期精确起止 + 限定 S 级代理人/音擎；起点写「版本更新后」时取同版本「更新公告」的 dtStartTime。
@@ -128,19 +132,27 @@
 			},
 			{
 				id: "wuwa",
-				parserVersion: 1,
+				parserVersion: 2,
 				name: "鸣潮",
 				icon: "https://storage.moegirl.org.cn/moegirl/commons/2/29/WutheringWavesIcon.png!/fw/64",
 				source: "官方公告",
-				// 默认卡池源=官方公告（aki-gm-resources-back，经 host 代理）：逐期「角色/武器活动唤取」公告含起止时间；
+				// 默认卡池源=官方公告（aki-gm-resources-back，经 host 代理）：
+				// entrypoint.json → <dir>/zh-Hans.json，其 `recommend` 组里 tag=7 为逐期「角色/武器活动唤取」，
+				// 条目自带 `startTimeMs`/`endTimeMs` 绝对时间戳（不再解析正文，见 parseWuwaNotice）。
 				// 无当期公告或抓取失败时由抓取器自动回退 Bwiki 角色轮换池；也可在设置中手动切 Bwiki（备选）
 				url: WUWA_NOTICE_ENTRY,
 				altSources: [
 					{ label: "Bwiki 角色轮换池", url: WUWA_BWIKI_URL, fetcher: "wuwa-bwiki" }
 				],
-				// 独立活动源：鸣潮活动日历页（与卡池源不同）
-				eventUrl: "https://wiki.biligame.com/wutheringwaves/api.php?action=parse&page=%E9%A6%96%E9%A1%B5%2F%E6%B4%BB%E5%8A%A8%E6%97%A5%E5%8E%86&prop=text&format=json&formatversion=2",
-				eventSource: "Bwiki 活动日历"
+				// 活动源：**默认=同一份官方公告**（`recommend` 组里 tag=5 为限时活动，见 parseWuwaRecommendEvents），
+				// 与卡池同址 → 一次请求复用两侧数据。
+				// ⚠️ 2026-10-01 改：Bwiki 活动日历页**已停更**（最新一条结束于 2026/9/29，无 3.7 内容），
+				// 所以把它从默认**降级为备选**（eventAltSources），仍可在设置里手动切回。
+				eventUrl: WUWA_NOTICE_ENTRY,
+				eventSource: "官方公告",
+				eventAltSources: [
+					{ label: "Bwiki 活动日历", url: WUWA_EVENT_BWIKI_URL, fetcher: "wuwa-event-bwiki" }
+				]
 			},
 			{
 				id: "arknights",
@@ -1384,8 +1396,13 @@ export function createEngine(env) {
 			return null;
 		}
 
-		// 鸣潮官方公告解析：从全量公告（game/activity/recommend）中取"覆盖当前时刻"的「角色活动唤取」
-		// 公告形如：tabTitle="[身赴三途]角色活动唤取"，content 内含"✦活动时间✦ 2026年9月10日10:00 ~ 2026年9月29日11:59"
+		// 鸣潮官方公告解析：从全量公告（game/activity/recommend）中取"覆盖当前时刻"的「角色活动唤取」。
+		//
+		// ⚠️ 时间**必须用 JSON 里的绝对时间戳** `startTimeMs` / `endTimeMs`，不要再去解析正文。
+		// 正文写的是 `✦活动时间✦ 3.7版本更新后 ~ 2026年10月22日09:59（服务器时间）` ——
+		// 起始端是**版本标签**而非绝对日期，旧实现用 `(\d{4})年(\d{1,2})月…` 匹配整段 → 恒失败 →
+		// 卡池侧返回 null（2026-10-01 实测：官方 JSON 已带 3 个在开角色池，却显示"未公布"）。
+		// 现在源站直接给了时间戳，比解析正文更准，也不受措辞漂移影响。
 		function parseWuwaNotice(list, now = nowMs()) {
 			const groups = [list?.game, list?.activity, list?.recommend].filter(Array.isArray);
 			const stripH = (s) => String(s || "")
@@ -1396,41 +1413,88 @@ export function createEngine(env) {
 			const pools = [];
 			for (const arr of groups) {
 				for (const it of arr) {
-					const title = stripH(it.tabTitle || it.title || "");
-					if (!/活动唤取/.test(title)) continue;
-					const text = stripH(it.content || "");
-					const m = text.match(/(\d{4})年(\d{1,2})月(\d{1,2})日\s*(\d{1,2}):(\d{2})\s*[~～-]\s*(?:(\d{4})年)?(\d{1,2})月(\d{1,2})日\s*(\d{1,2}):(\d{2})/);
-					if (!m) continue;
-					const sTs = new Date(+m[1], +m[2] - 1, +m[3], +m[4], +m[5]).getTime();
-					const eTs = new Date(+(m[6] || m[1]), +m[7] - 1, +m[8], +m[9], +m[10]).getTime();
+					// 标题可能是 "[但愿长圆如此夜]\n角色活动唤取" / "「玉阙玄华」武器活动唤取"
+					const title = stripH(it.tabTitle || it.title || "").replace(/\s+/g, " ").trim();
+					const isChar = /角色活动唤取/.test(title);
+					const isWeapon = /武器活动唤取/.test(title);
+					if (!isChar && !isWeapon) continue;
+					const sTs = Number(it.startTimeMs), eTs = Number(it.endTimeMs);
+					if (!Number.isFinite(sTs) || !Number.isFinite(eTs)) continue;
 					if (sTs > now || eTs < now) continue; // 只要当期覆盖
 					const name = title
 						.replace(/\s*(?:角色|武器)活动唤取\s*$/, "")
 						.replace(/^[\[【「]\s*/, "")
 						.replace(/\s*[\]】」]$/, "")
 						.trim();
-					const upPart = text.split(/✦\s*活动时间/)[0] || "";
-					const ups = [...upPart.matchAll(/[「【]([^」】]+)[」】]/g)].map((x) => x[1].trim()).filter(Boolean);
-					pools.push({ name, isChar: /角色活动唤取/.test(title), roles: ups.join("、"), startTs: sTs, endTs: eTs });
+					if (!name) continue;
+					// 类型名（外显用）：标题尾部那一段，如 `角色活动唤取` / `武器活动唤取`
+					const type = isChar ? "角色活动唤取" : "武器活动唤取";
+					// 角色名：正文开头那句「活动期间，5星角色「心」，4星角色「卜灵」、「桃祈」、「釉瑚」唤取概率限时提升！」
+					// 用 [^。！？\n]+ 限在一句内，避免把后面「唤取说明」里的角色也带进来
+					const text = stripH(it.content || "");
+					const upM = text.match(/活动期间，([^。！？\n]+?)唤取概率限时提升/);
+					const roles = upM
+						? [...new Set([...upM[1].matchAll(/[「【]([^」】]+)[」】]/g)].map((x) => x[1].trim()).filter(Boolean))].join("、")
+						: "";
+					pools.push({ name, type, isChar, roles, startTs: sTs, endTs: eTs });
 				}
 			}
 			const cur = pools.filter((p) => p.isChar && p.name);
 			if (cur.length === 0) return null;
-			const first = cur[0];
-			const roles = [...new Set(cur.flatMap((p) => p.roles.split("、")).filter(Boolean))].join("、");
+			// 外显与窗口取**结束最早**的那个池（与 selectCurrent 的 first 同口径）。
+			const first = cur.slice().sort((a, b) => a.endTs - b.endTs)[0];
+			// 角色：**先拆成单个名字再去重**，然后合并。
+			// ⚠️ 别写成 `new Set(cur.map(p => p.roles))` —— 那样比较的是"整串"（各池的 4★ 名单相同
+			// 但 5★ 不同 → 整串不同 → 重复留下）。拆开才能把三池共有的 4★ 去成一份。
+			// 顺序 = 各池依次展开（5★ 在前、4★ 共有名在后），去重后即 `心、千咲、尤诺、卜灵、桃祈、釉瑚`。
+			const roles = [...new Set(cur.flatMap((p) => p.roles.split("、").map((s) => s.trim()).filter(Boolean)))].join("、");
 			const fmt = (ts) => {
 				const d = new Date(ts);
 				return `${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")} ${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
 			};
 			const raw = fmtWindow(first.startTs, first.endTs);
-			// 悬停：每池"池名：角色"一行 + 时间一行；各池窗口相同则时间只在末尾写一遍；按结束时间升序
-			const bannerHover = buildPoolHover(cur.map((p) => ({
+			// 悬停：首行=卡池类型（与卡片外显同源），随后每池"池名：角色"一行；窗口相同则时间只在末尾写一遍；
+			// 按结束时间升序。**类型行只在本源补**，不动全站共用的 buildPoolHover（它按约定对 0/1 池返回 ""）。
+			const poolHover = buildPoolHover(cur.map((p) => ({
 				name: p.name,
 				label: `${p.name}\uFF1A${p.roles || "-"}`,
 				startTs: p.startTs,
 				endTs: p.endTs
 			})));
-			return { banner: first.name, roles, bannerDates: raw, bannerDatesRaw: raw, startTs: first.startTs, endTs: first.endTs, bannerHover };
+			const bannerHover = poolHover ? `${first.type}\n${poolHover}` : "";
+			// **外显用卡池类型**（`角色活动唤取`），不用某一个池名：
+			// 角色是多池合并的，若外显挂"但愿长圆如此夜"，卡片就成了"标题只说一个池、角色却是三个池的合成"。
+			// 与用户 2026-09-30 定的统一口径一致（国服显示 `限时限定招募`、异环显示 `限定棋盘`）。
+			// 具体池名在悬停里逐条列出，不丢信息。
+			return { banner: first.type, roles, bannerDates: raw, bannerDatesRaw: raw, startTs: first.startTs, endTs: first.endTs, bannerHover };
+		}
+
+		// 鸣潮官方活动解析：同一份全量公告的 `recommend` 组里，`tag === 7` 是卡池、**`tag === 5` 是限时活动**。
+		// 活动条目形如 tabTitle="[团团勇者大乱斗]休闲活动"，同样带绝对时间戳。
+		// 这是 2026-10-01 起鸣潮活动的**默认源**——Bwiki 活动日历页已停更（最新一条结束于 2026/9/29），
+		// 而官方源有当期 3.7 的活动，且与卡池同源、同一次请求即可拿到两侧数据。
+		function parseWuwaRecommendEvents(list, now = nowMs()) {
+			const arr = Array.isArray(list?.recommend) ? list.recommend : [];
+			const stripH = (s) => String(s || "")
+				.replace(/<br\s*\/?>/gi, "\n").replace(/<[^>]+>/g, " ")
+				.replace(/&nbsp;/g, " ").replace(/&amp;/g, "&")
+				.replace(/[ \t]+/g, " ").replace(/\n\s*\n+/g, "\n").trim();
+			const events = [];
+			for (const it of arr) {
+				if (Number(it.tag) !== 5) continue; // 7=卡池；5=限时活动
+				const name = stripH(it.tabTitle || "").replace(/\s+/g, " ").trim();
+				if (!name) continue;
+				const sTs = Number(it.startTimeMs), eTs = Number(it.endTimeMs);
+				if (!Number.isFinite(sTs) || !Number.isFinite(eTs)) continue;
+				if (sTs > now || eTs < now) continue;
+				events.push({ name, cat: "", startTs: sTs, endTs: eTs });
+			}
+			if (events.length === 0) return null;
+			const sorted = sortEventItems(events);
+			if (sorted.length === 0) return null;
+			const primary = pickEventPrimary(sorted) || sorted[0];
+			const dates = fmtWindow(primary.startTs, primary.endTs);
+			return { banner: primary.name, bannerDates: dates, bannerDatesRaw: dates, eventHover: buildEventHover(sorted) };
 		}
 
 		// 鸣潮卡池默认抓取器：官方公告（entrypoint → 目录 → zh-Hans.json 全量）优先；
@@ -1444,8 +1508,18 @@ export function createEngine(env) {
 				let list = null;
 				try { list = await proxyFetchJson(dir + "zh-Hans.json", ref); } catch { list = null; }
 				if (!list || typeof list !== "object") list = await proxyFetchJson(dir + "notice.json", ref);
+				// **同一份 JSON 里卡池（tag=7）与活动（tag=5）都在** → 顺带把活动字段也返回。
+				// 这是"统一来源注册表"里写明的同址复用契约：卡池载荷带 event 字段时，
+				// refresh 不再为活动侧另抓一次（否则同址条目每轮多一个请求）。
+				// ⚠️ 我重写解析时一度只返回卡池字段，导致鸣潮每轮请求从 1 次变成 2 次 —— 已补回。
+				// 活动侧仍保留自己的抓取器（fetchWuwaEventsOfficial）：卡池侧失败、或用户在设置里
+				// 单独选活动来源时，活动侧要能自己抓、自己报错（解耦不变）。
+				const ev = parseWuwaRecommendEvents(list, now);
+				const evFields = ev
+					? { event: ev.banner, eventDates: ev.bannerDates || "", eventDatesRaw: ev.bannerDatesRaw || ev.bannerDates || "", eventHover: ev.eventHover || "" }
+					: {};
 				const d = parseWuwaNotice(list, now);
-				if (d) return d;
+				if (d) return { ...d, ...evFields };
 			} catch { /* 官方失败 → Bwiki 备选 */ }
 			const apiUrl = WUWA_BWIKI_URL + (WUWA_BWIKI_URL.includes("?") ? "&" : "?") + "origin=*";
 			const res = await transportFetchRaw(apiUrl, { signal, headers: rawHeaders(apiUrl) });
@@ -1456,6 +1530,25 @@ export function createEngine(env) {
 			return parseWuwaPool(html);
 		}
 
+		// 鸣潮活动默认抓取器：抓同一份官方公告，取 `recommend` 组里 tag=5 的限时活动。
+		// 与卡池侧同一 URL（entrypoint.json），所以 refresh 的同址复用会让两侧共用一次请求。
+		async function fetchWuwaEventsOfficial(entryUrl) {
+			const ref = "https://aki-gm-resources.aki-game.com/";
+			const ej = await proxyFetchJson(entryUrl, ref);
+			const contentUrl = Array.isArray(ej?.contentUrl) ? ej.contentUrl[0] : "";
+			const dir = contentUrl ? contentUrl.replace(/[^/]*$/, "") : String(entryUrl).replace(/[^/]*$/, "");
+			const list = await proxyFetchJson(dir + "zh-Hans.json", ref);
+			if (!list || typeof list !== "object") throw new Error("wuwa-event-bad-json");
+			const d = parseWuwaRecommendEvents(list, nowMs());
+			if (!d) return null;
+			return {
+				event: d.banner,
+				eventDates: d.bannerDates || "",
+				eventDatesRaw: d.bannerDatesRaw || d.bannerDates || "",
+				eventHover: d.eventHover || ""
+			};
+		}
+
 		// 绝区零官网公告解析：从公告频道（iChanId=279）取「X.Y版本限时频段（上/下期）」，选覆盖当前时刻的一期。
 		// 公告形如：sIntro="本期代理人与音擎调频活动时间为：3.2版本更新后 ~ 2026/09/30 11:59"，
 		// sContent 内含「活动期间，限定S级代理人[克拉蕾(电·锋御)]、[南宫羽(以太·击破)]…」。
@@ -3707,9 +3800,13 @@ export function createEngine(env) {
 					d ? { event: d.banner, eventDates: d.bannerDates || "", eventDatesRaw: d.bannerDatesRaw || d.bannerDates || "" } : null
 				)
 			},
-			// 鸣潮：活动日历页（独立 eventUrl 源）→ 外显当期 + 悬停列出全部并行活动
+			// 鸣潮：**默认=同一份官方公告**（`recommend` 组里 tag=5 为限时活动），与卡池同址
+			// → 一次请求复用两侧数据（refresh 的同址复用优化）。
+			// ⚠️ 2026-10-01 改：Bwiki 活动日历**已停更**（最新一条结束于 2026/9/29），
+			// 所以把官方提为默认、Bwiki 降级为备选（`wuwa-event-bwiki`），仍可在设置里手动切回。
 			wuwa: {
-				default: mkMediaWiki((html) => {
+				default: (url, signal) => fetchWuwaEventsOfficial(url, signal),
+				"wuwa-event-bwiki": mkMediaWiki((html) => {
 					const d = parseWuwaCalendar(html);
 					return d ? { event: d.banner, eventDates: d.bannerDates || "", eventDatesRaw: d.bannerDatesRaw || d.bannerDates || "", eventHover: d.eventHover || "" } : null;
 				})
@@ -3825,9 +3922,21 @@ export function createEngine(env) {
 				let evData = null;
 				let eventFail = null;
 				if (source.eventUrl) {
-					// 活动侧自己的抓取器（与卡池侧各自独立选择，来源可以完全不同）
+					// 活动侧自己的抓取器（与卡池侧各自独立选择，来源可以完全不同）。
+					// 注意：**默认路径就是"活动侧自己抓"** —— 解耦是常态，复用只是优化。
 					const evFetcher = eventFetcherFor(source, eventUrl);
-					if (eventUrl === gachaUrl && g.data && g.data.event) {
+					// ── 同址复用：**命中才触发**的分支 ──────────────────────────────
+					// 只有两个条件**同时**成立才复用，否则一律走下面的独立抓取：
+					//   ① 两侧地址相同（同一次请求本来就能拿到两侧数据）
+					//   ② 卡池那次的载荷**确实带了活动字段**（`event`）
+					// 复用只是"省掉一次本来会重复的请求"，**不是解耦的腿**：
+					// 活动侧的抓取器、失败归因、来源选择都保持独立（见 §53）。
+					//
+					// 2026-10-01 实测（11 内置条目逐条）：复用支命中 5 次
+					//   （wuwa / nte / r1999 / ba-cn / ba-global —— 它们的卡池载荷本身就含活动字段），
+					// 其余 6 条目（zzz / genshin / hsr / arknights / ba-jp / endfield）走独立抓取。
+					const reuseSameUrl = eventUrl === gachaUrl && !!(g.data && g.data.event);
+					if (reuseSameUrl) {
 						// 同 URL：活动字段就在卡池载荷里，不重复抓
 						evData = {
 							event: g.data.event,
@@ -3836,12 +3945,20 @@ export function createEngine(env) {
 							eventHover: g.data.eventHover || ""
 						};
 					} else if (eventUrl === gachaUrl && !evFetcher) {
-						// 同 URL 且活动侧**没有自己的抓取器**（该条目就只有这一份载荷可用）：
-						//  · 卡池那次已抓成功但载荷里没有活动字段 → 该侧就是"未公布"；
-						//  · 卡池那次本身失败 → 沿用它的失败原因（同一次请求的结果，不该另起一个"无可用来源"）。
-						// 只在这一种情况下短路：若活动侧有自己的抓取器（如绝区零/异环），照旧独立抓取，解耦不变。
+						// ── 同址但活动侧**没有自己的抓取器**（该条目就只有这一份载荷可用）──
+						// ⚠️ **这一支不是死代码，别删**：**自定义条目**可以没有注册抓取器 ——
+						//   `getAllEntries` 里 customEntries 带 `custom:true` + 用户填的 url/eventUrl，
+						//   而 GACHA_FETCHERS / EVENT_FETCHERS 里没有它们的 id → `eventFetcherFor` 返回 null。
+						// 语义：
+						//  · 卡池那次成功但载荷没有活动字段 → 该侧就是"未公布"（nomatch），
+						//    且**不发**那次注定被 CORS 拦的直连；
+						//  · 卡池那次本身失败 → 沿用**同一次请求**的失败原因（如 HTTP 567），
+						//    而不是笼统报"无可用来源"。
+						// 教训：我一度只按"内置 11 条目命中 0 次"就判它死代码 —— **错的**，
+						// 把"当前没命中"当成了"不可达"。`_batch1` A3 用合成条目（sim-nte）刻意覆盖这两条语义。
 						eventFail = g.data ? { kind: "nomatch" } : (g.fail || { kind: "nomatch" });
 					} else {
+						// 活动侧独立抓取（含"地址不同"与"同址但载荷无活动字段"两种情形）
 						const ev = await resolveSide("event", {
 							fetcher: evFetcher,
 							url: eventUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gacha-calendar-core",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "description": "二游活动/卡池排期抓取核心：11 款游戏的来源注册表 + 解析器 + 刷新编排 + 缓存降级。零依赖、零宿主环境依赖，任何 JS 运行时（浏览器扩展 background / Tauri / JavaScriptCore / ArkTS 嵌入式引擎）都能跑。",
   "type": "module",
   "main": "./core.mjs",