@@ -57,26 +57,103 @@ function walkCloud(value: unknown, nodes: DeckIrNode[], hash: string, locator: s
   if (Array.isArray(value)) { value.forEach((item, index) => walkCloud(item, nodes, hash, `${locator}/${index}`, page, parentId)); return; }
   const record = value as Record<string, unknown>;
   const text = cloudText(record);
-  const kind = String(record.type ?? (record.txBody ? 'shape' : record.table ? 'table' : text ? 'text' : 'object')).toLowerCase();
+  const kind = cloudKind(record, text);
   let nextParent = parentId;
+  const skipKeys = new Set<string>(WALK_SKIP_KEYS);
   if (text || ['shape', 'picture', 'image', 'table', 'group', 'chart'].some((token) => kind.includes(token))) {
     const id = stableId(hash, `cloud:${locator}`);
     const xfrm = object(record.xfrm);
-    const assetPath = string(record.assetPath ?? record.suggestedPath ?? record.path);
+    // 只认解析器明确给出的资产指针。`path` 曾经也在这条兜底链上，但在 pptx 里它是自选
+    // 图形的几何路径（`"M 0 0 L 10 10 Z"`），任何 Freeform 都会因此被判成「指向不存在的
+    // 资产」，凭空产出一条 cloud_asset_unavailable 并把 quality 顶成 degraded。
+    const assetPath = string(record.assetPath ?? record.suggestedPath);
     const externalUrl = string(record.accessURL ?? record.url);
     const node: DeckIrNode = { id, type: kind, parentId, children: [], order: nodes.length, ...(text ? { text } : {}),
       ...(page ? { page } : {}), sourceRef: { path: locator, ...(page ? { page } : {}) },
       ...(xfrm && [xfrm.x, xfrm.y, xfrm.cx, xfrm.cy].every((item) => typeof item === 'number') ?
         { bbox: [xfrm.x as number, xfrm.y as number, (xfrm.x as number) + (xfrm.cx as number), (xfrm.y as number) + (xfrm.cy as number)] } : {}),
       extensions: { cloud: { id: record.id, name: record.name, style: record.style }, ...(assetPath ? { assetPath } : {}), ...(externalUrl ? { externalUrl } : {}) } };
     nodes.push(node); if (parentId) nodes.find((item) => item.id === parentId)?.children.push(id); nextParent = id;
+    // 表格必须按 table → table_row → table_cell 发，和 local/pptx、local/docx、result3 三个
+    // 适配器一致：Markdown 渲染器只认这三种类型，让通用遍历把单元格摊成一串 shape 子节点，
+    // 整张表会在渲染时被静默丢掉——IR 里看得见，产物里一个字都没有。
+    if (kind.includes('table') && emitCloudTable(record, node, nodes, hash, locator, page)) {
+      skipKeys.add('table');
+    }
   }
   for (const [key, child] of Object.entries(record)) {
-    if (['style', 'xfrm', 'txBody', 'text', 't', 'name', 'id', 'type'].includes(key)) continue;
+    if (skipKeys.has(key)) continue;
     if (child && typeof child === 'object') walkCloud(child, nodes, hash, `${locator}/${key}`, page, nextParent);
   }
 }
 
+/** 遍历时不再下钻的键：要么已在节点上表达，要么由更专门的分支接管。 */
+const WALK_SKIP_KEYS = ['style', 'xfrm', 'txBody', 'text', 't', 'name', 'id', 'type'] as const;
+
+/**
+ * 把云端表格结构展开成行列节点；认不出行列就返回 false，交回通用遍历。
+ *
+ * 行与单元格的键名各格式不同（pptx 是 `table.trs[].cells[]`），所以按候选键取第一个命中的，
+ * 而不是写死某一种格式。
+ */
+function emitCloudTable(
+  record: Record<string, unknown>,
+  table: DeckIrNode,
+  nodes: DeckIrNode[],
+  hash: string,
+  locator: string,
+  page?: number,
+): boolean {
+  const container = object(record.table) ?? record;
+  const rows = array(container.trs ?? container.rows).map((row) =>
+    array(object(row)?.cells ?? object(row)?.tcs).flatMap((cell) => {
+      const parsed = object(cell);
+      return parsed ? [parsed] : [];
+    }));
+  if (!rows.some((cells) => cells.length > 0)) return false;
+  table.extensions = { ...table.extensions, rows: rows.length,
+    columns: Math.max(...rows.map((cells) => cells.length)) };
+  rows.forEach((cells, rowIndex) => {
+    const rowLocator = `${locator}/row/${rowIndex}`;
+    const rowId = stableId(hash, `cloud:${rowLocator}`);
+    const row: DeckIrNode = { id: rowId, type: 'table_row', parentId: table.id, children: [], order: nodes.length,
+      ...(page ? { page } : {}), sourceRef: { path: rowLocator, ...(page ? { page } : {}) } };
+    nodes.push(row); table.children.push(rowId);
+    cells.forEach((cell, column) => {
+      const cellLocator = `${rowLocator}/cell/${column}`;
+      const cellId = stableId(hash, `cloud:${cellLocator}`);
+      const text = cloudText(cell);
+      nodes.push({ id: cellId, type: 'table_cell', parentId: rowId, children: [], order: nodes.length,
+        ...(text ? { text } : {}), ...(page ? { page } : {}),
+        sourceRef: { path: cellLocator, ...(page ? { page } : {}) },
+        extensions: { row: rowIndex, column,
+          gridSpan: number(cell.colSpan ?? cell.gridSpan) ?? 1, rowSpan: number(cell.rowSpan) ?? 1,
+          ...(cell.hMerge === true ? { hMerge: true } : {}), ...(cell.vMerge === true ? { vMerge: true } : {}) } });
+      row.children.push(cellId);
+    });
+  });
+  return true;
+}
+
+/**
+ * 节点类型。
+ *
+ * 解析器自报的 `type` 是它的形状分类（pptx 一律是 "Shape"），不是文档语义：整篇因此落成
+ * 清一色的 shape，Markdown 一个标题都没有（实测 99 页文档本地 96 个 heading、云端 0 个）。
+ * 占位符类型才是 OOXML 里「这是标题」的确定性证据，与 local/pptx/parser.ts 用的是同一条
+ * 判据 —— 两个引擎的产物必须在这件事上对得上，否则同一份文件换引擎结构就变了。
+ *
+ * 只在有文字时改判，空的标题占位符仍按原类型走：那些节点靠类型词命中才得以建出来，
+ * 改成 heading 会让它们从 IR 里整个消失。
+ */
+function cloudKind(record: Record<string, unknown>, text: string): string {
+  const placeholder = string(object(record.ph)?.type);
+  const declared = string(record.type)?.toLowerCase();
+  if (text && (placeholder === 'title' || placeholder === 'ctrTitle')) return 'heading';
+  if (text && declared === 'shape') return 'text';
+  return declared ?? (record.txBody ? 'shape' : record.table ? 'table' : text ? 'text' : 'object');
+}
+
 function cloudText(record: Record<string, unknown>): string {
   if (typeof record.text === 'string') return record.text;
   if (typeof record.t === 'string') return record.t;
 
@@ -0,0 +1,105 @@
+import { describe, expect, it } from 'vitest';
+import { cloudResultToCandidate } from '../../src/ir/cloud-adapter.js';
+import { renderMarkdown } from '../../src/views/markdown.js';
+import type { ParseResult } from '../../src/cloud/parse-facade.js';
+
+const source = { sha256: 'a'.repeat(64), name: 'fixture.pptx', bytes: 1 };
+
+const parse = (spTree: unknown[]): Promise<ReturnType<typeof cloudResultToCandidate>> =>
+  cloudResultToCandidate(
+    {
+      taskId: 'task', type: 'pptx.parse', irKey: 'ir/fixture', irSchemaVersion: 'pptx.v1',
+      ir: { slides: [{ _ref: 'slide1', spTree }], files: {}, images: [] },
+    } as ParseResult,
+    source,
+  ) as never;
+
+const cell = (text: string, extra: Record<string, unknown> = {}) => ({
+  text, txBody: { children: [{ children: [{ t: text }] }] }, ...extra,
+});
+
+describe('cloud IR adapter', () => {
+  it('expands tables into table_row and table_cell so Markdown can render them', async () => {
+    const candidate = await parse([
+      {
+        id: 1, name: 'Table 1', type: 'Table', xfrm: { x: 0, y: 0, cx: 400, cy: 100 },
+        table: {
+          grid: { cols: [] },
+          trs: [
+            { cells: [cell('Name'), cell('Qty')] },
+            { cells: [cell('Widget'), cell('12')] },
+          ],
+        },
+      },
+    ]);
+
+    const types = candidate.ir.document.nodes.map((node) => node.type);
+    expect(types).toEqual(['table', 'table_row', 'table_cell', 'table_cell', 'table_row', 'table_cell', 'table_cell']);
+
+    const table = candidate.ir.document.nodes[0]!;
+    expect(table.extensions).toMatchObject({ rows: 2, columns: 2 });
+    // 单元格摊成 table 的直接子节点时渲染器一个字都取不到，这里锁住层级。
+    const rows = candidate.ir.document.nodes.filter((node) => node.type === 'table_row');
+    expect(rows.map((row) => row.parentId)).toEqual([table.id, table.id]);
+    expect(rows.every((row) => row.children.length === 2)).toBe(true);
+
+    expect(renderMarkdown(candidate.ir).markdown).toContain('| Name | Qty |\n| --- | --- |\n| Widget | 12 |');
+  });
+
+  it('carries merge spans through to the cells', async () => {
+    const candidate = await parse([
+      {
+        id: 1, name: 'Table 1', type: 'Table',
+        table: { grid: { cols: [] }, trs: [{ cells: [cell('Wide', { colSpan: 2 }), cell('', { hMerge: true })] }] },
+      },
+    ]);
+
+    const cells = candidate.ir.document.nodes.filter((node) => node.type === 'table_cell');
+    expect(cells[0]!.extensions).toMatchObject({ row: 0, column: 0, gridSpan: 2, rowSpan: 1 });
+    expect(cells[1]!.extensions).toMatchObject({ column: 1, hMerge: true });
+  });
+
+  it('leaves records without a recognizable grid to the generic walk', async () => {
+    const candidate = await parse([
+      { id: 1, name: 'Empty', type: 'Table', table: { grid: { cols: [] }, trs: [] } },
+    ]);
+
+    expect(candidate.ir.document.nodes.map((node) => node.type)).toEqual(['table']);
+  });
+
+  it('types title placeholders as headings and text shapes as text', async () => {
+    const candidate = await parse([
+      { id: 1, name: 'Title 1', type: 'Shape', ph: { type: 'title' },
+        txBody: { children: [{ children: [{ t: 'Application architectures' }] }] }, text: 'Application architectures' },
+      { id: 2, name: 'Body 1', type: 'Shape', ph: { type: 'body' },
+        txBody: { children: [{ children: [{ t: 'Client-server' }] }] }, text: 'Client-server' },
+      // 空的标题占位符靠类型词才建得出节点，改判 heading 会让它整个消失。
+      { id: 3, name: 'Empty title', type: 'Shape', ph: { type: 'ctrTitle' }, xfrm: { x: 0, y: 0, cx: 10, cy: 10 } },
+    ]);
+
+    expect(candidate.ir.document.nodes.map((node) => node.type)).toEqual(['heading', 'text', 'shape']);
+    expect(renderMarkdown(candidate.ir).markdown).toContain('## Application architectures');
+  });
+
+  it('does not mistake a freeform geometry path for an asset pointer', async () => {
+    const candidate = await parse([
+      { id: 1, name: 'Freeform 9', type: 'Shape', path: 'M 0 0 L 10 10 Z', xfrm: { x: 0, y: 0, cx: 10, cy: 10 } },
+    ]);
+
+    const [shape] = candidate.ir.document.nodes;
+    expect(shape!.extensions?.assetPath).toBeUndefined();
+    expect(shape!.issues ?? []).toEqual([]);
+    // 几何路径被当成资产时会凭空产出这条告警，并把整份产物顶成 degraded。
+    expect(candidate.ir.quality.checks.map((check) => check.code)).not.toContain('cloud_asset_unavailable');
+    expect(candidate.ir.quality.status).toBe('pass');
+  });
+
+  it('still reports a real asset that the cloud could not materialize', async () => {
+    const candidate = await parse([
+      { id: 1, name: 'Picture 1', type: 'Picture', assetPath: 'assets/missing.png' },
+    ]);
+
+    expect(candidate.ir.document.nodes[0]!.issues).toEqual(['missing_media']);
+    expect(candidate.ir.quality.checks.map((check) => check.code)).toContain('cloud_asset_unavailable');
+  });
+});