@senguoyun/dsh-arkme 0.1.71 → 0.1.72

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,29 @@
+# 对话与联系人添加按钮回归（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 提交推送单独执行，不代表已合并或发布。

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,11 +2085,33 @@ 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();
@@ -2092,12 +2127,17 @@ Arkme 用户 {v0}|Arkme user {v0}
 				doc.addEventListener("pointerout", leave, true);
 				doc.defaultView?.addEventListener("blur", close);
 				return () => {
+					cancel();
 					observer.disconnect();
 					doc.removeEventListener("pointermove", move, true);
 					doc.removeEventListener("pointerout", leave, true);
 					doc.defaultView?.removeEventListener("blur", close);
 				};
-			}, [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,11 +110807,33 @@ 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();
@@ -110814,12 +110849,17 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 				doc.addEventListener("pointerout", leave, true);
 				doc.defaultView?.addEventListener("blur", close);
 				return () => {
+					cancel();
 					observer.disconnect();
 					doc.removeEventListener("pointermove", move, true);
 					doc.removeEventListener("pointerout", leave, true);
 					doc.defaultView?.removeEventListener("blur", close);
 				};
-			}, [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 +139802,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 +139839,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 +139901,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 +139918,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 +139935,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 +139979,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 +152984,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 +153135,7 @@ html body {
 					anchor,
 					align: "end",
 					onClose,
+					hoverCloseDelayMs: 250,
 					...getAnchorRect === void 0 ? {} : { getAnchorRect },
 					...hoverAnchor === void 0 ? {} : { hoverAnchor },
 					actions: [
@@ -153185,7 +153248,7 @@ html body {
 						else openMenu();
 					},
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, {
-						size: 14,
+						size: 20,
 						"aria-hidden": true
 					})
 				}),
@@ -201350,7 +201413,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 		const c$3 = e$24;
 		//#endregion
 		//#region package.json
-		var version = "0.1.71";
+		var version = "0.1.72";
 		//#endregion
 		//#region src/client/profile-change-store.ts
 		let revision = 0;