@senguoyun/dsh-arkme 0.1.89 → 0.1.90

package/docs/notification-list-stability-2026-10-03.md

@@ -0,0 +1,43 @@
+# 通知列表刷新与排序
+
+基线：`origin/dev` / `58e579677e931111785d50954755cfc901d85b4a`。本任务在独立 worktree 开发，原 checkout 的录音与频道改动保留。
+
+## 范围与能力边界
+
+用户确认的行为：点击通知只切换内容区；同账号刷新保留已有通知行与内容；通知按最新一条事件的时间参与普通会话排序，保留置顶规则。已读与刷新不生成新的排序时间。
+
+随后确认移除通知标题栏的返回箭头及占位，保留铃铛、标题与全部已读操作；通过会话列表直接切换对话。
+
+跨板块返回统一恢复离开前的会话：补齐通知与 Arko 的 `lastConversationDestination` 记录，复用普通会话、Bot、Harness、Codex 和发给自己的恢复机制。记忆仍由现有 UI controller 持有，仅保存当前运行期间的一个目标，退出登录或账号替换时清除；不增加持久化、网络请求或后台资源。
+
+| 能力面 | 范围 | 验证 |
+| --- | --- | --- |
+| UI | 通知缓存展示、账号隔离、目录排序、选中状态与跨板块恢复 | 慢请求、失败、账号切换、目录排序、会话恢复及真实登录态 Web 验收 |
+| Host owner | 复用既有通知查询与已读 API，不改变请求合同或权限 | 无 Host 修改 |
+| Tools / SDK | N/A：仅修复 Browser 展示状态，不新增业务能力、路由或持久化 | 既有入口保持不变 |
+| Client / Harness | 无客户端、原生桥或运行环境修改 | 仅部署独立 Web 预览 |
+
+## 请求与资源边界
+
+入口为已有通知行和通知中心的挂载；缓存 owner 仍为单例通知 store。同账号并发刷新共用现有 in-flight 请求，账号变化取消旧请求并清除旧账号投影；不新增轮询、定时器或后台进程。通知行移动不拥有新的数据请求生命周期。
+
+既有查询上限保持：安排 50 条、世界最近 10 条记录各取最多 50 条互动、AI 来信 20 条。失败保留已有的有界快照，成功结果替换对应快照，不累计历史。目录新增一个合成通知项，继续使用现有分块渲染。
+
+表态仍复用现有未读收件箱，不新增已读表态历史存储；排序取当前通知投影中最新事件的原始时间，不使用点击、已读操作或请求完成时间。
+
+## 验证记录
+
+- 基线相关测试：3 文件、56 项通过；新回归用例在修改前复现通知行消失、失败后丢失、固定位置三项问题。
+- 新增 9 项行为测试：慢请求期间保留同一选中行与内容、失败保留、置顶及事件时间排序、真正空数据隐藏、世界与 AI 缓存、世界部分失败、账号切换隔离、并发请求合并、跨目录分块不额外请求。
+- 定向验证：5 文件、69 项通过；增加边界用例并同步旧目录结构断言后，相关 2 文件、29 项通过。
+- `pnpm run typecheck`、`pnpm run build`、`git diff --check` 通过。
+- 全量 `pnpm test --maxWorkers=2`：850 文件、10037 项通过；11 文件、15 项按既有配置跳过。测试使用已安装的 zstd 工具链，未修改测试跳过配置。
+- 移除标题栏返回按钮后重新构建通过；通知目录与入口导航相关 2 文件、11 项测试通过。该追加改动仅删除按钮和未使用样式，未再次复跑全量测试。
+- 会话恢复基线 3 文件、64 项通过；新增切换用例在修复前复现通知和 Arko 往返 6 个板块的 12 项失败。修复后 3 文件、111 项通过，涵盖 42 种会话/板块组合、主动选择新会话、账号清理，以及世界通知入口到产品导航返回的实际组件链路；类型检查和构建通过。
+- 会话恢复最终全量验证：850 文件、10084 项通过；11 文件、15 项按既有配置跳过。
+- 打包版本仍为基线 `0.1.89`；独立临时 Web Profile 安装成功，本地预览使用的客户端构建文件与本次构建一致。
+- 真实登录态 Web：通知显示 8 条，最近事件为 9 月 10 日；目录项排在 9 月 13 日与 9 月 7 日会话之间，进入通知后行保留并显示选中状态。
+- 会话恢复实测：从已读的世界通知进入世界，再点击对话，通知行恢复选中且内容区仍显示 8 条通知；Arko → 世界 → 对话也恢复 Arko。未执行全部已读操作；世界通知跳转沿用既有的世界已查看处理。
+- 更新前已备份旧预览包与配置；原 checkout 的 30 个本地文件逐一校验，与备份完全一致。未修改已安装 Arkme 客户端。
+
+慢请求、失败、账号切换等边界由自动化测试覆盖；实际 Web 检查使用正常网络。临时 Profile 完成安装检查，实际运行验收使用已有独立 Web 预览；两者均不等同于桌面客户端发行验收。

package/lib/client.js

@@ -31395,13 +31395,14 @@ window.__ModuleLoader__.load({
 				const destination = this.lastConversationDestination;
 				this.publish({
 					...rest,
-					mode: destination?.kind === "codex" ? "codex" : destination?.kind === "harness" ? "harness" : destination?.kind === "bot" ? "bot" : "source",
+					mode: destination === void 0 || destination.kind === "send_to_self" ? "source" : destination.kind,
 					...destination?.kind === "source" ? { selectedSource: destination.source } : {},
 					...destination?.kind === "bot" ? { selectedBot: destination.bot } : {}
 				});
 			}
 			showNotifications() {
 				this.leaveContacts();
+				this.lastConversationDestination = { kind: "notifications" };
 				const { selectedSource: _selectedSource, selectedBot: _selectedBot, recordingTarget: _recordingTarget, calendarOpen: _calendarOpen, productMode: _productMode, conversationTarget: _conversationTarget, extensionShareRef: _extensionShareRef, extensionShareAction: _extensionShareAction, extensionDetailId: _extensionDetailId, extensionAuthorFilter: _extensionAuthorFilter, webLoginDialogOpen: _webLoginDialogOpen, ...rest } = this.state;
 				this.publish({
 					...rest,
@@ -31433,6 +31434,7 @@ window.__ModuleLoader__.load({
 			}
 			showArko() {
 				this.leaveContacts();
+				this.lastConversationDestination = { kind: "arko" };
 				const { selectedSource: _selectedSource, calendarOpen: _calendarOpen, productMode: _productMode, ...rest } = this.state;
 				this.publish({
 					...rest,
@@ -162825,6 +162827,7 @@ html body {
 		const EMPTY_SNAPSHOT = {
 			scope: void 0,
 			revision: 0,
+			ready: false,
 			loading: false,
 			error: void 0,
 			arrangementItems: [],
@@ -162936,20 +162939,14 @@ html body {
 				this.controller?.abort();
 				const controller = new AbortController();
 				this.controller = controller;
+				const previous = this.snapshot.scope === scope ? this.snapshot : EMPTY_SNAPSHOT;
 				const operation = (async () => {
 					this.publish({
-						...this.snapshot,
+						...previous,
 						scope,
 						loading: true,
 						error: void 0,
 						worldError: void 0,
-						arrangementItems: [],
-						worldItems: [],
-						worldUnreadCount: 0,
-						worldSeenThroughSequence: 0,
-						aiItems: [],
-						aiUnreadCount: 0,
-						aiLatestUnread: void 0,
 						aiError: void 0
 					});
 					const [arrangementsResult, worldSummaryResult, worldFeedResult, aiUnreadResult, aiListResult] = await Promise.allSettled([
@@ -162971,18 +162968,18 @@ html body {
 						}, controller.signal)
 					]);
 					if (controller.signal.aborted || this.controller !== controller) return;
-					let arrangementItems = [];
+					let arrangementItems = this.snapshot.arrangementItems;
 					let error;
 					if (arrangementsResult.status === "fulfilled") arrangementItems = Array.isArray(arrangementsResult.value?.items) ? arrangementsResult.value.items : [];
 					else error = arrangementsResult.reason instanceof Error ? arrangementsResult.reason.message : tr$1("通知暂时无法加载");
-					let worldUnreadCount = 0;
-					let worldSeenThroughSequence = 0;
+					let worldUnreadCount = this.snapshot.worldUnreadCount;
+					let worldSeenThroughSequence = this.snapshot.worldSeenThroughSequence;
 					let worldError;
 					if (worldSummaryResult.status === "fulfilled") {
 						worldUnreadCount = Math.max(0, Math.trunc(worldSummaryResult.value.unreadCount));
 						worldSeenThroughSequence = Math.max(0, Math.trunc(worldSummaryResult.value.seenThroughSequence));
 					} else worldError = worldSummaryResult.reason instanceof Error ? worldSummaryResult.reason.message : tr$1("世界互动暂时无法加载");
-					const worldItems = [];
+					let worldItems = [];
 					if (worldFeedResult.status === "fulfilled") {
 						const feedItems = Array.isArray(worldFeedResult.value?.items) ? worldFeedResult.value.items.slice(0, 10) : [];
 						const interactionResults = await Promise.allSettled(feedItems.map((feedItem) => callArkme("world.interactions.list", {
@@ -163001,21 +162998,28 @@ html body {
 							});
 						});
 						worldItems.sort((left, right) => right.atMillis - left.atMillis);
-						if (interactionResults.some((result) => result.status === "rejected") && worldError === void 0) worldError = tr$1("部分世界互动暂时无法加载");
-					} else if (worldError === void 0) worldError = worldFeedResult.reason instanceof Error ? worldFeedResult.reason.message : tr$1("世界互动暂时无法加载");
-					let aiUnreadCount = 0;
-					let aiLatestUnread;
+						if (interactionResults.some((result) => result.status === "rejected")) {
+							worldError ??= tr$1("部分世界互动暂时无法加载");
+							if (this.snapshot.worldItems.length > 0) worldItems = this.snapshot.worldItems;
+						}
+					} else {
+						worldItems = this.snapshot.worldItems;
+						worldError ??= worldFeedResult.reason instanceof Error ? worldFeedResult.reason.message : tr$1("世界互动暂时无法加载");
+					}
+					let aiUnreadCount = this.snapshot.aiUnreadCount;
+					let aiLatestUnread = this.snapshot.aiLatestUnread;
 					let aiError;
 					if (aiUnreadResult.status === "fulfilled") {
 						aiUnreadCount = Math.max(0, Math.trunc(aiUnreadResult.value.unreadCount));
 						aiLatestUnread = aiUnreadResult.value.latestUnread;
 					} else aiError = aiUnreadResult.reason instanceof Error ? aiUnreadResult.reason.message : tr$1("AI 来信暂时无法加载");
-					let aiItems = aiListResult.status === "fulfilled" ? (Array.isArray(aiListResult.value?.items) ? aiListResult.value.items : []).map(aiLetterItem).sort((left, right) => right.atMillis - left.atMillis) : [];
+					let aiItems = aiListResult.status === "fulfilled" ? (Array.isArray(aiListResult.value?.items) ? aiListResult.value.items : []).map(aiLetterItem).sort((left, right) => right.atMillis - left.atMillis) : this.snapshot.aiItems;
 					if (aiItems.length === 0 && aiLatestUnread !== void 0) aiItems = [aiLetterItem(aiLatestUnread)];
 					if (aiListResult.status === "rejected" && aiError === void 0) aiError = aiListResult.reason instanceof Error ? aiListResult.reason.message : tr$1("AI 来信暂时无法加载");
 					this.publish({
 						...this.snapshot,
 						scope,
+						ready: true,
 						loading: false,
 						error,
 						arrangementItems,
@@ -163091,11 +163095,11 @@ html body {
 		function useNotificationItems() {
 			const auth = (0, react$1.useSyncExternalStore)(arkmeAuthStore.subscribe, arkmeAuthStore.getSnapshot, arkmeAuthStore.getSnapshot).auth;
 			const scope = auth?.status === "authenticated" ? `${auth.environment}:${auth.userId}` : void 0;
-			const snapshot = (0, react$1.useSyncExternalStore)(arkmeNotificationStore.subscribe, arkmeNotificationStore.getSnapshot, arkmeNotificationStore.getSnapshot);
+			const storedSnapshot = (0, react$1.useSyncExternalStore)(arkmeNotificationStore.subscribe, arkmeNotificationStore.getSnapshot, arkmeNotificationStore.getSnapshot);
+			const snapshot = storedSnapshot.scope === scope ? storedSnapshot : EMPTY_SNAPSHOT;
 			const reactionRevision = (0, react$1.useSyncExternalStore)(reactionNotifications.subscribe, reactionNotifications.getSnapshot, reactionNotifications.getSnapshot);
 			(0, react$1.useEffect)(() => {
-				if (scope === void 0) return;
-				const release = reactionNotifications.acquire(scope);
+				const release = scope === void 0 ? void 0 : reactionNotifications.acquire(scope);
 				arkmeNotificationStore.refresh(scope);
 				return release;
 			}, [scope]);
@@ -163136,7 +163140,7 @@ html body {
 			const unread = items.filter((item) => item.unread);
 			const latest = items[0];
 			return {
-				ready: snapshot.scope !== void 0 && !snapshot.loading,
+				ready: snapshot.scope !== void 0 && snapshot.ready,
 				hasNotifications: items.length > 0 || snapshot.worldUnreadCount > 0 || snapshot.aiUnreadCount > 0,
 				unreadCount: unread.length + snapshot.worldUnreadCount + snapshot.aiUnreadCount,
 				preview: latest === void 0 ? tr$1("安排、互动和表态通知") : `${latest.title}：${latest.preview}`,
@@ -163160,17 +163164,6 @@ html body {
 				padding: "0 20px",
 				borderBottom: `1px solid ${arkmeTheme.borderSoft}`
 			},
-			back: {
-				width: 32,
-				height: 32,
-				border: 0,
-				borderRadius: 8,
-				background: "transparent",
-				color: arkmeTheme.text,
-				font: "inherit",
-				fontSize: 22,
-				cursor: "pointer"
-			},
 			title: {
 				margin: 0,
 				flex: 1,
@@ -163377,15 +163370,6 @@ html body {
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
 						style: styles$33.header,
 						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								style: styles$33.back,
-								"aria-label": tr$1("返回 Arkme 会话列表"),
-								onClick: () => {
-									arkmeUi.showConversations();
-								},
-								children: "‹"
-							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								style: { color: arkmeTheme.accent },
 								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NotificationBell, { size: 21 })
@@ -164986,14 +164970,21 @@ html body {
 			});
 		}
 		function ArkmeNotificationsRow({ selected, onClick }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeNotificationRowContent, {
+				selected,
+				onClick,
+				summary: useArkmeNotificationSummary()
+			});
+		}
+		function ArkmeNotificationRowContent({ selected, onClick, summary }) {
 			useArkmeLocale();
-			const summary = useArkmeNotificationSummary();
 			if (!summary.ready || !summary.hasNotifications) return null;
 			const time = timeLabel$3(summary.atMillis);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 				type: "button",
 				role: "treeitem",
 				"aria-selected": selected,
+				"data-arkme-directory-row": "notifications",
 				"aria-label": summary.unreadCount > 0 ? tr$1("通知，{v0} 条未读", { v0: String(summary.unreadCount) }) : tr$1("通知"),
 				style: {
 					...styles$32.chatRow,
@@ -165559,6 +165550,7 @@ html body {
 			const recordRevision = (0, react$1.useSyncExternalStore)(arkmeUi.subscribe, arkmeUi.getRecordRevision, arkmeUi.getRecordRevision);
 			const chatRevision = (0, react$1.useSyncExternalStore)(arkmeUi.subscribe, arkmeUi.getChatRevision, arkmeUi.getChatRevision);
 			const authState = (0, react$1.useSyncExternalStore)(arkmeAuthStore.subscribe, arkmeAuthStore.getSnapshot, arkmeAuthStore.getSnapshot);
+			const notificationSummary = useArkmeNotificationSummary();
 			const chatDirectory = (0, react$1.useSyncExternalStore)(arkmeChatDirectory.subscribe, arkmeChatDirectory.getSnapshot, arkmeChatDirectory.getSnapshot);
 			const conversationProjection = (0, react$1.useSyncExternalStore)(arkmeChatDirectory.subscribe, arkmeChatDirectory.getConversationSnapshot, arkmeChatDirectory.getConversationSnapshot);
 			const notificationActivation = (0, react$1.useSyncExternalStore)(arkmeNotificationActivation.subscribe, arkmeNotificationActivation.getSnapshot, arkmeNotificationActivation.getSnapshot);
@@ -165783,6 +165775,11 @@ html body {
 				scope: currentAccountKey,
 				enabled: active && directory === "root"
 			});
+			const rootDirectoryRows = [...removalFeedback.rows];
+			if (authenticated && notificationSummary.ready && notificationSummary.hasNotifications) {
+				const index = removalFeedback.rows.findIndex((row) => !row.pinned && row.activeAtMillis < notificationSummary.atMillis);
+				rootDirectoryRows.splice(index < 0 ? rootDirectoryRows.length : index, 0, { kind: "notifications" });
+			}
 			const directoryContextMenu = (0, react$1.useMemo)(() => {
 				if (directoryContextTarget === void 0) return void 0;
 				const row = rootConversationRows.find((row) => row.kind === directoryContextTarget.kind && (row.kind === "source" ? arkmeSourceIdentityKey(row.source) : conversationBotVisibilityKey(row.bot)) === directoryContextTarget.key);
@@ -167024,9 +167021,10 @@ html body {
 							"aria-label": directory === "send_to_self" ? "发给自己分类" : tr$1("Arkme 会话"),
 							children: [
 								directory === "root" && authenticated && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeNotificationPermissionBanner, {}),
-								authenticated && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeNotificationsRow, {
+								directory !== "root" && authenticated && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeNotificationRowContent, {
 									selected: ui.mode === "notifications",
-									onClick: showNotifications
+									onClick: showNotifications,
+									summary: notificationSummary
 								}),
 								directory === "root" && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 									showHarnessEntry && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DeepSeekHarnessRow, {
@@ -167138,8 +167136,13 @@ html body {
 									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeConversationRemovalStyles, {}),
 									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeDirectoryWindow, {
 										revealKey: unreadJumpTarget?.key,
-										activeKey: ui.mode === "source" && ui.selectedSource !== void 0 ? arkmeSourceIdentityKey(ui.selectedSource) : ui.mode === "bot" && ui.selectedBot !== void 0 ? conversationBotVisibilityKey(ui.selectedBot) : void 0,
-										children: removalFeedback.rows.map((row) => {
+										activeKey: ui.mode === "notifications" ? "notifications" : ui.mode === "source" && ui.selectedSource !== void 0 ? arkmeSourceIdentityKey(ui.selectedSource) : ui.mode === "bot" && ui.selectedBot !== void 0 ? conversationBotVisibilityKey(ui.selectedBot) : void 0,
+										children: rootDirectoryRows.map((row) => {
+											if (row.kind === "notifications") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArkmeNotificationRowContent, {
+												selected: activeDirectoryEntryId === void 0 && ui.mode === "notifications",
+												onClick: showNotifications,
+												summary: notificationSummary
+											}, "notifications");
 											if (row.kind === "bot") {
 												const { bot } = row;
 												const removalPhase = removalFeedback.phases.get(`bot:${conversationBotVisibilityKey(bot)}`);
@@ -213906,7 +213909,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 		const c$3 = e$20;
 		//#endregion
 		//#region package.json
-		var version = "0.1.89";
+		var version = "0.1.90";
 		//#endregion
 		//#region src/client/arkme-membership.ts
 		function membershipLabel(state) {