refactor: use Exchange Node for Office conversion

Author: OTime-Coder

AGENTS.md

@@ -36,11 +36,11 @@ scripts                       仓库级 SDK 版本与 CLI 本地开发脚本
 
 本仓库是 product/application composition root，不重新拥有上游 SDK 的合同：
 
-- Univer / Univer Pro SDK 拥有 Unit 数据模型、Facade API、mutation、render 和内容能力。
+- Univer / Univer Pro SDK 拥有 Unit 数据模型、Facade API、mutation、render、Office exchange 和内容能力。
 - Univer Collaboration SDK 拥有 snapshot、changeset、revision、OT、协同 Service、Worktree、
   Database Adapter、Endpoint 和 Transport 合同。
-- Univer CLI SDK 拥有 target-neutral 的 headless runtime、execution、inspection、render、exchange、
-  daemon 和可选 Commander preset。
+- Univer CLI SDK 拥有 target-neutral 的 headless runtime、execution、inspection、render、daemon 和可选
+  Commander preset。
 - Workspace 产品模型、认证、资源目录、远程 workflow 和 deployment 留在本仓库。
 
 只通过已发布 package 的公开 exports 使用其他 SDK。代码、构建、测试和生成流程不得依赖相邻仓库

DREAMNUM.md

@@ -30,13 +30,13 @@
 
 - [`dream-num/univer`](https://github.com/dream-num/univer) — owns the core Unit model, Facade APIs, mutations,
   rendering, and `@univerjs/*` packages composed by both applications. Contract: [repository boundary](AGENTS.md).
-- [`dream-num/univer-pro`](https://github.com/dream-num/univer-pro) — owns the Univer Pro content, collaboration
-  client, and UI packages consumed by the Browser and CLI. Contract: [repository boundary](AGENTS.md).
+- [`dream-num/univer-pro`](https://github.com/dream-num/univer-pro) — owns the Univer Pro content, Office exchange,
+  collaboration client, and UI packages consumed by the Browser and CLI. Contract: [repository boundary](AGENTS.md).
 - [`dream-num/univer-collaboration-sdk`](https://github.com/dream-num/univer-collaboration-sdk) — owns collaboration
   Service, revision, changeset, Worktree, persistence, Endpoint, and Transport contracts used by Workspace.
   Contract: [repository boundary](AGENTS.md).
 - [`dream-num/univer-cli-sdk`](https://github.com/dream-num/univer-cli-sdk) — owns the target-neutral headless,
-  execution, inspection, rendering, exchange, daemon, and Commander capabilities composed by Workspace CLI.
+  execution, inspection, rendering, daemon, and Commander capabilities composed by Workspace CLI.
   Contract: [repository boundary](AGENTS.md).
 - [`dream-num/univer-protocol`](https://github.com/dream-num/univer-protocol) — owns the protocol types consumed by
   collaboration and content workflows. Contract: [repository boundary](AGENTS.md).

apps/cli/package.json

@@ -48,7 +48,6 @@
     "@univer-cli/resource-library": "1.0.0-insiders.20260819-8595af2",
     "@univer-cli/resource-library-command": "1.0.0-insiders.20260819-8595af2",
     "@univer-cli/svg-facade": "1.0.0-insiders.20260819-8595af2",
-    "@univer-cli/unit-exchange": "1.0.0-insiders.20260819-8595af2",
     "@univer-cli/unit-layout-lint": "1.0.0-insiders.20260819-8595af2",
     "@univer-cli/unit-layout-lint-command": "1.0.0-insiders.20260819-8595af2",
     "@univer-cli/unit-screenshot": "1.0.0-insiders.20260819-8595af2",
@@ -95,6 +94,8 @@
     "@univerjs-pro/engine-formula": "1.0.0-insiders.20260819-8595af2",
     "@univerjs-pro/engine-shape": "1.0.0-insiders.20260819-8595af2",
     "@univerjs-pro/exchange-client": "1.0.0-insiders.20260819-8595af2",
+    "@univerjs-pro/exchange-node": "1.0.0-insiders.20260819-8595af2",
+    "@univerjs-pro/exchange-node-binding": "0.1.0",
     "@univerjs-pro/ink": "1.0.0-insiders.20260819-8595af2",
     "@univerjs-pro/ink-ui": "1.0.0-insiders.20260819-8595af2",
     "@univerjs-pro/license": "1.0.0-insiders.20260819-8595af2",

apps/cli/scripts/package-artifact.mjs

@@ -8,7 +8,7 @@ export const EXTERNAL_RUNTIME_DEPENDENCIES = [
   "@univerjs-pro/cli-assets",
   "@univerjs-pro/doc-typst-native-binding",
   "@univerjs-pro/engine-formula-rust-binding",
-  "@univerjs-pro/uexcli",
+  "@univerjs-pro/exchange-node-binding",
   "puppeteer-core",
 ];
 
@@ -103,7 +103,6 @@ export function resolveExternalRuntimeDependencies(appRoot, source) {
   const appRequire = createRequire(resolve(appRoot, "package.json"));
   const renderRuntime = readPackageManifest(appRequire, "@univer-cli/univer-render-runtime");
   const typst = readPackageManifest(appRequire, "@univer-cli/doc-typst-facade");
-  const exchange = readPackageManifest(appRequire, "@univer-cli/unit-exchange");
   const headless = readPackageManifest(appRequire, "@univer-cli/headless-univer");
   const headlessRequire = createRequire(headless.path);
   const formula = readPackageManifest(headlessRequire, "@univerjs-pro/engine-formula-rust");
@@ -122,7 +121,10 @@ export function resolveExternalRuntimeDependencies(appRoot, source) {
       formula.manifest,
       "@univerjs-pro/engine-formula-rust-binding",
     ),
-    "@univerjs-pro/uexcli": readOwnedDependency(exchange.manifest, "@univerjs-pro/uexcli"),
+    "@univerjs-pro/exchange-node-binding": readOwnedDependency(
+      source,
+      "@univerjs-pro/exchange-node-binding",
+    ),
     "puppeteer-core": readOwnedDependency(renderRuntime.manifest, "puppeteer-core"),
   };
 }

apps/cli/scripts/smoke-package.mjs

@@ -1,10 +1,15 @@
 import { spawnSync } from "node:child_process";
 import { mkdtemp, mkdir, readFile, rm } from "node:fs/promises";
+import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
 import { basename, join, resolve } from "node:path";
 
 const packageRoot = resolve(process.argv[2] ?? "package-dist");
 const packageManifest = JSON.parse(await readFile(join(packageRoot, "package.json"), "utf8"));
+const registry = packageManifest.publishConfig?.registry;
+if (typeof registry !== "string" || registry === "") {
+  throw new Error("Package manifest must declare publishConfig.registry");
+}
 const temporaryRoot = await mkdtemp(join(tmpdir(), "univer-workspace-cli-package-"));
 let executable;
 let smokeEnv;
@@ -27,7 +32,14 @@ try {
   const tarball = join(tarballRoot, basename(artifacts[0].filename));
   run(
     "npm",
-    ["install", "--no-audit", "--no-fund", "--package-lock=false", tarball],
+    [
+      "install",
+      "--no-audit",
+      "--no-fund",
+      "--package-lock=false",
+      `--registry=${registry}`,
+      tarball,
+    ],
     installRoot,
   );
 
@@ -50,6 +62,15 @@ try {
   run(executable, ["api", "--help"], installRoot, smokeEnv);
   run(executable, ["daemon", "start", "--json"], installRoot, smokeEnv);
   run(executable, ["daemon", "status", "--json"], installRoot, smokeEnv);
+  const binding = createRequire(join(installRoot, "package.json"))(
+    "@univerjs-pro/exchange-node-binding",
+  );
+  if (
+    typeof binding.exchangeImportToSnapshot !== "function" ||
+    typeof binding.exchangeExportSnapshot !== "function"
+  ) {
+    throw new Error("Installed package did not load the Exchange Node native binding");
+  }
   run(executable, ["daemon", "stop", "--json"], installRoot, smokeEnv);
   console.log("[package-smoke] installed tarball commands passed");
 } finally {

apps/cli/src/features/exchange/exchange.ts

@@ -1,20 +1,41 @@
 import { extname } from "node:path";
 import type { DaemonClient, JsonValue } from "@univer-cli/daemon";
 import {
-  UnitExchangeFormat,
-  type ImportableUnitType,
-  type UnitExchange,
-  type UnitExchangeData,
-} from "@univer-cli/unit-exchange";
+  ExchangeFormat,
+  FormulaCalculationMode,
+  exportToFile,
+  importFile,
+  type ExportOptions,
+  type ImportOptions,
+} from "@univerjs-pro/exchange-node";
 import { UniverInstanceType } from "@univerjs/core";
 import { workspaceError } from "../../errors.js";
 import type { WorkspaceRuntimeTarget } from "../../runtime/target.js";
 import type { WorkspaceUnitType } from "../space/model.js";
 import type { WorkspaceUnit } from "../worktree/model.js";
 
+type WorkspaceExchangeUnitType =
+  | UniverInstanceType.UNIVER_SHEET
+  | UniverInstanceType.UNIVER_BASE
+  | UniverInstanceType.UNIVER_DOC
+  | UniverInstanceType.UNIVER_SLIDE;
+type ImportOfficeFile = (
+  path: string,
+  options: ImportOptions,
+) => Promise<Readonly<Record<string, unknown>>>;
+type ExportOfficeFile = (
+  data: Readonly<Record<string, JsonValue>>,
+  path: string,
+  options: ExportOptions,
+) => Promise<void>;
+
+const importOfficeFile = importFile as unknown as ImportOfficeFile;
+const exportOfficeFile = exportToFile as unknown as ExportOfficeFile;
+
 export interface WorkspaceUnitExchangeDependencies {
   readonly daemon: Pick<DaemonClient, "request">;
-  readonly exchange: UnitExchange;
+  readonly exportToFile?: ExportOfficeFile;
+  readonly importFile?: ImportOfficeFile;
   readonly createUnit: (input: {
     readonly idempotencyKey?: string;
     readonly initialData: Readonly<Record<string, unknown>>;
@@ -70,18 +91,18 @@ export class WorkspaceUnitExchangeFeature {
   public async importFile(input: WorkspaceImportFileInput): Promise<WorkspaceImportFileResult> {
     const type = inferImportType(input.sourcePath, input.type);
     const unitType = toInstanceType(type);
-    const imported = await this.dependencies.exchange.importFile({
-      sourcePath: input.sourcePath,
-      unitType,
-    });
+    const imported = await (this.dependencies.importFile ?? importOfficeFile)(
+      input.sourcePath,
+      importOptions(input.sourcePath, unitType),
+    );
     const explicitName = nonEmpty(input.name);
     const name =
       explicitName ??
-      nonEmpty("name" in imported.data ? imported.data.name : undefined) ??
-      nonEmpty("title" in imported.data ? imported.data.title : undefined) ??
+      nonEmpty(imported["name"]) ??
+      nonEmpty(imported["title"]) ??
       `Imported ${type}`;
     const initialData = {
-      ...imported.data,
+      ...imported,
       ...(explicitName === undefined ? {} : { name: explicitName }),
     } as Readonly<Record<string, unknown>>;
     const created = await this.dependencies.createUnit({
@@ -129,7 +150,13 @@ export class WorkspaceUnitExchangeFeature {
         `Workspace runtime exported invalid UnitData for ${target.unitId}.`,
       );
     }
-    await exportUnit(this.dependencies.exchange, target.unitType, result, format, input.outputPath);
+    await exportUnit(
+      this.dependencies.exportToFile ?? exportOfficeFile,
+      target.unitType,
+      result,
+      format,
+      input.outputPath,
+    );
     return {
       outputPath: input.outputPath,
       type: target.unitType,
@@ -159,14 +186,14 @@ function inferImportType(
   );
 }
 
-function inferExportFormat(outputPath: string): UnitExchangeFormat {
+function inferExportFormat(outputPath: string): ExchangeFormat {
   switch (extname(outputPath).toLowerCase()) {
     case ".xlsx":
-      return UnitExchangeFormat.XLSX;
+      return ExchangeFormat.XLSX;
     case ".docx":
-      return UnitExchangeFormat.DOCX;
+      return ExchangeFormat.DOCX;
     case ".pptx":
-      return UnitExchangeFormat.PPTX;
+      return ExchangeFormat.PPTX;
     default:
       throw workspaceError(
         "workspace-exchange-export-format-unsupported",
@@ -177,12 +204,12 @@ function inferExportFormat(outputPath: string): UnitExchangeFormat {
 
 function requireCompatibleExport(
   type: Exclude<WorkspaceUnitType, "board">,
-  format: UnitExchangeFormat,
+  format: ExchangeFormat,
 ): void {
   const compatible =
-    ((type === "sheet" || type === "base") && format === UnitExchangeFormat.XLSX) ||
-    (type === "doc" && format === UnitExchangeFormat.DOCX) ||
-    (type === "slide" && format === UnitExchangeFormat.PPTX);
+    ((type === "sheet" || type === "base") && format === ExchangeFormat.XLSX) ||
+    (type === "doc" && format === ExchangeFormat.DOCX) ||
+    (type === "slide" && format === ExchangeFormat.PPTX);
   if (!compatible) {
     throw workspaceError(
       "workspace-exchange-export-format-mismatch",
@@ -191,7 +218,7 @@ function requireCompatibleExport(
   }
 }
 
-function toInstanceType(type: Exclude<WorkspaceUnitType, "board">): ImportableUnitType {
+function toInstanceType(type: Exclude<WorkspaceUnitType, "board">): WorkspaceExchangeUnitType {
   switch (type) {
     case "sheet":
       return UniverInstanceType.UNIVER_SHEET;
@@ -205,14 +232,34 @@ function toInstanceType(type: Exclude<WorkspaceUnitType, "board">): ImportableUn
 }
 
 async function exportUnit(
-  exchange: UnitExchange,
+  exchange: ExportOfficeFile,
   type: Exclude<WorkspaceUnitType, "board">,
   data: Record<string, JsonValue>,
-  format: UnitExchangeFormat,
+  format: ExchangeFormat,
   outputPath: string,
 ): Promise<void> {
-  const unit = { data, type: toInstanceType(type) } as unknown as UnitExchangeData;
-  await exchange.exportFile({ unit, format, outputPath });
+  const unitType = toInstanceType(type);
+  await exchange(data, outputPath, {
+    format,
+    type: unitType,
+    ...(unitType === UniverInstanceType.UNIVER_SHEET
+      ? { formulaCalculation: FormulaCalculationMode.FORCED }
+      : {}),
+  } as ExportOptions);
+}
+
+function importOptions(sourcePath: string, type: WorkspaceExchangeUnitType): ImportOptions {
+  const extension = extname(sourcePath).toLowerCase();
+  const format = [".pptm", ".ppsx", ".ppsm", ".potx"].includes(extension)
+    ? ExchangeFormat.PPTX
+    : undefined;
+  return {
+    type,
+    ...(format === undefined ? {} : { format }),
+    ...(type === UniverInstanceType.UNIVER_SHEET && extension === ".xlsx"
+      ? { formulaCalculation: FormulaCalculationMode.FORCED }
+      : {}),
+  } as ImportOptions;
 }
 
 function requireCreatedUnit(

apps/cli/src/program.ts

@@ -8,7 +8,6 @@ import { createDaemonClient, createDaemonControl, type JsonValue } from "@univer
 import { createDaemonCommand } from "@univer-cli/daemon-command";
 import { createNodeResourceLibraryFactory } from "@univer-cli/resource-library";
 import { createResourcesCommand } from "@univer-cli/resource-library-command";
-import { createUnitExchange, type UnitExchange } from "@univer-cli/unit-exchange";
 import type {
   UniverRenderRuntime,
   UniverRenderRuntimeOptions,
@@ -69,7 +68,6 @@ export interface WorkspaceCliProgramOptions {
   readonly resourceManifestPath: string;
   readonly socketPath: string;
   readonly skillDataRoot: string;
-  readonly unitExchange?: UnitExchange;
   readonly write: (text: string) => void;
   readonly writeError?: (text: string) => void;
 }
@@ -123,7 +121,6 @@ export function createProgram(options: WorkspaceCliProgramOptions): Command {
   });
   const exchange = new WorkspaceUnitExchangeFeature({
     daemon,
-    exchange: options.unitExchange ?? createUnitExchange(),
     createUnit: async (input) => await units.create(input),
     resolveRuntimeTarget: async (input) =>
       await new WorkspaceContentSource(await auth.authenticatedHttp("client")).resolveRuntimeTarget(

apps/cli/test/exchange-node.test.ts

@@ -0,0 +1,59 @@
+import { mkdtemp, rm, stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  ExchangeFormat,
+  FormulaCalculationMode,
+  exportToFile,
+  importFile,
+} from "@univerjs-pro/exchange-node";
+import {
+  LocaleType,
+  UniverInstanceType,
+  type IWorkbookData,
+} from "@univerjs/core";
+import { describe, expect, it } from "vitest";
+
+describe("Exchange Node runtime", () => {
+  it("round-trips a real XLSX through the native binding", async () => {
+    const directory = await mkdtemp(join(tmpdir(), "workspace-exchange-node-"));
+    const outputPath = join(directory, "roundtrip.xlsx");
+    try {
+      await exportToFile(workbookData(), outputPath, {
+        format: ExchangeFormat.XLSX,
+        formulaCalculation: FormulaCalculationMode.FORCED,
+        type: UniverInstanceType.UNIVER_SHEET,
+      });
+      expect((await stat(outputPath)).size).toBeGreaterThan(0);
+      const imported = await importFile(outputPath, {
+        formulaCalculation: FormulaCalculationMode.FORCED,
+        type: UniverInstanceType.UNIVER_SHEET,
+      });
+      expect(imported.sheets[imported.sheetOrder[0]!]!.cellData?.[0]?.[0]?.v).toBe("A1");
+    } finally {
+      await rm(directory, { force: true, recursive: true });
+    }
+  });
+});
+
+function workbookData(): IWorkbookData {
+  return {
+    appVersion: "",
+    id: "sheet-unit",
+    locale: LocaleType.EN_US,
+    name: "Workbook",
+    resources: [],
+    rev: 1,
+    sheetOrder: ["sheet-1"],
+    sheets: {
+      "sheet-1": {
+        cellData: { 0: { 0: { v: "A1" } } },
+        columnCount: 10,
+        id: "sheet-1",
+        name: "Sheet 1",
+        rowCount: 20,
+      },
+    },
+    styles: {},
+  };
+}