@senguoyun/dsh-arkme 0.1.71 → 0.1.73

package/docs/dsh-rightbar-regression-2026-09-21.md

@@ -0,0 +1,38 @@
+# DSH 嵌入右侧栏边界修复
+
+## 原因与范围
+
+Arkme 将原生 DSH iframe 保持为整个浏览器大小，以便任务菜单越过对话区域显示；实际对话通过 AppFrame 定位和 iframe clip-path 限定在第三栏。
+
+原生右侧栏在 AppFrame 宽度小于 768px 时切到 `position: fixed; inset: 0; width: 100%` 的全屏模式，其定位仍相对于整个 iframe。1100px 窗口中第三栏从 x=344 开始、宽 756px，原生面板却从 x=0 开始、宽 1100px。文件列表因此被外层裁掉，造成空白、会话消失的观感；会话实际没有卸载。
+
+本次只在嵌入适配器内限制原生 fullscreen 面板的边界：横向与第三栏一致，纵向位于当前任务标题下方。标题变化通过尺寸观察同步，不写死高度。宽屏 push 并排布局不变，不替换上游面板、消息、输入框或状态存储。
+
+## 验证
+
+- 类型检查、构建及本地打包通过。
+- 9 个相关测试文件，78 项通过，覆盖嵌入区域、原生任务下拉、标题、菜单、拖拽与前一轮添加菜单。
+- 独立 Web 预览 3098 安装包与本地 client.js SHA256 一致：`96f62c9b5c8920c554cca275608701cf5ed9c44cee389fdd5289754c36227397`。
+- Chromium 浏览器验证：1440px 为并排面板；1100、900、720px 为第三栏内展开。标题与文件列表可见，开关后保持同一会话、输入组件和任务标题，无页面异常。
+- 面板打开期间，1440 → 1100 → 720 → 420 → 1440 缩放通过，任务下拉仍能打开。
+- 经用户确认继续修复后，420、500、575px 均通过：顶部名称、任务选择及工具按钮不越界，侧栏完整约束在第三栏且可关闭。打开按钮不再触发外层横向滚动；标题与会话输入组件保持原位和身份。
+- 420px 和 1440px 的原生「更多操作」菜单均可打开、位于窗口边界内，Escape 可关闭。所有宽度无 pageerror。
+- 已人工检查 1440、1100、720、420px 截图。未发送消息、创建会话、执行文件操作或调用通话。
+
+## 极窄窗口补充修复（已确认并完成）
+
+420px 窗口下第三栏仅 236px。打开面板前 header.scrollWidth 为 276px，外层会话容器 scrollWidth 为 501px；点击右侧按钮后该容器 scrollLeft 变为 144px，导致顶部标题离开可见区域。此问题与 fullscreen 面板坐标越界不同。
+
+用户确认后，仅在标题内容区域宽度不超过 360px 时将工具按钮另排一行；上方保留对话名与当前任务。使用标题自身的容器查询而非窗口媒体查询，适配左侧目录和侧栏对实际宽度的影响。原生 React 节点和事件绑定不移动、不重建，常规桌面布局不变。
+
+420px 复测中标题保持 x=184，外层 scrollLeft=0；标题高度由 73px 自适应为 109px，侧栏自动从 y=109 开始，不遮盖工具栏。放大回 1440px 后恢复 73px 单行布局。
+
+补充修复预览包：`senguoyun-dsh-arkme-0.1.70-narrow-header-20260921-0204.tgz`。本地与已安装 `harness-session-client.js` SHA256 一致：`0283b1954813f74e199d47c7552bc7a49f04520e03f96a0da96e29502727231e`。
+
+## 交付边界
+
+仅更新独立 3098 预览；未修改已安装的 Arkme 客户端、未发布 npm。Git 提交推送单独执行，不代表已合并或发布。上一轮添加菜单修复保留。旧版安装包和预览回滚包保留。
+
+提交前补充回归：12 个相关测试文件、95 项通过，包含对话/联系人工具栏尺寸和添加菜单 portal；`git diff --check` 通过。
+
+浏览器脚本与截图位于本机 `.codex-artifacts/web-preview-3098/`：`check-dsh-rightbar.mjs`、`dsh-rightbar-fixed-{width}.png`。

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

@@ -0,0 +1,40 @@
+# 对话与联系人添加按钮回归（2026-09-21）
+
+## 已确认的交互
+
+- 第二栏添加按钮与搜索框同高，使用 40×40px 方形按钮、11px 圆角及原有主题色。
+- 悬浮立即展开，按钮与菜单之间可连续移动；短暂移出后 250ms 内返回取消关闭。
+- 选择菜单项、点击外部、Escape 仍直接关闭；保留键盘与触摸入口。
+- 联系人和对话入口统一使用同一个组件，不新增另一套菜单。
+
+## 根因与修改
+
+- 旧添加按钮为 28×28px，搜索框为 40px 高。3098 修改前实测分别为 28px、40px。
+- 原 hover 区域只覆盖左右菜单间隙；下拉菜单实际在按钮下方 4px，该间隙不属于有效区域。修改前浏览器鼠标移入间隙立即关闭。
+- 添加按钮直接引用 `directorySearchLayout.field` 的高度和圆角，图标从 14px 放大到 20px。
+- 补齐上、下方向的短距离菜单过渡区域；仅添加菜单启用 250ms 离开缓冲，其他菜单原有关闭时序不变。
+- 返回按钮、菜单或过渡区取消定时关闭；连续向外移动不重置倒计时；关闭或卸载取消旧定时器，避免影响下一次展开。
+- `ArkmePersistentShell` 联系人入口和 `ArkmeVirtualWorkspace` 对话入口均复用 `ArkmeQuickAddButton`，本次修改同时生效。
+
+## 验证
+
+- 20 个相关测试文件、186 项测试通过；包含四方向过渡区域、停留间隙、移出再返回、菜单重开、外部点击、Esc、触摸、键盘、联系人真实工具栏尺寸及原有菜单交互。
+- 类型检查、完整构建和打包通过。
+- 独立 3098 页面：对话与联系人各在 1440、900、420px 宽度下验证。两个入口按钮均为 40×40px，与搜索框同高且顶部对齐。
+- 浏览器实际鼠标验证：停留 4px 间隙、斜向进入菜单、短暂移出后返回、离开主页面菜单区域关闭；键盘 Enter/方向键/Escape、外部点击关闭均通过，未出现页面异常。
+- 浏览器验证未创建联系人、群聊、Bot、任务或真实通话；相关业务写请求被拦截，选项动作由组件测试验证。
+
+预览脚本：`/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

@@ -1830,6 +1830,19 @@ Arkme 用户 {v0}|Arkme user {v0}
 				top,
 				bottom
 			});
+			const left = Math.max(anchor.left, menu.left), right = Math.min(anchor.right, menu.right);
+			if (anchor.bottom <= menu.top && menu.top - anchor.bottom <= 24) return contains({
+				left,
+				right,
+				top: anchor.bottom,
+				bottom: menu.top
+			});
+			if (menu.bottom <= anchor.top && anchor.top - menu.bottom <= 24) return contains({
+				left,
+				right,
+				top: menu.bottom,
+				bottom: anchor.top
+			});
 			return false;
 		}
 		//#endregion
@@ -2072,14 +2085,36 @@ Arkme 用户 {v0}|Arkme user {v0}
 				const anchor = props.hoverAnchor;
 				if (!open || !anchor || typeof document === "undefined") return;
 				const doc = anchor.ownerDocument;
-				const close = () => closeRef.current();
+				let pending;
+				const cancel = () => {
+					if (pending !== void 0) {
+						clearTimeout(pending);
+						pending = void 0;
+					}
+				};
+				const close = () => {
+					cancel();
+					closeRef.current();
+				};
+				const scheduleClose = () => {
+					if (!props.hoverCloseDelayMs) {
+						close();
+						return;
+					}
+					if (pending === void 0) pending = setTimeout(close, props.hoverCloseDelayMs);
+				};
 				const move = (event) => {
 					if (event.pointerType === "touch") return;
+					if (!anchor.isConnected) {
+						close();
+						return;
+					}
 					const list = menu.current;
-					if (!anchor.isConnected || list && !inMenuHoverRegion(event.clientX, event.clientY, anchor.getBoundingClientRect(), list.getBoundingClientRect())) close();
+					if (!list || inMenuHoverRegion(event.clientX, event.clientY, anchor.getBoundingClientRect(), list.getBoundingClientRect())) cancel();
+					else scheduleClose();
 				};
 				const leave = (event) => {
-					if (event.relatedTarget === null) close();
+					if (event.relatedTarget === null) scheduleClose();
 				};
 				const observer = new MutationObserver(() => {
 					if (!anchor.isConnected) close();
@@ -2089,15 +2124,22 @@ 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, props.hoverAnchor]);
+			}, [
+				open,
+				props.hoverAnchor,
+				props.hoverCloseDelayMs
+			]);
 			const actions = props.actions.filter((action) => !!action);
 			const items = actions.map((action) => "type" in action ? action : {
 				id: action.id,

package/lib/client.js

@@ -110527,6 +110527,19 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 				top,
 				bottom
 			});
+			const left = Math.max(anchor.left, menu.left), right = Math.min(anchor.right, menu.right);
+			if (anchor.bottom <= menu.top && menu.top - anchor.bottom <= 24) return contains({
+				left,
+				right,
+				top: anchor.bottom,
+				bottom: menu.top
+			});
+			if (menu.bottom <= anchor.top && anchor.top - menu.bottom <= 24) return contains({
+				left,
+				right,
+				top: menu.bottom,
+				bottom: anchor.top
+			});
 			return false;
 		}
 		//#endregion
@@ -110794,14 +110807,36 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 				const anchor = props.hoverAnchor;
 				if (!open || !anchor || typeof document === "undefined") return;
 				const doc = anchor.ownerDocument;
-				const close = () => closeRef.current();
+				let pending;
+				const cancel = () => {
+					if (pending !== void 0) {
+						clearTimeout(pending);
+						pending = void 0;
+					}
+				};
+				const close = () => {
+					cancel();
+					closeRef.current();
+				};
+				const scheduleClose = () => {
+					if (!props.hoverCloseDelayMs) {
+						close();
+						return;
+					}
+					if (pending === void 0) pending = setTimeout(close, props.hoverCloseDelayMs);
+				};
 				const move = (event) => {
 					if (event.pointerType === "touch") return;
+					if (!anchor.isConnected) {
+						close();
+						return;
+					}
 					const list = menu.current;
-					if (!anchor.isConnected || list && !inMenuHoverRegion(event.clientX, event.clientY, anchor.getBoundingClientRect(), list.getBoundingClientRect())) close();
+					if (!list || inMenuHoverRegion(event.clientX, event.clientY, anchor.getBoundingClientRect(), list.getBoundingClientRect())) cancel();
+					else scheduleClose();
 				};
 				const leave = (event) => {
-					if (event.relatedTarget === null) close();
+					if (event.relatedTarget === null) scheduleClose();
 				};
 				const observer = new MutationObserver(() => {
 					if (!anchor.isConnected) close();
@@ -110811,15 +110846,22 @@ 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, props.hoverAnchor]);
+			}, [
+				open,
+				props.hoverAnchor,
+				props.hoverCloseDelayMs
+			]);
 			const actions = props.actions.filter((action) => !!action);
 			const items = actions.map((action) => "type" in action ? action : {
 				id: action.id,
@@ -139762,6 +139804,7 @@ body:has([data-arkme-self-topic-menu]) > [role="menu"] { z-index: 10030; }
 			let nativeObserver;
 			let viewportStyle;
 			let contentFrame;
+			let sessionHeader;
 			let scheduled = 0;
 			let disposed = false;
 			const shadow = surface.ownerDocument.createElement("div");
@@ -139798,6 +139841,16 @@ body:has([data-arkme-self-topic-menu]) > [role="menu"] { z-index: 10030; }
 					contentFrame = nextContent;
 					contentFrame?.setAttribute("data-arkme-harness-content-frame", "");
 				}
+				const nextHeader = contentFrame?.querySelector("[data-slot=\"conversation.session.header\"] > header") ?? void 0;
+				if (nextHeader !== sessionHeader) {
+					if (sessionHeader) resize?.unobserve(sessionHeader);
+					sessionHeader = nextHeader;
+					if (sessionHeader) resize?.observe(sessionHeader);
+				}
+				const headerBottom = sessionHeader?.getAttribute("aria-hidden") !== "true" ? sessionHeader?.getBoundingClientRect().bottom ?? rect.top : rect.top;
+				const panelTop = Math.min(rect.bottom, Math.max(rect.top, headerBottom));
+				set(viewport, "--arkme-harness-panel-top", `${panelTop}px`);
+				set(viewport, "--arkme-harness-panel-height", `${Math.max(0, rect.bottom - panelTop)}px`);
 				const ready = contentFrame !== void 0;
 				const layers = ready ? harnessMenuLayers(native) : [];
 				let menuRect;
@@ -139850,6 +139903,8 @@ body:has([data-arkme-self-topic-menu]) > [role="menu"] { z-index: 10030; }
 				viewportStyle?.remove();
 				contentFrame?.removeAttribute("data-arkme-harness-content-frame");
 				contentFrame = void 0;
+				if (sessionHeader) resize?.unobserve(sessionHeader);
+				sessionHeader = void 0;
 				native?.documentElement.removeAttribute("data-arkme-harness-viewport");
 				try {
 					native = frame.contentDocument ?? void 0;
@@ -139865,6 +139920,12 @@ body:has([data-arkme-self-topic-menu]) > [role="menu"] { z-index: 10030; }
         position: absolute !important; left: var(--arkme-harness-content-left); top: var(--arkme-harness-content-top);
         width: var(--arkme-harness-content-width); height: var(--arkme-harness-content-height);
       }
+      [data-arkme-harness-content-frame] [data-sidebar-right-panel="fullscreen"] {
+        left: var(--arkme-harness-content-left) !important; right: auto !important;
+        top: var(--arkme-harness-panel-top) !important; bottom: auto !important;
+        width: var(--arkme-harness-content-width) !important;
+        height: var(--arkme-harness-panel-height) !important;
+      }
     `;
 				native.head.append(viewportStyle);
 				nativeObserver = new win.MutationObserver(schedule);
@@ -139876,6 +139937,7 @@ body:has([data-arkme-self-topic-menu]) > [role="menu"] { z-index: 10030; }
 						"style",
 						"class",
 						"hidden",
+						"aria-hidden",
 						"data-arkme-session-open",
 						"data-arkme-session-frame"
 					]
@@ -139919,6 +139981,7 @@ body:has([data-arkme-self-topic-menu]) > [role="menu"] { z-index: 10030; }
 					"width",
 					"height"
 				]) native?.documentElement.style.removeProperty(`--arkme-harness-content-${key}`);
+				for (const key of ["top", "height"]) native?.documentElement.style.removeProperty(`--arkme-harness-panel-${key}`);
 			};
 		}
 		//#endregion
@@ -152923,14 +152986,15 @@ html body {
 				flex: "none"
 			},
 			trigger: {
-				width: 28,
-				height: 28,
+				width: directorySearchLayout.field.height,
+				height: directorySearchLayout.field.height,
 				flex: "none",
 				padding: 0,
 				display: "grid",
 				placeItems: "center",
+				boxSizing: "border-box",
 				border: 0,
-				borderRadius: 999,
+				borderRadius: directorySearchLayout.field.borderRadius,
 				backgroundColor: "var(--dsw-specific-selector, transparent)",
 				color: "var(--dsw-alias-label-primary)",
 				cursor: "pointer",
@@ -153073,6 +153137,7 @@ html body {
 					anchor,
 					align: "end",
 					onClose,
+					hoverCloseDelayMs: 500,
 					...getAnchorRect === void 0 ? {} : { getAnchorRect },
 					...hoverAnchor === void 0 ? {} : { hoverAnchor },
 					actions: [
@@ -153121,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);
@@ -153144,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);
@@ -153156,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,
@@ -153180,12 +153247,12 @@ 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: 14,
+						size: 20,
 						"aria-hidden": true
 					})
 				}),
@@ -153194,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: () => {
@@ -201350,7 +201417,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 		const c$3 = e$24;
 		//#endregion
 		//#region package.json
-		var version = "0.1.71";
+		var version = "0.1.73";
 		//#endregion
 		//#region src/client/profile-change-store.ts
 		let revision = 0;