Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(files): 为手机网页预览与视频播放补充诊断日志 (#5065)
Lizif5d296df4901
diff --git a/apps/desktop/src/main/device-link/__tests__/mediaFetch.test.ts b/apps/desktop/src/main/device-link/__tests__/mediaFetch.test.tsindex c80735aaf9..07f411e5af 100644--- a/apps/desktop/src/main/device-link/__tests__/mediaFetch.test.ts+++ b/apps/desktop/src/main/device-link/__tests__/mediaFetch.test.ts@@ -24,8 +24,9 @@ vi.mock('../../file-browser/ssh-media.js', () => ({ materializeSshRemoteMedia })const getSessionFsSnapshot = vi.hoisted(() => vi.fn());vi.mock('../../localDb/ipc/sessions.js', () => ({ getSessionFsSnapshot }));+const logDebug = vi.hoisted(() => vi.fn());vi.mock('../../logger.js', () => ({- createLogger: () => ({ info: vi.fn(), debug: vi.fn(), warn: vi.fn(), error: vi.fn() }),+ createLogger: () => ({ info: vi.fn(), debug: logDebug, warn: vi.fn(), error: vi.fn() }),}));const statMock = vi.hoisted(() => vi.fn());@@ -147,6 +148,7 @@ describe('fetchLocalMediaToOss — scheme 路由', () => {}expect(uploadLocalFile).not.toHaveBeenCalled();expect(close).toHaveBeenCalledOnce();+ expect(logDebug.mock.calls.flat().join('\n')).not.toMatch(/xdt-|path=|\/cache\//);},);it('xdt-image:// → imageCacheStore.resolveSafe,mime 透传给上传', async () => {diff --git a/apps/desktop/src/main/device-link/filePeer.ts b/apps/desktop/src/main/device-link/filePeer.tsindex 0aadd4bf10..2923e7473c 100644--- a/apps/desktop/src/main/device-link/filePeer.ts+++ b/apps/desktop/src/main/device-link/filePeer.ts@@ -12,6 +12,7 @@ import {parseFilePeerRequest,parseFilePeerFile,type FilePeerFile,+ type FilePeerRequest,} from '@cindy/device-link';import { FILE_PEER_LOCAL, type FilePeerCommand } from '../../shared/filePeer';import { DesktopCaptureWindow } from '../remote-desktop/captureWindow';@@ -19,6 +20,13 @@ import { loadDesktopIceServers } from '../remote-desktop/iceConfig';import { resolveAuthorizedMedia } from './mediaFetch';import { readDeviceLinkSettings } from './settings-store';import { captureDataOwnerBroadcastScope, isDataOwnerBroadcastScopeCurrent } from './broadcast-tap';+import { createLogger } from '../logger.js';++// Local-only diagnostics (scope is not upload-allowlisted): stages, sizes and timings, never paths.+const log = createLogger('device-link:filePeer');+const short = (id: string | undefined) => (id ?? '?').slice(0, 8);+const errorText = (error: unknown) =>+ (error instanceof Error ? error.message : String(error)).slice(0, 200);type Owner = ReturnType<typeof captureDataOwnerBroadcastScope>;interface Connection {@@ -35,6 +43,7 @@ interface Source {mtime: number;offset: number;busy: boolean;+ openedAt: number;}interface Sink {connection: string;@@ -73,24 +82,31 @@ function touch(id: string) {c.incoming &&(!settings.remoteControlEnabled || settings.revokedControllers.includes(c.peer))) {- stopConnection(id);+ stopConnection(id, 'revoked');throw new Error('FILE_PEER_REVOKED');}clearTimeout(c.timer);- c.timer = setTimeout(() => stopConnection(id), FILE_PEER_IDLE_MS);+ c.timer = setTimeout(() => stopConnection(id, 'idle'), FILE_PEER_IDLE_MS);c.timer.unref();return c;}function track(id: string, peer: string, incoming: boolean) {if (connections.size >= 4) throw new Error('FILE_PEER_BUSY');- const timer = setTimeout(() => stopConnection(id), FILE_PEER_IDLE_MS);+ const timer = setTimeout(() => stopConnection(id, 'idle'), FILE_PEER_IDLE_MS);timer.unref();connections.set(id, { peer, incoming, owner: captureDataOwnerBroadcastScope(), timer });}-function stopConnection(id: string) {+function stopConnection(id: string, reason: string) {const c = connections.get(id);if (!c) return;connections.delete(id);+ const unfinished = [...sources.values()].filter((s) => s.connection === id && s.offset < s.size);+ const detail = `conn=${short(id)} peer=${short(c.peer)} incoming=${c.incoming} reason=${reason}`;+ if (unfinished.length)+ log.warn(+ `closed with unfinished send ${detail} sent=${unfinished.map((s) => `${s.offset}/${s.size}B`).join(',')}`,+ );+ else log.debug(`closed ${detail}`);clearTimeout(c.timer);const out = outgoing.get(c.peer);if (out?.id === id) {@@ -128,7 +144,7 @@ function stopConnection(id: string) {}}export function stopFilePeers(peer?: string) {- for (const [id, c] of connections) if (!peer || peer === c.peer) stopConnection(id);+ for (const [id, c] of connections) if (!peer || peer === c.peer) stopConnection(id, 'stop');}async function prepareHost(connection: string): Promise<void> {touch(connection);@@ -148,7 +164,8 @@ async function command(c: FilePeerCommand): Promise<string | undefined> {const timer = setTimeout(() => {replies.delete(id);- stopConnection(c.connection);+ log.warn(`host ${c.action} timed out conn=${short(c.connection)}`);+ stopConnection(c.connection, `${c.action}-timeout`);reject(new Error('FILE_PEER_TIMEOUT'));},c.action === 'receive' ? 60_000 : 15_000,@@ -160,7 +177,31 @@ async function command(c: FilePeerCommand): Promise<string | undefined> {}export async function requestFilePeer(peer: string, value: unknown): Promise<unknown> {- const r = parseFilePeerRequest(value);+ const startedAt = Date.now();+ let action = 'invalid';+ try {+ const r = parseFilePeerRequest(value);+ action = r.action;+ const result = await handleFilePeerRequest(peer, r);+ const opened = r.action === 'open' ? (result as { size?: number; mimeType?: string }) : null;+ const connection =+ r.action === 'offer' ? (result as { connection?: string }).connection : 'connection' in r ? r.connection : undefined;+ log.debug(+ `request ${action} ok peer=${short(peer)} ms=${Date.now() - startedAt}` ++ (connection ? ` conn=${short(connection)}` : '') ++ (opened ? ` size=${opened.size} mime=${opened.mimeType}` : ''),+ );+ return result;+ } catch (error) {+ log.warn(`request ${action} failed peer=${short(peer)} ms=${Date.now() - startedAt} error=${errorText(error)}`);+ throw error;+ }+}++async function handleFilePeerRequest(+ peer: string,+ r: FilePeerRequest,+): Promise<unknown> {if (r.action === 'caps') return { version: 1, maxBytes: FILE_PEER_MAX_BYTES };if (r.action === 'offer') {const id = randomUUID();@@ -168,7 +209,9 @@ export async function requestFilePeer(peer: string, value: unknown): Promise<unktry {// Cold host readiness and TURN configuration share the outer 30s RPC// budget: max(10s, 8s) + 15s command leaves transport headroom.+ const readyStartedAt = Date.now();const [, servers] = await Promise.all([prepareHost(id), loadDesktopIceServers()]);+ log.debug(`offer host ready conn=${short(id)} ms=${Date.now() - readyStartedAt} iceServers=${servers.length}`);const sdp = await command({action: 'accept',connection: id,@@ -177,14 +220,14 @@ export async function requestFilePeer(peer: string, value: unknown): Promise<unk});return { connection: id, sdp };} catch (error) {- stopConnection(id);+ stopConnection(id, 'offer-failed');throw error;}}const c = touch(r.connection);if (!c.incoming || c.peer !== peer) throw new Error('FILE_PEER_DENIED');if (r.action === 'close') {- stopConnection(r.connection);+ stopConnection(r.connection, 'peer-close');return { ok: true };}if (c.opening || [...sources.values()].some((s) => s.connection === r.connection))@@ -196,7 +239,7 @@ export async function requestFilePeer(peer: string, value: unknown): Promise<unkresolveAuthorizedMedia({ url: r.url }, FILE_PEER_MAX_BYTES),new Promise<never>((_, reject) => {deadline = setTimeout(() => {- stopConnection(r.connection);+ stopConnection(r.connection, 'open-timeout');reject(new Error('FILE_PEER_TIMEOUT'));}, 20_000);deadline.unref();@@ -237,6 +280,7 @@ export async function requestFilePeer(peer: string, value: unknown): Promise<unkmtime: stat.mtimeMs,offset: 0,busy: false,+ openedAt: Date.now(),});return { ticket, size: stat.size, mimeType };} catch (error) {@@ -297,10 +341,12 @@ export function registerFilePeerIpc() {if (!bytes.length) {sources.delete(ticket);await s.file.close();+ log.debug(`send done conn=${short(connection)} size=${s.size} ms=${Date.now() - s.openedAt}`);}return bytes.toString('base64');} catch (error) {- stopConnection(connection);+ log.warn(`send failed conn=${short(connection)} sent=${s.offset}/${s.size}B error=${errorText(error)}`);+ stopConnection(connection, 'read-failed');throw error;} finally {s.busy = false;@@ -375,7 +421,7 @@ async function receivePeerFile(peer: string, url: string, invoke: Invoke, signallet remote = out.remote,directory: string | undefined,complete = false;- const cancel = () => stopConnection(id);+ const cancel = () => stopConnection(id, 'aborted');try {signal?.addEventListener('abort', cancel, { once: true });if (!remote) {@@ -457,7 +503,7 @@ async function receivePeerFile(peer: string, url: string, invoke: Invoke, signalsignal?.removeEventListener('abort', cancel);out.busy = false;if (!complete) {- stopConnection(id);+ stopConnection(id, 'incomplete');if (outgoing.get(peer) === out) outgoing.delete(peer);if (remote && isDataOwnerBroadcastScopeCurrent(owner))void invoke(peer, FILE_PEER_CHANNEL, [{ action: 'close', connection: remote }]).catch(diff --git a/apps/desktop/src/main/device-link/mediaFetch.ts b/apps/desktop/src/main/device-link/mediaFetch.tsindex 64384de09e..6f28fb6ae9 100644--- a/apps/desktop/src/main/device-link/mediaFetch.ts+++ b/apps/desktop/src/main/device-link/mediaFetch.ts@@ -441,7 +441,10 @@ export async function fetchLocalMediaToOss(arg: unknown): Promise<MediaFetchResumimeType ??mimeOf((uploadExtHint ?? path.extname(absPath)).replace(/^\./, '').toLowerCase()),};- if (before.size > FILE_INLINE_MAX_BYTES) return { ...result, transferRequired: true };+ if (before.size > FILE_INLINE_MAX_BYTES) {+ log.debug(`media:fetch prepare → transfer size=${before.size} mime=${result.mimeType}`);+ return { ...result, transferRequired: true };+ }// Bounded read: a growing file cannot allocate an unbounded relay response.const bytes = Buffer.alloc(before.size);let offset = 0;@@ -453,6 +456,7 @@ export async function fetchLocalMediaToOss(arg: unknown): Promise<MediaFetchResuconst after = await file.stat();if (after.size !== before.size || after.mtimeMs !== before.mtimeMs)throw new Error('REMOTE_FILE_CHANGED');+ log.debug(`media:fetch prepare → inline size=${before.size} mime=${result.mimeType}`);return { ...result, inlineBase64: bytes.toString('base64') };} finally {await file.close();diff --git a/apps/mobile/app/files/preview/[sessionId].tsx b/apps/mobile/app/files/preview/[sessionId].tsxindex 29b0621dc4..ed7f051436 100644--- a/apps/mobile/app/files/preview/[sessionId].tsx+++ b/apps/mobile/app/files/preview/[sessionId].tsx@@ -41,6 +41,8 @@ import { WebView } from 'react-native-webview';import type { WebViewNavigation } from 'react-native-webview/lib/WebViewTypes';import { Text } from '@/components/AppText';import { goBackGuarded } from '@/utils/backGuard';+import { errorText, resolvedUrlKind } from '@/debug/fileDiagnostics';+import { mobileDebugLog } from '@/debug/mobileDebugLog';import { useAuth } from '@/auth/AuthContext';import { DEVICE_LINK_API_BASE_URL } from '@/config/env';import { useDeviceLink } from '@/device-link/DeviceLinkContext';@@ -819,19 +821,27 @@ function AvPreviewPage({if (!active || requestedRef.current || !workdir) return undefined;requestedRef.current = true;let cancelled = false;+ const startedAt = Date.now();+ mobileDebugLog('debug', 'files', 'av preview fetch start', { kind, size: item.sizeBytes });setFailure(null);void exportToUrl(item.relPath, item.mtimeMs).then((next) => {+ mobileDebugLog('debug', 'files', 'av preview fetch done', {+ kind, ms: Date.now() - startedAt, source: resolvedUrlKind(next), left: cancelled,+ });if (!cancelled) setUrl(next);}).catch((err) => {+ mobileDebugLog(cancelled ? 'debug' : 'warn', 'files', 'av preview fetch failed', {+ kind, ms: Date.now() - startedAt, left: cancelled, error: errorText(err),+ });if (cancelled) return;setFailure(formatRemoteError(err));});return () => {cancelled = true;};- }, [active, exportToUrl, item.mtimeMs, item.relPath, requestEpoch, workdir]);+ }, [active, exportToUrl, item.mtimeMs, item.relPath, item.sizeBytes, kind, requestEpoch, workdir]);if (failure) {return <UnsupportedPage item={item} onDownload={onDownload} reason={t('files.preview.readFailed')}diff --git a/apps/mobile/src/__tests__/peerFileRegistry.test.ts b/apps/mobile/src/__tests__/peerFileRegistry.test.tsindex d0a778c261..239224752e 100644--- a/apps/mobile/src/__tests__/peerFileRegistry.test.ts+++ b/apps/mobile/src/__tests__/peerFileRegistry.test.ts@@ -69,6 +69,13 @@ describe("peer file staging ownership", () => {remove();expect(await tryMobilePeerFile("device", "url")).toBeNull();});+ it("forwards the read-level trace to the download provider", async () => {+ const peer = vi.fn(async () => null);+ const remove = installPeerFileDownload(peer);+ await tryMobilePeerFile("device", "url", undefined, 42);+ expect(peer).toHaveBeenCalledWith("device", "url", undefined, 42);+ remove();+ });});it("reserves space for a 2 GiB consumer copy before transfer, and rejects invalid sizes", () => {diff --git a/apps/mobile/src/debug/fileDiagnostics.test.ts b/apps/mobile/src/debug/fileDiagnostics.test.tsnew file mode 100644index 0000000000..bbc906d259--- /dev/null+++ b/apps/mobile/src/debug/fileDiagnostics.test.ts@@ -0,0 +1,45 @@+import { describe, expect, it } from "vitest";+import { errorText, mediaExtOf, nextFileTrace, resolvedUrlKind } from "./fileDiagnostics";++describe("file diagnostics", () => {+ it("keeps only the extension of a desktop media reference", () => {+ const url = `xdt-file://open?path=${encodeURIComponent("E:/Cindy/hhh/doc/im-watch-v12.HTML")}&baseDir=E%3A%2FCindy`;+ expect(mediaExtOf(url)).toBe("html");+ expect(mediaExtOf("xdt-file://open?path=%2Ftmp%2Fclip.mp4")).toBe("mp4");+ expect(mediaExtOf("xdt-file://open?path=%2Ftmp%2FREADME")).toBe("");+ expect(mediaExtOf("xdt-file://open?path=%E0%A4%A")).toBe("");+ });++ it("reports the scheme of a resolved URL without its address", () => {+ expect(resolvedUrlKind("https://oss.example.com/a.mp4?Signature=x")).toBe("https");+ expect(resolvedUrlKind("file:///var/mobile/cache/file")).toBe("file");+ expect(resolvedUrlKind("data:video/mp4;base64,AAAA")).toBe("data");+ expect(resolvedUrlKind("relative/path")).toBe("unknown");+ });++ it("produces distinct traces and bounded error text", () => {+ expect(nextFileTrace()).not.toBe(nextFileTrace());+ expect(errorText(new Error("FILE_PEER_CANCELLED"))).toBe("FILE_PEER_CANCELLED");+ expect(errorText("x".repeat(500))).toHaveLength(300);+ });++ it("strips paths and URLs from native, SSH and WebView failures", () => {+ expect(errorText(new Error("ENOENT: /data/user/0/com.cindy/cache/a.html"))).toBe(+ "ENOENT: [redacted-path]",+ );+ expect(errorText("failed file:///var/mobile/Containers/Data/Application/ABC/tmp/x.html")).toBe(+ "failed [redacted-url]",+ );+ expect(errorText("open E:\\Cindy\\secret\\file.html")).toBe("open [redacted-path]");+ expect(errorText("open \\\\server\\share\\secret.html")).toBe("open [redacted-path]");+ expect(errorText("open \\\\files.corp\\workdir\\doc.html")).toBe("open [redacted-path]");+ expect(errorText("ssh: /srv/secret/plot.png")).toBe("ssh: [redacted-path]");+ expect(errorText("https://oss.example.com/a.mp4?Signature=secret")).toBe("[redacted-url]");+ expect(+ errorText(+ 'Error Domain=NSURLErrorDomain Code=-1100 UserInfo={NSErrorFailingURLStringKey=file:///var/mobile/cache/x}',+ ),+ ).not.toMatch(/var\/mobile|file:\/\//);+ expect(errorText("")).toBe("");+ });+});diff --git a/apps/mobile/src/debug/fileDiagnostics.ts b/apps/mobile/src/debug/fileDiagnostics.tsnew file mode 100644index 0000000000..d9c90adf05--- /dev/null+++ b/apps/mobile/src/debug/fileDiagnostics.ts@@ -0,0 +1,63 @@+/**+ * Shared shape for the `files` debug scope (remote file preview / playback).+ * Records stages, routes, sizes and timings only: never file paths, signed URLs or file contents.+ */+let trace = 0;++const MAX_ERROR_TEXT = 300;++/** Correlates the stages of one remote read inside a single exported log. */+export function nextFileTrace(): number {+ trace = (trace + 1) % 1_000_000;+ return trace;+}++/** File extension of a desktop media reference (`xdt-file://open?path=…`), without the path itself. */+export function mediaExtOf(url: string): string {+ try {+ const match = /[?&]path=([^&#]*)/.exec(url);+ const path = match ? decodeURIComponent(match[1]) : url;+ return /\.([a-z0-9]{1,8})$/i.exec(path)?.[1]?.toLowerCase() ?? "";+ } catch {+ return "";+ }+}++/** Which transport produced a playable/renderable URL. */+export function resolvedUrlKind(url: string): string {+ const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(url)?.[1]?.toLowerCase();+ return scheme ?? "unknown";+}++/**+ * Bounded, path-free diagnostic text. Native / SSH / WebView failures often embed+ * absolute paths or signed URLs; those must not reach the `files` debug records.+ */+export function sanitizeDiagnosticText(value: string): string {+ if (!value) return "";+ const stripped = value+ .replace(/\b[a-z][a-z0-9+.-]*:\/\/[^\s<>"')]+/gi, "[redacted-url]")+ .replace(/\bdata:[^\s<>"')]+/gi, "[redacted-url]")+ .replace(+ /(?:[A-Za-z]:[\\/]|\\\\[^\s\\/<>"']+[\\/])[^\n<>"']*/g,+ "[redacted-path]",+ )+ .replace(+ /(^|[\s"'=(])(\/(?:Users|home|var|private|data|tmp|srv|mnt|opt|root|storage|sdcard|Applications)\/[^\n<>"']+)/g,+ "$1[redacted-path]",+ )+ .replace(+ /(^|[\s"'=(])(\/(?:[^/\s<>"')]+\/)+[^/\s<>"')]+)/g,+ "$1[redacted-path]",+ )+ .replace(/\s+/g, " ")+ .trim()+ .slice(0, MAX_ERROR_TEXT);+ return stripped;+}++export function errorText(error: unknown): string {+ if (error == null) return "";+ const raw = error instanceof Error ? error.message : String(error);+ return sanitizeDiagnosticText(raw);+}diff --git a/apps/mobile/src/debug/mobileDebugLog.ts b/apps/mobile/src/debug/mobileDebugLog.tsindex 29c80d4444..077215db6c 100644--- a/apps/mobile/src/debug/mobileDebugLog.ts+++ b/apps/mobile/src/debug/mobileDebugLog.ts@@ -5,7 +5,8 @@ export type MobileDebugScope =| "lifecycle"| "performance"| "scroll"- | "keyboard";+ | "keyboard"+ | "files";export type MobileDebugLevel = "debug" | "info" | "warn" | "error";type Sink = (level: MobileDebugLevel,diff --git a/apps/mobile/src/device-link/mobileMakerTransport.ts b/apps/mobile/src/device-link/mobileMakerTransport.tsindex 9905961338..ce2dbe4bb7 100644--- a/apps/mobile/src/device-link/mobileMakerTransport.ts+++ b/apps/mobile/src/device-link/mobileMakerTransport.ts@@ -38,7 +38,10 @@ import {createDeviceFileOperations,exportDeviceFile,assertFileReadActive,+ type DeviceFileResult,} from "@cindy/device-link";+import { errorText, mediaExtOf, nextFileTrace } from "@/debug/fileDiagnostics";+import { mobileDebugLog } from "@/debug/mobileDebugLog";import type {HistoryViewPage,HistoryDetailPage,@@ -906,28 +909,86 @@ export function createMobileMakerTransport({...(opts?.thumbnail ? { thumbnail: true } : {}),},]);- return readDeviceFile({- stream,- peerResultIsTransient: true,- isCurrent,- discard: (result) => {- const uri = peerMediaUri(result);- if (uri) releasePeerMedia(uri);- else if (- isMobileAuthOwnerCurrent(fileOwner) &&- typeof result.ossKey === "string" &&- result.ossKey.length > 0- )- opts?.onDiscardOssKey?.(result.ossKey);- },- signal: opts?.signal,- prepare: () => fetch(!opts?.thumbnail),- peer: (metadata) =>- metadata.size <= FILE_PEER_MAX_BYTES- ? tryMobilePeerFile(deviceId, url, opts?.signal)- : Promise.resolve(null),- fallback: fallback ?? (() => fetch(false)),+ // Chat thumbnails are high-volume and already covered by the list; trace full-file reads only.+ const trace = opts?.thumbnail ? 0 : nextFileTrace();+ const stage = <T>(+ name: string,+ run: () => Promise<T>,+ describe: (value: T) => Record<string, unknown>,+ ): Promise<T> => {+ if (!trace) return run();+ const startedAt = Date.now();+ return run().then(+ (value) => {+ mobileDebugLog("debug", "files", `remote read ${name}`, {+ trace,+ ms: Date.now() - startedAt,+ ...describe(value),+ });+ return value;+ },+ (error: unknown) => {+ mobileDebugLog("warn", "files", `remote read ${name} failed`, {+ trace,+ ms: Date.now() - startedAt,+ error: errorText(error),+ });+ throw error;+ },+ );+ };+ const describeResult = (result: DeviceFileResult) => ({+ size: result.size,+ mime: result.mimeType,+ transferRequired: result.transferRequired === true,+ inline: typeof result.inlineBase64 === "string",});+ if (trace)+ mobileDebugLog("debug", "files", "remote read start", {+ trace,+ ext: mediaExtOf(url),+ stream,+ });+ return stage(+ "result",+ () =>+ readDeviceFile({+ stream,+ peerResultIsTransient: true,+ isCurrent,+ discard: (result) => {+ const uri = peerMediaUri(result);+ if (uri) releasePeerMedia(uri);+ else if (+ isMobileAuthOwnerCurrent(fileOwner) &&+ typeof result.ossKey === "string" &&+ result.ossKey.length > 0+ )+ opts?.onDiscardOssKey?.(result.ossKey);+ },+ signal: opts?.signal,+ prepare: () =>+ stage("prepare", () => fetch(!opts?.thumbnail), describeResult),+ peer: (metadata) =>+ metadata.size <= FILE_PEER_MAX_BYTES+ ? stage(+ "direct",+ () => tryMobilePeerFile(deviceId, url, opts?.signal, trace || undefined),+ (result) => ({ hit: result !== null }),+ )+ : Promise.resolve(null),+ fallback: () =>+ stage("upload", fallback ?? (() => fetch(false)), describeResult),+ }),+ (result) => ({+ route: peerMediaUri(result)+ ? "direct"+ : typeof result.inlineBase64 === "string"+ ? "inline"+ : "upload",+ size: result.size,+ }),+ );};return {@@ -1236,7 +1297,12 @@ export function createMobileMakerTransport({assertFileReadActive(signal);const fallback = () =>exportDeviceFile(retryOp, workdir, relPath, signal);- if (!caps.fileRead) return fallback();+ if (!caps.fileRead) {+ mobileDebugLog("debug", "files", "file export without direct read", {+ reason: "host-lacks-file-read",+ });+ return fallback();+ }const reference = await retryOp<{ok: boolean;url: string;diff --git a/apps/mobile/src/device-link/peerFileRegistry.ts b/apps/mobile/src/device-link/peerFileRegistry.tsindex 40ef9da55c..f7077f48e6 100644--- a/apps/mobile/src/device-link/peerFileRegistry.ts+++ b/apps/mobile/src/device-link/peerFileRegistry.ts@@ -48,6 +48,7 @@ type Download = (device: string,url: string,signal?: AbortSignal,+ trace?: number,) => Promise<LocalPeerMedia | null>;let download: Download | null = null;export function installPeerFileDownload(value: Download) {@@ -60,8 +61,9 @@ export async function tryMobilePeerFile(device: string,url: string,signal?: AbortSignal,+ trace?: number,) {- return download?.(device, url, signal) ?? null;+ return download?.(device, url, signal, trace) ?? null;}/** Budget includes retained files; reserve room for the consumer copy and keep 256 MiB free. */diff --git a/apps/mobile/src/device-link/peerFileTransport.tsx b/apps/mobile/src/device-link/peerFileTransport.tsxindex e52c41ae0a..10b9fd7629 100644--- a/apps/mobile/src/device-link/peerFileTransport.tsx+++ b/apps/mobile/src/device-link/peerFileTransport.tsx@@ -14,6 +14,8 @@ import {REMOTE_DESKTOP_ICE_CONFIG_TIMEOUT_MS,} from "@cindy/device-link";import { useAuth } from "@/auth/AuthContext";+import { errorText, nextFileTrace } from "@/debug/fileDiagnostics";+import { mobileDebugLog } from "@/debug/mobileDebugLog";import { useDeviceLink } from "./DeviceLinkContext";import {DEVICE_LINK_API_BASE_URL,@@ -151,16 +153,39 @@ export function PeerFileTransport() {device: string,url: string,signal?: AbortSignal,+ readTrace?: number,): Promise<LocalMedia | null> => {if (!current() || signal?.aborted) throw new Error("FILE_PEER_CANCELLED");- if (busy) return null;+ const trace = readTrace || nextFileTrace();+ if (busy) {+ mobileDebugLog("debug", "files", "direct transfer skipped", { trace, reason: "busy" });+ return null;+ }busy = true;+ const startedAt = Date.now();+ let step = "link";+ let received = 0;+ // Distinguishes a transport/view reset (no upload fallback) from ordinary failures.+ const cancelReason = () =>+ signal?.aborted+ ? "aborted"+ : epoch.current !== generation+ ? "runtime-reset"+ : liveView.current !== viewKey+ ? "connection-changed"+ : AppState.currentState !== "active"+ ? "background"+ : null;if (connection && connection.device !== device) close();clearTimeout(idle);const id = connection?.id ?? randomUUID();let remote = connection?.remote,target: File | undefined,complete = false;+ mobileDebugLog("debug", "files", "direct transfer start", {+ trace,+ reuseConnection: !!remote,+ });const cancel = () => {if (current()) void command("close", [id]).catch(() => {});};@@ -170,22 +195,39 @@ export function PeerFileTransport() {try {await link.openLink(device);if (!remote) {+ step = "caps";const caps = (await invoke({ action: "caps" })) as {version?: number;};if (!current() || signal?.aborted)throw new Error("FILE_PEER_CANCELLED");- if (caps?.version !== 1) return null;- const servers = await resolveDesktopIceServers(() =>- auth.apiFetch(REMOTE_DESKTOP_ICE_CONFIG_PATH, {- baseUrl: DEVICE_LINK_API_BASE_URL,- timeoutMs: REMOTE_DESKTOP_ICE_CONFIG_TIMEOUT_MS,- cache: "no-store",- }),+ if (caps?.version !== 1) {+ mobileDebugLog("debug", "files", "direct transfer skipped", {+ trace,+ reason: "host-version",+ version: typeof caps?.version === "number" ? caps.version : null,+ });+ return null;+ }+ step = "ice-config";+ const servers = await resolveDesktopIceServers(+ () =>+ auth.apiFetch(REMOTE_DESKTOP_ICE_CONFIG_PATH, {+ baseUrl: DEVICE_LINK_API_BASE_URL,+ timeoutMs: REMOTE_DESKTOP_ICE_CONFIG_TIMEOUT_MS,+ cache: "no-store",+ }),+ (diagnostic) =>+ mobileDebugLog("debug", "files", "direct transfer ice config", {+ trace,+ ...diagnostic,+ }),);if (!current() || signal?.aborted)throw new Error("FILE_PEER_CANCELLED");+ step = "offer";const sdp = await command("offer", [id, servers]);+ step = "host-answer";const answer = (await invoke({ action: "offer", sdp })) as {connection?: string;sdp?: string;@@ -201,14 +243,28 @@ export function PeerFileTransport() {remote = answer.connection;if (!current() || signal?.aborted)throw new Error("FILE_PEER_CLOSED");+ step = "answer";await command("answer", [id, answer.sdp]);connection = { id, remote, device };+ mobileDebugLog("debug", "files", "direct transfer connected", {+ trace,+ ms: Date.now() - startedAt,+ });}+ step = "open";const file = parseFilePeerFile(await invoke({ action: "open", connection: remote, url }),);if (!current() || signal?.aborted) throw new Error("FILE_PEER_CLOSED");- if (!canStagePeerMedia(file.size, Paths.availableDiskSpace)) return null;+ if (!canStagePeerMedia(file.size, Paths.availableDiskSpace)) {+ mobileDebugLog("debug", "files", "direct transfer skipped", {+ trace,+ reason: "storage",+ size: file.size,+ });+ return null;+ }+ step = "receive";const directory = new Directory(Paths.cache,"remote-media-share",@@ -228,6 +284,7 @@ export function PeerFileTransport() {)throw new Error("FILE_PEER_SIZE");} finally {+ received = sinks.current.get(id)?.offset ?? received;sinks.current.delete(id);try {handle.close();@@ -239,12 +296,34 @@ export function PeerFileTransport() {!recordPeerMedia(result, target.uri, () => {if (completed.exists) completed.delete();})- )+ ) {+ mobileDebugLog("debug", "files", "direct transfer skipped", {+ trace,+ reason: "staging-budget",+ size: file.size,+ });return null;+ }target = undefined;complete = true;+ mobileDebugLog("debug", "files", "direct transfer done", {+ trace,+ ms: Date.now() - startedAt,+ size: file.size,+ mime: file.mimeType,+ });return result;- } catch {+ } catch (error) {+ const cancelled = cancelReason();+ mobileDebugLog("warn", "files", "direct transfer failed", {+ trace,+ step,+ ms: Date.now() - startedAt,+ received,+ error: errorText(error),+ // Non-null means the read is rejected instead of falling back to upload.+ cancelled,+ });if (!current() || signal?.aborted)throw new Error("FILE_PEER_CANCELLED");return null;@@ -268,9 +347,14 @@ export function PeerFileTransport() {}};const queueRead = createFileReadQueue();- const unregister = installPeerFileDownload((device, url, signal) =>- queueRead('connection', () => transfer(device, url, signal), signal));+ const unregister = installPeerFileDownload((device, url, signal, readTrace) =>+ queueRead('connection', () => transfer(device, url, signal, readTrace), signal));+ mobileDebugLog("debug", "files", "direct transfer ready");return () => {+ mobileDebugLog("debug", "files", "direct transfer reset", {+ busy,+ pendingCommands: pending.current.size,+ });close();++epoch.current;unregister();@@ -290,6 +374,7 @@ export function PeerFileTransport() {}, [foreground, ready, auth.isAuthenticated, viewKey]);const handleProcessTerminated = () => {if (liveView.current !== viewKey) return;+ mobileDebugLog("warn", "files", "direct transfer runtime terminated", { crashes });setReady(null);setCrashes((n) => Math.min(2, n + 1));};diff --git a/apps/mobile/src/i18n/locales/en/settings.json b/apps/mobile/src/i18n/locales/en/settings.jsonindex d6eff90aa3..abd4ca96a5 100644--- a/apps/mobile/src/i18n/locales/en/settings.json+++ b/apps/mobile/src/i18n/locales/en/settings.json@@ -10,7 +10,7 @@},"title": "Debug logs","record": "Record debug logs",- "hint": "Record phone connection, recovery, scrolling, keyboard and performance details. Off by default; keeps up to 7 days and 8 MB. Never uploaded automatically.",+ "hint": "Record phone connection, recovery, file preview and playback, scrolling, keyboard and performance details. Off by default; keeps up to 7 days and 8 MB. Never uploaded automatically.","export": "Export debug logs","clear": "Clear logs","busy": "Working…",diff --git a/apps/mobile/src/i18n/locales/ja/settings.json b/apps/mobile/src/i18n/locales/ja/settings.jsonindex f51d309d76..8eafec3d8c 100644--- a/apps/mobile/src/i18n/locales/ja/settings.json+++ b/apps/mobile/src/i18n/locales/ja/settings.json@@ -10,7 +10,7 @@},"title": "デバッグログ","record": "デバッグログを記録",- "hint": "スマートフォンの接続、復旧、スクロール、キーボード、性能の詳細を記録します。初期設定はオフ。最大7日間・8 MB保存し、自動送信しません。",+ "hint": "スマートフォンの接続、復旧、ファイルのプレビューと再生、スクロール、キーボード、性能の詳細を記録します。初期設定はオフ。最大7日間・8 MB保存し、自動送信しません。","export": "デバッグログを書き出す","clear": "ログを消去","busy": "処理中…",diff --git a/apps/mobile/src/i18n/locales/ko/settings.json b/apps/mobile/src/i18n/locales/ko/settings.jsonindex af70dacbbf..3efb5df8de 100644--- a/apps/mobile/src/i18n/locales/ko/settings.json+++ b/apps/mobile/src/i18n/locales/ko/settings.json@@ -10,7 +10,7 @@},"title": "디버그 로그","record": "디버그 로그 기록",- "hint": "휴대폰 연결, 복구, 스크롤, 키보드 및 성능 세부 정보를 기록합니다. 기본 꺼짐이며 최대 7일, 8 MB를 보관합니다. 자동 업로드하지 않습니다.",+ "hint": "휴대폰 연결, 복구, 파일 미리보기 및 재생, 스크롤, 키보드 및 성능 세부 정보를 기록합니다. 기본 꺼짐이며 최대 7일, 8 MB를 보관합니다. 자동 업로드하지 않습니다.","export": "디버그 로그 내보내기","clear": "로그 지우기","busy": "처리 중…",diff --git a/apps/mobile/src/i18n/locales/zh-CN/settings.json b/apps/mobile/src/i18n/locales/zh-CN/settings.jsonindex 742c119a6a..acae8db1dc 100644--- a/apps/mobile/src/i18n/locales/zh-CN/settings.json+++ b/apps/mobile/src/i18n/locales/zh-CN/settings.json@@ -10,7 +10,7 @@},"title": "Debug 日志","record": "记录 Debug 日志",- "hint": "记录手机上的连接、恢复、滚动、键盘与性能细节。默认关闭,最多保留 7 天、8 MB,不会自动上传。",+ "hint": "记录手机上的连接、恢复、文件预览与播放、滚动、键盘与性能细节。默认关闭,最多保留 7 天、8 MB,不会自动上传。","export": "导出 Debug 日志","clear": "清空日志","busy": "处理中…",diff --git a/apps/mobile/src/i18n/locales/zh-TW/settings.json b/apps/mobile/src/i18n/locales/zh-TW/settings.jsonindex b1f9981f06..0e1381ddaa 100644--- a/apps/mobile/src/i18n/locales/zh-TW/settings.json+++ b/apps/mobile/src/i18n/locales/zh-TW/settings.json@@ -10,7 +10,7 @@},"title": "Debug 日誌","record": "記錄 Debug 日誌",- "hint": "記錄手機上的連線、恢復、捲動、鍵盤與效能細節。預設關閉,最多保留 7 天、8 MB,不會自動上傳。",+ "hint": "記錄手機上的連線、恢復、檔案預覽與播放、捲動、鍵盤與效能細節。預設關閉,最多保留 7 天、8 MB,不會自動上傳。","export": "匯出 Debug 日誌","clear": "清空日誌","busy": "處理中…",diff --git a/apps/mobile/src/session/HtmlFileReader.tsx b/apps/mobile/src/session/HtmlFileReader.tsxindex 1e3b31c25f..2d663544e9 100644--- a/apps/mobile/src/session/HtmlFileReader.tsx+++ b/apps/mobile/src/session/HtmlFileReader.tsx@@ -38,6 +38,8 @@ import { StyleSheet, View } from 'react-native';import { WebView, type WebViewProps } from 'react-native-webview';import type { ShouldStartLoadRequest, WebViewNavigation } from 'react-native-webview/lib/WebViewTypes';+import { sanitizeDiagnosticText } from '@/debug/fileDiagnostics';+import { mobileDebugLog } from '@/debug/mobileDebugLog';import { interceptHtmlNavigation, interceptSnapshotNavigation } from '@/session/htmlNavigationPolicy';import { withHtmlPreviewCsp } from '@/session/htmlPreviewCsp';import type { MobileHtmlPreview } from '@/session/mobileHtmlPreview';@@ -65,6 +67,12 @@ export function HtmlSnapshotReader({ preview, onError, webViewRef, viewportInsetcurrentPreview.current = preview;return () => { currentPreview.current = null; };}, [preview]);+ // Diagnostics only: load outcome and timing per mounted snapshot; the URL carries the snapshot token.+ const mountedAt = useMemo(() => Date.now(), [preview]);+ const failed = (event: string, detail: Record<string, unknown>) => {+ mobileDebugLog('warn', 'files', event, { ms: Date.now() - mountedAt, ...detail });+ onError();+ };return <View ref={viewRef} onLayout={measure} collapsable={false} style={[styles.fill, viewportStyle]}><View style={styles.viewport}><WebViewkey={preview.url}ref={readerRef}@@ -77,7 +85,11 @@ export function HtmlSnapshotReader({ preview, onError, webViewRef, viewportInsetcontentInset={obscuredContentInsets}injectedJavaScriptBeforeContentLoaded={script}injectedJavaScript={script}- onLoadEnd={() => { if (currentPreview.current === preview && script) readerRef.current?.injectJavaScript(script); }}+ onLoadEnd={(event) => {+ if (currentPreview.current !== preview) return;+ mobileDebugLog('debug', 'files', 'html page load end', { ms: Date.now() - mountedAt, loading: event?.nativeEvent?.loading });+ if (script) readerRef.current?.injectJavaScript(script);+ }}onScroll={({ nativeEvent: { contentOffset } }) => {if (currentPreview.current === preview) readerRef.current?.injectJavaScript(browserViewportScrollScript(contentOffset.x, contentOffset.y));}}@@ -89,12 +101,17 @@ export function HtmlSnapshotReader({ preview, onError, webViewRef, viewportInsetsetSupportMultipleWindows={false}allowFileAccess={false}mediaCapturePermissionGrantType="deny"- onError={onError}- onContentProcessDidTerminate={onError}- onRenderProcessGone={onError}+ onError={(event) => failed('html page load error', {+ code: event?.nativeEvent?.code, domain: event?.nativeEvent?.domain,+ description: sanitizeDiagnosticText(String(event?.nativeEvent?.description ?? '')),+ })}+ onContentProcessDidTerminate={() => failed('html page process terminated', {})}+ onRenderProcessGone={(event) => failed('html page process gone', { didCrash: event?.nativeEvent?.didCrash })}onHttpError={(event) => {// Resource failures stay in the page; they must not replace an already loaded document.- if (interceptSnapshotNavigation(event.nativeEvent.url, preview.url, preview.documents, preview.onDemand)) onError();+ const document = interceptSnapshotNavigation(event.nativeEvent.url, preview.url, preview.documents, preview.onDemand);+ if (document) failed('html page http error', { status: event.nativeEvent.statusCode });+ else mobileDebugLog('debug', 'files', 'html subresource http error', { status: event.nativeEvent.statusCode });}}incognitostyle={styles.fill}diff --git a/apps/mobile/src/session/MessageRenderer.tsx b/apps/mobile/src/session/MessageRenderer.tsxindex 3425c5e5de..97f84311b6 100644--- a/apps/mobile/src/session/MessageRenderer.tsx+++ b/apps/mobile/src/session/MessageRenderer.tsx@@ -14,6 +14,7 @@ import { AuthorizationMessageCard } from './AuthorizationMessageCard';import { sharedTaskAuthorName } from '@cindy/maker-shared';import { CompanionMessageCard } from '@/session/CompanionMessageCard';import { mobileDebugEnabled, mobileDebugLog } from '@/debug/mobileDebugLog';+import { errorText, resolvedUrlKind } from '@/debug/fileDiagnostics';import { createContext, Fragment, memo, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, type ComponentProps, type ReactNode } from 'react';import { useTranslation } from 'react-i18next';import { Image as ExpoImage } from 'expo-image';@@ -7106,13 +7107,21 @@ function MessagePayloadBody({const resolve = useCallback((forceRefresh = false) => {if (!remoteMedia || !onResolveRemoteMedia) return;let cancelled = false;+ const startedAt = Date.now();setRemoteState({ status: 'loading' });// 用户主动打开的原图插队头,优先于列表缩略图的懒取件。void onResolveRemoteMedia(remoteMedia, { front: true, forceRefresh }).then((media) => {+ mobileDebugLog('debug', 'files', 'message media fetch done', {+ kind: remoteMedia.kind, ms: Date.now() - startedAt, source: resolvedUrlKind(media.url),+ previewable: media.previewable, size: media.size, left: cancelled, forceRefresh,+ });if (!cancelled) setRemoteState({ status: 'ready', media });}).catch((err) => {+ mobileDebugLog(cancelled ? 'debug' : 'warn', 'files', 'message media fetch failed', {+ kind: remoteMedia.kind, ms: Date.now() - startedAt, left: cancelled, forceRefresh, error: errorText(err),+ });if (!cancelled) setRemoteState({ status: 'error', message: err instanceof Error ? err.message : String(err) });});return () => {diff --git a/apps/mobile/src/session/fileBrowserExport.ts b/apps/mobile/src/session/fileBrowserExport.tsindex bf0f40588f..0b88009c2c 100644--- a/apps/mobile/src/session/fileBrowserExport.ts+++ b/apps/mobile/src/session/fileBrowserExport.ts@@ -10,6 +10,8 @@ import {} from "@/session/fileBrowserCache";import type { MobileRemoteMediaPresignResult } from "@/session/remoteMedia";import { peerMediaUri, peerMediaExpiry } from "@/device-link/peerFileRegistry";+import { errorText } from "@/debug/fileDiagnostics";+import { mobileDebugLog } from "@/debug/mobileDebugLog";export interface ExportRemoteFileDeps {/** Retained preview URLs must not reuse short-lived full-file peer results. */@@ -31,7 +33,10 @@ export async function exportRemoteFileToUrl(const ownerScope = deps.maker.fileBrowser.cacheScope ?? deps.deviceId;const scope = JSON.stringify([ownerScope, deps.stream === true ? "stream" : "file"]);const cached = getCachedExportUrl(scope, workdir, relPath, mtimeMs);- if (cached) return cached;+ if (cached) {+ mobileDebugLog("debug", "files", "file export cache hit", { stream: deps.stream === true });+ return cached;+ }const abort = new AbortController();const check = () => {if (deps.isCancelled?.()) abort.abort();@@ -63,7 +68,18 @@ export async function exportRemoteFileToUrl(}if (result.inlineBase64 !== undefined)return `data:${result.mimeType};base64,${result.inlineBase64}`;- const signed = await deps.presignGet(result.ossKey);+ const presignStartedAt = Date.now();+ const signed = await deps.presignGet(result.ossKey).catch((error: unknown) => {+ mobileDebugLog("warn", "files", "file export presign failed", {+ ms: Date.now() - presignStartedAt,+ error: errorText(error),+ });+ throw error;+ });+ mobileDebugLog("debug", "files", "file export presigned", {+ ms: Date.now() - presignStartedAt,+ size: result.size,+ });check();if (abort.signal.aborted) throw new Error(i18n.t("files.export.leftPage"));storeCachedExportUrl(diff --git a/apps/mobile/src/session/mediaPlayerWebView.tsx b/apps/mobile/src/session/mediaPlayerWebView.tsxindex a743ac6230..7d4ec651d5 100644--- a/apps/mobile/src/session/mediaPlayerWebView.tsx+++ b/apps/mobile/src/session/mediaPlayerWebView.tsx@@ -10,6 +10,8 @@ import {} from '@/session/mediaPlayerWebViewHtml';import { createMediaPlayerWebViewLifecycle } from '@/session/mediaPlayerWebViewLifecycle';import { registerMobileMessageWebView } from '@/session/mobileMessageWebViewMetrics';+import { resolvedUrlKind, sanitizeDiagnosticText } from '@/debug/fileDiagnostics';+import { mobileDebugLog } from '@/debug/mobileDebugLog';import { useTheme } from '@/theme';export function RemoteMediaPlayerWebView({@@ -35,6 +37,19 @@ export function RemoteMediaPlayerWebView({const mountedRef = useRef(true);const [reloadGeneration, setReloadGeneration] = useState(0);useEffect(() => registerMobileMessageWebView('media'), []);+ // Diagnostics: which URL scheme reached the player and how its load/playback went (never the URL).+ const lastLoggedStateRef = useRef<string | null>(null);+ const loadStartedAtRef = useRef(Date.now());+ useEffect(() => {+ lastLoggedStateRef.current = null;+ loadStartedAtRef.current = Date.now();+ mobileDebugLog('debug', 'files', 'media player mounted', {+ kind, mimeType: mimeType ?? null, source: resolvedUrlKind(url), reloadGeneration,+ });+ }, [kind, mimeType, reloadGeneration, url]);+ const logPlayerFailure = useCallback((event: string, detail: Record<string, unknown>) => {+ mobileDebugLog('warn', 'files', event, { kind, ms: Date.now() - loadStartedAtRef.current, ...detail });+ }, [kind]);const pausePlayback = useCallback(() => {webViewRef.current?.postMessage(buildMediaPlayerWebViewCommand('pause'));}, []);@@ -75,8 +90,18 @@ export function RemoteMediaPlayerWebView({const handleMessage = useCallback((event: WebViewMessageEvent) => {if (!mountedRef.current) return;const status = parseMediaPlayerWebViewMessage(event.nativeEvent.data);+ if (status && status.state !== lastLoggedStateRef.current) {+ lastLoggedStateRef.current = status.state;+ mobileDebugLog(status.state === 'error' ? 'warn' : 'debug', 'files', 'media player state', {+ kind,+ state: status.state,+ ms: Date.now() - loadStartedAtRef.current,+ duration: status.duration ?? null,+ mediaError: status.error ? sanitizeDiagnosticText(status.error) : null,+ });+ }if (status) onStatusChange?.(status);- }, [onStatusChange]);+ }, [kind, onStatusChange]);return (<View style={style} testID={testID}>@@ -88,6 +113,11 @@ export function RemoteMediaPlayerWebView({mediaPlaybackRequiresUserAction={false}onLoadEnd={lifecycleRef.current.onLoadEnd}onLoadStart={lifecycleRef.current.onLoadStart}+ onError={(event) => logPlayerFailure('media player load error', {+ code: event?.nativeEvent?.code, domain: event?.nativeEvent?.domain,+ description: sanitizeDiagnosticText(String(event?.nativeEvent?.description ?? '')),+ })}+ onContentProcessDidTerminate={() => logPlayerFailure('media player process terminated', {})}onMessage={handleMessage}originWhitelist={['*']}scrollEnabled={false}diff --git a/apps/mobile/src/session/mobileHtmlPreview.ts b/apps/mobile/src/session/mobileHtmlPreview.tsindex b6d076112d..703c69de33 100644--- a/apps/mobile/src/session/mobileHtmlPreview.ts+++ b/apps/mobile/src/session/mobileHtmlPreview.ts@@ -4,6 +4,8 @@ import { Directory, File, Paths } from 'expo-file-system';import { createDownloadResumable } from 'expo-file-system/legacy';import { getRandomBytes } from 'expo-crypto';import native from '../../modules/cindy-html-preview/src/CindyHtmlPreviewModule';+import { errorText } from '@/debug/fileDiagnostics';+import { mobileDebugLog } from '@/debug/mobileDebugLog';import type { MobileMakerTransport } from '@/device-link/mobileMakerTransport';import { withTransientRemoteRetry } from '@/device-link/remoteRetry';import { assertHtmlSnapshotActive, collectHtmlSnapshot, htmlSnapshotLocation, HTML_SNAPSHOT_MAX_ENTRIES, snapshotDocumentPaths } from './htmlDirectorySnapshot';@@ -48,6 +50,10 @@ export async function prepareMobileHtmlPreview(absPath: string, deps: RemoteAbsFdeleteOssObject(key: string): void;}, signal: AbortSignal): Promise<MobileHtmlPreview> {if (!native) throw new Error('HTML_PREVIEW_NATIVE_UNAVAILABLE');+ mobileDebugLog('debug', 'files', 'html preview mode', {+ onDemand: !!(native.startOnDemand && native.resolveRequest),+ ssh: !!deps.ssh,+ });if (native.startOnDemand && native.resolveRequest) return prepareOnDemand(absPath, deps, signal);const server = native;assertHtmlSnapshotActive(signal);@@ -151,6 +157,7 @@ async function prepareOnDemand(absPath: string, deps: RemoteAbsFileFetchDeps & {dir.create({ intermediates: true });let closed = false;let sequence = 0;+ let requestCount = 0;const requests = new Map<string, AbortController>();const pending = new Set<Promise<void>>();const materialized = new Map<string, { filename: string; mime: string }>();@@ -159,9 +166,15 @@ async function prepareOnDemand(absPath: string, deps: RemoteAbsFileFetchDeps & {if (event.token !== token || closed || requests.has(event.id)) return;const controller = new AbortController();requests.set(event.id, controller);+ const request = ++requestCount;+ const queuedAt = Date.now();+ const ext = /\.([a-z0-9]{1,8})$/i.exec(event.path ?? '')?.[1]?.toLowerCase() ?? '';const work = queue('preview', async () => {let destination: File | undefined;let accepted = false;+ let route = 'unknown';+ let bytes = 0;+ const startedAt = Date.now();const uploaded = new Set<string>();try {assertHtmlSnapshotActive(controller.signal);@@ -171,6 +184,7 @@ async function prepareOnDemand(absPath: string, deps: RemoteAbsFileFetchDeps & {const reused = materialized.get(relative);if (reused) {accepted = await server.resolveRequest!(token, event.id, reused.filename, reused.mime, 200);+ mobileDebugLog('debug', 'files', 'html resource reused', { request, ext, accepted });return;}const filename = String(sequence++);@@ -178,6 +192,8 @@ async function prepareOnDemand(absPath: string, deps: RemoteAbsFileFetchDeps & {const media = await fetchRemoteAbsFileOnce(deps, root.replace(/\/$/, '') + '/' + relative, deps.ssh,(key) => uploaded.add(key), { baseDir: root, maxBytes: FILE_PEER_MAX_BYTES }, controller.signal);assertHtmlSnapshotActive(controller.signal);+ bytes = media.size;+ route = media.inlineBase64 !== undefined ? 'inline' : media.url.startsWith('file://') ? 'direct' : 'upload';if (!(Paths.availableDiskSpace >= media.size + 256 * 1024 * 1024)) {if (media.url.startsWith('file://')) releasePeerMedia(media.url);throw new Error('PREVIEW_DISK_FULL');@@ -210,10 +226,22 @@ async function prepareOnDemand(absPath: string, deps: RemoteAbsFileFetchDeps & {assertHtmlSnapshotActive(controller.signal);accepted = await server.resolveRequest!(token, event.id, filename, mime, 200);if (accepted) materialized.set(relative, { filename, mime });+ mobileDebugLog('debug', 'files', 'html resource served', {+ request, ext, route, bytes, accepted,+ waitMs: startedAt - queuedAt, ms: Date.now() - startedAt,+ });} catch (error) {- if (!closed && !controller.signal.aborted) {- const message = error instanceof Error ? error.message : '';- await server.resolveRequest!(token, event.id, '', '', /NOT_FOUND|ENOENT/.test(message) ? 404 : 502);+ const aborted = closed || controller.signal.aborted;+ const message = error instanceof Error ? error.message : '';+ const status = /NOT_FOUND|ENOENT/.test(message) ? 404 : 502;+ mobileDebugLog(aborted ? 'debug' : 'warn', 'files', 'html resource failed', {+ request, ext, route, bytes,+ status: aborted ? 'aborted' : status,+ waitMs: startedAt - queuedAt, ms: Date.now() - startedAt,+ error: errorText(error),+ });+ if (!aborted) {+ await server.resolveRequest!(token, event.id, '', '', status);}} finally {for (const key of uploaded) deps.deleteOssObject(key);diff --git a/apps/mobile/src/session/remoteMedia.ts b/apps/mobile/src/session/remoteMedia.tsindex 8857714ce1..e6e3c44d39 100644--- a/apps/mobile/src/session/remoteMedia.ts+++ b/apps/mobile/src/session/remoteMedia.ts@@ -5,6 +5,8 @@ import {isPayloadDirectPreviewableUrl,} from "@cindy/maker-shared/payload-summary";import { i18n } from "@/i18n";+import { errorText } from "@/debug/fileDiagnostics";+import { mobileDebugLog } from "@/debug/mobileDebugLog";const EXPIRY_SAFETY_WINDOW_MS = 60 * 1000;@@ -211,10 +213,26 @@ export async function resolveMobileRemoteMedia(if (!isValidFetchResult(fetched)) {throw new Error(i18n.t("composer.attachments.mediaResultInvalid"));}- const signed = await deps.presignGet(fetched.ossKey);+ // Image thumbnails are high-volume; trace presign timing for full files, failures always.+ const presignStartedAt = Date.now();+ const signed = await deps.presignGet(fetched.ossKey).catch((error: unknown) => {+ mobileDebugLog("warn", "files", "remote media presign failed", {+ kind: media.kind,+ ms: Date.now() - presignStartedAt,+ error: errorText(error),+ });+ throw error;+ });if (!isValidPresignResult(signed)) {+ mobileDebugLog("warn", "files", "remote media presign invalid", { kind: media.kind });throw new Error(i18n.t("composer.attachments.mediaUrlInvalid"));}+ if (media.kind !== "image")+ mobileDebugLog("debug", "files", "remote media presigned", {+ kind: media.kind,+ ms: Date.now() - presignStartedAt,+ size: fetched.size,+ });return {url: signed.getUrl,ossKey: fetched.ossKey,diff --git a/apps/mobile/src/session/useHtmlSnapshot.ts b/apps/mobile/src/session/useHtmlSnapshot.tsindex dc3f705923..597d412f0a 100644--- a/apps/mobile/src/session/useHtmlSnapshot.ts+++ b/apps/mobile/src/session/useHtmlSnapshot.ts@@ -1,6 +1,8 @@import { useEffect, useState } from 'react';import { AppState } from 'react-native';import type { MobileHtmlPreview, PrepareMobileHtmlPreview } from './mobileHtmlPreview';+import { errorText } from '@/debug/fileDiagnostics';+import { mobileDebugLog } from '@/debug/mobileDebugLog';/** Visible rendered page owns the listener. Resuming rebuilds a fresh snapshot after suspension. */export function useHtmlSnapshot(absPath: string, enabled: boolean, prepare: PrepareMobileHtmlPreview) {@@ -20,12 +22,19 @@ export function useHtmlSnapshot(absPath: string, enabled: boolean, prepare: PrepsetResult({});if (!enabled || !foreground) return;const controller = new AbortController();+ const startedAt = Date.now();let preview: MobileHtmlPreview | undefined;void prepare(absPath, controller.signal).then((value) => {preview = value;+ mobileDebugLog('debug', 'files', 'html preview prepared', {+ ms: Date.now() - startedAt, onDemand: value.onDemand === true, aborted: controller.signal.aborted,+ });if (controller.signal.aborted) void value.close().catch(() => {});else setResult({ preview: value, path: absPath, prepare, epoch });}).catch((error: unknown) => {+ mobileDebugLog(controller.signal.aborted ? 'debug' : 'warn', 'files', 'html preview prepare failed', {+ ms: Date.now() - startedAt, aborted: controller.signal.aborted, error: errorText(error),+ });if (!controller.signal.aborted) setResult({ error, path: absPath, prepare, epoch });});return () => {diff --git a/docs/dev-rules/log-upload-and-redaction.md b/docs/dev-rules/log-upload-and-redaction.mdindex c8048b3a08..cc0053261e 100644--- a/docs/dev-rules/log-upload-and-redaction.md+++ b/docs/dev-rules/log-upload-and-redaction.md@@ -268,7 +268,9 @@ Mobile 的设置 → 调试 / 开发者提供 Debug 开关、导出与手动上个人排障构建可用 `EXPO_PUBLIC_CINDY_DIAGNOSTICS=1` 设置默认值,用户保存的开关优先。- 本地详细 Debug 与上传摘要分别保存。`mobileDebugLog.ts` 只接手机自身的显式记录点:连接与网络变化、- 恢复阶段、生命周期、JS 停摆、渲染计数与解析耗时、滚动几何和键盘状态。保留级别、错误原因与堆栈,+ 恢复阶段、生命周期、JS 停摆、渲染计数与解析耗时、滚动几何和键盘状态,以及远程文件预览与播放的+ 取件阶段(`files` scope:传输路线、大小、耗时与失败原因,只记扩展名,不记文件路径、签名地址或文件内容)。+ 保留级别、错误原因与堆栈,`mobileDebugRecord.ts` 在落盘前过滤敏感字段、凭证、地址参数等;禁止传入消息正文、请求体或完整鉴权信息,不接管全局 console,不重复保存被控端任务记录。- 详细日志在 `Paths.document/cindy-debug/`,NDJSON 文件每份最多 1 MiB、最多 8 份、保留最近 7 天。