@actiondock/builder 2.0.11-beta.0 → 2.0.12

package/dist/planner.d.ts

@@ -0,0 +1,26 @@
+import type { BuildPlan, BuildPlannerOptions } from "./types";
+/**
+ * 构建规划器。
+ * 纯声明式解析 actiondock.manifest.json 与配置，绝不执行 Action 业务代码。
+ */
+export declare class BuildPlanner {
+    private projectRoot;
+    constructor(options?: {
+        projectRoot?: string;
+    });
+    /**
+     * 执行依赖闭包裁剪与构建规划。
+     *
+     * @param options 规划参数
+     * @returns 完整的 BuildPlan 结构
+     */
+    plan(options?: BuildPlannerOptions): BuildPlan;
+    /**
+     * 静态辅助调用方法。
+     */
+    static plan(options: BuildPlannerOptions): BuildPlan;
+}
+/**
+ * 快捷构建规划函数。
+ */
+export declare function buildPlan(options: BuildPlannerOptions): BuildPlan;

package/dist/types.d.ts

@@ -0,0 +1,311 @@
+import type { ActionDockManifest, ProjectConfig } from "@actiondock/core";
+/**
+ * Action 依赖描述。
+ */
+export interface ActionDependency {
+    /** Action 唯一标识符 */
+    id: string;
+    /** Action 入口文件相对路径 */
+    entry: string;
+    /** Action 源码文件绝对路径 */
+    resolvedPath: string;
+    /** 静态依赖的下游 Action ID 列表 */
+    uses: string[];
+    /** Action 功能描述 */
+    description?: string;
+    /** 入参校验模式 */
+    inputSchema?: Record<string, unknown> | boolean;
+    /** 出参校验模式 */
+    outputSchema?: Record<string, unknown> | boolean;
+    /** 标签列表 */
+    tags?: string[];
+    /** 扩展注解 */
+    annotations?: Record<string, unknown>;
+}
+/**
+ * 资产或模块依赖描述。
+ */
+export interface AssetDependency {
+    /** 资产相对路径 */
+    path: string;
+    /** 资产绝对物理路径 */
+    resolvedPath: string;
+    /** 资产类型：静态资产、规程文档、配置文件或模块源码 */
+    type: "asset" | "playbook" | "config" | "module";
+}
+/**
+ * 外部依赖描述。
+ */
+export interface ExternalDependency {
+    /** 外部依赖包名 */
+    name: string;
+    /** 版本约束范围 */
+    versionRange?: string;
+    /** 是否为开发期依赖 */
+    isDev?: boolean;
+}
+/**
+ * 构建规划中的依赖集合分类。
+ */
+export interface BuildPlanDependencies {
+    /** Action 依赖闭包 */
+    actions: ActionDependency[];
+    /** 模块与资产依赖 */
+    modulesAndAssets: AssetDependency[];
+    /** 外部 npm 依赖 */
+    external: ExternalDependency[];
+}
+/**
+ * Playbook 规划项。
+ */
+export interface PlaybookPlanEntry {
+    id: string;
+    filePath: string;
+    actions?: string[];
+    description?: string;
+}
+/**
+ * 构建规划产物结构。
+ */
+export interface BuildPlan {
+    /** 所属 Package ID */
+    packageId: string;
+    /** 项目展示名称 */
+    packageName: string;
+    /** 版本号 */
+    version: string;
+    /** 描述信息 */
+    description?: string;
+    /** 项目根目录绝对路径 */
+    projectRoot: string;
+    /** actions 目录相对路径 */
+    actionsDir?: string;
+    /** playbooks 目录相对路径 */
+    playbooksDir?: string;
+    /** 参与构建的 Action 列表 */
+    actions: ActionDependency[];
+    /** 参与构建的 Playbook 列表 */
+    playbooks: PlaybookPlanEntry[];
+    /** 分类依赖明细 */
+    dependencies: BuildPlanDependencies;
+    /** 资产路径列表 */
+    assets: string[];
+    /** 声明的配置定义字典 */
+    configDefs?: Record<string, unknown>;
+    /** 规划元数据 */
+    metadata: {
+        plannedAt: string;
+        schemaVersion: number;
+        actionCount: number;
+        playbookCount: number;
+    };
+}
+/**
+ * 构建规划器配置选项。
+ */
+export interface BuildPlannerOptions {
+    /** 项目根目录绝对路径 */
+    projectRoot: string;
+    /** 显式传入的项目配置（若未提供则从 actiondock.json 读取） */
+    config?: ProjectConfig;
+    /** 显式传入的声明式清单（若未提供则从 actiondock.manifest.json 读取） */
+    manifest?: ActionDockManifest;
+    /** 挑选的 Action ID 列表（用于依赖闭包裁剪） */
+    actions?: string[];
+    /** 挑选的 Playbook ID 列表（用于 Playbook 驱动的依赖闭包裁剪） */
+    playbooks?: string[];
+}
+/**
+ * 支持的 Bun 独立编译目标平台。
+ */
+export type CompileTarget = "bun" | "host" | "bun-linux-x64" | "linux-x64" | "bun-linux-arm64" | "linux-arm64" | "bun-darwin-x64" | "darwin-x64" | "bun-darwin-arm64" | "darwin-arm64" | "bun-windows-x64" | "windows-x64" | "bun-linux-x64-baseline" | "linux-x64-baseline" | "bun-linux-x64-modern" | "linux-x64-modern";
+/**
+ * Bun 独立编译器参数选项。
+ */
+export interface BunCompilerOptions {
+    /** 编译入口文件绝对路径 */
+    entrypoint: string;
+    /** 目标二进制文件输出路径 */
+    outfile: string;
+    /** 编译目标平台架构（默认 host） */
+    target?: CompileTarget | string;
+    /** 是否开启代码压缩混淆（默认 true） */
+    minify?: boolean;
+    /** 是否启用字节码预编译（默认 true） */
+    bytecode?: boolean;
+    /** 构建工作目录（默认入口文件所在根目录） */
+    cwd?: string;
+    /** 自定义环境变量 */
+    env?: Record<string, string>;
+    /** 所属 Package ID（写入元数据用） */
+    packageId?: string;
+    /** 所属版本号（写入元数据用） */
+    version?: string;
+    /** 包含的 Action ID 列表（写入元数据用） */
+    actions?: string[];
+    /** 是否生成 artifact.json 元数据文件（默认 true） */
+    emitMetadata?: boolean;
+}
+/**
+ * Bun 独立编译器输出结果。
+ */
+export interface BunCompilerResult {
+    /** 所属 Package ID */
+    packageId?: string;
+    /** 版本号 */
+    version?: string;
+    /** 编译目标架构 */
+    target: string;
+    /** 独立二进制文件绝对路径 */
+    executablePath: string;
+    /** 独立二进制文件字节大小 */
+    sizeBytes: number;
+    /** 独立二进制文件的 SHA-256 校验和 */
+    sha256: string;
+    /** 生成的元数据文件绝对路径（若生成） */
+    metadataPath?: string;
+    /** 编译是否开启混淆 */
+    minify: boolean;
+    /** 编译是否启用字节码 */
+    bytecode: boolean;
+    /** 编译耗时（毫秒） */
+    durationMs: number;
+    /** 编译完成时间戳 */
+    compiledAt: string;
+}
+/**
+ * 归档压缩格式。
+ */
+export type ArchiveFormat = "zip" | "tar.gz";
+/**
+ * Skill 导出选项。
+ */
+export interface SkillExporterOptions {
+    /** 源码项目根目录绝对路径 */
+    projectRoot: string;
+    /** 导出模式：source 源码模式 或 standalone 独立二进制模式（默认 source） */
+    mode?: "source" | "standalone";
+    /** 是否开启独立二进制模式（简写选项） */
+    standalone?: boolean;
+    /** 二进制编译目标架构（仅在独立二进制模式生效，默认 host） */
+    target?: CompileTarget | string;
+    /** 导出产物目标目录（默认输出至 dist 目录） */
+    outDir?: string;
+    /** 是否执行归档压缩，亦可直接指定归档格式 */
+    archive?: boolean | ArchiveFormat;
+    /** 归档压缩格式（zip 或 tar.gz） */
+    archiveFormat?: ArchiveFormat;
+    /** 挑选的 Playbook 列表（用于 Playbook 驱动的依赖闭包裁剪） */
+    playbooks?: string[];
+    /** 挑选的 Action 列表（用于 Action 驱动的依赖闭包裁剪） */
+    actions?: string[];
+    /** 独立二进制模式下是否开启代码混淆（默认 true） */
+    minify?: boolean;
+    /** 独立二进制模式下是否编译为字节码（默认 true） */
+    bytecode?: boolean;
+    /** 预置的项目配置（可选） */
+    config?: ProjectConfig;
+    /** 预置的声明式清单（可选） */
+    manifest?: ActionDockManifest;
+    /** 是否跳过生成 SKILL.md（多包聚合时避免子包重复生成，对外保持唯一定义） */
+    skipSkillMd?: boolean;
+    /** 显式指定的已有 SKILL.md 文件路径（若提供或存在则直接使用，不再动态生成） */
+    skillMdPath?: string;
+}
+/**
+ * Skill 导出完成结果。
+ */
+export interface SkillExportResult {
+    /** 所属 Package ID */
+    packageId: string;
+    /** 项目版本号 */
+    version: string;
+    /** 导出模式 */
+    mode: "source" | "standalone";
+    /** 目标平台架构 */
+    target: string;
+    /** 生成的 Skill 目录绝对路径 */
+    skillDir: string;
+    /** 生成的归档文件绝对路径（若开启压缩） */
+    archivePath?: string;
+    /** 导出的 Action 数量 */
+    actionsCount: number;
+    /** 导出的 Playbook 数量 */
+    playbooksCount: number;
+    /** 导出的 Action ID 列表 */
+    actions: string[];
+    /** 导出的 Playbook ID 列表 */
+    playbooks: string[];
+    /** 导出的文件相对路径清单 */
+    files: string[];
+    /** 若复用了已有的 SKILL.md 文件，返回该文件的绝对路径 */
+    usedExistingSkillMd?: string;
+}
+/**
+ * 批量 Skill 导出选项。
+ */
+export interface BatchSkillExportOptions extends Omit<SkillExporterOptions, "projectRoot"> {
+    /** 待导出的项目根目录绝对路径列表 */
+    projectRoots: string[];
+}
+/**
+ * 批量 Skill 导出结果。
+ */
+export interface BatchSkillExportResult {
+    /** 各包独立导出结果列表 */
+    results: SkillExportResult[];
+    /** 批量导出根目录 */
+    outDir: string;
+    /** 导出的总 Action 数量 */
+    totalActions: number;
+    /** 导出的总 Playbook 数量 */
+    totalPlaybooks: number;
+}
+/**
+ * 复合 Skill 套件导出选项。
+ */
+export interface CompositeSkillExportOptions {
+    /** 复合技能套件名称 */
+    bundleName: string;
+    /** 参与聚合的项目根目录绝对路径列表 */
+    projectRoots: string[];
+    /** 复合套件输出目标目录（默认输出至 dist 目录） */
+    outDir?: string;
+    /** 复合技能描述信息 */
+    description?: string;
+    /** 是否执行归档压缩，亦可直接指定归档格式 */
+    archive?: boolean | ArchiveFormat;
+    /** 归档压缩格式（zip 或 tar.gz） */
+    archiveFormat?: ArchiveFormat;
+    /** 工作区根目录（用于检索工作区现有的 SKILL.md 等资产，默认基于 cwd 与项目目录推导） */
+    workspaceRoot?: string;
+    /** 显式指定的已有 SKILL.md 文件路径（若存在则直接使用，不再动态生成） */
+    skillMdPath?: string;
+}
+/**
+ * 复合 Skill 套件导出结果。
+ */
+export interface CompositeSkillExportResult {
+    /** 复合技能套件名称 */
+    bundleName: string;
+    /** 生成的复合 Skill 目录绝对路径 */
+    skillDir: string;
+    /** 生成的归档文件绝对路径（若开启压缩） */
+    archivePath?: string;
+    /** 包含的 Package 数量 */
+    packagesCount: number;
+    /** 包含的总 Action 数量 */
+    actionsCount: number;
+    /** 包含的总 Playbook 数量 */
+    playbooksCount: number;
+    /** 各包的摘要明细 */
+    packages: Array<{
+        packageId: string;
+        actions: string[];
+        playbooks: string[];
+    }>;
+    /** 生成的文件清单 */
+    files: string[];
+    /** 若复用了已有的 SKILL.md 文件，返回该文件的绝对路径 */
+    usedExistingSkillMd?: string;
+}

package/package.json

@@ -1,40 +1,39 @@
 {
   "name": "@actiondock/builder",
-  "version": "2.0.11-beta.0",
+  "version": "2.0.12",
   "description": "ActionDock Build Planner, Bun standalone compiler, and Skill exporter",
   "type": "module",
-  "main": "./src/index.ts",
-  "module": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.ts",
-      "types": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "files": [
-    "src",
+    "dist",
     "README.md"
   ],
   "engines": {
-    "node": ">=22.12.0"
+    "node": ">=22.13.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
+    "build": "bun run ../../scripts/build.ts",
     "test": "bun test"
   },
   "dependencies": {
-    "@actiondock/core": "2.0.11-beta.0",
-    "@actiondock/sdk": "2.0.11-beta.0",
+    "@actiondock/core": "^2.0.12",
+    "@actiondock/sdk": "^2.0.12",
+    "typescript": "^5.7.0",
     "yaml": "^2.7.0"
   },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
   "keywords": [
     "actiondock",
     "builder",

package/src/archive.ts

@@ -1,248 +0,0 @@
-import { readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { deflateRawSync, gzipSync } from "node:zlib";
-import { basename, dirname, join, relative, sep } from "node:path";
-
-/**
- * 纯 Node 实现的归档压缩模块。
- *
- * zip 与 tar.gz 均在进程内完成打包，不依赖宿主机的 zip / tar 命令行工具
- * （Windows 与最小化 Linux 环境普遍缺少 zip 命令）。
- * 压缩能力复用 node:zlib 内置的 deflateRaw（zip 条目）与 gzip（tar.gz 容器）。
- */
-
-/** 目录内相对路径条目（目录在前、同级按名称排序，保证归档内容顺序稳定） */
-interface ArchiveEntry {
-  /** 相对根目录的 POSIX 风格路径（目录以 / 结尾仅出现在 zip 条目名层面） */
-  relPath: string;
-  /** 是否为目录 */
-  isDir: boolean;
-}
-
-/** 递归收集目录内全部条目 */
-function collectEntries(dir: string, baseDir = dir): ArchiveEntry[] {
-  const entries: ArchiveEntry[] = [];
-  for (const name of readdirSync(dir).sort()) {
-    const fullPath = join(dir, name);
-    const stat = statSync(fullPath);
-    if (stat.isDirectory()) {
-      entries.push({ relPath: relative(baseDir, fullPath).split(sep).join("/"), isDir: true });
-      entries.push(...collectEntries(fullPath, baseDir));
-    } else if (stat.isFile()) {
-      entries.push({ relPath: relative(baseDir, fullPath).split(sep).join("/"), isDir: false });
-    }
-  }
-  return entries;
-}
-
-/* ------------------------------------------------------------------ */
-/* zip 格式写入                                                        */
-/* ------------------------------------------------------------------ */
-
-/** CRC32 查表（IEEE 802.3 多项式） */
-const CRC32_TABLE: Uint32Array = (() => {
-  const table = new Uint32Array(256);
-  for (let n = 0; n < 256; n++) {
-    let c = n;
-    for (let k = 0; k < 8; k++) {
-      c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
-    }
-    table[n] = c >>> 0;
-  }
-  return table;
-})();
-
-function crc32(buf: Buffer): number {
-  let crc = 0xffffffff;
-  for (let i = 0; i < buf.length; i++) {
-    crc = CRC32_TABLE[(crc ^ buf[i]) & 0xff] ^ (crc >>> 8);
-  }
-  return (crc ^ 0xffffffff) >>> 0;
-}
-
-/** Unix 毫秒时间戳转 DOS 时间格式（date/time 各 16 位） */
-function dosDateTime(ms: number): { date: number; time: number } {
-  const d = new Date(ms);
-  const year = Math.max(d.getFullYear(), 1980);
-  const time = (d.getHours() << 11) | (d.getMinutes() << 5) | (d.getSeconds() >> 1);
-  const date = ((year - 1980) << 9) | ((d.getMonth() + 1) << 5) | d.getDate();
-  return { date, time };
-}
-
-/** central directory 记录（写入 EOCD 前聚合） */
-interface ZipCentralRecord {
-  header: Buffer;
-  localOffset: number;
-}
-
-/**
- * 将目录打包为标准 zip 归档（PKZIP APPNOTE 结构）。
- *
- * @param dir 待打包目录（目录名即归档内根文件夹名）
- * @param outPath 输出 zip 文件路径
- */
-export function createZipArchive(dir: string, outPath: string): void {
-  const rootName = basename(dir);
-  const entries = collectEntries(dir);
-  const chunks: Buffer[] = [];
-  const centralRecords: ZipCentralRecord[] = [];
-  let offset = 0;
-
-  for (const entry of entries) {
-    // 归档内路径带根目录前缀；目录条目名以 / 结尾
-    const name = `${rootName}/${entry.relPath}${entry.isDir ? "/" : ""}`;
-    const nameBuf = Buffer.from(name, "utf8");
-    const stat = statSync(join(dir, entry.relPath));
-    const { date, time } = dosDateTime(stat.mtimeMs);
-    const content = entry.isDir ? Buffer.alloc(0) : readFileSync(join(dir, entry.relPath));
-
-    let method = 0;
-    let payload = content;
-    if (!entry.isDir && content.length > 0) {
-      const deflated = deflateRawSync(content, { level: 9 });
-      if (deflated.length < content.length) {
-        method = 8;
-        payload = deflated;
-      }
-    }
-
-    const crc = crc32(content);
-
-    // Local File Header（30 字节 + 文件名）
-    const local = Buffer.alloc(30);
-    local.writeUInt32LE(0x04034b50, 0);
-    local.writeUInt16LE(20, 4);
-    local.writeUInt16LE(0x0800, 6); // UTF-8 文件名标志
-    local.writeUInt16LE(method, 8);
-    local.writeUInt16LE(time, 10);
-    local.writeUInt16LE(date, 12);
-    local.writeUInt32LE(crc, 14);
-    local.writeUInt32LE(payload.length, 18);
-    local.writeUInt32LE(content.length, 22);
-    local.writeUInt16LE(nameBuf.length, 26);
-    local.writeUInt16LE(0, 28);
-    chunks.push(local, nameBuf, payload);
-
-    // Central Directory Header（46 字节 + 文件名）
-    const central = Buffer.alloc(46);
-    central.writeUInt32LE(0x02014b50, 0);
-    central.writeUInt16LE(20, 4); // version made by
-    central.writeUInt16LE(20, 6); // version needed
-    central.writeUInt16LE(0x0800, 8);
-    central.writeUInt16LE(method, 10);
-    central.writeUInt16LE(time, 12);
-    central.writeUInt16LE(date, 14);
-    central.writeUInt32LE(crc, 16);
-    central.writeUInt32LE(payload.length, 20);
-    central.writeUInt32LE(content.length, 24);
-    central.writeUInt16LE(nameBuf.length, 28);
-    central.writeUInt16LE(0, 30); // extra len
-    central.writeUInt16LE(0, 32); // comment len
-    central.writeUInt16LE(0, 34); // disk start
-    central.writeUInt16LE(0, 36); // internal attrs
-    // 外部属性：Unix 权限左移 16 位，目录附加 MS-DOS 目录位
-    const extAttrs = ((entry.isDir ? 0o40755 : 0o100644) << 16) | (entry.isDir ? 0x10 : 0);
-    central.writeUInt32LE(extAttrs >>> 0, 38);
-    central.writeUInt32LE(offset, 42);
-    centralRecords.push({ header: Buffer.concat([central, nameBuf]), localOffset: offset });
-
-    offset += local.length + nameBuf.length + payload.length;
-  }
-
-  const centralDirOffset = offset;
-  let centralDirSize = 0;
-  for (const record of centralRecords) {
-    chunks.push(record.header);
-    centralDirSize += record.header.length;
-  }
-
-  // End of Central Directory Record（22 字节）
-  const eocd = Buffer.alloc(22);
-  eocd.writeUInt32LE(0x06054b50, 0);
-  eocd.writeUInt16LE(0, 4);
-  eocd.writeUInt16LE(0, 6);
-  eocd.writeUInt16LE(centralRecords.length, 8);
-  eocd.writeUInt16LE(centralRecords.length, 10);
-  eocd.writeUInt32LE(centralDirSize, 12);
-  eocd.writeUInt32LE(centralDirOffset, 16);
-  eocd.writeUInt16LE(0, 20); // comment len
-  chunks.push(eocd);
-
-  writeFileSync(outPath, Buffer.concat(chunks));
-}
-
-/* ------------------------------------------------------------------ */
-/* tar.gz 格式写入                                                     */
-/* ------------------------------------------------------------------ */
-
-/**
- * 构造单个条目的 USTAR 头块（512 字节）。
- * 路径超长时按 USTAR prefix 字段拆分，仍放不下则抛错。
- */
-function tarHeader(path: string, size: number, mtimeSec: number, isDir: boolean): Buffer {
-  let name = path;
-  let prefix = "";
-  if (Buffer.byteLength(name, "utf8") > 100) {
-    const split = name.lastIndexOf("/");
-    if (split <= 0 || split > 155 || name.length - split - 1 > 100) {
-      throw new Error(`归档路径超出 USTAR 字段容量: ${path}`);
-    }
-    prefix = name.slice(0, split);
-    name = name.slice(split + 1);
-  }
-
-  const buf = Buffer.alloc(512);
-  buf.write(name, 0, 100, "utf8");
-  buf.write(isDir ? "0000755" : "0000644", 100, 8, "ascii"); // mode
-  buf.write("0000000", 108, 8, "ascii"); // uid
-  buf.write("0000000", 116, 8, "ascii"); // gid
-  buf.write(size.toString(8).padStart(11, "0"), 124, 12, "ascii"); // size
-  buf.write(Math.floor(mtimeSec).toString(8).padStart(11, "0"), 136, 12, "ascii"); // mtime
-  buf.fill(" ", 148, 156); // chksum 占位（计算时视为空格）
-  buf.write(isDir ? "5" : "0", 156, 1, "ascii"); // typeflag
-  buf.write("ustar\0", 257, 6, "ascii"); // magic
-  buf.write("00", 263, 2, "ascii"); // version
-  if (prefix) buf.write(prefix, 345, 155, "utf8");
-
-  // 校验和：整块字节的无符号累加和，写作 6 位八进制 + NUL + 空格
-  let sum = 0;
-  for (let i = 0; i < 512; i++) sum += buf[i];
-  buf.write(sum.toString(8).padStart(6, "0"), 148, 7, "ascii");
-  buf.write("\0", 154, 1, "ascii");
-  buf.write(" ", 155, 1, "ascii");
-  return buf;
-}
-
-/** 将字节数补齐到 512 的整数倍 */
-function pad512(length: number): Buffer {
-  const rem = length % 512;
-  return rem === 0 ? Buffer.alloc(0) : Buffer.alloc(512 - rem);
-}
-
-/**
- * 将目录打包为标准 tar.gz 归档（USTAR + gzip）。
- *
- * @param dir 待打包目录（目录名即归档内根文件夹名）
- * @param outPath 输出 tar.gz 文件路径
- */
-export function createTarGzArchive(dir: string, outPath: string): void {
-  const rootName = basename(dir);
-  const entries = collectEntries(dir);
-  const chunks: Buffer[] = [];
-
-  for (const entry of entries) {
-    const path = `${rootName}/${entry.relPath}`;
-    const fullPath = join(dir, entry.relPath);
-    const stat = statSync(fullPath);
-    const content = entry.isDir ? Buffer.alloc(0) : readFileSync(fullPath);
-
-    chunks.push(tarHeader(path, content.length, Math.floor(stat.mtimeMs / 1000), entry.isDir));
-    if (!entry.isDir) {
-      chunks.push(content, pad512(content.length));
-    }
-  }
-
-  // 归档结尾：两个全零块
-  chunks.push(Buffer.alloc(1024));
-
-  writeFileSync(outPath, gzipSync(Buffer.concat(chunks), { level: 9 }));
-}