@ycodium-ai/plugin-office 0.2.3510 → 0.2.3566

package/dist/index.js

@@ -1,155 +1,10 @@
 // src/index.ts
-import * as NodePath7 from "node:path";
+import * as NodePath5 from "node:path";
 import { definePlugin } from "@ycodium-ai/plugin-api";
 
-// src/download.ts
-import * as NodeCrypto from "node:crypto";
-import * as NodeFS from "node:fs";
+// src/paths.ts
 import * as NodeFSP from "node:fs/promises";
 import * as NodePath from "node:path";
-import * as NodeStream from "node:stream";
-import * as NodeStreamPromises from "node:stream/promises";
-var DEFAULT_SOURCES = {
-  npmRegistry: "https://registry.npmjs.org",
-  githubMirror: "",
-  pypiMirror: "https://files.pythonhosted.org/packages",
-  localDir: ""
-};
-var PYPI_PACKAGES = "https://files.pythonhosted.org/packages";
-var GITHUB_HOSTS = ["https://github.com/", "https://raw.githubusercontent.com/"];
-var trimSlash = (value) => value.replace(/\/+$/, "");
-var resolveDownloadUrl = (url, sources) => {
-  if (url.startsWith(PYPI_PACKAGES)) {
-    return `${trimSlash(sources.pypiMirror)}${url.slice(PYPI_PACKAGES.length)}`;
-  }
-  if (sources.githubMirror !== "" && GITHUB_HOSTS.some((host) => url.startsWith(host))) {
-    return `${trimSlash(sources.githubMirror)}/${url}`;
-  }
-  return url;
-};
-var npmTarballUrl = (registry, name, version) => {
-  const bare = name.includes("/") ? name.slice(name.indexOf("/") + 1) : name;
-  return `${trimSlash(registry)}/${name}/-/${bare}-${version}.tgz`;
-};
-var parseSri = (sri) => {
-  if (!sri.startsWith("sha512-")) throw new Error(`Unsupported integrity value: ${sri}`);
-  return { algorithm: "sha512", base64: sri.slice("sha512-".length) };
-};
-var digestMatches = (hash, integrity) => integrity.algorithm === "sha256" ? hash.digest("hex") === integrity.hex.toLowerCase() : hash.digest("base64") === integrity.base64;
-var fileMatches = async (filePath, integrity) => {
-  const hash = NodeCrypto.createHash(integrity.algorithm);
-  try {
-    await NodeStreamPromises.pipeline(NodeFS.createReadStream(filePath), hash);
-  } catch {
-    return false;
-  }
-  return digestMatches(hash, integrity);
-};
-var DownloadError = class extends Error {
-  reason;
-  constructor(reason, message) {
-    super(message);
-    this.reason = reason;
-  }
-};
-var hostOf = (url) => {
-  try {
-    return new URL(url).host;
-  } catch {
-    return url;
-  }
-};
-var describeNetworkError = (error) => {
-  const message = error instanceof Error ? error.message : String(error);
-  const cause = error?.cause;
-  if (cause === void 0) return message;
-  const code = typeof cause.code === "string" ? `${cause.code} ` : "";
-  return `${message}: ${code}${typeof cause.message === "string" ? cause.message : ""}`.trim();
-};
-var downloadVerified = async (input) => {
-  const { item, dir, sources } = input;
-  const target = NodePath.join(dir, item.fileName);
-  await NodeFSP.mkdir(dir, { recursive: true });
-  if (await fileMatches(target, item.integrity)) return target;
-  if (sources.localDir !== "") {
-    const local = NodePath.join(sources.localDir, item.fileName);
-    if (await fileMatches(local, item.integrity)) {
-      await NodeFSP.copyFile(local, target);
-      return target;
-    }
-  }
-  const url = resolveDownloadUrl(item.url, sources);
-  let response;
-  try {
-    response = await input.http(url, { signal: input.signal });
-  } catch (error) {
-    if (input.signal.aborted) throw error;
-    throw new DownloadError(
-      "network",
-      `Could not reach ${hostOf(url)} to download ${item.fileName} (${describeNetworkError(error)}). Check this machine's internet access and proxy settings.`
-    );
-  }
-  if (!response.ok || response.body === null) {
-    throw new DownloadError(
-      "http",
-      `${hostOf(url)} answered HTTP ${String(response.status)} for ${item.fileName}.`
-    );
-  }
-  const rawLength = Number(response.headers.get("content-length") ?? Number.NaN);
-  const totalBytes = Number.isFinite(rawLength) && rawLength > 0 ? rawLength : null;
-  const hash = NodeCrypto.createHash(input.item.integrity.algorithm);
-  const partPath = `${target}.part`;
-  let transferredBytes = 0;
-  let lastReport = 0;
-  const readable = NodeStream.Readable.fromWeb(
-    response.body
-  );
-  readable.on("data", (chunk) => {
-    transferredBytes += chunk.length;
-    hash.update(chunk);
-    const now = Date.now();
-    if (now - lastReport >= 250) {
-      lastReport = now;
-      input.onProgress({ fileName: item.fileName, transferredBytes, totalBytes });
-    }
-  });
-  try {
-    await NodeStreamPromises.pipeline(readable, NodeFS.createWriteStream(partPath));
-  } catch (error) {
-    await NodeFSP.rm(partPath, { force: true });
-    if (input.signal.aborted) throw error;
-    const code = error.code;
-    if (code === "ENOSPC") {
-      throw new DownloadError(
-        "disk",
-        `This machine ran out of disk space while downloading ${item.fileName}.`
-      );
-    }
-    throw new DownloadError(
-      "network",
-      `The download of ${item.fileName} stopped after ${String(transferredBytes)} bytes (${describeNetworkError(error)}).`
-    );
-  }
-  input.onProgress({ fileName: item.fileName, transferredBytes, totalBytes });
-  if (!digestMatches(hash, item.integrity)) {
-    await NodeFSP.rm(partPath, { force: true });
-    throw new DownloadError(
-      "integrity",
-      `${item.fileName} from ${hostOf(url)} did not match its pinned ${item.integrity.algorithm} hash and was discarded. If this machine uses a proxy or mirror, make sure it serves the original file.`
-    );
-  }
-  await NodeFSP.rename(partPath, target);
-  return target;
-};
-
-// src/engine.ts
-import * as NodeFSP4 from "node:fs/promises";
-import * as NodeProcess3 from "node:process";
-
-// src/install.ts
-import * as NodeFSP3 from "node:fs/promises";
-import * as NodePath4 from "node:path";
-import * as NodeProcess2 from "node:process";
 
 // src/lock.ts
 var OFFICE_LOCK = {
@@ -492,24 +347,49 @@ var OFFICE_LOCK = {
     }
   },
   fonts: {
+    /** 字体取自 notofonts/noto-cjk 的 release 资产（raw 文件在受限网络里取不到）；成员再各自按 sha256 核对。 */
+    archives: {
+      sans: {
+        url: "https://github.com/notofonts/noto-cjk/releases/download/Sans2.004/18_NotoSansSC.zip",
+        sha256: "4d107c09ada479d3e48b6e78c83835773cbd9214bf6e12cdb7b60f8e068292ec"
+      },
+      serif: {
+        url: "https://github.com/notofonts/noto-cjk/releases/download/Serif2.003/14_NotoSerifSC.zip",
+        sha256: "c58cd035ab2adb003510846db9ec80c35b1b97755d329486c3a1e88edfe6e98e"
+      }
+    },
+    license: {
+      archive: "sans",
+      member: "LICENSE",
+      sha256: "6a73f9541c2de74158c0e7cf6b0a58ef774f5a780bf191f2d7ec9cc53efe2bf2"
+    },
+    /** path 是上游仓库里的位置（出处）；落盘名取其文件名，member 是它在压缩包里的路径。 */
     files: [
       {
         path: "Sans2.004/Sans/SubsetOTF/SC/NotoSansSC-Regular.otf",
+        archive: "sans",
+        member: "NotoSansSC-Regular.otf",
         size: 8331336,
         sha256: "faa6c9df652116dde789d351359f3d7e5d2285a2b2a1f04a2d7244df706d5ea9"
       },
       {
         path: "Sans2.004/Sans/SubsetOTF/SC/NotoSansSC-Bold.otf",
+        archive: "sans",
+        member: "NotoSansSC-Bold.otf",
         size: 8543168,
         sha256: "c6cb5a93abaa9edc8ee7463b7ebb7f42d618d40e6ed2f7a5371c97b0b64767c0"
       },
       {
         path: "Serif2.003/Serif/SubsetOTF/SC/NotoSerifSC-Regular.otf",
+        archive: "serif",
+        member: "SubsetOTF/SC/NotoSerifSC-Regular.otf",
         size: 11625800,
         sha256: "e8f396decc1f0963a016a989c3d8852e863d1350996f573860a80767c83a1cd3"
       },
       {
         path: "Serif2.003/Serif/SubsetOTF/SC/NotoSerifSC-Bold.otf",
+        archive: "serif",
+        member: "SubsetOTF/SC/NotoSerifSC-Bold.otf",
         size: 12094336,
         sha256: "24693d48bdb9152f0a06b02af625638a1097abd6de4010ebba027f6e82710527"
       }
@@ -518,109 +398,95 @@ var OFFICE_LOCK = {
 };
 
 // src/paths.ts
-import * as NodeCrypto2 from "node:crypto";
-import * as NodeFSP2 from "node:fs/promises";
-import * as NodePath2 from "node:path";
-var PYTHON_PROGRAM = {
-  win32: "data:runtime/python/python.exe",
-  other: "data:runtime/python/bin/python3"
-};
-var officePaths = (dataDir) => {
-  const runtimeDir = NodePath2.join(dataDir, "runtime");
-  const dirOf = (component) => NodePath2.join(runtimeDir, component);
+var ENGINE_VERSION = OFFICE_LOCK.engine.version;
+var PYTHON_VERSION = `${OFFICE_LOCK.python.version}+${OFFICE_LOCK.python.release}`;
+var FONTS_VERSION = "Sans2.004+Serif2.003";
+var officePaths = (pluginDir, dataDir, target, runtimePath) => {
+  const runtimeDir = runtimePath ?? NodePath.join(pluginDir, "runtime", target ?? "unsupported");
+  const pythonLibraries = NodePath.join(runtimeDir, "python", "site-packages");
   return {
     dataDir,
     runtimeDir,
-    downloadsDir: NodePath2.join(dataDir, "downloads"),
-    dirOf,
-    recordOf: (component) => NodePath2.join(runtimeDir, `${component}.json`),
-    engineCli: NodePath2.join(
-      dirOf("engine"),
+    pythonLibraries,
+    pythonRunner: NodePath.join(pluginDir, "assets", "run_office.py"),
+    engineCli: NodePath.join(
+      runtimeDir,
       "node_modules",
       "@deepseek-ai",
       "libreoffice-kit",
       "lib",
       "cli.js"
     ),
-    pythonExecutable: (platform5) => platform5 === "win32" ? NodePath2.join(dirOf("python"), "python.exe") : NodePath2.join(dirOf("python"), "bin", "python3")
+    dirOf: (component) => component === "python" ? pythonLibraries : component === "engine" ? NodePath.join(runtimeDir, "node_modules") : NodePath.join(runtimeDir, "fonts")
   };
 };
-var readInstallRecord = async (paths, component) => {
+var bundledComponentReady = async (paths, component, target) => {
+  if (target === null) return false;
   try {
-    const value = JSON.parse(await NodeFSP2.readFile(paths.recordOf(component), "utf8"));
-    if (typeof value !== "object" || value === null) return null;
-    const record = value;
-    return typeof record["version"] === "string" && typeof record["target"] === "string" ? { version: record["version"], target: record["target"] } : null;
+    const manifest = JSON.parse(
+      await NodeFSP.readFile(NodePath.join(paths.runtimeDir, "manifest.json"), "utf8")
+    );
+    if (typeof manifest !== "object" || manifest === null) return false;
+    const value = manifest;
+    const versions = { engine: ENGINE_VERSION, python: PYTHON_VERSION, fonts: FONTS_VERSION };
+    if (value["target"] !== target || value[`${component}Version`] !== versions[component])
+      return false;
+    const files = component === "engine" ? [paths.engineCli] : component === "python" ? [
+      paths.pythonRunner,
+      ...["docx", "pptx", "openpyxl", "pandas", "PIL", "lxml", "xlsxwriter"].map(
+        (name) => NodePath.join(paths.pythonLibraries, name, "__init__.py")
+      )
+    ] : OFFICE_LOCK.fonts.files.map(
+      (font) => NodePath.join(paths.dirOf("fonts"), NodePath.basename(font.path))
+    );
+    return (await Promise.all(
+      files.map(async (file, index) => {
+        const stat2 = await NodeFSP.stat(file);
+        return stat2.isFile() && (component !== "fonts" || stat2.size === OFFICE_LOCK.fonts.files[index].size);
+      })
+    )).every(Boolean);
   } catch {
-    return null;
-  }
-};
-var writeInstallRecord = (paths, component, record) => writeAtomic(paths.recordOf(component), `${JSON.stringify(record)}
-`);
-var removePath = (target) => NodeFSP2.rm(target, { recursive: true, force: true });
-var writeAtomic = async (filePath, contents) => {
-  await NodeFSP2.mkdir(NodePath2.dirname(filePath), { recursive: true });
-  const tmp = `${filePath}.${NodeCrypto2.randomBytes(6).toString("hex")}.tmp`;
-  try {
-    await NodeFSP2.writeFile(tmp, contents);
-    await NodeFSP2.rename(tmp, filePath);
-  } catch (error) {
-    await NodeFSP2.rm(tmp, { force: true });
-    throw error;
-  }
-};
-var swapIntoPlace = async (staging, target) => {
-  const retired = `${target}.old-${NodeCrypto2.randomBytes(4).toString("hex")}`;
-  const hadPrevious = await NodeFSP2.rename(target, retired).then(
-    () => true,
-    () => false
-  );
-  try {
-    await NodeFSP2.rename(staging, target);
-  } catch (error) {
-    if (hadPrevious) await NodeFSP2.rename(retired, target).catch(() => void 0);
-    throw error;
+    return false;
   }
-  if (hadPrevious) await removePath(retired);
 };
 
 // src/platform.ts
-import * as NodeFS2 from "node:fs";
+import * as NodeFS from "node:fs";
 import * as NodeOS from "node:os";
-import * as NodePath3 from "node:path";
+import * as NodePath2 from "node:path";
 import * as NodeProcess from "node:process";
-var detectOfficeTarget = (platform5 = NodeProcess.platform, arch2 = NodeProcess.arch) => {
-  const key = `${platform5}-${arch2}`;
+var detectOfficeTarget = (platform2 = NodeProcess.platform, arch2 = NodeProcess.arch) => {
+  const key = `${platform2}-${arch2}`;
   return Object.hasOwn(OFFICE_LOCK.engine.targets, key) ? key : null;
 };
 var pythonTargetOf = (target) => OFFICE_LOCK.python.targets[target] ?? null;
-var systemFontDirectories = (platform5 = NodeProcess.platform, home = NodeOS.homedir(), env2 = NodeProcess.env) => {
-  if (platform5 === "win32") {
+var systemFontDirectories = (platform2 = NodeProcess.platform, home = NodeOS.homedir(), env2 = NodeProcess.env) => {
+  if (platform2 === "win32") {
     return [
-      NodePath3.win32.join(env2["SystemRoot"] ?? "C:\\Windows", "Fonts"),
-      NodePath3.win32.join(
-        env2["LOCALAPPDATA"] ?? NodePath3.win32.join(home, "AppData", "Local"),
+      NodePath2.win32.join(env2["SystemRoot"] ?? "C:\\Windows", "Fonts"),
+      NodePath2.win32.join(
+        env2["LOCALAPPDATA"] ?? NodePath2.win32.join(home, "AppData", "Local"),
         "Microsoft",
         "Windows",
         "Fonts"
       )
     ];
   }
-  if (platform5 === "darwin") {
+  if (platform2 === "darwin") {
     return [
       "/System/Library/Fonts",
       "/Library/Fonts",
-      NodePath3.posix.join(home, "Library/Fonts"),
+      NodePath2.posix.join(home, "Library/Fonts"),
       ...mobileAssetFontDirectories("/System/Library/AssetsV2")
     ];
   }
   const shared = (env2["XDG_DATA_DIRS"] ?? "/usr/local/share:/usr/share").split(":").filter(Boolean);
   return [
     .../* @__PURE__ */ new Set([
-      ...shared.map((dir) => NodePath3.posix.join(dir, "fonts")),
-      NodePath3.posix.join(home, ".fonts"),
-      NodePath3.posix.join(
-        env2["XDG_DATA_HOME"] ?? NodePath3.posix.join(home, ".local/share"),
+      ...shared.map((dir) => NodePath2.posix.join(dir, "fonts")),
+      NodePath2.posix.join(home, ".fonts"),
+      NodePath2.posix.join(
+        env2["XDG_DATA_HOME"] ?? NodePath2.posix.join(home, ".local/share"),
         "fonts"
       )
     ])
@@ -629,265 +495,26 @@ var systemFontDirectories = (platform5 = NodeProcess.platform, home = NodeOS.hom
 var mobileAssetFontDirectories = (assets) => {
   let entries = [];
   try {
-    entries = NodeFS2.readdirSync(assets);
+    entries = NodeFS.readdirSync(assets);
   } catch {
     return [];
   }
-  return entries.filter((name) => /^com_apple_MobileAsset_Font\d*$/.test(name)).sort().map((name) => NodePath3.posix.join(assets, name));
+  return entries.filter((name) => /^com_apple_MobileAsset_Font\d*$/.test(name)).sort().map((name) => NodePath2.posix.join(assets, name));
 };
 
-// src/install.ts
-var InstallError = class extends Error {
-  /** 插件 locales 里 `failure.<reason>` 的那一段。 */
-  reason;
-  constructor(reason, message) {
-    super(message);
-    this.reason = reason;
-  }
-};
-var ENGINE_VERSION = OFFICE_LOCK.engine.version;
-var PYTHON_VERSION = `${OFFICE_LOCK.python.version}+${OFFICE_LOCK.python.release}`;
-var FONTS_VERSION = "Sans2.004+Serif2.003";
-var npmFileName = (name, version) => `${name.replace(/^@/, "").replace("/", "__")}-${version}.tgz`;
-var engineItems = (target, registry) => [...OFFICE_LOCK.engine.shared, ...OFFICE_LOCK.engine.targets[target]].map((pkg) => ({
-  name: pkg.name,
-  item: {
-    url: npmTarballUrl(registry, pkg.name, pkg.version),
-    fileName: npmFileName(pkg.name, pkg.version),
-    integrity: parseSri(pkg.integrity)
-  }
-}));
-var basenameOfUrl = (url) => decodeURIComponent(url.slice(url.lastIndexOf("/") + 1));
-var pythonItems = (target) => {
-  const artifact = pythonTargetOf(target);
-  if (artifact === null) return null;
-  const fileName = `cpython-${OFFICE_LOCK.python.version}+${OFFICE_LOCK.python.release}-${artifact.pythonTarget}-install_only_stripped.tar.gz`;
-  const archive = {
-    url: `https://github.com/astral-sh/python-build-standalone/releases/download/${OFFICE_LOCK.python.release}/${encodeURIComponent(fileName)}`,
-    fileName,
-    integrity: { algorithm: "sha256", hex: artifact.sha256 }
-  };
-  const wheels = [...artifact.wheels, ...OFFICE_LOCK.python.wheels].map(
-    (wheel) => ({
-      url: wheel.url,
-      fileName: basenameOfUrl(wheel.url),
-      integrity: { algorithm: "sha256", hex: wheel.sha256 }
-    })
-  );
-  return { archive, wheels };
-};
-var fontItems = () => OFFICE_LOCK.fonts.files.map((file) => ({
-  url: `https://raw.githubusercontent.com/notofonts/noto-cjk/${file.path}`,
-  fileName: basenameOfUrl(file.path),
-  integrity: { algorithm: "sha256", hex: file.sha256 }
-}));
-var megabytes = (bytes) => (bytes / (1024 * 1024)).toFixed(1);
-var downloadAll = async (ctx, component, items) => {
-  const dir = NodePath4.join(ctx.paths.downloadsDir, component);
-  const files = [];
-  for (const [index, item] of items.entries()) {
-    const report = (progress) => ctx.emit({
-      kind: "status",
-      statusKey: progress.totalBytes === null ? "progress.downloadingUnknown" : "progress.downloading",
-      params: {
-        file: progress.fileName,
-        index: String(index + 1),
-        count: String(items.length),
-        done: megabytes(progress.transferredBytes),
-        total: progress.totalBytes === null ? "" : megabytes(progress.totalBytes)
-      }
-    });
-    files.push(
-      await downloadVerified({
-        http: ctx.http,
-        item,
-        dir,
-        sources: ctx.sources,
-        signal: ctx.signal,
-        onProgress: report
-      })
-    );
-  }
-  return files;
-};
-var relativeToData = (ctx, target) => NodePath4.relative(ctx.paths.dataDir, target).split(NodePath4.sep).join("/");
-var untar = async (ctx, archive, destination) => {
-  await NodeFSP3.mkdir(destination, { recursive: true });
-  const result = await ctx.process.run({
-    program: "tar",
-    args: [
-      "-xzf",
-      relativeToData(ctx, archive),
-      "-C",
-      relativeToData(ctx, destination),
-      "--strip-components=1"
-    ],
-    cwd: ctx.paths.dataDir,
-    timeoutMs: 6e5
-  });
-  if (result.exitCode !== 0) {
-    throw new InstallError(
-      "unpack-failed",
-      `tar could not unpack ${NodePath4.basename(archive)}: ${(result.stderr || result.stdout).trim().slice(0, 400)}`
-    );
-  }
-};
-var steps = (ctx, states) => ctx.emit({
-  kind: "steps",
-  steps: ["download", "unpack", "check"].map((id) => ({
-    id,
-    labelKey: `progress.step.${id}`,
-    state: states[id]
-  }))
-});
-var stagingOf = (ctx, component) => `${ctx.paths.dirOf(component)}.staging`;
-var finish = async (ctx, component, version) => {
-  await swapIntoPlace(stagingOf(ctx, component), ctx.paths.dirOf(component));
-  await writeInstallRecord(ctx.paths, component, { version, target: ctx.target });
-  await removePath(NodePath4.join(ctx.paths.downloadsDir, component));
-};
-var installEngine = async (ctx) => {
-  const packages = engineItems(ctx.target, ctx.sources.npmRegistry);
-  steps(ctx, { download: "running", unpack: "pending", check: "pending" });
-  const files = await downloadAll(
-    ctx,
-    "engine",
-    packages.map((pkg) => pkg.item)
-  );
-  steps(ctx, { download: "done", unpack: "running", check: "pending" });
-  const staging = stagingOf(ctx, "engine");
-  await removePath(staging);
-  for (const [index, pkg] of packages.entries()) {
-    await untar(ctx, files[index], NodePath4.join(staging, "node_modules", ...pkg.name.split("/")));
-  }
-  steps(ctx, { download: "done", unpack: "done", check: "running" });
-  const cli = NodePath4.join(
-    staging,
-    "node_modules",
-    "@deepseek-ai",
-    "libreoffice-kit",
-    "lib",
-    "cli.js"
-  );
-  const backend = await engineBackend(ctx.process, cli, ctx.paths.dataDir);
-  await finish(ctx, "engine", ENGINE_VERSION);
-  steps(ctx, { download: "done", unpack: "done", check: "done" });
-  return backend;
-};
-var engineBackend = async (processApi, cli, cwd) => {
-  const result = await processApi.run({
-    program: "host:node",
-    args: [cli, "capabilities", "--json"],
-    cwd,
-    timeoutMs: 6e4
-  });
-  let backend;
-  try {
-    backend = JSON.parse(result.stdout).runtime?.backend;
-  } catch {
-    backend = void 0;
-  }
-  if (result.exitCode !== 0 || typeof backend !== "string") {
-    throw new InstallError(
-      NodeProcess2.platform === "win32" ? "engine-unavailable-windows" : "engine-unavailable",
-      `The Office engine did not start: ${(result.stderr || result.stdout).trim().slice(0, 400)}`
-    );
-  }
-  return backend;
-};
-var pythonProgram = (platform5 = NodeProcess2.platform) => platform5 === "win32" ? PYTHON_PROGRAM.win32 : PYTHON_PROGRAM.other;
-var runPython = async (ctx, args, what) => {
-  const result = await ctx.process.run({
-    program: pythonProgram(),
-    args,
-    cwd: ctx.paths.dataDir,
-    timeoutMs: 6e5
-  });
-  if (result.exitCode !== 0) {
-    throw new InstallError(
-      "python-failed",
-      `${what} failed: ${(result.stderr || result.stdout).trim().slice(-600)}`
-    );
-  }
-};
-var installPython = async (ctx) => {
-  const items = pythonItems(ctx.target);
-  if (items === null) {
-    throw new InstallError("python-unsupported", `No Python build is pinned for ${ctx.target}.`);
-  }
-  steps(ctx, { download: "running", unpack: "pending", check: "pending" });
-  const [archive, ...wheels] = await downloadAll(ctx, "python", [items.archive, ...items.wheels]);
-  steps(ctx, { download: "done", unpack: "running", check: "pending" });
-  const staging = stagingOf(ctx, "python");
-  await removePath(staging);
-  await untar(ctx, archive, staging);
-  await removePath(ctx.paths.recordOf("python"));
-  await swapIntoPlace(staging, ctx.paths.dirOf("python"));
-  try {
-    await runPython(
-      ctx,
-      [
-        "-I",
-        "-m",
-        "pip",
-        "install",
-        "--no-index",
-        "--no-deps",
-        "--no-compile",
-        "--disable-pip-version-check",
-        ...wheels
-      ],
-      "Installing the document libraries"
-    );
-    steps(ctx, { download: "done", unpack: "done", check: "running" });
-    await runPython(ctx, ["-I", "-m", "pip", "check"], "Checking the document libraries");
-    await runPython(
-      ctx,
-      ["-I", "-c", "import docx, pptx, openpyxl, pandas, PIL, lxml"],
-      "Importing the document libraries"
+// src/engine.ts
+var componentReady = bundledComponentReady;
+var fontDirectoryArgs = async (paths, target) => {
+  if (!await componentReady(paths, "engine", target) || !await componentReady(paths, "fonts", target)) {
+    throw new Error(
+      "The bundled Office engine or fonts are missing, incomplete, or the wrong version. Restore the complete Ycodium installation."
     );
-  } catch (error) {
-    await removePath(ctx.paths.dirOf("python"));
-    throw error;
-  }
-  await writeInstallRecord(ctx.paths, "python", { version: PYTHON_VERSION, target: ctx.target });
-  await removePath(NodePath4.join(ctx.paths.downloadsDir, "python"));
-  steps(ctx, { download: "done", unpack: "done", check: "done" });
-};
-var installFonts = async (ctx) => {
-  steps(ctx, { download: "running", unpack: "pending", check: "pending" });
-  const files = await downloadAll(ctx, "fonts", fontItems());
-  steps(ctx, { download: "done", unpack: "running", check: "pending" });
-  const staging = stagingOf(ctx, "fonts");
-  await removePath(staging);
-  await NodeFSP3.mkdir(staging, { recursive: true });
-  for (const file of files) {
-    await NodeFSP3.copyFile(file, NodePath4.join(staging, NodePath4.basename(file)));
   }
-  await finish(ctx, "fonts", FONTS_VERSION);
-  steps(ctx, { download: "done", unpack: "done", check: "done" });
+  return [...systemFontDirectories(), paths.dirOf("fonts")].flatMap((dir) => [
+    "--font-directory",
+    dir
+  ]);
 };
-var removeRuntime = async (paths) => {
-  await removePath(paths.runtimeDir);
-  await removePath(paths.downloadsDir);
-};
-
-// src/engine.ts
-var EXPECTED_VERSION = {
-  engine: ENGINE_VERSION,
-  python: PYTHON_VERSION,
-  fonts: FONTS_VERSION
-};
-var componentReady = async (paths, component, target) => {
-  if (target === null) return false;
-  const record = await readInstallRecord(paths, component);
-  if (record?.version !== EXPECTED_VERSION[component] || record.target !== target) return false;
-  return NodeFSP4.stat(paths.dirOf(component)).then(
-    (info) => info.isDirectory(),
-    () => false
-  );
-};
-var fontDirectoryArgs = async (paths, target) => await componentReady(paths, "fonts", target) ? [...systemFontDirectories(), paths.dirOf("fonts")].flatMap((dir) => ["--font-directory", dir]) : [];
 var EngineError = class extends Error {
 };
 var parseEngineOutput = (stdout, stderr, exitCode) => {
@@ -949,19 +576,39 @@ var runEngineCancellable = async (input) => {
     input.signal.removeEventListener("abort", onAbort);
   }
 };
-var machineHasCjkFont = async (processApi, paths, target, platform5 = NodeProcess3.platform) => {
-  if (await componentReady(paths, "fonts", target)) return true;
-  if (platform5 !== "linux") return true;
+var machineHasCjkFont = async (_processApi, paths, target) => componentReady(paths, "fonts", target);
+
+// src/runtime.ts
+var compatiblePython = (runtime) => runtime !== null && runtime.version === PYTHON_VERSION;
+var pythonArgs = (paths, script, args = []) => [
+  "-I",
+  "-S",
+  "-B",
+  paths.pythonRunner,
+  "--libraries",
+  paths.pythonLibraries,
+  "--",
+  script,
+  ...args
+];
+var engineBackend = async (processApi, cli, cwd) => {
+  const result = await processApi.run({
+    program: "host:node",
+    args: [cli, "capabilities", "--json"],
+    cwd,
+    timeoutMs: 6e4
+  });
+  let backend;
   try {
-    const result = await processApi.run({
-      program: "fc-list",
-      args: [":lang=zh", "family"],
-      timeoutMs: 15e3
-    });
-    return result.exitCode === 0 && result.stdout.trim().length > 0;
+    backend = JSON.parse(result.stdout).runtime?.backend;
   } catch {
-    return false;
+    backend = void 0;
   }
+  if (result.exitCode !== 0 || typeof backend !== "string")
+    throw new Error(
+      `The bundled Office engine did not start: ${(result.stderr || result.stdout).trim().slice(0, 400)}`
+    );
+  return backend;
 };
 
 // src/health.ts
@@ -975,7 +622,11 @@ var runHealthCheck = async (input) => {
   } else {
     try {
       const backend = await engineBackend(processApi, paths.engineCli, paths.dataDir);
-      entries.push({ key: "health.engine.ok", params: { backend }, ok: true });
+      entries.push({
+        key: "health.engine.ok",
+        params: { backend, version: ENGINE_VERSION },
+        ok: true
+      });
     } catch (error) {
       entries.push({
         key: "health.engine.broken",
@@ -986,47 +637,59 @@ var runHealthCheck = async (input) => {
   }
   if (pythonTargetOf(target) === null) {
     entries.push({ key: "health.python.unsupported", ok: false });
-  } else if (!await componentReady(paths, "python", target)) {
-    entries.push({ key: "health.python.missing", ok: false });
   } else {
-    const result = await processApi.run({
-      program: pythonProgram(),
-      args: ["-I", "-c", "import docx, pptx, openpyxl, pandas, PIL, lxml"],
-      cwd: paths.dataDir,
-      timeoutMs: 6e4
-    });
-    entries.push(
-      result.exitCode === 0 ? { key: "health.python.ok", ok: true } : {
+    try {
+      const runtime = await input.resolvePython();
+      if (!compatiblePython(runtime) || !await componentReady(paths, "python", target)) {
+        entries.push({ key: "health.python.missing", ok: false });
+      } else {
+        const result = await processApi.run({
+          program: "host:python",
+          args: pythonArgs(paths, input.runtimeCheckScript),
+          env: runtime.env,
+          cwd: paths.dataDir,
+          timeoutMs: 6e4
+        });
+        entries.push(
+          result.exitCode === 0 ? { key: "health.python.ok", params: { version: runtime.version }, ok: true } : {
+            key: "health.python.broken",
+            params: { detail: (result.stderr || result.stdout).trim().slice(-300) },
+            ok: false
+          }
+        );
+      }
+    } catch (error) {
+      entries.push({
         key: "health.python.broken",
-        params: { detail: (result.stderr || result.stdout).trim().slice(-300) },
+        params: { detail: firstLine(error) },
         ok: false
-      }
-    );
+      });
+    }
   }
   entries.push(
-    await machineHasCjkFont(processApi, paths, target) ? { key: "health.fonts.ok", ok: true } : { key: "health.fonts.missing", ok: false }
+    await componentReady(paths, "fonts", target) ? { key: "health.fonts.ok", params: { version: FONTS_VERSION }, ok: true } : { key: "health.fonts.missing", ok: false }
   );
   return entries;
 };
 
 // src/preview.ts
-import * as NodeFSP5 from "node:fs/promises";
-import * as NodePath5 from "node:path";
+import * as NodeFSP2 from "node:fs/promises";
+import * as NodePath3 from "node:path";
 var PREVIEW_COMMAND = "convert-preview";
 var isWithin = (root, candidate) => {
-  const relative4 = NodePath5.relative(root, candidate);
-  return relative4 !== "" && !relative4.startsWith("..") && !NodePath5.isAbsolute(relative4);
+  const relative3 = NodePath3.relative(root, candidate);
+  return relative3 !== "" && !relative3.startsWith("..") && !NodePath3.isAbsolute(relative3);
 };
 var isAllowedPreviewOutput = async (cacheDir, outputPath) => {
-  if (!NodePath5.isAbsolute(outputPath) || NodePath5.extname(outputPath).toLowerCase() !== ".pdf") {
+  if (!NodePath3.isAbsolute(outputPath) || NodePath3.extname(outputPath).toLowerCase() !== ".pdf") {
     return false;
   }
   try {
     const [root, parent] = await Promise.all([
-      NodeFSP5.realpath(cacheDir),
-      NodeFSP5.realpath(NodePath5.dirname(outputPath))
+      NodeFSP2.realpath(cacheDir),
+      NodeFSP2.realpath(NodePath3.dirname(outputPath))
     ]);
-    return isWithin(root, NodePath5.join(parent, NodePath5.basename(outputPath)));
+    return isWithin(root, NodePath3.join(parent, NodePath3.basename(outputPath)));
   } catch {
     return false;
   }
@@ -1068,8 +731,7 @@ var registerPreviewCommand = (ctx, deps) => ctx.stream({
 });
 
 // src/tools.ts
-import * as NodePath6 from "node:path";
-import * as NodeProcess4 from "node:process";
+import * as NodePath4 from "node:path";
 
 // src/ooxml.ts
 import * as NodeZlib from "node:zlib";
@@ -1136,7 +798,7 @@ var ooxmlHasCjk = (input) => {
 // src/tools.ts
 var MAX_IMAGES = 4;
 var MAX_IMAGE_BYTES = 3 * 1024 * 1024;
-var SETUP_HINT = "Ask the user to set it up in Settings \u2192 Plugins \u2192 Office. Do not install LibreOffice, Python packages, or another renderer yourself.";
+var SETUP_HINT = "Open Settings \u2192 Plugins \u2192 Office \u2192 Check for diagnostics. Restore the complete Ycodium installation from an offline installer if bundled files are missing or damaged. Do not install LibreOffice, Python packages, or another renderer yourself.";
 var text = (value, isError = false) => isError ? { text: value, isError: true } : { text: value };
 var stringArg = (input, key) => {
   const value = input[key];
@@ -1144,10 +806,10 @@ var stringArg = (input, key) => {
 };
 var workingDirOf = (invocation) => invocation.workspace?.roots[0] ?? invocation.projectRoot;
 var relativeTo = (cwd, target) => {
-  const relative4 = NodePath6.relative(cwd, target);
-  return relative4.startsWith("..") || NodePath6.isAbsolute(relative4) ? target : relative4;
+  const relative3 = NodePath4.relative(cwd, target);
+  return relative3.startsWith("..") || NodePath4.isAbsolute(relative3) ? target : relative3;
 };
-var requireEngine = async (deps) => await componentReady(deps.paths, "engine", deps.target) ? null : text(`The Office engine is not installed on this machine. ${SETUP_HINT}`, true);
+var requireEngine = async (deps) => await componentReady(deps.paths, "engine", deps.target) && await componentReady(deps.paths, "fonts", deps.target) ? null : text(`The bundled Office engine or fonts are missing or damaged. ${SETUP_HINT}`, true);
 var noWorkspace = text(
   "This tool needs a conversation with a project folder; call it from a thread.",
   true
@@ -1157,7 +819,7 @@ var engineFailure = (error) => text(
 Do not retry with another renderer; report the failure.`,
   true
 );
-var CJK_WARNING = "Warning: this machine has no Chinese/Japanese/Korean font, so CJK text in these images is drawn as boxes. Do not judge the layout from them. Fixes: install Chinese fonts in Settings \u2192 Plugins \u2192 Office, or install a system package such as fonts-noto-cjk.";
+var CJK_WARNING = "Warning: bundled Chinese fonts are missing or damaged, so CJK text may be drawn as boxes. Do not judge the layout from these images. Restore the complete Ycodium installation from an offline installer.";
 var missingFontsLine = (fonts) => fonts === void 0 || fonts.length === 0 ? "Missing fonts: none." : `Missing fonts (substituted): ${fonts.join(", ")}.`;
 var readImages = async (invocation, images) => {
   const workspace = invocation.workspace;
@@ -1183,7 +845,7 @@ var documentHasCjk = async (invocation, source) => {
 };
 var render = (deps) => ({
   name: "render",
-  description: "Render pages, slides, or a worksheet range of an Office document (docx, pptx, xlsx, doc, ppt, xls, odt, odp, ods) or a PDF to PNG images with the bundled LibreOffice engine, for visual checks. Returns the page count, image paths, and missing fonts; up to four images are attached for models that read images. `outputDir` must be a new directory.",
+  description: "Render Word documents, PowerPoint slides, Excel worksheet ranges or OpenDocument files (docx, pptx, xlsx, doc, ppt, xls, odt, odp, ods), or PDF pages, to PNG images with the bundled LibreOffice engine for visual checks of layout, pagination, charts and fonts. Returns the page count, image paths, and missing fonts; up to four images are attached for models that read images. `outputDir` must be a new directory.",
   inputSchema: {
     type: "object",
     properties: {
@@ -1239,7 +901,7 @@ var render = (deps) => ({
       return engineFailure(error);
     }
     const images = result.images ?? [];
-    const absoluteSource = NodePath6.resolve(cwd, source);
+    const absoluteSource = NodePath4.resolve(cwd, source);
     const warn = !await machineHasCjkFont(deps.process, deps.paths, deps.target) && await documentHasCjk(invocation, absoluteSource) === true;
     const lines = [
       ...warn ? [CJK_WARNING] : [],
@@ -1318,8 +980,12 @@ var check = (deps) => ({
     required: ["path"]
   },
   handle: async (input, invocation) => {
-    if (!await componentReady(deps.paths, "python", deps.target)) {
-      return text(`Python for Office is not installed on this machine. ${SETUP_HINT}`, true);
+    const runtime = await deps.resolvePython();
+    if (!compatiblePython(runtime) || !await componentReady(deps.paths, "python", deps.target)) {
+      return text(
+        `The shared Python runtime or bundled Office document libraries are missing or damaged. ${SETUP_HINT}`,
+        true
+      );
     }
     const cwd = workingDirOf(invocation);
     if (cwd === null) return noWorkspace;
@@ -1328,16 +994,14 @@ var check = (deps) => ({
     const contains = Array.isArray(input["contains"]) ? input["contains"].filter((entry) => typeof entry === "string") : [];
     const count = typeof input["count"] === "number" ? ["--count", String(input["count"])] : [];
     const result = await deps.process.run({
-      program: pythonProgram(),
-      args: [
-        "-I",
-        deps.checkerScript,
+      program: "host:python",
+      args: pythonArgs(deps.paths, deps.checkerScript, [
         source,
         ...contains.flatMap((value) => ["--contains", value]),
         ...count
-      ],
+      ]),
       cwd,
-      env: { PYTHONIOENCODING: "utf-8" },
+      env: runtime.env,
       timeoutMs: 12e4
     });
     const report = result.stdout.trim();
@@ -1352,24 +1016,38 @@ ${result.stderr.trim()}`.trim());
 });
 var python = (deps) => ({
   name: "python",
-  description: "Return the bundled Python interpreter for writing Office files, with python-docx, python-pptx, openpyxl, pandas, Pillow, lxml, and XlsxWriter preinstalled. Run your scripts with this executable instead of installing packages or looking for a system Python.",
+  description: "Return the shared Ycodium Python executable and required arguments for creating or editing Word documents (docx), PowerPoint presentations (pptx) and Excel workbooks (xlsx), with python-docx, python-pptx, openpyxl, pandas, Pillow, lxml, and XlsxWriter preinstalled. Run your scripts with the returned executable AND args instead of installing packages or looking for a system Python.",
   inputSchema: { type: "object", properties: {} },
   handle: async () => {
-    if (!await componentReady(deps.paths, "python", deps.target)) {
-      return text(`Python for Office is not installed on this machine. ${SETUP_HINT}`, true);
+    const runtime = await deps.resolvePython();
+    if (!compatiblePython(runtime) || !await componentReady(deps.paths, "python", deps.target)) {
+      return text(
+        `The shared Python runtime or bundled Office document libraries are missing or damaged. ${SETUP_HINT}`,
+        true
+      );
     }
     return text(
       [
         JSON.stringify(
           {
-            python: deps.paths.pythonExecutable(NodeProcess4.platform),
-            version: OFFICE_LOCK.python.version,
+            python: runtime.executablePath,
+            args: [
+              "-I",
+              "-S",
+              "-B",
+              deps.paths.pythonRunner,
+              "--libraries",
+              deps.paths.pythonLibraries,
+              "--"
+            ],
+            env: runtime.env,
+            version: runtime.version,
             packages: OFFICE_LOCK.python.packages
           },
           null,
           2
         ),
-        "Quote the path when you run it; PowerShell also needs the `&` call operator. Keep scripts and outputs in the project folder."
+        "Invoke `python` with every returned `args` element followed by your script path and script arguments; this loads the isolated Office libraries. Apply the returned env entries if any. Quote each argument; PowerShell also needs the `&` call operator. Keep scripts and outputs in the project folder."
       ].join("\n")
     );
   }
@@ -1383,110 +1061,39 @@ var officeTools = (deps) => [
 ];
 
 // src/index.ts
-var sourcesOf = (config) => {
-  const pick = (value, fallback) => typeof value === "string" && value.trim() !== "" ? value.trim() : fallback;
-  return {
-    npmRegistry: pick(config.npmRegistry, DEFAULT_SOURCES.npmRegistry),
-    githubMirror: pick(config.githubMirror, DEFAULT_SOURCES.githubMirror),
-    pypiMirror: pick(config.pypiMirror, DEFAULT_SOURCES.pypiMirror),
-    localDir: pick(config.localDir, DEFAULT_SOURCES.localDir)
-  };
-};
-var failureOf = (error) => {
-  const detail = error instanceof Error ? error.message : String(error);
-  if (error instanceof InstallError)
-    return { kind: "failed", reasonKey: `failure.${error.reason}`, detail };
-  if (error instanceof DownloadError) {
-    return { kind: "failed", reasonKey: `failure.download-${error.reason}`, detail };
-  }
-  return { kind: "failed", reasonKey: "failure.unknown", detail };
-};
-var EMPTY_PAYLOAD = { type: "object", properties: {} };
 var index_default = definePlugin({
   id: "office",
-  apiVersion: 43,
+  apiVersion: 46,
   activate: (ctx) => {
-    const paths = officePaths(ctx.paths.dataDir);
     const target = detectOfficeTarget();
+    const paths = officePaths(ctx.paths.pluginDir, ctx.paths.dataDir, target, ctx.paths.runtimeDir);
+    const resolvePython = async () => await ctx.runtimes?.resolve("python") ?? null;
     ctx.toolkit({
       name: "office",
       tools: officeTools({
         process: ctx.process,
         paths,
         target,
-        checkerScript: NodePath7.join(ctx.paths.pluginDir, "assets", "check_office.py")
+        resolvePython,
+        checkerScript: NodePath5.join(ctx.paths.pluginDir, "assets", "check_office.py")
       })
     });
     registerPreviewCommand(ctx, { paths, target });
-    let busy = false;
-    const action = (name, description, run) => ctx.stream({
-      name,
-      description,
+    ctx.stream({
+      name: "health",
+      description: "Check bundled Office components and shared Python on this machine without downloading anything.",
       scope: "operate",
-      payloadSchema: EMPTY_PAYLOAD,
-      handle: async (_payload, emit, signal) => {
-        if (busy) {
-          emit({ kind: "failed", reasonKey: "failure.busy" });
-          return;
-        }
-        busy = true;
-        try {
-          emit(await run(emit, signal));
-        } catch (error) {
-          if (!signal.aborted) emit(failureOf(error));
-        } finally {
-          busy = false;
-        }
-      }
-    });
-    const installContext = (emit, signal) => {
-      if (target === null) {
-        throw new InstallError(
-          "unsupported-platform",
-          "This machine's platform has no Office engine build."
-        );
-      }
-      return {
-        http: ctx.http,
-        process: ctx.process,
-        paths,
-        target,
-        sources: sourcesOf(ctx.config),
-        signal,
-        emit
-      };
-    };
-    action("install-engine", "Download and install the Office engine.", async (emit, signal) => {
-      const backend = await installEngine(installContext(emit, signal));
-      return {
-        kind: "done",
-        fills: {},
-        messageKey: `progress.done.engine.${backend === "wasm" ? "wasm" : "native"}`
-      };
-    });
-    action(
-      "install-python",
-      "Download and install Python with the document libraries.",
-      async (emit, signal) => {
-        await installPython(installContext(emit, signal));
-        return { kind: "done", fills: {}, messageKey: "progress.done.python" };
-      }
-    );
-    action(
-      "install-fonts",
-      "Download Chinese fonts for the Office engine.",
-      async (emit, signal) => {
-        await installFonts(installContext(emit, signal));
-        return { kind: "done", fills: {}, messageKey: "progress.done.fonts" };
-      }
-    );
-    action(
-      "health",
-      "Check the Office engine, Python, and fonts on this machine.",
-      async (emit) => {
+      payloadSchema: { type: "object", properties: {} },
+      handle: async (_payload, emit) => {
         emit({ kind: "status", statusKey: "progress.checking" });
-        const entries = await runHealthCheck({ process: ctx.process, paths, target });
-        return {
+        const entries = await runHealthCheck({
+          process: ctx.process,
+          paths,
+          target,
+          resolvePython,
+          runtimeCheckScript: NodePath5.join(ctx.paths.pluginDir, "assets", "check_runtime.py")
+        });
+        emit({
           kind: "done",
           fills: {},
           messageKey: entries.every((entry) => entry.ok) ? "health.summary.ok" : "health.summary.issues",
@@ -1494,77 +1101,19 @@ var index_default = definePlugin({
             key: entry.key,
             ...entry.params === void 0 ? {} : { params: entry.params }
           }))
-        };
-      }
-    );
-    action(
-      "remove-runtime",
-      "Delete the Office engine, Python, and fonts from this machine.",
-      async (emit) => {
-        emit({ kind: "status", statusKey: "progress.removing" });
-        await removeRuntime(paths);
-        return { kind: "done", fills: {}, messageKey: "progress.done.removed" };
+        });
       }
-    );
+    });
     ctx.settingsCard({
       titleKey: "settings.card.title",
       descriptionKey: "settings.card.description",
-      fields: [
-        {
-          key: "npmRegistry",
-          kind: "text",
-          labelKey: "settings.npmRegistry.label",
-          descriptionKey: "settings.npmRegistry.description"
-        },
-        {
-          key: "githubMirror",
-          kind: "text",
-          labelKey: "settings.githubMirror.label",
-          descriptionKey: "settings.githubMirror.description"
-        },
-        {
-          key: "pypiMirror",
-          kind: "text",
-          labelKey: "settings.pypiMirror.label",
-          descriptionKey: "settings.pypiMirror.description"
-        },
-        {
-          key: "localDir",
-          kind: "text",
-          labelKey: "settings.localDir.label",
-          descriptionKey: "settings.localDir.description"
-        }
-      ],
+      fields: [],
       actions: [
-        {
-          id: "install-engine",
-          labelKey: "actions.installEngine.label",
-          descriptionKey: "actions.installEngine.description",
-          command: "install-engine"
-        },
-        {
-          id: "install-python",
-          labelKey: "actions.installPython.label",
-          descriptionKey: "actions.installPython.description",
-          command: "install-python"
-        },
-        {
-          id: "install-fonts",
-          labelKey: "actions.installFonts.label",
-          descriptionKey: "actions.installFonts.description",
-          command: "install-fonts"
-        },
         {
           id: "health",
           labelKey: "actions.health.label",
           descriptionKey: "actions.health.description",
           command: "health"
-        },
-        {
-          id: "remove-runtime",
-          labelKey: "actions.remove.label",
-          descriptionKey: "actions.remove.description",
-          command: "remove-runtime"
         }
       ]
     });