dsh-mobile 0.5.0 → 0.5.1

package/lib/index.d.mts

@@ -356,6 +356,8 @@ declare class JsonMobileAccessControlStore implements MobileAccessControlStore {
   private readonly file;
   private readonly initiallyEnabled;
   constructor(file: string, initiallyEnabled: boolean);
+  /** Avoid writing an absent already-disabled state without changing recovery of existing files. */
+  disableIfPresent(): Promise<void>;
   load(): Promise<MobileAccessControlState>;
   save(state: MobileAccessControlState): Promise<void>;
 }

package/lib/index.mjs

@@ -1078,6 +1078,25 @@ var JsonMobileAccessControlStore = class {
 		this.file = file;
 		this.initiallyEnabled = initiallyEnabled;
 	}
+	/** Avoid writing an absent already-disabled state without changing recovery of existing files. */
+	async disableIfPresent() {
+		try {
+			await lstat(this.file);
+		} catch (error) {
+			if (error.code === "ENOENT") {
+				if (this.initiallyEnabled) await this.save({
+					version: 1,
+					enabled: false
+				});
+				return;
+			}
+			throw error;
+		}
+		await this.save({
+			version: 1,
+			enabled: false
+		});
+	}
 	async load() {
 		let stat;
 		try {
@@ -9977,7 +9996,7 @@ function buildMobileGuide(state) {
 	const scriptLine = state.hasCustomJs ? "存在（当前生效的自定义脚本）" : "不存在（无自定义脚本）";
 	const extensionLines = state.extensions.length === 0 ? "（无）" : state.extensions.map((entry) => `- ${entry.id}（${entry.name} v${entry.version}）`).join("\n");
 	const failureLine = state.failedExtensionCount > 0 ? `注意：${state.failedExtensionCount} 个扩展的电脑端 host 激活失败，如改动相关扩展请先检查其 host.mjs 与 extension.json。` : "";
-	return `${`## 手机端当前状态（改名前必读，避免覆盖已有定制）
+	return `${`## 手机端当前状态（改动前必读，避免覆盖已有定制）
 
 - 定制目录：${state.directory}（所有改动只允许在这里进行）
 - mobile.css：${styleLine}
@@ -10003,6 +10022,8 @@ const MOBILE_CUSTOMIZATION_GUIDE_BODY = `你在为用户定制 DSH Mobile 的手
    - $DSH_HOME/mobile-access/mobile.js：手机端脚本，用 window.dshMobile.register(({ root }) => { ... }) 把内容挂载到 root，返回清理函数
    - 保存后手机端几秒内自动应用，无需重启
 
+动手前先读已有的定制文件。若要调整 DSH 自带的输入框、侧栏或设置等现有界面，先确认当前 DSH 版本与手机页面模式（专用移动页面或 ?frontend=stock），只读核对运行页面的 DOM、属性和样式；本机有同版本前端源码时可参考相应组件，没有源码时可查看已安装的客户端产物，不必下载源码。优先使用扩展 API、插槽和稳定的 data-* 标记，不凭猜测依赖构建类名。只读查看不改变前述写入范围。
+
 2. 电脑端能力 —— 手机需要读电脑文件、执行命令或访问硬件时，创建扩展：
    - 目录：$DSH_HOME/mobile-access/extensions/<id>/，id 用小写字母数字和连字符（如 media-remote）
    - extension.json：{"schemaVersion":1,"id":"<id>","name":"显示名","version":"0.1.0","description":"说明"}
@@ -10019,6 +10040,7 @@ const MOBILE_CUSTOMIZATION_GUIDE_BODY = `你在为用户定制 DSH Mobile 的手
 
 完成前请自检：
 - 改动涉及 mobile.js 或扩展的 mobile.js / host.mjs 时，先做语法检查再保存（如 node --check <file>），确保没有语法错误
+- 改动 DSH 现有界面后尽可能在实际手机页面核对效果；无法观察运行页面时，明确告诉用户尚未实测
 - 创建或修改扩展后，确认 extension.json 的 schemaVersion 为 1、id 与目录名一致、且 id 只含小写字母数字和连字符
 - 扩展的 host.mjs 若在完成前无法激活，先修正而不是留下损坏的扩展
 - 完成后检查自己实际写入了哪些文件，向用户简要说明改了什么、手机端会有什么变化`;
@@ -13705,7 +13727,7 @@ async function apply(ctx, config) {
 		const unregister = ctx.webServer.register(adminRoute);
 		const disposeMobileCommand = ctx.commands.register({
 			name: "mobile",
-			description: "按需求修改 DSH Mobile 的手机端界面或添加电脑端能力",
+			description: "定制手机界面或添加电脑能力",
 			input: { hint: "<要做什么>" },
 			handler: async ({ agent, rawInput }) => {
 				const task = rawInput.trim();
@@ -13751,10 +13773,7 @@ async function apply(ctx, config) {
 				frp: frpStore,
 				origin: originStore
 			};
-			await Promise.all(Object.keys(stores).filter((provider) => provider !== remoteProviders.selected).map((provider) => stores[provider].save({
-				version: 1,
-				enabled: false
-			})));
+			await Promise.all(Object.keys(stores).filter((provider) => provider !== remoteProviders.selected).map((provider) => stores[provider].disableIfPresent()));
 			for (const provider of REMOTE_PROVIDERS) await remoteControllers[provider].initialize();
 			const lanDiscovery = lanGateway?.discoveryStatus();
 			if (lanDiscovery !== void 0 && !lanDiscovery.broadcast) logger.warn("broadcast discovery is unavailable (%s); mDNS is still published, so pair manually or free the UDP port", lanDiscovery.errorCode ?? "unknown_cause");