@senguoyun/dsh-arkme 0.1.72 → 0.1.73

package/docs/quick-add-hover-regression-2026-09-21.md

@@ -27,3 +27,14 @@
 预览脚本：`/Users/tison/arkme/.codex-artifacts/web-preview-3098/check-quick-add-hover.mjs`。
 
 仅更新独立 3098 Web 预览，未修改已安装 Arkme 客户端。Git 提交推送单独执行，不代表已合并或发布。
+
+## 第二轮：500ms 缓冲与点击固定
+
+- 用户反馈对话入口仍不易从按钮移入菜单。旧版 3098 的真实鼠标测试确认：越出菜单停留 350ms 已关闭。
+- 添加菜单离开缓冲改为 500ms；进入按钮、菜单或过渡间隙取消关闭。鼠标离开文档与窗口失焦也遵循缓冲，避免绕过定时器立即收起。
+- 悬浮与点击使用独立状态。点击（包括触摸和键盘激活）固定展开，取消原有倒计时；随后鼠标移开、再次经过按钮均不关闭或退回悬浮模式。
+- 点击外部、选择菜单操作或 Escape 关闭并重置状态，下次单纯悬浮仍按 500ms 规则收起。外部点击覆盖嵌入页面及阻止冒泡的元素。
+- 对话和联系人复用相同入口。其他悬浮菜单未配置延时时仍保持原有立即关闭行为。
+- 定向回归 11 个测试文件、67 项通过；类型检查、通话资源校验和构建通过。
+- 更新独立 3098 后，Chromium 对话及联系人入口在 1440、900、420px 均通过：跨按钮下方间隙、斜向移入、越出 350ms 再返回、点击固定后移开 800ms、重新经过按钮、菜单项可达、外部点击及键盘关闭；无 pageerror。
+- 预览安装包为 `senguoyun-dsh-arkme-0.1.72.tgz`；本地与预览安装目录的 `client.js` SHA256 相同：`a41546e5126b39389f4f509ec22abdd5651b1266445e898aa2abd1d4f2408052`。旧预览包已备份为 `backups/quick-add-before-20260921-0345.tgz`。

package/lib/arko-native-client.js

@@ -2114,7 +2114,7 @@ Arkme 用户 {v0}|Arkme user {v0}
 					else scheduleClose();
 				};
 				const leave = (event) => {
-					if (event.relatedTarget === null) close();
+					if (event.relatedTarget === null) scheduleClose();
 				};
 				const observer = new MutationObserver(() => {
 					if (!anchor.isConnected) close();
@@ -2124,14 +2124,16 @@ Arkme 用户 {v0}|Arkme user {v0}
 					subtree: true
 				});
 				doc.addEventListener("pointermove", move, true);
+				doc.addEventListener("pointerover", move, true);
 				doc.addEventListener("pointerout", leave, true);
-				doc.defaultView?.addEventListener("blur", close);
+				doc.defaultView?.addEventListener("blur", scheduleClose);
 				return () => {
 					cancel();
 					observer.disconnect();
 					doc.removeEventListener("pointermove", move, true);
+					doc.removeEventListener("pointerover", move, true);
 					doc.removeEventListener("pointerout", leave, true);
-					doc.defaultView?.removeEventListener("blur", close);
+					doc.defaultView?.removeEventListener("blur", scheduleClose);
 				};
 			}, [
 				open,

package/lib/client.js

@@ -110836,7 +110836,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 					else scheduleClose();
 				};
 				const leave = (event) => {
-					if (event.relatedTarget === null) close();
+					if (event.relatedTarget === null) scheduleClose();
 				};
 				const observer = new MutationObserver(() => {
 					if (!anchor.isConnected) close();
@@ -110846,14 +110846,16 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 					subtree: true
 				});
 				doc.addEventListener("pointermove", move, true);
+				doc.addEventListener("pointerover", move, true);
 				doc.addEventListener("pointerout", leave, true);
-				doc.defaultView?.addEventListener("blur", close);
+				doc.defaultView?.addEventListener("blur", scheduleClose);
 				return () => {
 					cancel();
 					observer.disconnect();
 					doc.removeEventListener("pointermove", move, true);
+					doc.removeEventListener("pointerover", move, true);
 					doc.removeEventListener("pointerout", leave, true);
-					doc.defaultView?.removeEventListener("blur", close);
+					doc.defaultView?.removeEventListener("blur", scheduleClose);
 				};
 			}, [
 				open,
@@ -153135,7 +153137,7 @@ html body {
 					anchor,
 					align: "end",
 					onClose,
-					hoverCloseDelayMs: 250,
+					hoverCloseDelayMs: 500,
 					...getAnchorRect === void 0 ? {} : { getAnchorRect },
 					...hoverAnchor === void 0 ? {} : { hoverAnchor },
 					actions: [
@@ -153184,7 +153186,9 @@ html body {
 		}
 		function ArkmeQuickAddButton({ onContactAdd, onSourceCreated, onBotCreated, onNewDshSession, notificationActivationRevision = 0, onBlockingOverlayChange }) {
 			useArkmeLocale();
-			const [menuOpen, setMenuOpen] = (0, react$1.useState)(false);
+			const [menuMode, setMenuMode] = (0, react$1.useState)();
+			const menuOpen = menuMode !== void 0;
+			const closeMenu = () => setMenuMode(void 0);
 			const [menuError, setMenuError] = (0, react$1.useState)("");
 			const [dialogKind, setDialogKind] = (0, react$1.useState)();
 			const [dialogBusy, setDialogBusy] = (0, react$1.useState)(false);
@@ -153207,7 +153211,7 @@ html body {
 				if (notificationRevisionRef.current === notificationActivationRevision) return;
 				notificationRevisionRef.current = notificationActivationRevision;
 				pendingNotificationDismissRef.current = true;
-				setMenuOpen(false);
+				closeMenu();
 				if (!dialogBusy) {
 					pendingNotificationDismissRef.current = false;
 					setDialogKind(void 0);
@@ -153219,18 +153223,18 @@ html body {
 				setDialogKind(void 0);
 			}, [dialogBusy]);
 			const chooseDialog = (kind) => {
-				setMenuOpen(false);
+				closeMenu();
 				setDialogBusy(false);
 				setDialogKind(kind);
 			};
 			const openMenu = () => {
 				setMenuError("");
-				setMenuOpen(true);
+				setMenuMode((current) => current ?? "hover");
 			};
 			const menu = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeQuickAddMenu, {
 				open: menuOpen,
-				onClose: () => setMenuOpen(false),
-				hoverAnchor: triggerRef.current ?? void 0,
+				onClose: closeMenu,
+				hoverAnchor: menuMode === "hover" ? triggerRef.current ?? void 0 : void 0,
 				anchor: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 					"data-arkme-feedback": "neutral",
 					ref: triggerRef,
@@ -153243,9 +153247,9 @@ html body {
 					onPointerEnter: (event) => {
 						if (event?.pointerType !== "touch") openMenu();
 					},
-					onClick: (event) => {
-						if ((event?.detail ?? 0) === 0) setMenuOpen((open) => !open);
-						else openMenu();
+					onClick: () => {
+						setMenuError("");
+						setMenuMode("pinned");
 					},
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, {
 						size: 20,
@@ -153257,13 +153261,13 @@ html body {
 					try {
 						onNewDshSession();
 						setMenuError("");
-						setMenuOpen(false);
+						closeMenu();
 					} catch (error) {
 						setMenuError(error instanceof Error ? error.message : "暂时无法新建 DSH 会话，请稍后再试");
 					}
 				},
 				onContactAdd: () => {
-					setMenuOpen(false);
+					closeMenu();
 					onContactAdd();
 				},
 				onCreateGroup: () => {
@@ -201413,7 +201417,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 		const c$3 = e$24;
 		//#endregion
 		//#region package.json
-		var version = "0.1.72";
+		var version = "0.1.73";
 		//#endregion
 		//#region src/client/profile-change-store.ts
 		let revision = 0;