dsh-gacha-calendar 0.9.39 → 0.10.0

package/README.md

@@ -13,7 +13,7 @@ DeepSeek Harness 桌面端侧边栏插件：一键查看主流二游的**当期
 
 ## 功能
 
-- 侧边栏底部「📅 二游排期」按钮 → 悬浮面板，按行展示每款游戏的当期卡池、卡池起止、当期活动、活动起止
+- 侧边栏底部「📅 二游日历」按钮 → 悬浮面板，按行展示每款游戏的当期卡池、卡池起止、当期活动、活动起止
 - **倒计时**显示剩余时间；悬停看卡池/活动的完整名称与源站原文
 - **刷新提示**（顶行）：按「成功 / 卡池失败 / 活动失败 / 新卡池未公布 / 新活动未公布」归类，悬停看逐条原因；"来源报错"计入失败、"源站还没收录当期"不算失败；某列沿用上次缓存时，悬停里另起一行说明。游戏名悬停可看**上次完全成功的时间**
 - **自动刷新**：启动时判一次——插件更新（缓存不是当前版本产出的）与首次安装会**强制刷一次，不看自动刷新开关**（悬停格式、来源地址、解析器、样式等改动一刷新即生效）；其余按设置间隔（1–42 天）到点才刷，间隔从**上次成功刷新**起算
@@ -39,8 +39,7 @@ DeepSeek Harness 桌面端侧边栏插件：一键查看主流二游的**当期
 
 ## 数据来源
 
-排期数据实时抓取自各游戏**官方公告 / 官方 Wiki / 第三方站**——bwiki、PRTS、wiki.gg、Game8、GameKee、Canmoe、GachaTracker、ldshop、小米游戏中心等。
-无联网数据时对应列显示为空；单列抓取失败则沿用上次成功数据，并在悬停里标注。
+排期数据实时抓取自各游戏**官方公告 / 官方 Wiki / 第三方站**——bwiki、PRTS、wiki.gg、Game8、GameKee、Canmoe、GachaTracker、ldshop、小米游戏中心等。采用**克制的抓取策略**设计，普通用户正常使用时的抓取请求不会影响网站正常运行。
 
 ## 安装
 
@@ -66,7 +65,7 @@ npm run check   # 只校验：src/ 拼出来的结果是否与产物一致（不
 | npm 包 | 内容 | 谁用 |
 |---|---|---|
 | `dsh-gacha-calendar` | DSH 桌面端插件（已内联同一份 core，运行时不依赖 npm 解析） | DSH Desktop |
-| [`gacha-calendar-core`](packages/core) | 平台中立的抓取核心：`createEngine({ transport, storage, now })`，零依赖、零宿主依赖 | 其它平台（开发中） |
+| [`gacha-calendar-core`](packages/core) | 平台中立的抓取核心：`createEngine({ transport, storage, now })`，零依赖、零宿主依赖 | 其它平台 浏览器插件［`gacha-calendar-extension`］(https://github.com/EastMG/gacha-calendar-extension) 等 开发中 |
 
 ```bash
 npm run publish:plugin   # 发布 DSH 插件包（dsh-gacha-calendar）
@@ -118,7 +117,7 @@ dsh-gacha-calendar/
 
 ## 致谢
 
-- [MAA1999/M9A](https://github.com/MAA1999/M9A)——重返未来：1999 的逐期「征集时间」依赖官方**游戏内公告**接口，该接口线索来自它的 `tools/activity_data`。
+- [MAA1999/M9A](https://github.com/MAA1999/M9A)——对《重返未来：1999》逐期「征集时间」的获取手段受到**M9A**的启发。
 
 ## 免责声明
 

package/lib/client.js

@@ -4,7 +4,7 @@
 		// 用途：缓存里记录"这份数据是哪版插件产出的"。更新插件后首次启动，据此**强制**刷新一次
 		// （不看自动刷新开关）——因为有些改动（悬停格式、来源地址、样式、解析器）不刷新就看不到效果。
 		// 写入时机见 engine-api.js 的 refresh()；判定见 60-helpers.js 的 autoRefreshPlan()。
-		const PLUGIN_VERSION = "0.9.39";
+		const PLUGIN_VERSION = "0.10.0";
 		//#endregion
 
 window.__ModuleLoader__.load({
@@ -18,6 +18,12 @@ window.__ModuleLoader__.load({
 
 		//#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 的整版本
@@ -322,7 +328,7 @@ window.__ModuleLoader__.load({
 			},
 			{
 				id: "r1999",
-				parserVersion: 2,
+				parserVersion: 3,
 				name: "重返未来：1999",
 				icon: "https://play-lh.googleusercontent.com/LwcueZMBbLq6aELtqJVn61ToKkJUgxEO8O4KgK_5052hfYoDAglQJIzqSu8srUJeaOZwv36Qi5YKtsXZjo-JPg=s64",
 				source: "\u5B98\u65B9\u516C\u544A",
@@ -2665,7 +2671,31 @@ window.__ModuleLoader__.load({
 			return "";
 		}
 
-		// 解析一篇「版本活动一览」→ { pools, events, rotations }
+		// 独立池公告：标题形如「池名」类型开启！，正文只有一张图（拿不到 UP 名单），
+		// 但接口的 beginTime/endTime 就是该池的真实起止。官方**逐池各发一篇**，且**过期即从公告板下线**：
+		// 实测公告板上 22 条无一条过期，已结束的池与其轮换期全都没有公告（"有公告" ⟺ "该池在开"）。
+		// 所以轮换征集只能靠它——一览里那三行日期不带时间，过期后连日期行也会随版本一起消失。
+		const R99_SOLO_POOL = /^\u300c([^\u300d]{1,40})\u300d([^\u300c\u300d]{1,12})\u5f00\u542f\uff01$/;
+		function r99SoloPools(items) {
+			const out = [];
+			for (const it of items) {
+				const title = String((it.contentMap && it.contentMap["zh-CN"] && it.contentMap["zh-CN"].title) || "").trim();
+				const m = title.match(R99_SOLO_POOL);
+				if (!m) continue;
+				const kind = m[2].trim();
+				if (R99_POOL_TIERS.indexOf(kind) < 0) continue;   // 衣着上新/上架/上新等不是卡池
+				const startTs = Number(it.beginTime);
+				const endTs = Number(it.endTime) - 6e4;           // 接口边界是排他的（…05:00），面板统一显示末分钟 04:59
+				if (!startTs || !endTs) continue;
+				out.push({
+					name: `\u300c${m[1]}\u300d${kind}`, kind, roles: "", startTs, endTs, raw: "",
+					display: fmtWindow(startTs, endTs)
+				});
+			}
+			return out;
+		}
+
+		// 解析一篇「版本活动一览」→ { pools, events, rotRows }
 		function parseR99Overview(item, now = nowMs()) {
 			const lines = r99NoticeLines(item);
 			if (!lines) return null;
@@ -2720,20 +2750,16 @@ window.__ModuleLoader__.load({
 				seenEvent.add(key);
 				events.push({ name: sec.name, cat: sec.kind, startTs, endTs, raw: fmtWindow(startTs, endTs) });
 			}
-			// 轮换征集：一览以「X月X日更新：角色、角色」逐期公布（14 天一期，末日 04:59）
-			const rotations = [];
+			// 轮换征集在一览里**只有日期行**（「N月N日更新：角色」，不带起止时间）→ 这里只当"角色字典"。
+			// 时间不再用"+14 天"推算：每期轮换都有自己的独立公告（见 r99SoloPools），接口给的就是真实起止。
+			const rotRows = [];
 			for (const line of lines) {
 				const m = line.match(/^(\d{1,2})\u6708(\d{1,2})\u65e5\u66f4\u65b0[\uff1a:]\s*(.+)$/);
 				if (!m) continue;
-				const startTs = new Date(year, Number(m[1]) - 1, Number(m[2]), 5, 0).getTime();
-				const endTs = startTs + 14 * 864e5 - 6e4;
-				rotations.push({
-					name: "\u300c\u8f6e\u6362\u5f81\u96c6\u300d", kind: "\u8f6e\u6362\u5f81\u96c6", roles: cleanRoles(m[3]),
-					startTs, endTs, raw: `\u3010${m[1]}\u6708${m[2]}\u65e5\u66f4\u65b0\u3011${cleanRoles(m[3])}`,
-					display: fmtWindow(startTs, endTs)
-				});
+				// 只用"更新日"当匹配键（与同一期独立公告的 startTs 同一天），不作为时间来源
+				rotRows.push({ startTs: new Date(year, Number(m[1]) - 1, Number(m[2]), 5, 0).getTime(), roles: cleanRoles(m[3]) });
 			}
-			return { pools, events, rotations };
+			return { pools, events, rotRows };
 		}
 
 		// 官方游戏内公告 → 当期征集（含真实起止、悬停列全部并行）+ 当期活动（同其它游戏的活动列规则）。
@@ -2746,7 +2772,7 @@ window.__ModuleLoader__.load({
 			const titleOf = (it) => String((it.contentMap && it.contentMap["zh-CN"] && it.contentMap["zh-CN"].title) || "");
 			const overviews = items.filter((it) => /\u7248\u672c\u6d3b\u52a8\u4e00\u89c8/.test(titleOf(it)));
 			if (overviews.length === 0) throw new Error("r1999-notice-no-section");
-			const pools = [], events = [], rotations = [];
+			const pools = [], events = [], rotRows = [];
 			let parsed = 0;
 			for (const it of overviews) {
 				const o = parseR99Overview(it, now);
@@ -2754,11 +2780,27 @@ window.__ModuleLoader__.load({
 				parsed++;
 				pools.push.apply(pools, o.pools);
 				events.push.apply(events, o.events);
-				rotations.push.apply(rotations, o.rotations);
+				rotRows.push.apply(rotRows, o.rotRows);
 			}
 			if (parsed === 0) throw new Error("r1999-notice-no-dates");
+			// 用独立公告补齐一览没有的池（当前就是轮换征集）。同名池**以一览为准**——它有正文【征集时间】
+			// 与 UP 名单；独立公告正文只有图，只能补"池名 + 真实起止"，角色另从日期行字典里按同一天取。
+			const dayKey = (ts) => { const d = new Date(ts); return `${d.getFullYear()}-${d.getMonth() + 1}-${d.getDate()}`; };
+			const rolesByDay = new Map(rotRows.map((r) => [dayKey(r.startTs), r.roles]));
+			for (const p of r99SoloPools(items)) {
+				if (pools.some((x) => x.name === p.name)) continue;
+				p.roles = rolesByDay.get(dayKey(p.startTs)) || "";
+				pools.push(p);
+			}
 			const data = {};
-			const active = pools.concat(rotations).filter((p) => p.startTs <= now && p.endTs >= now);
+			// 当期 = 窗口覆盖现在的池；同名多期（一览的下一期 + 公告的当期）只留第一个 = 一览优先
+			const seenName = new Set();
+			const active = pools.filter((p) => {
+				if (!(p.startTs <= now && p.endTs >= now)) return false;
+				if (seenName.has(p.name)) return false;
+				seenName.add(p.name);
+				return true;
+			});
 			if (active.length > 0) {
 				const rank = (p) => {
 					const i = R99_POOL_TIERS.indexOf(p.kind);
@@ -3252,6 +3294,40 @@ window.__ModuleLoader__.load({
 			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 || "");
@@ -3818,6 +3894,7 @@ window.__ModuleLoader__.load({
 				DEFAULT_SETTINGS,
 				// 启动自动刷新判定（纯函数）与当前插件版本（注入自 package.json）：回归脚本据此验收
 				autoRefreshPlan,
+				formRejectHint,
 				PLUGIN_VERSION
 			};
 
@@ -3884,7 +3961,10 @@ window.__ModuleLoader__.load({
 
 		//#region components
 		// 本插件在 DSH 设置面板里的导航名；面板按钮与弹层标题也用它（唯一事实来源，90-plugin.js 注册分区时共用）。
-		const SETTINGS_SECTION_LABEL = "\u4E8C\u6E38\u6392\u671F";
+		const SETTINGS_SECTION_LABEL = "\u4E8C\u6E38\u65E5\u5386";
+		// 面板上那个「设置」按钮：**临时隐藏**（用户要求）。函数与样式都保留，
+		// 改回 true 即可恢复，不用重写逻辑。
+		const SETTINGS_BUTTON_VISIBLE = false;
 		// DSH 设置面板是"点了才挂载"，打开后要等导航渲染出来才能切页；预算给足但不无限等。
 		const SETTINGS_NAV_TIMEOUT_MS = 600;
 		const SETTINGS_NAV_POLL_MS = 30;
@@ -3904,11 +3984,36 @@ window.__ModuleLoader__.load({
 			if (!trigger || typeof trigger.click !== "function") return;
 			trigger.click();
 			const deadline = Date.now() + SETTINGS_NAV_TIMEOUT_MS;
+			// 在给定根节点里找「二游排期」那一项：先按 aria-label，再按自身文本。
+			// 不写死 `nav button` 结构 —— 设置外壳换布局时（0.1.7 把插件配置挪到了
+			// 「插件」页）这种硬结构选择器会静默失效，表现为"点设置跳错页"。
+			//
+			// 必须排除本插件自己的面板：面板的开关按钮 aria-label 就是同一个标签，
+			// 文档级兜底会先命中它 → 点下去变成"自己开自己"（典型症状：点设置没反应/跳错）。
+			const inOwnPanel = (el) => {
+				for (let n = el; n; n = n.parent) if (n.classList && n.classList.contains("gacha-cal-pop")) return true;
+				return false;
+			};
+			const findItem = (root) => {
+				if (!root || typeof root.querySelectorAll !== "function") return null;
+				const items = [...root.querySelectorAll("button, a")]
+					.filter((el) => el !== trigger && !inOwnPanel(el));
+				const byAttr = items.find((el) => {
+					const l = (el.getAttribute("aria-label") || el.getAttribute("title") || "").trim();
+					return l === SETTINGS_SECTION_LABEL;
+				});
+				if (byAttr) return byAttr;
+				return items.find((el) => (el.textContent || "").trim() === SETTINGS_SECTION_LABEL) || null;
+			};
 			const tick = () => {
-				// 不锁定"文档序第一个 [role=dialog]"：别的插件也可能有带 nav 的对话框。
-				const btn = [...document.querySelectorAll('[role="dialog"] nav button')]
-					.find((b) => b.textContent.trim() === SETTINGS_SECTION_LABEL);
-				if (btn) { btn.click(); return; }
+				// 只在设置面板（dialog）里找，**不做整篇文档的兜底搜索**：
+				// 本插件面板的开关按钮 aria-label 就是同一个标签，文档级搜索会先命中它，
+				// 一点就变成"自己把自己打开"（实测就是这样：点设置只弹本插件面板、不跳页）。
+				const dialogs = [...document.querySelectorAll('[role="dialog"]')];
+				for (const d of dialogs) {
+					const hit = findItem(d);
+					if (hit) { hit.click(); return; }
+				}
 				if (Date.now() < deadline) window.setTimeout(tick, SETTINGS_NAV_POLL_MS);
 			};
 			window.setTimeout(tick, 0);
@@ -4149,14 +4254,16 @@ window.__ModuleLoader__.load({
 										})
 									})
 								}),
-								// 设置按钮：打开 DSH 设置面板并切到本插件的「二游排期」页，同时关闭本面板。
+								// 设置按钮：打开 DSH 设置面板并切到本插件的设置页，同时关闭本面板。
+								// **当前按用户要求临时隐藏**（SETTINGS_BUTTON_VISIBLE = false）；
+								// 下面这段逻辑与说明全部保留，改回 true 即可恢复。
 								// 为什么这么绕：DSH 没给插件"跳转设置页"的官方 API——面板是 modal，open/activeId 都是组件
 								// 私有 state（dsh-client-ui-settings-general 的 SettingsRoot），打开后按 rows[0] 兜底，也就是停在
 								// 导航第一项「通用」；插件拿不到 openSection。只能点侧边栏那个设置触发器（aria-haspopup="dialog"
 								// 是它的契约属性：全客户端带这个属性的有 6 个 dialog 类 + 12 个 menu/listbox/tree，所以按
 								// "可见 + 无障碍名匹配 设置/Settings" 挑，挑不到才退回第一个），再交给 openPluginSettingsSection
 								// 等面板挂载后按导航名切到本插件那一节。
-								(0, react_jsx_runtime.jsx)("button", {
+								SETTINGS_BUTTON_VISIBLE && (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: "gacha-cal-refresh",
 									title: "\u8BBE\u7F6E",
@@ -4240,6 +4347,8 @@ window.__ModuleLoader__.load({
 
 		// engine：core 引擎（设置页的「解析器自检」用它跑 selfCheck()）
 		function CalendarSettingsPage({ scope, engine }) {
+			// 设置表单服务本体（用于在写不进去时列出宿主真正 serve 的 namespace，见 formStateText）
+			const ctxConfigForms = scope && scope.configForms ? scope.configForms : null;
 			const [snapshot, setSnapshot] = (0, react.useState)(() => scope.getSnapshot());
 			const [adding, setAdding] = (0, react.useState)(false);
 			// 添加表单临时值（名称/图标手动填；卡池与活动内容由链接解析产出）
@@ -4265,6 +4374,16 @@ window.__ModuleLoader__.load({
 			};
 			(0, react.useEffect)(() => scope.subscribe(() => setSnapshot(scope.getSnapshot())), [scope]);
 			const s = { ...DEFAULT_SETTINGS, ...(snapshot.value ?? {}) };
+			// 表单可用性（写不进去时在页面上如实说明，见下面渲染处）。
+			// 文案与 formRejectHint 同源：只解释"为什么写不了"，不猜。
+			const formReady = snapshot.status === "ready" && snapshot.mode !== "memory";
+			const formStateText = snapshot.mode === "memory"
+				? "本次连接不是本机，宿主不接受写入"
+				: snapshot.status === "loading"
+					? "配置表单还没送到，请稍后重试"
+					: snapshot.status === "unavailable"
+						? "宿主未 serve 条目「" + (scope.entryId || "?") + "」" + servedNamespacesText(ctxConfigForms)
+						: "宿主拒绝了写入（表单状态 " + String(snapshot.status) + "）";
 
 			const allEntries = getAllEntries(s);
 			const hidden = Array.isArray(s.hidden) ? s.hidden : [];
@@ -4280,10 +4399,16 @@ window.__ModuleLoader__.load({
 
 			// 保存失败必须可见：旧实现只 await 不 catch，写被宿主拒绝时控件弹回原值、
 			// 用户只会觉得"点了没反应"（「重置排序」写 null 被拒就是这种病的极端例子）
+			//
+			// DSH 0.1.7 起这里多了一个坑：`configForms` 的 set() **返回布尔值而不是抛错**
+			// （旧 settingsScope 的 set() 失败会抛）。所以只写 try/catch 的话，
+			// "宿主拒绝写入"会被当成成功，控件照样弹回、依旧没有任何提示。
+			// 必须显式判返回值：false = 宿主没接受（多半是该字段没进表单 / 修订号冲突 / 页面只读）。
 			const [saveError, setSaveError] = (0, react.useState)("");
 			const commit = async (key, value) => {
 				try {
-					await scope.set(key, value);
+					const accepted = await scope.set(key, value);
+					if (accepted === false) throw new Error(formRejectHint(scope, key));
 					setSaveError("");
 				} catch (err) {
 					setSaveError("\u4FDD\u5B58\u5931\u8D25\uFF1A" + String((err && err.message) || err || "未知错误"));
@@ -4398,9 +4523,14 @@ window.__ModuleLoader__.load({
 				style: { display: "flex", flexDirection: "column", gap: 14, maxWidth: 720, fontSize: 13, padding: "2px 0 8px" },
 				children: [
 					(0, react_jsx_runtime.jsx)("div", { children: [
-						(0, react_jsx_runtime.jsx)("div", { style: { fontSize: 16, fontWeight: 600 }, children: "二游排期" })
+						(0, react_jsx_runtime.jsx)("div", { style: { fontSize: 16, fontWeight: 600 }, children: SETTINGS_SECTION_LABEL })
 					] }),
 					saveError ? (0, react_jsx_runtime.jsx)("div", { style: { color: "var(--dsw-alias-state-error-primary, #d4380d)", fontSize: 12 }, children: saveError }) : null,
+					// 配置表单本身的状态：只在"写不进去"时才出现，平时不占位。
+					// 这一行是给"控件点了弹回原值、却没有任何提示"这类问题留的现场：
+					// memory = 非本机连接（只读）；loading/unavailable = 宿主没把表单送到；
+					// ready 但写仍被拒 = 该字段没进表单或修订号冲突。
+					(formReady ? null : (0, react_jsx_runtime.jsx)("div", { style: { color: "var(--dsw-alias-state-error-primary, #d4380d)", fontSize: 12 }, children: "\u914D\u7F6E\u53EA\u8BFB\uFF1A" + formStateText })),
 					(0, react_jsx_runtime.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 12, border: "1px solid var(--dsw-alias-border-l1)", borderRadius: 10, padding: "12px 14px", background: "var(--dsw-alias-bg-layer-1)" }, children: [
 						(0, react_jsx_runtime.jsxs)("label", { style: { display: "flex", alignItems: "center", gap: 8, cursor: "pointer" }, children: [
 							(0, react_jsx_runtime.jsx)("input", { type: "checkbox", checked: !!s.autoRefresh, onChange: (e) => commit("autoRefresh", e.target.checked) }),
@@ -4558,7 +4688,9 @@ window.__ModuleLoader__.load({
 		//#endregion
 
 		//#region plugin
-		const inject = ["slots", "settingsScope", "locale"];
+		// configForms = DSH 0.1.7 起的设置表单服务；0.1.6 及以前叫 settingsScope。
+		// 两者都是"按 profile 条目 id 取一个表单"，本插件的条目 id 就是 NS。
+		const inject = ["slots", "configForms", "locale"];
 		function apply(ctx) {
 			ctx.effect(() => {
 				const style = document.createElement("style");
@@ -4568,9 +4700,9 @@ window.__ModuleLoader__.load({
 				return () => style.remove();
 			}, "dsh-gacha-calendar: styles");
 
-			// DSH 设置页左侧导航的 section 图标由 navIcon 硬编码（未知 id 一律默认齿轮），
+			// 设置页左侧导航的 section 图标由 navIcon 硬编码（未知 id 一律默认齿轮），
 			// 插件无法通过 settings.section 配置图标；这里在设置面板打开后，把
-			// "二游排期" 导航项的齿轮图标替换为日历图标（Lucide 风格 16px，幂等）。
+			// "二游日历" 导航项的齿轮图标替换为日历图标（Lucide 风格 16px，幂等）。
 			// 性能：MutationObserver 回调只置脏标记，用 requestAnimationFrame 合并执行；
 			// patch 先查 dialog 是否存在，不存在立即返回（Web 端高频 DOM 变化时开销极小）。
 			ctx.effect(() => {
@@ -4641,7 +4773,15 @@ window.__ModuleLoader__.load({
 				};
 			}, "dsh-gacha-calendar: marquee");
 
-			const scope = ctx.settingsScope.bind({ namespace: NS });
+			// 取本插件的配置表单：读走镜像快照，写由表单自己排队并带修订号。
+			// 条目 id 从宿主**真正 serve 的** namespace 列表里解析（候选见 10-config.js 的
+			// SETTINGS_ENTRY_IDS）—— 不写死的原因见 92-dsh-env.js 的 resolveSettingsEntryId 注释。
+			const settingsEntryId = resolveSettingsEntryId(ctx.configForms, SETTINGS_ENTRY_IDS);
+			const scope = ctx.configForms.get(settingsEntryId);
+			// 把解析结果与表单服务挂到 scope 上：设置页要靠它们说明"为什么写不进去"，
+			// 以及列出宿主真正 serve 的条目（排障用，见 60-helpers.js 的 servedNamespacesText）。
+			scope.entryId = settingsEntryId;
+			scope.configForms = ctx.configForms;
 			// core 引擎：抓取/解析/缓存合并都在 engine 里（面板只读它返回的 Result JSON）。
 			// 存储适配（settings scope）与传输适配（直连 + 宿主代理）见 92-dsh-env.js。
 			const engine = createDshEngine(scope);
@@ -4701,17 +4841,49 @@ window.__ModuleLoader__.load({
 		const DSH_TRANSPORT = { fetchRaw: dshFetchRaw, fetchViaProxy: dshFetchViaProxy };
 		setCoreEnv({ transport: DSH_TRANSPORT });
 
-		// DSH 的存储适配：settings scope（settings.yaml 的 gacha-calendar 命名空间）→ engine 的 storage 接口。
+		// 解析本插件的设置条目 id：从 configForms 的 describe 镜像里读**宿主真正 serve 的** namespace 列表，
+		// 在候选里挑第一个匹配。为什么不能直接写死：0.1.7 按条目 id 寻址，而条目 id、包名、插件名
+		// 三者未必同名；写死一旦对不上，表现就是"表单永远 unavailable、所有写入被拒、
+		// 面板只显示 schema 默认值"——症状和"数据被清空"极像，其实只是地址找错了。
+		// 拿不到镜像时回退到第一个候选，保持原行为、不更坏。
+		function listServedNamespaces(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 : [];
+				return rows.map((r) => r && r.ns).filter((ns) => typeof ns === "string");
+			} catch (e) {
+				return [];
+			}
+		}
+		function resolveSettingsEntryId(configForms, candidates) {
+			const served = listServedNamespaces(configForms);
+			for (const id of candidates) if (served.indexOf(id) >= 0) return id;
+			return candidates[0];
+		}
+
+		// DSH 的存储适配：插件配置表单（profile 条目 id）→ engine 的 storage 接口。
 		// engine 只认 get(key)/set(key, value)，键名沿用既有设置键，所以设置页与历史缓存都不用迁移。
+		//
+		// DSH 0.1.7 起这个表单由 `configForms` 服务给出（旧名 `settingsScope`，已改名），
+		// 快照形态也从「恒有 value」变成带状态机的 `{ status, value, base, user, revision, writable, mode }`：
+		// 只有 status === "ready" 时 value 才可信（其余是 loading / unavailable）。
+		// 取不到值一律回 undefined —— engine 会把 undefined 回落成 DEFAULT_SETTINGS，
+		// 绝不能回落成 {} 之外的东西，否则"读不到"会被当成"读到了空配置"。
 		function dshStorage(scope) {
 			return {
 				async get(key) {
 					const snap = scope.getSnapshot();
-					const value = snap && snap.value ? snap.value : {};
+					if (!snap || snap.status !== "ready") return undefined;
+					const value = snap.value;
+					if (!value || typeof value !== "object") return undefined;
 					return value[key];
 				},
 				async set(key, value) {
-					await scope.set(key, value);
+					// set 返回"宿主是否接受本次写入"；engine 不消费该布尔值，
+					// 但失败时抛错比静默丢数据好（静默会把"没存上"伪装成"已存"）。
+					const accepted = await scope.set(key, value);
+					if (accepted === false) throw new Error("settings-write-rejected:" + key);
 				}
 			};
 		}

package/lib/index.js

@@ -1,15 +1,17 @@
 // Host-side entry for dsh-gacha-calendar.
-// 1) Registers the settings namespace so the browser half's Settings > 二游排期
-//    section can read/write persisted config through the settings scope.
+// 1) Declares the persisted Config schema the browser half's Settings >
+//    二游日历 section reads and writes. DSH 0.1.7 derives the settings document
+//    from this schema automatically, so there is nothing to register here.
 // 2) Registers a same-origin HTTP proxy route on DSH's webServer so the browser
 //    half can fetch external sources that block cross-origin browser requests
 //    (CORS / Referer anti-scrape) — the host runs Node fetch with full control
 //    over headers, bypassing browser-only restrictions.
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
 
-/** Settings namespace persisted through DSH Settings. */
-const GACHA_NAMESPACE = "gacha-calendar";
+// 设置文档的标识已不再是插件自报的 namespace，而是**本插件在 profile 里的条目 id**
+// （`~/.dsh/profiles/<profile>/cordis.patch.yml` 的 `- id: gacha-calendar`）。
+// 旧的 settingsNamespace("gacha-calendar") 随 API 一并删除，两边现在只靠这个 id 对齐；
+// 浏览器半边的同一字面量在 src/client/10-config.js 的 `NS`。
 
 /** Route prefix owned by this plugin on DSH's webServer. */
 const PROXY_PREFIX = "/api/gacha-calendar-proxy";
@@ -227,32 +229,45 @@ async function proxyHandler(req, res) {
 	}
 }
 
-/** Cordis configuration schema for this plugin's persisted settings. */
+/**
+ * Cordis configuration schema for this plugin's persisted settings.
+ *
+ * 每个字段都标 `.volatile()`：DSH 0.1.7 起设置文档**只投影 volatile 字段**
+ * （见 @deepseek-ai/dsh-settings 的 volatileForm/projectForm），未标记的字段
+ * 既不进表单、也不接受表单写入。本插件的持久化状态（含 lastData 缓存、
+ * lastRefresh、排序、自定义条目）全都要经表单读写，所以必须整份标记。
+ * 约束：volatile 字段必须是固定对象路径、外层不能再套 volatile —— 这里全平铺，满足。
+ * 用户可见的设置页由 80-components.js 以 settings.section 自带，配合
+ * settings.configure({ auto: false }) 抑制自动生成页，故不会把 lastData 这类
+ * 运行时状态暴露成输入框。
+ */
 const Config = z.object({
-	autoRefresh: z.boolean().default(true),
-	refreshMinutes: z.number().min(1).max(60480).default(1440),
-	order: z.array(z.string()).default([]),
-	lastRefresh: z.number().default(0),
-	lastSource: z.string().default("builtin"),
-	lastData: z.string().default(""),
+	autoRefresh: z.boolean().default(true).volatile(),
+	refreshMinutes: z.number().min(1).max(60480).default(1440).volatile(),
+	order: z.array(z.string()).default([]).volatile(),
+	lastRefresh: z.number().default(0).volatile(),
+	lastSource: z.string().default("builtin").volatile(),
+	lastData: z.string().default("").volatile(),
 	// 产出上面那份缓存的插件版本（空 = 首次安装 / 装了本功能之前的旧缓存）。
 	// 更新插件后首次启动据此**强制**刷新一次（不看自动刷新开关），判定见 60-helpers.js 的 autoRefreshPlan
-	lastVersion: z.string().default(""),
-	hidden: z.array(z.string()).default([]),
-	removed: z.array(z.string()).default([]),
-	customUrls: z.string().default("{}"),
-	customEventUrls: z.string().default("{}"),
-	customEntries: z.string().default("[]")
+	lastVersion: z.string().default("").volatile(),
+	hidden: z.array(z.string()).default([]).volatile(),
+	removed: z.array(z.string()).default([]).volatile(),
+	customUrls: z.string().default("{}").volatile(),
+	customEventUrls: z.string().default("{}").volatile(),
+	customEntries: z.string().default("[]").volatile()
 });
 
 /** Required services (host side). */
 const inject = ["webServer"];
 
 export function apply(ctx, config = {}) {
-	installSettingsSection(ctx, settingsNamespace(GACHA_NAMESPACE), Config, config, {
-		// hooks 为 dsh-settings 要求的回调位（source 同步 / 配置变更通知），当前版本无需额外处理
-		setSource: () => {},
-		onChange: () => {}
+	// 抑制「按 schema 自动生成」的设置页：本插件自带 settings.section 页面
+	// （80-components.js），自动页会把 lastData 等运行时状态渲染成可编辑输入框。
+	// 这是 DSH 官方 README 给自带页面插件的做法；配置读写不受影响。
+	// 走可选子级注入：未挂载 settings 服务的主机不会因此起不来。
+	ctx.inject(["settings"], (settingsCtx) => {
+		settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber));
 	});
 	ctx.inject(["webServer"], (injected) => {
 		const webServer = injected.get("webServer");
@@ -265,4 +280,10 @@ export function apply(ctx, config = {}) {
 	});
 }
 
-export { inject };
+// Config 必须**导出**：cordis loader 把插件的具名导出 `Config` 变成
+// `fiber.runtime.Config`，而 DSH 0.1.7 的 settings.describe() 正是靠它
+// （entry.fiber.runtime.Config 能不能 toJSON / 能不能投影出 volatile 表单）
+// 决定这个条目进不进设置文档。不导出 = 该条目永远不在 describe 列表里，
+// 表现是客户端 status 恒为 unavailable、**所有写入被拒**、面板只显示 schema 默认值。
+// 这正是 v0.9.41~0.9.43 上机后"设置改不动 + 刷新失败"的根因。
+export { Config, inject };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-gacha-calendar",
-  "version": "0.9.39",
+  "version": "0.10.0",
   "description": "二游活动/卡池排期速查：侧边栏底部按钮，点击展开 11 款已安装二游的当前版本、卡池与活动起止；支持联网自动刷新与刷新频率设置（原神/星铁/绝区零/鸣潮/明日方舟/终末地/蔚蓝档案国服+国际服+日服/重返未来1999/异环）。",
   "type": "module",
   "main": "lib/index.js",