0.6 rust重构01

wolai-frontend/src/app/api/blocks/patch/route.ts

@@ -3,32 +3,104 @@ import { isConvexEnabled } from "@/lib/convex/enabled";
 import { getAuthedConvexClient } from "@/lib/convex/route";
 import { api } from "@/lib/convex/api";
 import { getBlocksFromDocumentContent, replaceBlockInTree, withBlocksWrittenBack } from "@/lib/blocks";
+import {
+  assertBlockId,
+  assertDocumentId,
+  assertNextBlock,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import { recordBridgeCommandArtifacts } from "@/lib/documents/bridge-log";
 
 type PatchPayload = {
   sourceDocumentId: string;
+  workspaceId?: string | null;
   blockId: string;
   nextBlock: unknown;
 };
 
 export async function POST(request: Request) {
-  const { sourceDocumentId, blockId, nextBlock }: PatchPayload = await request.json();
-
-  if (!sourceDocumentId || !blockId || !nextBlock) {
-    return NextResponse.json({ error: "缺少参数" }, { status: 400 });
-  }
-
   if (isConvexEnabled()) {
-    const { client } = await getAuthedConvexClient();
-    const doc = await client.query(api.documents.getContent, { id: sourceDocumentId });
-    if (!doc) return NextResponse.json({ error: "页面不存在或无权限" }, { status: 404 });
+    try {
+      const { sourceDocumentId, workspaceId, blockId, nextBlock }: PatchPayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(sourceDocumentId);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const normalizedBlockId = assertBlockId(blockId);
+      assertNextBlock(nextBlock);
 
-    const blocks = getBlocksFromDocumentContent(doc.content);
-    const replaced = replaceBlockInTree(blocks, blockId, nextBlock as any);
-    if (!replaced.ok) return NextResponse.json({ error: "块不存在或无权限" }, { status: 404 });
+      const bridgeContext = await buildDocumentBridgeContext({
+        request,
+        workspaceId: normalizedWorkspaceId,
+      });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "blocks.patch",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          blockId: normalizedBlockId,
+          nextBlock,
+        },
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+          blockId: normalizedBlockId,
+        },
+      });
 
-    const payload = withBlocksWrittenBack(doc.content, replaced.nextBlocks);
-    await client.mutation(api.documents.updateContent, { id: sourceDocumentId, content: payload });
-    return NextResponse.json({ ok: true });
+      const { client } = await getAuthedConvexClient();
+      const doc = await client.query(api.documents.getContent, { id: normalizedDocumentId });
+      if (!doc) {
+        return NextResponse.json(
+          {
+            error: "页面不存在或无权限",
+            meta: {
+              requestId: bridgeContext.requestId,
+              traceId: bridgeContext.traceId,
+              commandId: envelope.commandId,
+              commandName: envelope.name,
+            },
+          },
+          { status: 404 },
+        );
+      }
+
+      const blocks = getBlocksFromDocumentContent(doc.content);
+      const replaced = replaceBlockInTree(blocks, normalizedBlockId, nextBlock as any);
+      if (!replaced.ok) {
+        return NextResponse.json(
+          {
+            error: "块不存在或无权限",
+            meta: {
+              requestId: bridgeContext.requestId,
+              traceId: bridgeContext.traceId,
+              commandId: envelope.commandId,
+              commandName: envelope.name,
+            },
+          },
+          { status: 404 },
+        );
+      }
+
+      const payload = withBlocksWrittenBack(doc.content, replaced.nextBlocks);
+      await client.mutation(api.documents.updateContent, { id: normalizedDocumentId, content: payload });
+      await recordBridgeCommandArtifacts({
+        context: bridgeContext,
+        envelope,
+      });
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          commandId: envelope.commandId,
+          commandName: envelope.name,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
+    }
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/bridge/request/route.ts

@@ -0,0 +1,27 @@
+import { NextResponse } from "next/server";
+import { getAuthedConvexClient } from "@/lib/convex/route";
+import { api } from "@/lib/convex/api";
+import { documentBridgeErrorResponse } from "@/lib/documents/bridge";
+
+const bridgeLogsApi = api as any;
+
+export async function GET(request: Request) {
+  try {
+    const url = new URL(request.url);
+    const workspaceId = url.searchParams.get("workspaceId")?.trim() ?? "";
+    const requestId = url.searchParams.get("requestId")?.trim() ?? "";
+    if (!workspaceId || !requestId) {
+      return NextResponse.json({ error: "缺少 workspaceId 或 requestId" }, { status: 400 });
+    }
+
+    const { client } = await getAuthedConvexClient();
+    const result = await client.query(bridgeLogsApi.bridgeLogs.listByRequest, {
+      workspaceId,
+      requestId,
+    });
+
+    return NextResponse.json(result);
+  } catch (error) {
+    return documentBridgeErrorResponse(error);
+  }
+}

wolai-frontend/src/app/api/bridge/trace/route.ts

@@ -0,0 +1,27 @@
+import { NextResponse } from "next/server";
+import { getAuthedConvexClient } from "@/lib/convex/route";
+import { api } from "@/lib/convex/api";
+import { documentBridgeErrorResponse } from "@/lib/documents/bridge";
+
+const bridgeLogsApi = api as any;
+
+export async function GET(request: Request) {
+  try {
+    const url = new URL(request.url);
+    const workspaceId = url.searchParams.get("workspaceId")?.trim() ?? "";
+    const traceId = url.searchParams.get("traceId")?.trim() ?? "";
+    if (!workspaceId || !traceId) {
+      return NextResponse.json({ error: "缺少 workspaceId 或 traceId" }, { status: 400 });
+    }
+
+    const { client } = await getAuthedConvexClient();
+    const result = await client.query(bridgeLogsApi.bridgeLogs.listByTrace, {
+      workspaceId,
+      traceId,
+    });
+
+    return NextResponse.json(result);
+  } catch (error) {
+    return documentBridgeErrorResponse(error);
+  }
+}

wolai-frontend/src/app/api/documents/content/route.ts

@@ -2,28 +2,57 @@ import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
 import { getAuthedConvexClient } from "@/lib/convex/route";
 import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  buildDocumentBridgeContext,
+  buildDocumentQueryEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
 
 export const dynamic = "force-dynamic";
 
 export async function GET(request: Request) {
   if (isConvexEnabled()) {
-    const url = new URL(request.url);
-    const documentId = url.searchParams.get("documentId") ?? "";
+    try {
+      const url = new URL(request.url);
+      const documentId = assertDocumentId(url.searchParams.get("documentId"));
+      const workspaceId = url.searchParams.get("workspaceId")?.trim() || null;
+      const { client } = await getAuthedConvexClient();
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId });
+      const envelope = buildDocumentQueryEnvelope({
+        name: "documents.content.get",
+        payload: { documentId, workspaceId },
+      });
 
-    if (!documentId) {
-      return NextResponse.json({ error: "缺少 documentId" }, { status: 400 });
+      const result = await client.query(api.documents.getContent, {
+        id: documentId,
+      });
+
+      if (!result) {
+        return NextResponse.json(
+          {
+            error: "页面不存在",
+            meta: {
+              requestId: bridgeContext.requestId,
+              traceId: bridgeContext.traceId,
+              queryName: envelope.name,
+            },
+          },
+          { status: 404 },
+        );
+      }
+
+      return NextResponse.json({
+        content: result.content ?? null,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          queryName: envelope.name,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
     }
-
-    const { client } = await getAuthedConvexClient();
-    const result = await client.query(api.documents.getContent, {
-      id: documentId,
-    });
-
-    if (!result) {
-      return NextResponse.json({ error: "页面不存在" }, { status: 404 });
-    }
-
-    return NextResponse.json({ content: result.content ?? null });
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/meta/route.ts

@@ -0,0 +1,57 @@
+import { NextResponse } from "next/server";
+import { isConvexEnabled } from "@/lib/convex/enabled";
+import { getAuthedConvexClient } from "@/lib/convex/route";
+import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  buildDocumentBridgeContext,
+  buildDocumentQueryEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+
+export const dynamic = "force-dynamic";
+
+export async function GET(request: Request) {
+  if (isConvexEnabled()) {
+    try {
+      const url = new URL(request.url);
+      const documentId = assertDocumentId(url.searchParams.get("documentId"));
+      const workspaceId = url.searchParams.get("workspaceId")?.trim() || null;
+      const { client } = await getAuthedConvexClient();
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId });
+      const envelope = buildDocumentQueryEnvelope({
+        name: "documents.meta.get",
+        payload: { documentId, workspaceId },
+      });
+
+      const doc = await client.query(api.documents.getMeta, { id: documentId });
+
+      if (!doc) {
+        return NextResponse.json(
+          {
+            error: "页面不存在",
+            meta: {
+              requestId: bridgeContext.requestId,
+              traceId: bridgeContext.traceId,
+              queryName: envelope.name,
+            },
+          },
+          { status: 404 },
+        );
+      }
+
+      return NextResponse.json({
+        doc,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          queryName: envelope.name,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
+    }
+  }
+
+  return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });
+}

wolai-frontend/src/app/api/documents/options/route.ts

@@ -1,42 +1,65 @@
 import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
-import { getAuthedConvexClient } from "@/lib/convex/route";
-import { api } from "@/lib/convex/api";
 import type { PageOptionsState } from "@/types/page-options";
+import {
+  assertDocumentId,
+  assertOptionsPatch,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import {
+  executeMetadataBridgeCommand,
+  type DocumentOptionsUpdatePayload,
+} from "@/lib/documents/metadata-command-adapter";
 
 type OptionsPayload = {
   documentId: string;
+  workspaceId?: string | null;
   options: Partial<PageOptionsState>;
 };
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, options }: OptionsPayload = await request.json();
-    if (!documentId || !options) {
-      return NextResponse.json({ error: "缺少参数" }, { status: 400 });
+    try {
+      const { documentId, workspaceId, options }: OptionsPayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      assertOptionsPatch(options);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({
+        request,
+        workspaceId: normalizedWorkspaceId,
+      });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.options.update",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          options,
+        } satisfies DocumentOptionsUpdatePayload,
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+      const result = await executeMetadataBridgeCommand({
+        context: bridgeContext,
+        envelope,
+      });
+
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: result.requestId,
+          traceId: result.traceId,
+          commandId: result.commandId,
+          commandName: result.commandName,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
     }
-
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateOptions, {
-      id: documentId,
-      options: {
-        wideLayout: options.wideLayout,
-        smallText: options.smallText,
-        showHeadingNumbers: options.showHeadingNumbers,
-        showToc: options.showToc,
-        showStructure: options.showStructure,
-        protectEditing: options.protectEditing,
-        showWordCount: options.showWordCount,
-        collapseBacklinks: options.collapseBacklinks,
-        pageFont: options.pageFont,
-        layoutDensity: options.layoutDensity,
-        hideChildPages: options.hideChildPages,
-        showBlockRefCount: options.showBlockRefCount,
-        embedDefaultBlockId: typeof options.embedDefaultBlockId === "string" ? options.embedDefaultBlockId : null,
-      },
-    });
-
-    return NextResponse.json({ ok: true });
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/save/route.ts

@@ -2,21 +2,62 @@ import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
 import { getAuthedConvexClient } from "@/lib/convex/route";
 import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import { recordBridgeCommandArtifacts } from "@/lib/documents/bridge-log";
 
 interface SavePayload {
   documentId: string;
+  workspaceId?: string | null;
   content: unknown;
 }
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, content }: SavePayload = await request.json();
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateContent, {
-      id: documentId,
-      content,
-    });
-    return NextResponse.json({ ok: true });
+    try {
+      const { documentId, workspaceId, content }: SavePayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId: normalizedWorkspaceId });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.save",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          content,
+        },
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+
+      const { client } = await getAuthedConvexClient();
+      await client.mutation(api.documents.updateContent, {
+        id: normalizedDocumentId,
+        content: envelope.payload.content,
+      });
+      await recordBridgeCommandArtifacts({
+        context: bridgeContext,
+        envelope,
+      });
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          commandId: envelope.commandId,
+          commandName: envelope.name,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
+    }
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/stats/route.ts

@@ -1,32 +1,65 @@
 import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
-import { getAuthedConvexClient } from "@/lib/convex/route";
-import { api } from "@/lib/convex/api";
 import type { DocumentStats } from "@/types/page-options";
+import {
+  assertDocumentId,
+  assertStats,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import {
+  executeMetadataBridgeCommand,
+  type DocumentStatsUpdatePayload,
+} from "@/lib/documents/metadata-command-adapter";
 
 interface StatsPayload {
   documentId: string;
+  workspaceId?: string | null;
   stats: DocumentStats;
 }
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, stats }: StatsPayload = await request.json();
-    if (!documentId || !stats) {
-      return NextResponse.json({ error: "缺少参数" }, { status: 400 });
+    try {
+      const { documentId, workspaceId, stats }: StatsPayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      assertStats(stats);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({
+        request,
+        workspaceId: normalizedWorkspaceId,
+      });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.stats.update",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          stats,
+        } satisfies DocumentStatsUpdatePayload,
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+      const result = await executeMetadataBridgeCommand({
+        context: bridgeContext,
+        envelope,
+      });
+
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: result.requestId,
+          traceId: result.traceId,
+          commandId: result.commandId,
+          commandName: result.commandName,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
     }
-
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateStats, {
-      id: documentId,
-      wordCount: stats.wordCount,
-      characterCount: stats.characterCount,
-      blockCount: stats.blockCount,
-      todoTotal: stats.todoTotal,
-      todoDone: stats.todoDone,
-    });
-
-    return NextResponse.json({ ok: true });
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/documents/title/route.ts

@@ -1,22 +1,61 @@
 import { NextResponse } from "next/server";
 import { isConvexEnabled } from "@/lib/convex/enabled";
-import { getAuthedConvexClient } from "@/lib/convex/route";
-import { api } from "@/lib/convex/api";
+import {
+  assertDocumentId,
+  assertTitle,
+  buildDocumentBridgeContext,
+  buildDocumentCommandEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import {
+  executeMetadataBridgeCommand,
+  type DocumentTitleUpdatePayload,
+} from "@/lib/documents/metadata-command-adapter";
 
 interface RenamePayload {
   documentId: string;
+  workspaceId?: string | null;
   title: string;
 }
 
 export async function POST(request: Request) {
   if (isConvexEnabled()) {
-    const { documentId, title }: RenamePayload = await request.json();
-    const { client } = await getAuthedConvexClient();
-    await client.mutation(api.documents.updateTitle, {
-      id: documentId,
-      title,
-    });
-    return NextResponse.json({ ok: true });
+    try {
+      const { documentId, workspaceId, title }: RenamePayload = await request.json();
+      const normalizedDocumentId = assertDocumentId(documentId);
+      const normalizedTitle = assertTitle(title);
+      const normalizedWorkspaceId = workspaceId?.trim() || null;
+      const bridgeContext = await buildDocumentBridgeContext({ request, workspaceId: normalizedWorkspaceId });
+      const envelope = buildDocumentCommandEnvelope({
+        name: "documents.title.update",
+        payload: {
+          documentId: normalizedDocumentId,
+          workspaceId: normalizedWorkspaceId,
+          title: normalizedTitle,
+        } satisfies DocumentTitleUpdatePayload,
+        context: bridgeContext,
+        target: {
+          workspaceId: normalizedWorkspaceId,
+          pageId: normalizedDocumentId,
+        },
+      });
+      const result = await executeMetadataBridgeCommand({
+        context: bridgeContext,
+        envelope,
+      });
+
+      return NextResponse.json({
+        ok: true,
+        meta: {
+          requestId: result.requestId,
+          traceId: result.traceId,
+          commandId: result.commandId,
+          commandName: result.commandName,
+        },
+      });
+    } catch (error) {
+      return documentBridgeErrorResponse(error);
+    }
   }
 
   return NextResponse.json({ error: "当前仅支持 Convex 模式" }, { status: 501 });

wolai-frontend/src/app/api/sidebar/route.ts

@@ -1,263 +1,58 @@
 import { NextResponse } from "next/server";
-import type { SidebarInitialData } from "@/components/sidebar/types";
 import { isConvexEnabled } from "@/lib/convex/enabled";
-import { api } from "@/lib/convex/api";
 import { getAuthedConvexClient } from "@/lib/convex/route";
-import { randomUUID } from "crypto";
-import type { MediaAsset } from "@/types/media";
+import {
+  buildDocumentBridgeContext,
+  buildDocumentQueryEnvelope,
+  documentBridgeErrorResponse,
+} from "@/lib/documents/bridge";
+import { loadSidebarDataFromConvex } from "@/lib/server/sidebar-data";
 
 export const dynamic = "force-dynamic";
 
-function extractMindmapImageAssetIdsFromData(input: unknown): string[] {
-  const root = (() => {
-    if (!input || typeof input !== "object") return input;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const record = input as any;
-    // 兼容：某些导图结构为 { root: ... }
-    return record && typeof record === "object" && "root" in record ? record.root : input;
-  })();
-
-  const ids: string[] = [];
-  const seen = new Set<string>();
-
-  const push = (value: unknown) => {
-    if (typeof value !== "string") return;
-    if (!value.startsWith("asset:")) return;
-    const id = value.slice("asset:".length).trim();
-    if (!id) return;
-    if (seen.has(id)) return;
-    seen.add(id);
-    ids.push(id);
-  };
-
-  const get = (obj: unknown, key: string): unknown => {
-    if (!obj || typeof obj !== "object") return undefined;
-    return (obj as Record<string, unknown>)[key];
-  };
-
-  const walk = (node: unknown) => {
-    if (!node || typeof node !== "object") return;
-
-    const data = get(node, "data");
-    const image = get(node, "image");
-
-    // 常见：node.data.image = "asset:xxx"
-    push(get(data, "image"));
-    // 兼容：node.image = "asset:xxx"
-    push(image);
-    // 兼容：node.image.url = "asset:xxx"
-    push(get(image, "url"));
-    // 兼容：node.data.image.url = "asset:xxx"
-    push(get(get(data, "image"), "url"));
-
-    const children = get(node, "children");
-    if (Array.isArray(children)) {
-      children.forEach(walk);
-    }
-  };
-
-  walk(root);
-  return ids;
-}
-
 export async function GET(request: Request) {
   if (isConvexEnabled()) {
     const { auth, client } = await getAuthedConvexClient();
 
     const url = new URL(request.url);
     const workspaceIdParam = url.searchParams.get("workspaceId");
-
-    const bootstrap = await client.mutation(api.workspaces.ensureDefaultWorkspace, {
+    const {
+      targetWorkspaceId,
+      sidebarInitialData,
+    } = await loadSidebarDataFromConvex({
+      client,
+      userId: auth.userId,
       fallbackName: auth.email ?? auth.name ?? "我的空间",
-      workspaceIdIfCreate: randomUUID(),
+      requestedWorkspaceId: workspaceIdParam,
     });
 
-    const summaries = await client.query(api.workspaces.fetchWorkspaceSummaries, {
-    });
-
-    const workspaces = summaries.workspaces.length > 0 ? summaries.workspaces : bootstrap.workspaces;
-    const activeWorkspaceId = summaries.activeWorkspaceId || bootstrap.activeWorkspaceId;
-    const targetWorkspaceId = workspaceIdParam || activeWorkspaceId;
-
     if (!targetWorkspaceId) {
       return NextResponse.json({ error: "暂无可用工作空间" }, { status: 404 });
     }
 
     try {
-      const documents = await client.query(api.documents.listByWorkspace, {
+      const bridgeContext = await buildDocumentBridgeContext({
+        request,
         workspaceId: targetWorkspaceId,
       });
-
-      const trashedDocuments = await client.query(api.documents.listTrashedByWorkspace, {
-        workspaceId: targetWorkspaceId,
+      const envelope = buildDocumentQueryEnvelope({
+        name: "sidebar.dataset.list",
+        payload: { workspaceId: targetWorkspaceId },
       });
+      if (!sidebarInitialData) {
+        return NextResponse.json({ error: "暂无可用工作空间" }, { status: 404 });
+      }
 
-      const mindmapRows = await client.query(api.mindmaps.listByWorkspace, {
-        workspaceId: targetWorkspaceId,
-        includeDeleted: true,
+      return NextResponse.json({
+        ...sidebarInitialData,
+        meta: {
+          requestId: bridgeContext.requestId,
+          traceId: bridgeContext.traceId,
+          queryName: envelope.name,
+        },
       });
-
-      const mediaAssets = await client.query(api.mediaAssets.listByWorkspace, {
-        userId: auth.userId,
-        workspaceId: targetWorkspaceId,
-        limit: 200,
-      });
-
-      const trashedMediaAssets = await client.query(api.mediaAssets.listDeletedByWorkspace, {
-        userId: auth.userId,
-        workspaceId: targetWorkspaceId,
-        limit: 2000,
-      });
-
-      const tables = await client.query(api.tables.listByWorkspaceForSearch, {
-        userId: auth.userId,
-        workspaceId: targetWorkspaceId,
-        includeArchived: true,
-        limit: 3000,
-      });
-
-      const activeMindmaps = (mindmapRows ?? []).filter((r) => !r.deleted_at);
-      const trashedMindmaps = (mindmapRows ?? []).filter((r) => !!r.deleted_at);
-
-      const mindmapDocs = Array.from(new Set(activeMindmaps.map((r) => r.document_id)));
-
-      const mindmapAssetChildren: Record<string, string[]> = {};
-      activeMindmaps.forEach((r) => {
-        const ids = extractMindmapImageAssetIdsFromData(r.data);
-        if (ids.length > 0) {
-          mindmapAssetChildren[r.mindmap_id] = ids;
-        }
-      });
-
-      const mindmapAssets: MediaAsset[] = activeMindmaps.map((r) => {
-        const isLegacy = r.mindmap_id.startsWith("legacy-");
-        return {
-          id: r.mindmap_id,
-          workspace_id: r.workspace_id ?? targetWorkspaceId,
-          document_id: r.document_id,
-          asset_type: "mindmap",
-          file_url: null,
-          thumbnail_url: null,
-          bucket: null,
-          storage_path: null,
-          file_name: isLegacy ? "mindmap.json" : `mindmap-${r.mindmap_id}.json`,
-          file_size: null,
-          mime_type: "application/json",
-          ocr_payload: undefined,
-          ocr_strategy: null,
-          ocr_text: null,
-          ocr_status: null,
-          signed_url: null,
-          created_at: r.created_at ?? "",
-          updated_at: r.updated_at ?? "",
-        };
-      });
-
-      const trashedMindmapAssets: MediaAsset[] = trashedMindmaps.map((r) => {
-        const isLegacy = r.mindmap_id.startsWith("legacy-");
-        return {
-          id: r.mindmap_id,
-          workspace_id: r.workspace_id ?? targetWorkspaceId,
-          document_id: r.document_id,
-          asset_type: "mindmap",
-          file_url: null,
-          thumbnail_url: null,
-          bucket: null,
-          storage_path: null,
-          file_name: isLegacy ? "mindmap.json" : `mindmap-${r.mindmap_id}.json`,
-          file_size: null,
-          mime_type: "application/json",
-          ocr_payload: undefined,
-          ocr_strategy: null,
-          ocr_text: null,
-          ocr_status: null,
-          deleted_at: r.deleted_at ?? null,
-          deleted_by: r.deleted_by ?? null,
-          purged_at: null,
-          signed_url: null,
-          created_at: r.created_at ?? "",
-          updated_at: r.updated_at ?? "",
-        };
-      });
-
-      const tableAssets: MediaAsset[] = (tables ?? [])
-        .filter((row) => !row.is_archived)
-        .map((row) => {
-        const base = String(row.title ?? "未命名表格").trim() || "未命名表格";
-        const fileName = base.toLowerCase().endsWith(".luckysheet") ? base : `${base}.luckysheet`;
-        return {
-          id: row.id,
-          workspace_id: row.workspace_id ?? targetWorkspaceId,
-          document_id: row.document_id,
-          asset_type: "luckysheet",
-          file_url: null,
-          thumbnail_url: null,
-          bucket: null,
-          storage_path: null,
-          file_name: fileName,
-          file_size: null,
-          mime_type: "application/json",
-          ocr_payload: undefined,
-          ocr_strategy: null,
-          ocr_text: null,
-          ocr_status: null,
-          signed_url: null,
-          created_at: row.created_at ?? "",
-          updated_at: row.updated_at ?? "",
-        };
-      });
-
-      const trashedTableAssets: MediaAsset[] = (tables ?? [])
-        .filter((row) => Boolean(row.is_archived))
-        .map((row) => {
-          const base = String(row.title ?? "未命名表格").trim() || "未命名表格";
-          const fileName = base.toLowerCase().endsWith(".luckysheet") ? base : `${base}.luckysheet`;
-          return {
-            id: row.id,
-            workspace_id: row.workspace_id ?? targetWorkspaceId,
-            document_id: row.document_id,
-            asset_type: "luckysheet",
-            file_url: null,
-            thumbnail_url: null,
-            bucket: null,
-            storage_path: null,
-            file_name: fileName,
-            file_size: null,
-            mime_type: "application/json",
-            ocr_payload: undefined,
-            ocr_strategy: null,
-            ocr_text: null,
-            ocr_status: null,
-            deleted_at: row.deleted_at ?? row.updated_at ?? null,
-            deleted_by: row.deleted_by ?? null,
-            purged_at: row.purged_at ?? null,
-            signed_url: null,
-            created_at: row.created_at ?? "",
-            updated_at: row.updated_at ?? "",
-          };
-        });
-
-      const payload: SidebarInitialData = {
-        activeWorkspaceId: targetWorkspaceId,
-        workspaces,
-        documents,
-        trashedDocuments,
-        trashedMediaAssets: (trashedMediaAssets ?? []) as MediaAsset[],
-        trashedMindmapAssets,
-        trashedTableAssets,
-        mindmapDocs,
-        mindmapAssets,
-        mindmapAssetChildren,
-        tableAssets,
-        mediaAssets: (mediaAssets ?? []) as MediaAsset[],
-      };
-
-      return NextResponse.json(payload);
     } catch (error) {
-      return NextResponse.json(
-        { error: error instanceof Error ? error.message : "拉取侧边栏数据失败" },
-        { status: 500 },
-      );
+      return documentBridgeErrorResponse(error);
     }
   }
 
@@ -268,22 +63,22 @@ export async function GET(request: Request) {
   const {
     data: { session },
   } = await supabase.auth.getSession();
-
-  if (!session) {
-    return NextResponse.json({ error: "未登录" }, { status: 401 });
-  }
-
-  const url = new URL(request.url);
-  const workspaceIdParam = url.searchParams.get("workspaceId");
-
-  await ensureDefaultWorkspace(supabase, session.user.id, session.user.email ?? "我的空间");
-  const { workspaces, activeWorkspaceId } = await fetchWorkspaceSummaries(supabase, session.user.id);
-  const targetWorkspaceId = workspaceIdParam || activeWorkspaceId;
-
-  if (!targetWorkspaceId) {
-    return NextResponse.json({ error: "暂无可用工作空间" }, { status: 404 });
-  }
-
+
+  if (!session) {
+    return NextResponse.json({ error: "未登录" }, { status: 401 });
+  }
+
+  const url = new URL(request.url);
+  const workspaceIdParam = url.searchParams.get("workspaceId");
+
+  await ensureDefaultWorkspace(supabase, session.user.id, session.user.email ?? "我的空间");
+  const { workspaces, activeWorkspaceId } = await fetchWorkspaceSummaries(supabase, session.user.id);
+  const targetWorkspaceId = workspaceIdParam || activeWorkspaceId;
+
+  if (!targetWorkspaceId) {
+    return NextResponse.json({ error: "暂无可用工作空间" }, { status: 404 });
+  }
+
   try {
     const dataset = await fetchSidebarDataset(supabase, targetWorkspaceId);
     const docIds = dataset.documents.map((d) => d.id);
@@ -360,10 +155,10 @@ export async function GET(request: Request) {
 
     return NextResponse.json(payload);
   } catch (error) {
-    return NextResponse.json(
-      { error: error instanceof Error ? error.message : "拉取侧边栏数据失败" },
-      { status: 500 },
-    );
-  }
+    return NextResponse.json(
+      { error: error instanceof Error ? error.message : "拉取侧边栏数据失败" },
+      { status: 500 },
+    );
+  }
   */
 }