dsh-remote-panel 0.3.1 → 0.3.2

package/README.md

@@ -64,6 +64,17 @@ Caddy 的 `pki/authorities/local/root.crt`）。
 - Android：设置 → 安全 → 加密与凭据 → 安装证书 → CA 证书。
 - iOS：下载后到 设置 → 通用 → 关于本机 → 证书信任设置 里打开信任。
 
+## 已知限制（有意为之 / 待后续）
+
+| 项 | 现状 | 说明 |
+|---|---|---|
+| APK 签名 | debug keystore | 自己侧载够用；要公开分发需换正式签名并保留密钥 |
+| APK 更新 | 重新下载覆盖安装 | 面板「手机 App」卡里有下载入口；没有应用内自动更新 |
+| APK 与口令 | 壳内置门禁口令 | 换了口令要重新构建壳（`./android/build.sh [server] [key]`） |
+| DSH 升级 | hash 类名可能变 | 有契约自检（面板「外壳适配」灯），失配会显红而不是静默错位 |
+| 崩溃上报 | 无 | 壳里失败会显示错误文本；日志只有控制台 |
+| 无障碍 | 部分 | 抽屉没有焦点陷阱；aria 只覆盖了注入的按钮 |
+
 ## 安全模型：令牌只在门禁之后
 
 手机端有两道门：Caddy 的口令门禁（`dsh_gate` Cookie）+ DSH 自己的会话令牌。两者的取用顺序是：

package/lib/client.js

@@ -1639,63 +1639,6 @@ window.__ModuleLoader__.load({
 			}
 		}
 
-		/**
-		 * 切换工作区后别自动聚焦输入框。
-		 *
-		 * DSH 打开工作区选择器时会先把焦点交给搜索框；关掉后焦点会回到输入条，
-		 * 手机上就是键盘自己弹出来。这里在选择器关闭、或 chip 文案变化后，
-		 * 把焦点从输入条上撤走（只撤输入条里的可编辑区，不动选择器自己的搜索框）。
-		 */
-		function installComposerFocusGuard() {
-			if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') return () => {}
-			let labelObserver = null
-			let observedLabel = null
-			let lastLabel = ''
-
-			const isComposer = (el) =>
-				el !== null &&
-				el !== document.body &&
-				(el.isContentEditable === true || el.tagName === 'TEXTAREA' || el.tagName === 'INPUT') &&
-				(el.closest('.uV2eYG_root') !== null || el.closest('[class*="_composer"]') !== null)
-
-			const release = () => {
-				const el = document.activeElement
-				if (isComposer(el)) el.blur()
-			}
-			// DSH 可能在我们之后又把焦点塞回去，所以分几拍各撤一次
-			const scheduleRelease = () => {
-				for (const delay of [0, 80, 200, 400]) window.setTimeout(release, delay)
-			}
-
-			const watchLabel = () => {
-				const label = document.querySelector('[class*="_workspaceLabel"]')
-				if (label === null || label === observedLabel) return
-				labelObserver?.disconnect()
-				observedLabel = label
-				lastLabel = label.textContent ?? ''
-				labelObserver = new MutationObserver(() => {
-					const now = label.textContent ?? ''
-					if (now === lastLabel) return
-					lastLabel = now
-					scheduleRelease()
-				})
-				labelObserver.observe(label, { childList: true, characterData: true, subtree: true })
-			}
-
-			// 选择器关闭 = 里面那个搜索框失焦。用事件判断，别在每次 DOM 变动时全量 querySelector。
-			const onFocusOut = (event) => {
-				const target = event.target
-				if (target instanceof Element && target.closest('[class*="wsc-"]') !== null) scheduleRelease()
-			}
-			document.addEventListener('focusout', onFocusOut, true)
-			const ensureLabel = window.setInterval(watchLabel, 800)
-			watchLabel()
-			return () => {
-				document.removeEventListener('focusout', onFocusOut, true)
-				window.clearInterval(ensureLabel)
-				labelObserver?.disconnect()
-			}
-		}
 
 		/**
 		 * 外壳挂点自检：DSH 升级后这些 hash 类名可能全变，样式就整体失配。
@@ -2006,30 +1949,97 @@ window.__ModuleLoader__.load({
 		 * 做法：在 pointerdown 阶段记一个短窗口（900ms），窗口内如果输入框收到 focus 就立刻 blur 回去；
 		 * 点别的地方会立刻清掉窗口，不会影响正常输入。
 		 */
+		/**
+		 * 输入条焦点守卫：这几种操作都不该把键盘顶起来——
+		 * 切工作区、切会话、打开面板、点「+」菜单。
+		 *
+		 * DSH 会在操作之后把焦点塞回输入条，且时机在我们之后，
+		 * 所以除了撤焦点，还要开一个短暂的压制窗口（focusin 里再撤一次）。
+		 * 只针对输入条里的可编辑区，不拦用户自己点输入条。
+		 */
 		function installComposerFocusGuard() {
 			if (typeof document === 'undefined') return () => {}
-			let until = 0
-			const isComposerInput = (el) => el instanceof Element && el.closest?.('.uV2eYG_input') !== null
-			const onPointerDown = (event) => {
-				const target = event.target
-				until = target instanceof Element && target.closest('.uV2eYG_add') !== null ? Date.now() + 900 : 0
+			let suppressUntil = 0
+			let labelObserver = null
+			let observedLabel = null
+			let lastLabel = ''
+			let labelTimer = 0
+
+			const isComposer = (el) =>
+				el instanceof Element &&
+				el !== document.body &&
+				(el.isContentEditable === true || el.tagName === 'TEXTAREA' || el.tagName === 'INPUT') &&
+				(el.closest('.uV2eYG_root') !== null || el.closest('[class*="_composer"]') !== null)
+
+			const release = () => {
+				const el = document.activeElement
+				if (isComposer(el)) el.blur()
+			}
+			// 分几拍撤一次，并留一段压制窗口覆盖 DSH 自己的 focus
+			const scheduleRelease = (windowMs = 700) => {
+				suppressUntil = Math.max(suppressUntil, Date.now() + windowMs)
+				for (const delay of [0, 80, 200, 400, 700]) window.setTimeout(release, delay)
 			}
+
 			const onFocusIn = (event) => {
-				if (Date.now() > until) return
+				if (Date.now() > suppressUntil) return
 				const el = event.target
-				if (!isComposerInput(el)) return
+				if (!isComposer(el)) return
 				const drop = () => {
-					if (Date.now() <= until && document.activeElement === el) el.blur?.()
+					if (Date.now() <= suppressUntil && document.activeElement === el) el.blur?.()
 				}
 				drop()
 				// 有的实现会在下一帧再 focus 一次，补一刀
 				requestAnimationFrame(drop)
 			}
+
+			// 「+」按钮弹菜单，别顺手把焦点交给输入条
+			const onPointerDown = (event) => {
+				const target = event.target
+				if (target instanceof Element && target.closest('.uV2eYG_add') !== null) suppressUntil = Date.now() + 900
+			}
+
+			// 抽屉里选会话 / 打开面板：切完别把键盘顶起来
+			const onClick = (event) => {
+				const target = event.target
+				if (!(target instanceof Element)) return
+				if (target.closest('[class*="_sessionRow"], [class*="_panelRow"]') !== null) scheduleRelease(900)
+			}
+
+			// 工作区选择器关闭 = 里面那个搜索框失焦
+			const onFocusOut = (event) => {
+				const target = event.target
+				if (target instanceof Element && target.closest('[class*="wsc-"]') !== null) scheduleRelease()
+			}
+
+			const watchLabel = () => {
+				const label = document.querySelector('[class*="_workspaceLabel"]')
+				if (label === null || label === observedLabel) return
+				labelObserver?.disconnect()
+				observedLabel = label
+				lastLabel = label.textContent ?? ''
+				labelObserver = new MutationObserver(() => {
+					const now = label.textContent ?? ''
+					if (now === lastLabel) return
+					lastLabel = now
+					scheduleRelease()
+				})
+				labelObserver.observe(label, { childList: true, characterData: true, subtree: true })
+			}
+
 			document.addEventListener('pointerdown', onPointerDown, true)
 			document.addEventListener('focusin', onFocusIn, true)
+			document.addEventListener('click', onClick, true)
+			document.addEventListener('focusout', onFocusOut, true)
+			labelTimer = window.setInterval(watchLabel, 800)
+			watchLabel()
 			return () => {
 				document.removeEventListener('pointerdown', onPointerDown, true)
 				document.removeEventListener('focusin', onFocusIn, true)
+				document.removeEventListener('click', onClick, true)
+				document.removeEventListener('focusout', onFocusOut, true)
+				window.clearInterval(labelTimer)
+				labelObserver?.disconnect()
 			}
 		}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-panel",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "DSH 远程访问控制面：部署向导、状态面板与一键配对（EasyTier + Caddy），数据面保持进程外。",
   "type": "module",
   "main": "./lib/index.js",