@awiki/dsh-plugin 0.2.1 → 0.2.2

package/README.md

@@ -19,7 +19,7 @@ TypeScript SDK `identity.json`; create a new Rust-backed identity after upgradin
 - Register one deployment-level AWiki identity from the Web UI.
 - Open the top-left AWiki account menu to sign out locally without deleting the encrypted identity or message database; **Resume** restores the same DID and Handle, including across DSH restarts.
 - Reuse that identity across the root Agent and its subagents.
-- Direct-message and existing-group conversation lists, unread counts, latest-message previews, and persisted display names. Opening a conversation keeps loading feedback inside the history and lands on the newest message; scrolling up reveals a latest-message control that counts newer arrivals without interrupting reading.
+- Direct-message and existing-group conversation lists, unread counts, latest-message previews, and persisted display names. Opening a conversation keeps loading feedback inside the history and lands on the newest message; scrolling up reveals a latest-message control that counts newer arrivals without interrupting reading. A conversation is marked read only after its newest rendered message reaches the visible bottom.
 - Text messages plus one attachment per message, with Enter-to-send, Shift+Enter line breaks, optimistic sending bubbles, image previews, and SHA verification.
 - A draggable circular launcher, adaptive popup placement, dark mode, and remembered active conversation.
 - User-triggered AI summaries for up to 50 recent or unread messages, kept only in runtime memory with explicit stale, retry, copy, and source-navigation states.
@@ -36,7 +36,7 @@ group administration, realtime push, or multiple attachments in one message.
 Install the official public npm package:
 
 ```bash
-pnpm add @awiki/dsh-plugin@next
+pnpm add @awiki/dsh-plugin@latest
 ```
 
 `@awiki/dsh-plugin` is the canonical package identity starting with

package/README.zh.md

@@ -13,7 +13,7 @@ Rust 身份。
 - 在 Web UI 中注册一个部署级 AWiki 身份，根 Agent 与子 Agent 共用。
 - 点击 AWiki 面板左上角图标可打开账户菜单；普通退出只锁定本机会话，不删除加密身份或消息数据库，重新进入及重启 DSH 后仍恢复同一个 DID 和 Handle。
 - 注册失败时保留手机号、Handle、验证码和本机待注册密钥；注册未开放、验证码状态失效和提交冲突会给出对应的安全处理提示。
-- 私聊和已有群聊列表、未读角标、最新消息预览、时间更新与昵称持久化。打开会话时在消息区内显示加载状态并落到最新消息；向上阅读时显示下滑箭头，新消息到达后在同一控件中累计数量且不打断阅读位置。
+- 私聊和已有群聊列表、未读角标、最新消息预览、时间更新与昵称持久化。打开会话时在消息区内显示加载状态并落到最新消息；向上阅读时显示下滑箭头，新消息到达后在同一控件中累计数量且不打断阅读位置。只有最新一条已渲染消息到达可视区域底部后，当前会话才会自动标记为已读。
 - 文本和单附件消息；Enter 发送、Shift+Enter 换行，发送中立即显示带 loading 动画的乐观气泡，并支持图片预览、附件说明与 SHA 校验。
 - 圆形可拖动入口、自适应四角弹窗、深色模式和当前会话记忆。
 - 用户点击后才生成的 AI 对话总结：最多处理 50 条最近或未读消息，按会话保留本次运行期缓存，并支持过期提示、重试、复制与跳转原消息。
@@ -29,7 +29,7 @@ Rust 身份。
 安装公开发布的官方 npm 包：
 
 ```bash
-pnpm add @awiki/dsh-plugin@next
+pnpm add @awiki/dsh-plugin@latest
 ```
 
 从 `0.2.0-rc.4` 起，`@awiki/dsh-plugin` 是唯一规范包名。原

package/lib/client.js

@@ -5451,6 +5451,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			generation = 0;
 			disposed = false;
 			polling = false;
+			markReadInFlight = /* @__PURE__ */ new Map();
 			unreadAtOpen = /* @__PURE__ */ new Map();
 			summaryBaselines = /* @__PURE__ */ new Map();
 			/** @param remote - generated Host Remote namespace. */
@@ -5560,6 +5561,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				if (this.timer !== void 0) clearInterval(this.timer);
 				this.timer = void 0;
 				this.polling = false;
+				this.markReadInFlight.clear();
 			}
 			/**
 			* Request one phone verification challenge.
@@ -5716,24 +5718,51 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					})
 				});
 				if (!loaded.ok) return loaded;
-				const marked = await call(() => this.remote.markConversationRead({ conversationId }));
-				if (!marked.ok) return this.fail(marked.error);
-				if (!this.current(generation) || this.view.selectedConversationId !== conversationId) return {
+				return {
 					ok: true,
 					value: void 0
 				};
-				this.publish({
-					...this.view,
-					conversations: this.view.conversations.map((conversation) => conversation.id === conversationId ? {
-						...conversation,
-						unreadCount: 0
-					} : conversation),
-					error: null
-				});
-				return {
+			}
+			/**
+			* Mark the selected conversation read after the UI proves its newest message is visible.
+			* Repeated scroll and layout notifications share one Host request, while a failed
+			* background attempt keeps the unread badge so reaching the bottom can retry.
+			*/
+			async markSelectedConversationRead() {
+				if (this.disposed) return {
+					ok: false,
+					error: "AWiki 插件已卸载"
+				};
+				const conversation = this.selectedConversation();
+				if (conversation === void 0 || (conversation.unreadCount ?? 0) <= 0) return {
 					ok: true,
 					value: void 0
 				};
+				const existing = this.markReadInFlight.get(conversation.id);
+				if (existing !== void 0) return existing;
+				const conversationId = conversation.id;
+				const generation = this.generation;
+				const operation = (async () => {
+					const result = await call(() => this.remote.markConversationRead({ conversationId }));
+					if (!result.ok) return result;
+					if (this.current(generation)) this.publish({
+						...this.view,
+						conversations: this.view.conversations.map((current) => current.id === conversationId ? {
+							...current,
+							unreadCount: 0
+						} : current)
+					});
+					return {
+						ok: true,
+						value: void 0
+					};
+				})();
+				this.markReadInFlight.set(conversationId, operation);
+				try {
+					return await operation;
+				} finally {
+					if (this.markReadInFlight.get(conversationId) === operation) this.markReadInFlight.delete(conversationId);
+				}
 			}
 			/**
 			* Load one older history page before the currently rendered messages.
@@ -6991,6 +7020,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const summaryPanelId = (0, react.useId)();
 			selectedConversationId.current = view.selectedConversationId;
 			const visibleSendingDraft = sendingDraft?.conversationId === view.selectedConversationId ? sendingDraft : null;
+			const markSelectedConversationReadAtBottom = () => {
+				const node = history.current;
+				const newestRendered = view.messages.at(-1);
+				if (node === null || selected === void 0 || newestRendered === void 0 || (selected.unreadCount ?? 0) <= 0 || view.pending === "加载消息" || selected.lastMessageAt !== void 0 && newestRendered.sentAt < selected.lastMessageAt || node.scrollHeight - node.scrollTop - node.clientHeight > HISTORY_BOTTOM_THRESHOLD) return;
+				props.markSelectedConversationRead();
+			};
 			const scrollHistoryToLatest = (smooth) => {
 				const node = history.current;
 				if (node === null) return;
@@ -7003,6 +7038,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				historyPinnedToBottom.current = true;
 				setHistoryAwayFromBottom(false);
 				setUnseenMessageCount(0);
+				if (!smooth || reduceMotion || typeof node.scrollTo !== "function") markSelectedConversationReadAtBottom();
 			};
 			const syncHistoryPosition = () => {
 				const node = history.current;
@@ -7010,8 +7046,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				const atBottom = node.scrollHeight - node.scrollTop - node.clientHeight <= HISTORY_BOTTOM_THRESHOLD;
 				historyPinnedToBottom.current = atBottom;
 				setHistoryAwayFromBottom(!atBottom);
-				if (atBottom) setUnseenMessageCount(0);
+				if (atBottom) {
+					setUnseenMessageCount(0);
+					markSelectedConversationReadAtBottom();
+				}
 			};
+			(0, react.useLayoutEffect)(() => {
+				markSelectedConversationReadAtBottom();
+			}, [
+				selected?.id,
+				selected?.lastMessageAt,
+				selected?.unreadCount,
+				view.messages,
+				view.pending
+			]);
 			(0, react.useLayoutEffect)(() => {
 				const conversationId = view.selectedConversationId;
 				if (conversationId !== previousConversationId.current) {
@@ -7036,7 +7084,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						messageId: view.messages.at(-1)?.id ?? null
 					};
 					scrollHistoryToLatest(false);
-					if (pendingInitialImages.current.size === 0) conversationAwaitingBottom.current = null;
+					if (pendingInitialImages.current.size === 0) {
+						conversationAwaitingBottom.current = null;
+						markSelectedConversationReadAtBottom();
+					}
 					return;
 				}
 				const previous = previousMessageTail.current;
@@ -7067,6 +7118,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				if (!pendingInitialImages.current.delete(messageId)) return;
 				if (history.current !== null) scrollHistoryToLatest(false);
 				if (pendingInitialImages.current.size === 0) conversationAwaitingBottom.current = null;
+				if (pendingInitialImages.current.size === 0) markSelectedConversationReadAtBottom();
 			};
 			const viewSummarySource = (messageId) => {
 				if (selected === void 0) return;
@@ -8522,6 +8574,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 							loadMoreConversations: () => controller.loadMoreConversations(),
 							startDirectChat: (handle) => controller.startDirectChat(handle),
 							selectConversation: (conversationId) => controller.selectConversation(conversationId),
+							markSelectedConversationRead: () => controller.markSelectedConversationRead(),
 							loadOlderHistory: () => controller.loadOlderHistory(),
 							summarizeConversation: () => controller.summarizeConversation(),
 							setSummaryCollapsed: (conversationId, collapsed) => {