Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

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.ts
index 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.ts
index 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<unk
try {
// 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<unk
resolveAuthorizedMedia({ 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<unk
mtime: 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, signal
let 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, signal
signal?.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.ts
index 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<MediaFetchResu
mimeType ??
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<MediaFetchResu
const 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].tsx
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.tsx
index 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, viewportInset
currentPreview.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}><WebView
key={preview.url}
ref={readerRef}
@@ -77,7 +85,11 @@ export function HtmlSnapshotReader({ preview, onError, webViewRef, viewportInset
contentInset={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, viewportInset
setSupportMultipleWindows={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 });
}}
incognito
style={styles.fill}
diff --git a/apps/mobile/src/session/MessageRenderer.tsx b/apps/mobile/src/session/MessageRenderer.tsx
index 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.ts
index 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.tsx
index 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.ts
index 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: RemoteAbsF
deleteOssObject(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.ts
index 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.ts
index 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: Prep
setResult({});
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.md
index 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 天。