feat(document): decouple shared Office conversion from preview

scripts/build-python-release.py

@@ -55,6 +55,11 @@ def runtime_filenames(executable_name: str) -> tuple[str, ...]:
     return (*names, f"{executable_name}-spawn-helper") if "-macos-" in executable_name else names
 
 
+def office_sidecar_name(executable_name: str) -> str:
+    """Return the complete Office dependency directory for one executable."""
+    return f"{executable_name.removesuffix('.exe')}-office"
+
+
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
     parser.add_argument("--package", choices=("sdk", "runtime"), required=True)
@@ -220,6 +225,42 @@ def stage_runtime(destination: Path, version: str, executable: Path, executable_
     source_directory = executable.parent
     for filename in runtime_filenames(executable_name):
         shutil.copy2(source_directory / filename, runtime_dir / filename)
+    office = office_sidecar_name(executable_name)
+    shutil.copytree(source_directory / office, runtime_dir / office)
+
+
+def verify_office_payload(archive: zipfile.ZipFile, office_modules: str, platform_tag: str) -> None:
+    """Check packaged engine assets and native helper executable permissions."""
+    names = set(archive.namelist())
+    adapter = f"{office_modules}/@deepseek-ai/libreoffice-kit/package.json"
+    if adapter not in names:
+        raise RuntimeError("Office dependency is missing: libreoffice-kit")
+    engines = f"{office_modules}/@deepseek-ai"
+    target = next(name for name, value in PLATFORMS.items() if value[0] == platform_tag)
+    selected = "wasm" if target.startswith("linux-") else target.replace("win-", "win32-").replace("macos-", "darwin-")
+    for required in (f"libreoffice-kit-{selected}/prebuilds.json",):
+        if f"{engines}/{required}" not in names:
+            raise RuntimeError(f"Office dependency is missing: {required}")
+    manifests = (
+        name for name in names
+        if name.startswith(f"{engines}/libreoffice-kit-")
+        and name.endswith("/prebuilds.json")
+        and name.count("/") == engines.count("/") + 2
+    )
+    for manifest_path in manifests:
+        if manifest_path != f"{engines}/libreoffice-kit-{selected}/prebuilds.json":
+            raise RuntimeError(f"Unexpected Office engine for {platform_tag}: {manifest_path}")
+        manifest = json.loads(archive.read(manifest_path))
+        engine = manifest["engine"]
+        native = engine["kind"] == "native"
+        fields = ("executable",) if native else ("loader", "wasm", "data", "metadata")
+        for field in fields:
+            asset = f"{manifest_path.rsplit('/', 1)[0]}/{engine[field]}"
+            if asset not in names:
+                raise RuntimeError(f"Office engine asset is missing: {asset}")
+            mode = archive.getinfo(asset).external_attr >> 16
+            if native and platform_tag != "win_amd64" and mode & stat.S_IXUSR == 0:
+                raise RuntimeError(f"Office helper lost its executable bit: {asset}")
 
 
 def verify_wheel(
@@ -253,21 +294,26 @@ def verify_wheel(
             raise RuntimeError(
                 f"{wheel} has license files {license_files}, expected {expected_license_files}"
             )
-        runtime_files = [
+        runtime_payload = [
             name for name in archive.namelist() if "/runtime/deepseek-harness-sdk-runtime-" in name
         ]
         if package == "runtime":
             assert platform is not None
-            expected_files = sorted(runtime_filenames(platform[1]))
-            found_files = sorted(Path(name).name for name in runtime_files)
+            office = office_sidecar_name(platform[1])
+            expected_files = sorted((*runtime_filenames(platform[1]), office))
+            found_files = sorted({name.split("/runtime/", 1)[1].split("/", 1)[0] for name in runtime_payload})
             if found_files != expected_files:
                 raise RuntimeError(f"{wheel} runtime payload must be {expected_files}, found {found_files}")
-            for runtime_file in runtime_files:
+            office_modules = f"deepseek_harness_runtime/runtime/{office}/node_modules"
+            verify_office_payload(archive, office_modules, platform[0])
+            for runtime_file in runtime_payload:
+                if "/" in runtime_file.split("/runtime/", 1)[1]:
+                    continue
                 mode = archive.getinfo(runtime_file).external_attr >> 16
                 if platform[0] != "win_amd64" and mode & stat.S_IXUSR == 0:
                     raise RuntimeError(f"{wheel} runtime executable lost its executable bit: {runtime_file}")
-        elif runtime_files:
-            raise RuntimeError(f"SDK wheel unexpectedly contains runtime executables: {runtime_files}")
+        elif runtime_payload:
+            raise RuntimeError(f"SDK wheel unexpectedly contains runtime files: {runtime_payload}")
         if package == "sdk":
             requirements = metadata.get_all("Requires-Dist") or []
             expected_requirement = f"{RUNTIME_DISTRIBUTION}=={version}"