gacha-calendar-core 0.9.40 → 0.10.0

package/core.mjs

@@ -4,11 +4,17 @@
 		// 用途：缓存里记录"这份数据是哪版插件产出的"。更新插件后首次启动，据此**强制**刷新一次
 		// （不看自动刷新开关）——因为有些改动（悬停格式、来源地址、样式、解析器）不刷新就看不到效果。
 		// 写入时机见 engine-api.js 的 refresh()；判定见 60-helpers.js 的 autoRefreshPlan()。
-		const PLUGIN_VERSION = "0.9.40";
+		const PLUGIN_VERSION = "0.10.0";
 		//#endregion
 
 		//#region config
 		const NS = "gacha-calendar";
+		// 本插件在 profile 里的条目 id 候选（用于解析设置表单，见 92-dsh-env.js 的 resolveSettingsEntryId）。
+		// DSH 0.1.7 起设置文档按**条目 id**寻址，而"插件名/条目 id/包名"三者未必同名：
+		//   · cordis.patch.yml 里是 id: gacha-calendar（我们自己的 insert 声明）
+		//   · 包名是 dsh-gacha-calendar
+		// 所以不写死单一字符串，按顺序试，谁能拿到表单就用谁。
+		const SETTINGS_ENTRY_IDS = [NS, "dsh-gacha-calendar"];
 		// 刷新频率选项：按天（存分钟），与 host 端 Config.refreshMinutes 对应。
 		// 档位对齐常见版本周期：14/21/28/35/42 天 —— 15≈蔚蓝档案的 14 天轮换、21=1999 半版本/3.6 整版本
 		// 与异环当期、30≈方舟月度、42=米系与 1999 的整版本
@@ -292,6 +298,40 @@
 			gacha: { fail: "卡池失败", nomatch: "新卡池未公布", nomatchUser: "未解析出内容" },
 			event: { fail: "活动失败", nomatch: "新活动未公布", nomatchUser: "未解析出内容" }
 		};
+
+		// —— 配置表单写入被拒时的归因（纯函数）——
+		// DSH 0.1.7 的 configForms 表单有四种"能读不能写"的状态，肉眼在界面上完全分不出来
+		// （控件点一下弹回原值、没有任何提示）。这里按快照如实说清是哪一种，让下次出问题能一眼定位：
+		//   memory  = 本次连接不是本机回环 → 宿主压根不接受持久化写入（只读）
+		//   loading = 表单数据还没送到（点太早了）
+		//   unavailable = 宿主没在 serve 本插件的条目（多半是条目 id 对不上 / 没进 describe）
+		//   其它    = 宿主明确拒绝（字段没进表单，或修订号冲突）
+		function formRejectHint(scope, key) {
+			var snap = null;
+			try { snap = scope && scope.getSnapshot ? scope.getSnapshot() : null; } catch (e) { snap = null; }
+			const status = snap && snap.status ? snap.status : "unknown";
+			const mode = snap && snap.mode ? snap.mode : "unknown";
+			const rev = snap && typeof snap.revision === "number" ? " (rev " + snap.revision + ")" : "";
+			const id = scope && scope.entryId ? scope.entryId : "(未解析)";
+			if (mode === "memory") return "本次连接不是本机，宿主不接受写入（只读模式）";
+			if (status === "loading") return "配置表单还没送到，请稍后重试";
+			if (status === "unavailable") return "宿主未 serve 条目「" + id + "」" + servedNamespacesText(scope.configForms);
+			return "宿主拒绝了该写入（表单状态 " + status + " / " + mode + rev + "）";
+		}
+
+		// 把宿主**真正 serve 的**设置 namespace 列出来。这一条是给"地址对不上"这类故障留的现场：
+		// 只说"没提供配置条目"定位不了，列出真实 id 就能一眼看出该用哪个。
+		function servedNamespacesText(configForms) {
+			try {
+				const mirror = configForms && typeof configForms.describe === "function" ? configForms.describe() : null;
+				const view = mirror && typeof mirror.getSnapshot === "function" ? mirror.getSnapshot().view : null;
+				const rows = view && Array.isArray(view.namespaces) ? view.namespaces : [];
+				const names = rows.map((r) => r && r.ns).filter((ns) => typeof ns === "string");
+				return names.length ? "（宿主当前 serve：" + names.join(", ") + "）" : "（宿主当前一个设置条目都没 serve）";
+			} catch (e) {
+				return "";
+			}
+		}
 		function normErr(err) {
 			const name = String((err && err.name) || "");
 			const msg = String((err && err.message) || err || "");
@@ -3845,6 +3885,7 @@ export function createEngine(env) {
 				DEFAULT_SETTINGS,
 				// 启动自动刷新判定（纯函数）与当前插件版本（注入自 package.json）：回归脚本据此验收
 				autoRefreshPlan,
+				formRejectHint,
 				PLUGIN_VERSION
 			};
 

package/package.json

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