@senguoyun/dsh-arkme 0.1.85 → 0.1.86

package/lib/client.js

@@ -800,6 +800,20 @@ window.__ModuleLoader__.load({
 				if (imageRef.trim() === "") throw new TypeError("Arkme image reference must not be empty");
 				return await this.call("image.read", { imageRef }, signal);
 			}
+			/** Probe immutable image bytes without starting an upstream request. */
+			async readCachedImage(imageRef, signal) {
+				if (imageRef.trim() === "") throw new TypeError("Arkme image reference must not be empty");
+				if ((await this.capabilities(signal)).features.imageCacheRead !== true) throw new Error("当前 Arkme Provider 不支持本地头像探测，请升级");
+				try {
+					return await this.call("image.read", {
+						imageRef,
+						cacheOnly: true
+					}, signal);
+				} catch (error) {
+					if (error instanceof ArkmeClientError && error.body.code === "image-cache-miss") return void 0;
+					throw error;
+				}
+			}
 			/** Convert a Provider image payload into a browser-renderable data URL. */
 			imageDataUrl(image) {
 				return `data:${image.mediaType};base64,${image.dataBase64}`;
@@ -54565,84 +54579,15 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			});
 		}
 		//#endregion
-		//#region src/avatar-diagnostics.ts
-		function record(value) {
-			return value !== null && typeof value === "object" ? value : {};
-		}
-		function positiveId(value) {
-			return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : void 0;
-		}
-		/** Decoded IDs are diagnostic hints only, never authentication or authorization inputs. */
-		function avatarReferenceDiagnostic(imageRef) {
-			const ref = imageRef.trim();
-			if (!ref.startsWith("arkme-profile-image-v1.")) return { referenceKind: ref.startsWith("arkme-media-v1.") ? "media" : "other" };
-			const context = { referenceKind: "profile" };
-			try {
-				const parts = ref.split(".");
-				const encoded = parts[1] ?? "";
-				if (parts.length !== 3 || encoded.length > 1024 || !/^[A-Za-z0-9_-]+$/.test(encoded)) return context;
-				const base64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
-				const payload = record(JSON.parse(globalThis.atob(base64.padEnd(Math.ceil(base64.length / 4) * 4, "="))));
-				if (payload.version !== 1) return context;
-				const viewer = positiveId(payload.viewerUserId);
-				const target = positiveId(payload.targetUserId);
-				if (viewer !== void 0) context.referenceViewerUserId = viewer;
-				if (target !== void 0) context.referenceTargetUserId = target;
-			} catch {}
-			return context;
-		}
-		function avatarScopeDiagnostic(scopeKey) {
-			const match = /^(prod|test):([1-9][0-9]*)$/.exec(scopeKey ?? "");
-			const viewerUserId = positiveId(Number(match?.[2]));
-			return match === null || viewerUserId === void 0 ? {} : {
-				environment: match[1],
-				viewerUserId
-			};
-		}
-		function safeErrorCode(value) {
-			return typeof value === "string" && /^(?:(?:arkme|image|auth-http|local|profile)-[A-Za-z0-9_-]{1,80}|UND_ERR_[A-Z_]{1,64}|E[A-Z_]{1,64})$/.test(value) ? value : void 0;
-		}
-		function httpStatus(value) {
-			return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599 ? value : void 0;
-		}
-		function imageDownloadStatus(error) {
-			if (error.name !== "ArkmePluginError" || error.code !== "image-download-failed" || typeof error.message !== "string") return void 0;
-			const match = /^Arkme 图片读取返回 HTTP ([1-5][0-9]{2})$/.exec(error.message);
-			return match === null ? void 0 : httpStatus(Number(match[1]));
-		}
-		function logArkmeAvatarDiagnostic(event, context, error) {
-			try {
-				const source = record(error);
-				const body = record(source.body);
-				const detail = source.name === "ArkmeClientError" ? body : source;
-				const errorName = [
-					"Error",
-					"TypeError",
-					"AbortError",
-					"TimeoutError",
-					"ArkmePluginError",
-					"ArkmeClientError"
-				].includes(String(source.name)) ? String(source.name) : "unknown";
-				console.warn(`[ArkmeAvatarDiag] ${JSON.stringify({
-					timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-					event,
-					...context,
-					...error === void 0 ? {} : { error: {
-						name: errorName,
-						code: safeErrorCode(detail.code),
-						retryable: typeof detail.retryable === "boolean" ? detail.retryable : void 0,
-						httpStatus: httpStatus(source.httpStatus),
-						upstreamStatus: httpStatus(source.upstreamStatus) ?? imageDownloadStatus(source),
-						causeCode: safeErrorCode(record(source.cause).code)
-					} }
-				})}`);
-			} catch {}
-		}
-		//#endregion
 		//#region src/client/avatar-image-store.ts
+		/** These references identify immutable bytes, unlike mutable profile references. */
+		function isImmutableAvatarRef(ref) {
+			return /^file_asset:\/\/[A-Za-z0-9_-]{8,128}$/.test(ref) || /^arkme-self-role-image-v1\.[A-Za-z0-9_-]+$/.test(ref);
+		}
 		const DEFAULT_TTL_MILLIS = 600 * 1e3;
 		const DEFAULT_JITTER_MILLIS$1 = 120 * 1e3;
-		const DEFAULT_CONCURRENCY = 6;
+		const DEFAULT_CONCURRENCY = 3;
+		const IMMUTABLE_CONCURRENCY = 2;
 		const MAX_RETAINED_AVATARS = 256;
 		const MAX_QUEUED_AVATARS = 512;
 		const AVATAR_IMAGE_SCOPE_CHANGED = "Avatar image scope changed";
@@ -54656,6 +54601,8 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			jitterMillis;
 			concurrency;
 			activeDownloads = 0;
+			activeImmutableReads = 0;
+			activeCacheProbes = 0;
 			generation = 0;
 			scopeKey;
 			constructor(options) {
@@ -54709,10 +54656,26 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 					expiresAtMillis: 0,
 					pending: void 0
 				};
-				const pending = this.schedule(async () => {
+				const readRemote = () => this.schedule(isImmutableAvatarRef(imageRef) ? "immutable" : "remote", async () => {
 					if (generation !== this.generation) throw new Error(AVATAR_IMAGE_SCOPE_CHANGED);
 					return await this.options.reader(imageRef);
-				}).then((payload) => {
+				});
+				const persistent = scopeKey !== void 0 && isImmutableAvatarRef(imageRef) ? this.options.persistentCache : void 0;
+				const probe = isImmutableAvatarRef(imageRef) ? this.options.cachedReader : void 0;
+				const pending = (persistent === void 0 && probe === void 0 ? readRemote() : (async () => {
+					const cached = await persistent?.read(scopeKey, imageRef).catch(() => void 0);
+					if (generation !== this.generation) throw new Error(AVATAR_IMAGE_SCOPE_CHANGED);
+					if (cached !== void 0) return cached;
+					const local = probe === void 0 ? void 0 : await this.schedule("probe", async () => {
+						if (generation !== this.generation) throw new Error(AVATAR_IMAGE_SCOPE_CHANGED);
+						return await probe(imageRef);
+					});
+					if (generation !== this.generation) throw new Error(AVATAR_IMAGE_SCOPE_CHANGED);
+					const payload = local ?? await readRemote();
+					if (generation !== this.generation) throw new Error(AVATAR_IMAGE_SCOPE_CHANGED);
+					persistent?.write(scopeKey, imageRef, payload).catch(() => void 0);
+					return payload;
+				})()).then((payload) => {
 					if (generation !== this.generation) throw new Error(AVATAR_IMAGE_SCOPE_CHANGED);
 					const value = `data:${payload.mediaType};base64,${payload.dataBase64}`;
 					const previousValue = entry.value;
@@ -54751,27 +54714,35 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 					if (entry.pending === void 0 && !this.listeners.has(ref)) this.entries.delete(ref);
 				}
 			}
-			schedule(load) {
+			schedule(lane, load) {
 				return new Promise((resolve, reject) => {
 					if (this.queue.length >= MAX_QUEUED_AVATARS) {
 						reject(/* @__PURE__ */ new Error("Avatar loading queue is full"));
 						return;
 					}
-					this.queue.push(() => {
-						load().then(resolve, reject).finally(() => {
-							this.activeDownloads -= 1;
-							this.drainQueue();
-						});
+					this.queue.push({
+						lane,
+						start: () => {
+							load().then(resolve, reject).finally(() => {
+								if (lane === "probe") this.activeCacheProbes -= 1;
+								else if (lane === "immutable") this.activeImmutableReads -= 1;
+								else this.activeDownloads -= 1;
+								this.drainQueue();
+							});
+						}
 					});
 					this.drainQueue();
 				});
 			}
 			drainQueue() {
-				while (this.activeDownloads < this.concurrency) {
-					const start = this.queue.shift();
-					if (start === void 0) return;
-					this.activeDownloads += 1;
-					start();
+				for (;;) {
+					const index = this.queue.findIndex((job) => job.lane === "probe" ? this.activeCacheProbes < 1 : job.lane === "immutable" ? this.activeImmutableReads < IMMUTABLE_CONCURRENCY : this.activeDownloads < this.concurrency);
+					if (index === -1) return;
+					const job = this.queue.splice(index, 1)[0];
+					if (job.lane === "probe") this.activeCacheProbes += 1;
+					else if (job.lane === "immutable") this.activeImmutableReads += 1;
+					else this.activeDownloads += 1;
+					job.start();
 				}
 			}
 			notify(imageRef, value) {
@@ -54779,8 +54750,185 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			}
 		};
 		//#endregion
+		//#region src/client/avatar-persistent-cache.ts
+		const CACHE_NAME = "arkme-immutable-avatars-v1";
+		const MAX_ENTRIES$1 = 64;
+		const MAX_BYTES$1 = 64 * 1024 * 1024;
+		const MAX_BASE64_LENGTH = Math.ceil(8 * 1024 * 1024 / 3) * 4;
+		function validPayload(value) {
+			if (typeof value !== "object" || value === null) return false;
+			const payload = value;
+			return typeof payload.mediaType === "string" && /^image\/(png|jpeg|webp|gif|avif)$/.test(payload.mediaType) && typeof payload.dataBase64 === "string" && payload.dataBase64.length > 0 && payload.dataBase64.length <= MAX_BASE64_LENGTH && payload.dataBase64.length % 4 === 0 && !/[^A-Za-z0-9+/]/.test(payload.dataBase64.replace(/={1,2}$/, ""));
+		}
+		/** Validate browser-persisted bytes too: base64 syntax is not image validity. */
+		async function decodableAvatar(payload) {
+			try {
+				const bytes = Uint8Array.from(atob(payload.dataBase64), (character) => character.charCodeAt(0));
+				const blob = new Blob([bytes], { type: payload.mediaType });
+				if (typeof createImageBitmap === "function") {
+					(await createImageBitmap(blob)).close();
+					return true;
+				}
+				if (typeof Image === "undefined") return false;
+				const url = URL.createObjectURL(blob);
+				try {
+					return await new Promise((resolve) => {
+						const image = new Image();
+						image.onload = () => resolve(image.naturalWidth > 0 && image.naturalHeight > 0);
+						image.onerror = () => resolve(false);
+						image.src = url;
+					});
+				} finally {
+					URL.revokeObjectURL(url);
+				}
+			} catch {
+				return false;
+			}
+		}
+		/** Browser bytes survive reloads. Host remains the authenticated source on misses.
+		* No TTL for immutable refs; quota eviction and clearing site data are cache misses.
+		* Synthetic keys are never fetched and include the environment/account scope.
+		*/
+		var BrowserAvatarPersistentCache = class {
+			decode;
+			constructor(decode = decodableAvatar) {
+				this.decode = decode;
+			}
+			writes = Promise.resolve();
+			key(scope, ref) {
+				try {
+					if (!scope.trim() || !isImmutableAvatarRef(ref) || typeof globalThis.caches === "undefined" || typeof globalThis.location === "undefined") return void 0;
+					return new URL(`/arkme-self/avatar-cache/v1/${encodeURIComponent(scope)}/${encodeURIComponent(ref)}`, globalThis.location.origin).href;
+				} catch {
+					return;
+				}
+			}
+			async read(scope, ref) {
+				const key = this.key(scope, ref);
+				if (key === void 0) return void 0;
+				try {
+					const cache = await caches.open(CACHE_NAME);
+					const response = await cache.match(key);
+					if (response === void 0) return void 0;
+					const payload = await response.json().catch(() => void 0);
+					if (validPayload(payload) && await this.decode(payload)) return payload;
+					await cache.delete(key);
+				} catch {}
+			}
+			write(scope, ref, payload) {
+				const key = this.key(scope, ref);
+				if (key === void 0 || !validPayload(payload)) return Promise.resolve();
+				const operation = this.writes.then(async () => {
+					if (!await this.decode(payload)) return;
+					const cache = await caches.open(CACHE_NAME);
+					const body = JSON.stringify(payload);
+					const keys = (await cache.keys()).filter((request) => request.url !== key);
+					const sizes = await Promise.all(keys.map(async (request) => Number((await cache.match(request))?.headers.get("Content-Length")) || 0));
+					let bytes = sizes.reduce((sum, size) => sum + size, 0) + body.length;
+					let count = keys.length + 1;
+					for (let index = 0; index < keys.length && (count > MAX_ENTRIES$1 || bytes > MAX_BYTES$1); index++) {
+						await cache.delete(keys[index]);
+						bytes -= sizes[index];
+						count -= 1;
+					}
+					await cache.put(key, new Response(body, { headers: {
+						"Content-Type": "application/json",
+						"Content-Length": String(body.length)
+					} }));
+				});
+				this.writes = operation.catch(() => void 0);
+				return this.writes;
+			}
+		};
+		//#endregion
+		//#region src/avatar-diagnostics.ts
+		function record(value) {
+			return value !== null && typeof value === "object" ? value : {};
+		}
+		function positiveId(value) {
+			return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : void 0;
+		}
+		/** Decoded IDs are diagnostic hints only, never authentication or authorization inputs. */
+		function avatarReferenceDiagnostic(imageRef) {
+			const ref = imageRef.trim();
+			if (!ref.startsWith("arkme-profile-image-v1.")) return { referenceKind: ref.startsWith("arkme-media-v1.") ? "media" : "other" };
+			const context = { referenceKind: "profile" };
+			try {
+				const parts = ref.split(".");
+				const encoded = parts[1] ?? "";
+				if (parts.length !== 3 || encoded.length > 1024 || !/^[A-Za-z0-9_-]+$/.test(encoded)) return context;
+				const base64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
+				const payload = record(JSON.parse(globalThis.atob(base64.padEnd(Math.ceil(base64.length / 4) * 4, "="))));
+				if (payload.version !== 1) return context;
+				const viewer = positiveId(payload.viewerUserId);
+				const target = positiveId(payload.targetUserId);
+				if (viewer !== void 0) context.referenceViewerUserId = viewer;
+				if (target !== void 0) context.referenceTargetUserId = target;
+			} catch {}
+			return context;
+		}
+		function avatarScopeDiagnostic(scopeKey) {
+			const match = /^(prod|test):([1-9][0-9]*)$/.exec(scopeKey ?? "");
+			const viewerUserId = positiveId(Number(match?.[2]));
+			return match === null || viewerUserId === void 0 ? {} : {
+				environment: match[1],
+				viewerUserId
+			};
+		}
+		function safeErrorCode(value) {
+			return typeof value === "string" && /^(?:(?:arkme|image|auth-http|local|profile)-[A-Za-z0-9_-]{1,80}|UND_ERR_[A-Z_]{1,64}|E[A-Z_]{1,64})$/.test(value) ? value : void 0;
+		}
+		function httpStatus(value) {
+			return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599 ? value : void 0;
+		}
+		function imageDownloadStatus(error) {
+			if (error.name !== "ArkmePluginError" || error.code !== "image-download-failed" || typeof error.message !== "string") return void 0;
+			const match = /^Arkme 图片读取返回 HTTP ([1-5][0-9]{2})$/.exec(error.message);
+			return match === null ? void 0 : httpStatus(Number(match[1]));
+		}
+		function logArkmeAvatarDiagnostic(event, context, error) {
+			try {
+				const source = record(error);
+				const body = record(source.body);
+				const detail = source.name === "ArkmeClientError" ? body : source;
+				const errorName = [
+					"Error",
+					"TypeError",
+					"AbortError",
+					"TimeoutError",
+					"ArkmePluginError",
+					"ArkmeClientError"
+				].includes(String(source.name)) ? String(source.name) : "unknown";
+				console.warn(`[ArkmeAvatarDiag] ${JSON.stringify({
+					timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+					event,
+					...context,
+					...error === void 0 ? {} : { error: {
+						name: errorName,
+						code: safeErrorCode(detail.code),
+						retryable: typeof detail.retryable === "boolean" ? detail.retryable : void 0,
+						httpStatus: httpStatus(source.httpStatus),
+						upstreamStatus: httpStatus(source.upstreamStatus) ?? imageDownloadStatus(source),
+						causeCode: safeErrorCode(record(source.cause).code)
+					} }
+				})}`);
+			} catch {}
+		}
+		//#endregion
 		//#region src/client/avatar-image-runtime.ts
 		const arkmeAvatarImages = new InMemoryArkmeAvatarImageStore({
+			persistentCache: new BrowserAvatarPersistentCache(),
+			cachedReader: async (imageRef) => {
+				try {
+					return await callArkme("image.read", {
+						imageRef,
+						cacheOnly: true
+					});
+				} catch (error) {
+					if (error instanceof ArkmeClientError && error.body.code === "image-cache-miss") return void 0;
+					throw error;
+				}
+			},
 			reader: async (imageRef) => await callArkme("image.read", { imageRef }),
 			onLoadFailure: ({ imageRef, scopeKey, error, ...context }) => {
 				logArkmeAvatarDiagnostic("image_load_failed", {
@@ -55526,6 +55674,54 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			return stop;
 		}
 		//#endregion
+		//#region src/reaction-diagnostics.ts
+		/** Timing metadata only: no credentials, message refs, names or message bodies. */
+		function reactionTraceId(value) {
+			return value && /^[a-f0-9-]{36}$/.test(value) ? value : globalThis.crypto.randomUUID();
+		}
+		function logReactionTiming(traceId, stage, started, detail = {}) {
+			console.info(`[ArkmeReactionTiming] ${JSON.stringify({
+				traceId,
+				stage,
+				at: Date.now(),
+				durationMs: Math.round((performance.now() - started) * 100) / 100,
+				...detail
+			})}`);
+		}
+		//#endregion
+		//#region src/client/reaction-transport.ts
+		const timings = /* @__PURE__ */ new WeakMap();
+		function traceReactionApplied(value, stage) {
+			const timing = timings.get(value);
+			if (timing) logReactionTiming(timing.traceId, stage, timing.started);
+		}
+		async function callReaction(input, signal) {
+			let diagnostics = false;
+			try {
+				diagnostics = globalThis.sessionStorage?.getItem("arkme.reaction.diagnostics") === "1";
+			} catch {}
+			if (!diagnostics) return await callArkme("reactions", input, signal);
+			const traceId = reactionTraceId(input.traceId), started = performance.now();
+			let ok = false;
+			try {
+				const value = await callArkme("reactions", {
+					...input,
+					traceId
+				}, signal);
+				ok = true;
+				if (diagnostics && value && typeof value === "object") timings.set(value, {
+					traceId,
+					started
+				});
+				return value;
+			} finally {
+				if (diagnostics) logReactionTiming(traceId, "browser-request", started, {
+					action: input.action,
+					ok
+				});
+			}
+		}
+		//#endregion
 		//#region src/client/reaction-label-content.ts
 		const reactionHandIds = [
 			"ok_hand",
@@ -55778,10 +55974,12 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			targets = /* @__PURE__ */ new Map();
 			states = /* @__PURE__ */ new Map();
 			inactive = /* @__PURE__ */ new Set();
+			actorRefreshAt = /* @__PURE__ */ new Map();
 			knownTargets = /* @__PURE__ */ new Map();
 			failures = /* @__PURE__ */ new Map();
 			listeners = /* @__PURE__ */ new Set();
 			revision = 0;
+			reading;
 			refreshing;
 			timer;
 			timerDue = 0;
@@ -55789,7 +55987,7 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			retryMillis = 2e3;
 			pending;
 			writing = false;
-			constructor(transport = (input, signal) => callArkme("reactions", input, signal)) {
+			constructor(transport = callReaction) {
 				this.transport = transport;
 			}
 			subscribe = (listener) => {
@@ -55811,6 +56009,7 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 				this.targets.clear();
 				this.states.clear();
 				this.inactive.clear();
+				this.actorRefreshAt.clear();
 				this.knownTargets.clear();
 				this.failures.clear();
 				this.pending = void 0;
@@ -55823,6 +56022,11 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			}
 			watch(scope, target) {
 				if (scope !== this.scope) return () => {};
+				const resolver = target.resolveActor ?? this.knownTargets.get(target.id)?.resolveActor;
+				if (resolver) target = {
+					...target,
+					resolveActor: resolver
+				};
 				const existing = this.targets.get(target.id);
 				if (!existing && this.targets.size >= 200) {
 					this.failures.set(target.id, "请打开消息后刷新表态");
@@ -55851,6 +56055,8 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 						this.failures.delete(target.id);
 						this.retainInactive(target.id);
 					}
+					const reading = this.reading;
+					if (reading && ![...reading.entries].some(([id, entry]) => this.targets.get(id) === entry)) reading.controller.abort();
 					if (!this.targets.size) this.stop();
 				};
 			}
@@ -55862,6 +56068,7 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 					const oldest = this.inactive.values().next().value;
 					this.inactive.delete(oldest);
 					this.states.delete(oldest);
+					this.actorRefreshAt.delete(oldest);
 					this.knownTargets.delete(oldest);
 					this.failures.delete(oldest);
 				}
@@ -55884,9 +56091,20 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 					await this.refresh();
 					if (active && !signal.aborted && scope === this.scope && (alreadyReading || missing.some((target) => !this.states.has(target.id) && !this.failures.has(target.id)))) await this.refresh();
 				};
+				let unsubscribe = () => {};
+				const factsReady = new Promise((resolve) => {
+					unsubscribe = this.subscribe(() => {
+						if (missing.every((target) => this.states.has(target.id) || this.failures.has(target.id))) resolve();
+					});
+				});
 				try {
-					await Promise.race([load(), deadline]);
+					await Promise.race([
+						load(),
+						deadline,
+						factsReady
+					]);
 				} finally {
+					unsubscribe();
 					active = false;
 					clearTimeout(timer);
 					signal.removeEventListener("abort", finish);
@@ -55947,11 +56165,17 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			}
 			async refresh() {
 				if (this.refreshing) return this.refreshing;
-				const scope = this.scope, signal = this.controller.signal;
+				const scope = this.scope;
 				if (!scope) return;
+				const controller = new AbortController(), entries = new Map(this.targets);
+				const reading = {
+					controller,
+					entries
+				};
+				this.reading = reading;
+				const signal = AbortSignal.any([this.controller.signal, controller.signal]);
 				const operation = (async () => {
 					let failed = false;
-					const entries = new Map(this.targets);
 					const targets = [...entries.values()].map((item) => item.target);
 					for (let offset = 0; offset < targets.length; offset += 50) {
 						const batch = targets.slice(offset, offset + 50);
@@ -55960,7 +56184,8 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 							const page = await this.transport({
 								action: "query",
 								accountKey: scope,
-								targets: batch
+								targets: batch,
+								actorPresentation: "deferred"
 							}, signal);
 							if (signal.aborted) return;
 							const returned = new Set(page.items.map((item) => item.target_id));
@@ -55973,8 +56198,25 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 							}
 							for (const item of page.items) if (entries.has(item.target_id) && this.targets.get(item.target_id) === entries.get(item.target_id)) {
 								const previous = this.states.get(item.target_id);
-								if (!previous || previous.mine.revision <= item.mine.revision) this.states.set(item.target_id, item);
+								if (!previous || previous.mine.revision <= item.mine.revision) {
+									const known = new Map((Date.now() - (this.actorRefreshAt.get(item.target_id) ?? 0) < 6e4 ? previous?.groups : void 0)?.flatMap((group) => group.actors ?? []).filter((actor) => !actor.presentationPending).map((actor) => [actor.userId, actor]));
+									const resolve = this.targets.get(item.target_id)?.target.resolveActor;
+									this.states.set(item.target_id, {
+										...item,
+										groups: item.groups.map((group) => ({
+											...group,
+											actors: (group.actors ?? []).map((actor) => resolve?.(actor) ?? (actor.presentationPending && known.has(actor.userId) ? {
+												...actor,
+												...known.get(actor.userId),
+												...actor.memberRef ? { memberRef: actor.memberRef } : {},
+												presentationPending: false
+											} : actor))
+										}))
+									});
+								}
 							}
+							if (before !== JSON.stringify(batch.map((t) => [this.states.get(t.id), this.failures.get(t.id)]))) this.publish();
+							traceReactionApplied(page, "browser-facts-published");
 						} catch (error) {
 							if (signal.aborted) return;
 							failed = true;
@@ -55983,7 +56225,52 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 								this.failures.set(target.id, error instanceof Error ? error.message : "表态加载失败");
 							}
 						}
-						if (!signal.aborted && before !== JSON.stringify(batch.map((t) => [this.states.get(t.id), this.failures.get(t.id)]))) this.publish();
+						if (failed && !signal.aborted && before !== JSON.stringify(batch.map((t) => [this.states.get(t.id), this.failures.get(t.id)]))) this.publish();
+						const missing = batch.filter((target) => this.states.get(target.id)?.groups.some((group) => group.actors?.some((actor) => actor.presentationPending)));
+						if (missing.length && !signal.aborted) {
+							const initial = new Map(missing.map((target) => [target.id, this.states.get(target.id)]));
+							try {
+								const enriched = await this.transport({
+									action: "query",
+									accountKey: scope,
+									targets: missing
+								}, signal);
+								if (signal.aborted) return;
+								for (const item of enriched.items) {
+									const current = this.states.get(item.target_id);
+									if (!current || current !== initial.get(item.target_id) || this.targets.get(item.target_id) !== entries.get(item.target_id)) continue;
+									this.actorRefreshAt.set(item.target_id, Date.now());
+									if (!item.actors_visible) {
+										this.states.set(item.target_id, {
+											...current,
+											actors_visible: false,
+											private: item.private,
+											groups: current.groups.map((group) => ({
+												...group,
+												actors: []
+											}))
+										});
+										continue;
+									}
+									const actors = new Map(item.groups.flatMap((group) => group.actors ?? []).map((actor) => [actor.userId, actor]));
+									const resolve = this.targets.get(item.target_id)?.target.resolveActor;
+									this.states.set(item.target_id, {
+										...current,
+										groups: current.groups.map((group) => ({
+											...group,
+											actors: (group.actors ?? []).map((actor) => resolve?.(actor) ?? (actor.presentationPending && actors.has(actor.userId) ? {
+												...actor,
+												...actors.get(actor.userId),
+												...actor.memberRef ? { memberRef: actor.memberRef } : {},
+												presentationPending: false
+											} : actor))
+										}))
+									});
+								}
+								this.publish();
+								traceReactionApplied(enriched, "browser-actors-published");
+							} catch {}
+						}
 					}
 					if (!signal.aborted) this.retryMillis = failed ? Math.min(12e4, this.retryMillis * 2) : 2e3;
 				})();
@@ -55991,6 +56278,7 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 				try {
 					await operation;
 				} finally {
+					if (this.reading === reading) this.reading = void 0;
 					if (this.refreshing === operation) {
 						this.refreshing = void 0;
 						if (this.refreshAgain) {
@@ -56158,7 +56446,7 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 			users = 0;
 			error = "";
 			hasMore = false;
-			constructor(transport = (input, signal) => callArkme("reactions", input, signal)) {
+			constructor(transport = callReaction) {
 				this.transport = transport;
 			}
 			subscribe = (fn) => {
@@ -56279,6 +56567,7 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 								limit: 50
 							}, signal);
 							if (signal.aborted) return;
+							traceReactionApplied(page, "browser-notifications-received");
 							rows.push(...page.items);
 							hasMore = page.has_more;
 							if (!page.has_more) break;
@@ -57947,29 +58236,29 @@ body[data-ds-dark-theme] .arkme-bot-identity {
 				this.timer = void 0;
 			}
 		};
-		const caches = /* @__PURE__ */ new Map();
+		const caches$1 = /* @__PURE__ */ new Map();
 		function activateSelfTopicDirectoryAccount(account) {
-			for (const [key, cache] of caches) {
+			for (const [key, cache] of caches$1) {
 				if (key === account) continue;
 				cache.dispose();
-				caches.delete(key);
+				caches$1.delete(key);
 			}
 		}
 		function selfTopicDirectory(userId, environment) {
 			const key = `${environment}:${String(userId)}`;
-			let cache = caches.get(key);
+			let cache = caches$1.get(key);
 			if (!cache) {
 				cache = new SelfTopicDirectoryCache(userId, environment);
-				caches.set(key, cache);
+				caches$1.set(key, cache);
 			}
 			return cache;
 		}
 		function invalidateSelfTopicDirectories(hard = false) {
-			for (const cache of caches.values()) cache.invalidate(hard);
+			for (const cache of caches$1.values()) cache.invalidate(hard);
 		}
 		function resetSelfTopicDirectories() {
-			for (const cache of caches.values()) cache.dispose();
-			caches.clear();
+			for (const cache of caches$1.values()) cache.dispose();
+			caches$1.clear();
 		}
 		//#endregion
 		//#region src/client/provider-instance-runtime.ts
@@ -118596,7 +118885,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 										displayName: actorGroupNickname?.trim() || actorName,
 										...actorGroupNickname ? { groupNickname: actorGroupNickname } : {},
 										...actorAvatarRef ? { avatarRef: actorAvatarRef } : {}
-									} : actor;
+									} : target.resolveActor?.(actor) ?? actor;
 									const name = identity.displayName;
 									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [index > 0 && "、", /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 										type: "button",
@@ -120961,14 +121250,17 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 				scope,
 				roles: [],
 				loading: true,
+				loaded: false,
 				error: ""
 			});
 			const visibleState = roleState.scope === scope ? roleState : {
 				scope,
 				roles: [],
 				loading: true,
+				loaded: false,
 				error: ""
 			};
+			const initialLoading = visibleState.loading && !visibleState.loaded;
 			const [refreshRevision, setRefreshRevision] = (0, react$1.useState)(0);
 			(0, react$1.useEffect)(() => {
 				if (typeof window === "undefined") return;
@@ -120986,6 +121278,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 			const [saving, setSaving] = (0, react$1.useState)(false);
 			const [formError, setFormError] = (0, react$1.useState)("");
 			const fileInputRef = (0, react$1.useRef)(null);
+			const listControllerRef = (0, react$1.useRef)();
 			const saveControllerRef = (0, react$1.useRef)();
 			(0, react$1.useEffect)(() => {
 				setMenuOpen(false);
@@ -121004,31 +121297,37 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 			}, [scope]);
 			(0, react$1.useEffect)(() => {
 				const controller = new AbortController();
-				setRoleState({
+				listControllerRef.current = controller;
+				setRoleState((current) => ({
 					scope,
-					roles: roleState.scope === scope ? roleState.roles : [],
+					roles: current.scope === scope ? current.roles : [],
+					loaded: current.scope === scope && current.loaded,
 					loading: true,
 					error: ""
-				});
+				}));
 				callArkme("self-roles.list", { expectedUserId: userId }, controller.signal).then((roles) => {
 					if (controller.signal.aborted || scopeRef.current !== scope) return;
 					setRoleState({
 						scope,
 						roles,
 						loading: false,
+						loaded: true,
 						error: ""
 					});
+					for (const ref of new Set(roles.map((role) => role.avatarRef?.trim()).filter((ref) => !!ref))) arkmeAvatarImages.load(ref).catch(() => void 0);
 				}).catch((caught) => {
 					if (controller.signal.aborted || scopeRef.current !== scope) return;
 					setRoleState((current) => ({
 						scope,
 						roles: current.scope === scope ? current.roles : [],
+						loaded: current.scope === scope && current.loaded,
 						loading: false,
 						error: caught instanceof Error ? caught.message : "角色加载失败，请重试"
 					}));
 				});
 				return () => {
 					controller.abort();
+					if (listControllerRef.current === controller) listControllerRef.current = void 0;
 				};
 			}, [
 				scope,
@@ -121071,7 +121370,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 			const createRole = async (event) => {
 				event.preventDefault();
 				const roleName = name.trim();
-				if (disabled || saveControllerRef.current !== void 0 || visibleState.loading || visibleState.error !== "" || editingRole === void 0 && visibleState.roles.length >= MAX_ROLES || !roleName || Array.from(roleName).length > MAX_NAME_LENGTH) return;
+				if (disabled || saveControllerRef.current !== void 0 || initialLoading || visibleState.error !== "" || editingRole === void 0 && visibleState.roles.length >= MAX_ROLES || !roleName || Array.from(roleName).length > MAX_NAME_LENGTH) return;
 				const controller = new AbortController();
 				saveControllerRef.current = controller;
 				const submittingScope = scope;
@@ -121087,8 +121386,12 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 						...avatarRef === void 0 ? {} : { avatarRef }
 					}, controller.signal);
 					if (controller.signal.aborted || scopeRef.current !== submittingScope) return;
+					listControllerRef.current?.abort();
 					setRoleState((current) => current.scope === submittingScope ? {
 						...current,
+						loading: false,
+						loaded: true,
+						error: "",
 						roles: [...current.roles.filter((role) => role.roleId !== created.roleId), created]
 					} : current);
 					setCreateOpen(false);
@@ -121120,7 +121423,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 					event.stopPropagation();
 				},
 				onClick: () => {
-					if (!menuOpen) setRefreshRevision((value) => value + 1);
+					if (!menuOpen && !visibleState.loading) setRefreshRevision((value) => value + 1);
 					setMenuOpen((value) => !value);
 				},
 				children: [
@@ -121168,8 +121471,12 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 					roleId: role.roleId
 				}).then(() => {
 					if (scopeRef.current !== scope) return;
+					listControllerRef.current?.abort();
 					setRoleState((current) => current.scope === scope ? {
 						...current,
+						loading: false,
+						loaded: true,
+						error: "",
 						roles: current.roles.filter((item) => item.roleId !== role.roleId)
 					} : current);
 					setRefreshRevision((value) => value + 1);
@@ -121219,7 +121526,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 						onSelect: () => deleteRole(role)
 					}]
 				})),
-				...visibleState.loading ? [{
+				...initialLoading ? [{
 					type: "label",
 					id: "role-loading",
 					text: "正在加载角色…"
@@ -121242,7 +121549,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 				{
 					id: "role-create",
 					label: "＋ 创建角色",
-					disabled: visibleState.loading || visibleState.error !== "" || visibleState.roles.length >= MAX_ROLES,
+					disabled: initialLoading || visibleState.error !== "" || visibleState.roles.length >= MAX_ROLES,
 					onSelect: () => {
 						setMenuOpen(false);
 						setEditingRole(void 0);
@@ -212533,7 +212840,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 		const c$3 = e$20;
 		//#endregion
 		//#region package.json
-		var version = "0.1.85";
+		var version = "0.1.86";
 		//#endregion
 		//#region src/client/arkme-membership.ts
 		function membershipLabel(state) {
@@ -234417,7 +234724,6 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 						return result;
 					}, { signal }), controller.signal);
 					page = refreshWindow === void 0 ? await readPage(cursor) : await readConversationTimelineWindow(refreshWindow, readPage, controller.signal);
-					if (refreshWindow === void 0 && intent !== "return-to-latest") await prepareTimelineReactions(page.items, controller.signal);
 				} catch (caught) {
 					if (isArkmeRequestAbort(caught, controller.signal)) return;
 					throw caught;
@@ -234510,7 +234816,6 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 				acknowledgeRead,
 				confirmedSendRetention,
 				interwovenMoments,
-				prepareTimelineReactions,
 				source,
 				sourceIsChat,
 				sourceProjectionRevision
@@ -236422,6 +236727,43 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 				return projected.isMuted === true;
 			}, [updateSourceProjection]);
 			const conversationMemberByRef = (0, react$1.useMemo)(() => new Map(conversationMembers.map((member) => [member.memberRef, member])), [conversationMembers]);
+			const localReactionActors = (0, react$1.useMemo)(() => {
+				const names = /* @__PURE__ */ new Map();
+				for (const item of items) if (item.memberRef && !item.selfRole && item.senderKind !== "bot") names.set(item.memberRef, {
+					displayName: arkmeTimelineSenderName(item, selfProfile),
+					...item.avatarRef ? { avatarRef: item.avatarRef } : {}
+				});
+				for (const member of conversationMembers) if (member.status === "active" && member.displayName.trim() && member.displayName !== "群成员") names.set(member.memberRef, {
+					displayName: member.displayName,
+					...member.avatarRef ? { avatarRef: member.avatarRef } : {}
+				});
+				return names;
+			}, [
+				items,
+				selfProfile,
+				conversationMembers
+			]);
+			const resolveReactionActor = (0, react$1.useCallback)((actor) => {
+				const self = conversationMembers.find((member) => member.isSelf);
+				const local = actor.userId === authenticatedUserId ? {
+					displayName: (source?.kind === "group_chat" ? self?.memberName : void 0) || selfProfile?.displayName || selfProfile?.nickname || "我",
+					...selfProfile?.avatarRef ? { avatarRef: selfProfile.avatarRef } : {}
+				} : source?.kind === "private_chat" && actor.userId === source.peerUserId ? {
+					displayName: source.displayName,
+					...source.avatarRef ? { avatarRef: source.avatarRef } : {}
+				} : actor.memberRef ? localReactionActors.get(actor.memberRef) : void 0;
+				return local ? {
+					...actor,
+					...local,
+					presentationPending: false
+				} : void 0;
+			}, [
+				authenticatedUserId,
+				source,
+				selfProfile,
+				conversationMembers,
+				localReactionActors
+			]);
 			const composerMentionsEnabled = source?.kind === "group_chat" || source?.kind === "private_chat";
 			const mentionCandidates = (0, react$1.useMemo)(() => {
 				if (!composerMentionsEnabled || mentionTrigger === void 0) return [];
@@ -238971,6 +239313,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 									},
 									children: [!isSharedRecordingCard && !isExtensionMessage && messageHeader, (() => {
 										const reactionTarget = {
+											resolveActor: resolveReactionActor,
 											sourceKey: source.sourceKey,
 											itemUid: item.itemUid,
 											id: `${conversationKey}:${arkmeTimelineOccurrenceKey(item)}`,
@@ -239215,6 +239558,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 				selfProfile,
 				selfConversationMember,
 				conversationMemberByRef,
+				resolveReactionActor,
 				activeSelectMode,
 				archiveReadOnly,
 				authenticatedAccountKey,
@@ -241885,7 +242229,7 @@ registerProcessor('arkme-pcm-journal', ArkmePcmJournal);
 							};
 						});
 						const foreground = arkmeRealtimeTimelineDeliveryAllowed(browserDocument?.visibilityState, browserDocument?.hasFocus?.() ?? true);
-						if (foreground && timelineUpdates.length > 0) arkmeChatTimelineDelta.publish(timelineUpdates);
+						if (timelineUpdates.length > 0) arkmeChatTimelineDelta.publish(timelineUpdates);
 						for (const dateStamp of arkmeChatDeltaCalendarDateStamps(update)) arkmeCalendarInvalidations.publish({ dateStamp });
 						if (foreground && arkmeSelectedBotAffectedByChatDelta(arkmeUi.getSnapshot().selectedBot, update)) arkmeUi.chatChanged();
 						for (const sourceKey of arkmeChatDeltaSourceKeys(update)) arkmeInterwovenInvalidation.invalidate(sourceKey);