@qinsilk/scm-agent-tools 0.0.0-stage → 0.2.0

package/reports/goodsFirstOrder.js

@@ -0,0 +1,409 @@
+// 商品首单面料工序单价报表：全部商品写入同一个 Excel（37 列、双行表头）。
+// 四段列组：商品信息（1~21 列）、首单面料（22~32 列，表头合并为「首单面料信息」）、
+// 首单信息（33~35 列）、工序（36~37 列）。每个商品占 lcm(面料数, 工序数) 行：
+// 商品列与首单信息列纵向合并整块，每条面料、每条工序各自纵向合并，
+// 让面料行数与工序行数互相对齐（最小公倍数规则，与原脚本一致）。
+// 数据流：GET /api/agent/v1/goods/rich-list 分页取商品（列表行自带首单面料），
+// 再逐商品 GET /api/agent/v1/goods/full-detail 取工序与档案字段，商品主图嵌入 A 列。
+// 列名、列序、合并规则、文件名与原 Python 脚本 export_goods_first_order_material_process.py 一致。
+const fs = require('fs');
+const path = require('path');
+const { call } = require('../cli/api');
+const { timestamp, createThrottle, fetchAll } = require('./util');
+const { downloadImage } = require('./image');
+const { createWorkbook, saveWorkbook, embedImage } = require('./excel');
+
+/** 列表分页大小（服务端单页上限 100） */
+const PAGE_LIMIT = 100;
+/** 逐商品详情请求的最小间隔毫秒数（服务端按 Key 每分钟限流约 30 次） */
+const REQUEST_INTERVAL_MS = 2100;
+/** 行数保护上限（与原脚本一致） */
+const MAX_ROWS_PER_GOODS = 5000;
+const MAX_TOTAL_ROWS = 200000;
+
+const SHEET_NAME = '商品首单面料工序';
+const HEADERS = [
+  '图片', '商品货号', '成本价', '尺码', '分类', '执行标准', '安全类别', '可用库存', '生产中', 'IE核价', '颜色', '商品名称', '供应商货号', '设计师', '跟单员', '年份', '月份', '季节', '成分', '性别', '状态',
+  '物料名称', '物料货号', '物料颜色', '物料规格', '默认供应商', '安数', '采购单价', '基础单价', '幅宽', '面料成分', '备注',
+  '新款/翻单', '首单日期', '创建人', '工序名称', '单价',
+];
+/** 四段列组的列号范围（1 开始） */
+const GOODS_COLS = [];
+for (let c = 1; c <= 21; c += 1) GOODS_COLS.push(c);
+const MATERIAL_COLS = [];
+for (let c = 22; c <= 32; c += 1) MATERIAL_COLS.push(c);
+const FIRST_ORDER_COLS = [33, 34, 35];
+const PROCESS_COLS = [36, 37];
+const COLUMN_WIDTHS = [22, 16, 12, 16, 14, 14, 14, 12, 12, 12, 16, 22, 16, 14, 14, 10, 10, 12, 16, 10, 12, 18, 16, 16, 20, 18, 10, 12, 12, 10, 16, 20, 14, 14, 14, 18, 12];
+/** 左对齐列：图片、商品名称、物料名称、物料规格、备注 */
+const LEFT_COLS = new Set([1, 12, 22, 25, 32]);
+
+const HEADER_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFD9EAF7' } };
+const THIN_BORDER = {
+  top: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+  left: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+  bottom: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+  right: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+};
+
+function text(value) {
+  return value === null || value === undefined ? '' : String(value).trim();
+}
+
+/** 取第一个非空值（null、undefined、空字符串视为空），保留原始类型 */
+function firstValue(...values) {
+  for (const value of values) {
+    if (value !== null && value !== undefined && value !== '') {
+      return value;
+    }
+  }
+  return '';
+}
+
+function pad2(n) {
+  return String(n).padStart(2, '0');
+}
+
+/** 时间戳毫秒或日期字符串转「yyyy-MM-dd HH:mm:ss」，解析失败返回空字符串 */
+function formatDateTime(value) {
+  if (value === null || value === undefined || value === '') {
+    return '';
+  }
+  let date = null;
+  if (typeof value === 'number') {
+    date = new Date(value);
+  } else {
+    const s = String(value).trim();
+    if (/^\d+(\.\d+)?$/.test(s)) {
+      date = new Date(Number(s));
+    } else if (/^\d{4}-\d{2}-\d{2}/.test(s)) {
+      date = new Date(s);
+    }
+    if (!date || Number.isNaN(date.getTime())) {
+      return '';
+    }
+  }
+  if (Number.isNaN(date.getTime())) {
+    return '';
+  }
+  return (
+    `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())} ` +
+    `${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`
+  );
+}
+
+function gcd(a, b) {
+  while (b) {
+    [a, b] = [b, a % b];
+  }
+  return a;
+}
+
+function lcm(a, b) {
+  return (a / gcd(a, b)) * b;
+}
+
+/**
+ * 单个商品的行数 = max(1, 面料数) 与 max(1, 工序数) 的最小公倍数。
+ * 面料或工序为空时按 1 行占位（该段输出空值）。
+ */
+function lcmLayout(materialCount, processCount) {
+  const m = Math.max(1, materialCount);
+  const p = Math.max(1, processCount);
+  const rows = lcm(m, p);
+  if (rows > MAX_ROWS_PER_GOODS) {
+    throw new Error(`单商品面料 ${materialCount} 条、工序 ${processCount} 条，最小公倍数 ${rows} 超出上限`);
+  }
+  return rows;
+}
+
+/** 首单面料 11 列（rich-list 列表行内的 firstProduceOrderMaterials） */
+function materialValues(material) {
+  return [
+    firstValue(material.materialName),
+    firstValue(material.materialSn),
+    firstValue(material.bomSupplierColor, material.materialColor),
+    firstValue(material.propertyText),
+    firstValue(material.supplierName),
+    firstValue(material.materialQunce),
+    firstValue(material.skuPurchasePrice, material.purchasePrice),
+    firstValue(material.skuPrice, material.price),
+    firstValue(material.materialFabricWidth),
+    firstValue(material.materialComposition),
+    firstValue(material.remark),
+  ];
+}
+
+/** 商品信息 21 列（详情字段优先，列表行字段回退） */
+function goodsValues(summary, detail) {
+  const colors = (detail.goodsColors || []).map((c) => text(c.colorName)).filter(Boolean);
+  const sizes = (detail.goodsSizes || []).map((s) => text(s.sizeName)).filter(Boolean);
+  return [
+    firstValue(detail.goodsImgUrl, summary.goodsImgUrl),
+    firstValue(detail.goodsSn, summary.goodsSn),
+    firstValue(detail.costPrice, summary.costPrice),
+    sizes.join(','),
+    firstValue(detail.categoryName),
+    firstValue(detail.executeStandardName),
+    firstValue(detail.securityTypeName),
+    firstValue(detail.availableNumber, summary.availableNumber),
+    firstValue(detail.produceNumber, summary.produceNumber),
+    firstValue(detail.iePrice, summary.iePrice),
+    colors.join(','),
+    firstValue(detail.name, summary.name),
+    firstValue(detail.supplierSn, summary.supplierSn),
+    firstValue(detail.designerName),
+    firstValue(detail.followerName),
+    firstValue(detail.year, summary.year),
+    firstValue(detail.month, summary.month),
+    firstValue(detail.seasonName),
+    firstValue(detail.composition, summary.composition),
+    // 性别：DTO 数字枚举转文字
+    firstValue(({ 0: '通款', 1: '男款', 2: '女款', 3: '童装' })[detail.sex], ({ 0: '通款', 1: '男款', 2: '女款', 3: '童装' })[summary.sex]),
+    // 状态：DTO isOnSale 1/0 转「启用/停用」
+    firstValue(detail.isOnSale === 1 ? '启用' : detail.isOnSale === 0 ? '停用' : '', summary.isOnSale === 1 ? '启用' : summary.isOnSale === 0 ? '停用' : ''),
+  ];
+}
+
+/** 单个商品的全部报表数据：商品列、首单面料行、首单信息、工序行与主图 */
+async function prepareGoods(summary, detail) {
+  const materials = (summary.firstProduceOrderMaterials || []).map(materialValues);
+  // 工序按显示顺序升序排列，未设置顺序的排在最后
+  const processes = [...(detail.goodsWorkProcessList || [])].sort((a, b) => {
+    const an = a.showOrder === null || a.showOrder === undefined;
+    const bn = b.showOrder === null || b.showOrder === undefined;
+    if (an !== bn) {
+      return an ? 1 : -1;
+    }
+    if (an) {
+      return 0;
+    }
+    return (a.showOrder || 0) - (b.showOrder || 0);
+  }).map((p) => [firstValue(p.workProcessName), firstValue(p.price)]);
+
+  const order = [
+    firstValue(summary.reorderOrderInfo, '新款'),
+    formatDateTime(summary.firstOrderTime),
+    text(summary.handlerName),
+  ];
+  const goods = goodsValues(summary, detail);
+  // 图片列不写文字值，改用嵌图
+  goods[0] = '';
+  const image = await downloadImage(text(firstValue(detail.goodsImgUrl, summary.goodsImgUrl)));
+  return {
+    goods,
+    image,
+    materials,
+    order,
+    processes,
+    hasFirstOrderInfo: summary.firstOrderTime !== null && summary.firstOrderTime !== undefined && summary.firstOrderTime !== '',
+  };
+}
+
+/** 表头样式：加粗、浅蓝底、细边框、居中换行 */
+function styleHeaderCell(cell) {
+  cell.border = THIN_BORDER;
+  cell.fill = HEADER_FILL;
+  cell.font = { bold: true };
+  cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+}
+
+/**
+ * 写整份 Excel：双行表头 + 每商品一个 lcm 行块。
+ * 表头合并：首单面料组第一行横向合并（V1:AF1）显示「首单面料信息」；
+ * 商品列、首单信息列、工序列各自纵向合并两行表头。
+ */
+function writeXlsx(filePath, items) {
+  const workbook = createWorkbook();
+  const sheet = workbook.addWorksheet(SHEET_NAME, { views: [{ state: 'frozen', xSplit: 2, ySplit: 2 }] });
+
+  const first = HEADERS.map((title, index) => {
+    const c = index + 1;
+    if (c === 22) {
+      return '首单面料信息';
+    }
+    return c < 22 || c >= 33 ? title : '';
+  });
+  const second = HEADERS.map((title, index) => {
+    const c = index + 1;
+    return c >= 22 && c <= 32 ? title : '';
+  });
+  const row1 = sheet.getRow(1);
+  row1.values = first;
+  row1.height = 24;
+  row1.eachCell({ includeEmpty: true }, (cell) => styleHeaderCell(cell));
+  const row2 = sheet.getRow(2);
+  row2.values = second;
+  row2.height = 36;
+  row2.eachCell({ includeEmpty: true }, (cell) => styleHeaderCell(cell));
+
+  // 全部合并区域先收集、写完行值后统一执行：合并后的从属单元格不能再写值
+  const merges = [[1, 22, 1, 32]];
+  for (const c of [...GOODS_COLS, ...FIRST_ORDER_COLS, ...PROCESS_COLS]) {
+    merges.push([1, c, 2, c]);
+  }
+
+  let rowNo = 3;
+  let totalRows = 0;
+  for (const item of items) {
+    const n = lcmLayout(item.materials.length, item.processes.length);
+    totalRows += n;
+    if (totalRows > MAX_TOTAL_ROWS) {
+      throw new Error(`导出明细行数超过上限 ${MAX_TOTAL_ROWS}`);
+    }
+    const start = rowNo;
+    const end = rowNo + n - 1;
+    const materialRepeat = n / Math.max(1, item.materials.length);
+    const processRepeat = n / Math.max(1, item.processes.length);
+    // 商品列与首单信息列只写块首行的值，其余行留空后纵向合并
+    if (start !== end) {
+      for (const c of [...GOODS_COLS, ...FIRST_ORDER_COLS]) {
+        merges.push([start, c, end, c]);
+      }
+    }
+    // 每条面料占 materialRepeat 行、每条工序占 processRepeat 行，占多行时纵向合并
+    item.materials.forEach((_, index) => {
+      const a = start + index * materialRepeat;
+      const b = start + (index + 1) * materialRepeat - 1;
+      if (a !== b) {
+        for (const c of MATERIAL_COLS) {
+          merges.push([a, c, b, c]);
+        }
+      }
+    });
+    item.processes.forEach((_, index) => {
+      const a = start + index * processRepeat;
+      const b = start + (index + 1) * processRepeat - 1;
+      if (a !== b) {
+        for (const c of PROCESS_COLS) {
+          merges.push([a, c, b, c]);
+        }
+      }
+    });
+    for (let offset = 0; offset < n; offset += 1) {
+      const values = new Array(HEADERS.length).fill('');
+      if (offset === 0) {
+        item.goods.forEach((v, i) => {
+          values[i] = v;
+        });
+        values[32] = item.order[0];
+        values[33] = item.order[1];
+        values[34] = item.order[2];
+      }
+      // 值只写在各合并区间的第一行，保证合并后不丢数据
+      if (offset % materialRepeat === 0) {
+        const material = item.materials[offset / materialRepeat];
+        if (material) {
+          material.forEach((v, i) => {
+            values[21 + i] = v;
+          });
+        }
+      }
+      if (offset % processRepeat === 0) {
+        const process = item.processes[offset / processRepeat];
+        if (process) {
+          values[35] = process[0];
+          values[36] = process[1];
+        }
+      }
+      const row = sheet.getRow(rowNo);
+      row.values = values;
+      row.height = 30;
+      row.eachCell({ includeEmpty: true }, (cell, colNumber) => {
+        cell.border = THIN_BORDER;
+        cell.alignment = { vertical: 'middle', horizontal: LEFT_COLS.has(colNumber) ? 'left' : 'center', wrapText: true };
+      });
+      rowNo += 1;
+    }
+    // 商品主图嵌在 A 列，纵向占满该商品的整块行（约 40 像素/行）
+    if (item.image) {
+      embedImage(workbook, sheet, item.image, start, 1, { width: 150, height: Math.max(1, 40 * n - 8) });
+    }
+  }
+
+  for (const [r1, c1, r2, c2] of merges) {
+    sheet.mergeCells(r1, c1, r2, c2);
+  }
+
+  COLUMN_WIDTHS.forEach((w, i) => {
+    sheet.getColumn(i + 1).width = w;
+  });
+  // 打印方向横向并按宽度缩放到一页（与原脚本 pageSetup 一致）
+  sheet.pageSetup = { orientation: 'landscape', fitToPage: true, fitToWidth: 1, fitToHeight: 0 };
+  return saveWorkbook(workbook, filePath).then(() => totalRows);
+}
+
+/**
+ * 报表入口：分页取商品列表（可选按款号过滤），逐商品取详情后写入单个 Excel。
+ * argv：{ sn 款号（可选）, limit 最多导出商品数（默认 100）, out 输出目录 }。
+ */
+async function generate(argv = {}) {
+  const limit = Number(argv.limit) > 0 ? Number(argv.limit) : 100;
+  const outDir = argv.out ? path.resolve(String(argv.out)) : process.cwd();
+  const sn = text(argv.sn);
+  const throttle = createThrottle(REQUEST_INTERVAL_MS);
+
+  const { list } = await fetchAll(
+    (page) => throttle(() => call('GET', '/api/agent/v1/goods/rich-list', {
+      sn: sn || undefined,
+      // 原报表导出全部商品（含停用），isOnSale 传 -1 让服务端不过滤上下架状态
+      isOnSale: -1,
+      skuIsDisable: 0,
+      page,
+      limit: PAGE_LIMIT,
+    })),
+    { limit: PAGE_LIMIT, maxPages: Math.max(1, Math.ceil(limit / PAGE_LIMIT)) }
+  );
+  const selected = list.slice(0, limit);
+  if (!selected.length) {
+    throw new Error('没有符合条件的商品');
+  }
+
+  const issues = {};
+  const issue = (key) => {
+    issues[key] = (issues[key] || 0) + 1;
+  };
+  const prepared = [];
+  for (let i = 0; i < selected.length; i += 1) {
+    const summary = selected[i];
+    try {
+      const detail = await throttle(() => call('GET', '/api/agent/v1/goods/full-detail', { id: summary.id }));
+      const item = await prepareGoods(summary, detail);
+      prepared.push(item);
+      if (!item.hasFirstOrderInfo) {
+        issue('无首单日期');
+      }
+      if (!item.materials.length) {
+        issue('无首单面料');
+      }
+      if (!item.processes.length) {
+        issue('无商品工序');
+      }
+    } catch (e) {
+      issue('跳过商品');
+      process.stdout.write(`跳过商品 ${text(summary.goodsSn) || summary.id}：${e.message}\n`);
+    }
+    if ((i + 1) % 10 === 0) {
+      process.stdout.write(`已处理 ${i + 1}/${selected.length} 个商品\n`);
+    }
+  }
+  if (!prepared.length) {
+    throw new Error('没有成功处理的商品，未生成文件');
+  }
+
+  // 文件名「基础名-时间戳.xlsx」；已存在时追加序号，不覆盖既有文件
+  let filePath = path.join(outDir, `商品首单面料工序单价-${timestamp()}.xlsx`);
+  let seq = 2;
+  while (fs.existsSync(filePath)) {
+    filePath = path.join(outDir, `商品首单面料工序单价-${timestamp()}-${seq}.xlsx`);
+    seq += 1;
+  }
+  const detailRows = await writeXlsx(filePath, prepared);
+
+  const issueText = Object.entries(issues).map(([k, v]) => `${k} ${v}`).join('、');
+  const summaryText = `商品首单面料工序单价导出完成：商品 ${prepared.length}/${selected.length} 个，明细行 ${detailRows} 行` +
+    (issueText ? `；${issueText}` : '') + `；文件：${filePath}`;
+  return { filePaths: [filePath], summary: summaryText };
+}
+
+module.exports = { generate };

package/reports/goodsInventory.js

@@ -0,0 +1,220 @@
+// 服装成品盘存表：全量拉取商品单品库存，按「款号 → 颜色」分组、尺码摊开为动态列。
+// 列布局、合并单元格、文件名与原 Python 报表脚本保持一致。
+const fs = require('fs');
+const path = require('path');
+const { call } = require('../cli/api');
+const { dateStr, fetchAll } = require('./util');
+const { createWorkbook, saveWorkbook } = require('./excel');
+
+// 常见服装尺码的固定展示顺序；不在其中的尺码按名称排序放在这些之后
+const COMMON_SIZES = ['XXS', 'XS', 'S', 'M', 'L', 'XL', 'XXL', 'XXXL', '4XL', '5XL'];
+
+// 单元格边框：黑色细线，与原脚本的盘存表边框一致
+const BORDER = {
+  top: { style: 'thin', color: { argb: 'FF000000' } },
+  left: { style: 'thin', color: { argb: 'FF000000' } },
+  bottom: { style: 'thin', color: { argb: 'FF000000' } },
+  right: { style: 'thin', color: { argb: 'FF000000' } },
+};
+// 表头底色：浅蓝，与原脚本一致
+const HEADER_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFD9EAF7' } };
+
+/** 空字符串归一化：空值换成指定兜底文案 */
+function normalizedText(value, fallback) {
+  const text = String(value == null ? '' : value).trim();
+  return text || fallback;
+}
+
+/** 尺码排序键：常见尺码按固定顺序，其余按名称升序排在后面 */
+function sizeOrder(value) {
+  const text = normalizedText(value, '未设尺码');
+  const index = COMMON_SIZES.indexOf(text);
+  return index >= 0 ? { common: 0, index } : { common: 1, name: text };
+}
+
+/**
+ * 把单品列表汇总为「款号 → 颜色 → 尺码 → 库存」三层结构。
+ * 每个款号保留一个商品名称；同一款号同一颜色的相同尺码库存累加。
+ */
+function buildRows(skus) {
+  const grouped = new Map();
+  const names = new Map();
+  for (const sku of skus) {
+    const goodsName = normalizedText(sku.goodsName, '');
+    const goodsSn = normalizedText(sku.goodsSn, goodsName || '未设置款号');
+    const color = normalizedText(sku.colorName, '未设颜色');
+    const size = normalizedText(sku.sizeName, '未设尺码');
+    const stock = sku.storedNumber == null ? 0 : Number(sku.storedNumber);
+    if (!grouped.has(goodsSn)) {
+      grouped.set(goodsSn, new Map());
+    }
+    const colors = grouped.get(goodsSn);
+    if (!colors.has(color)) {
+      colors.set(color, new Map());
+    }
+    const stocks = colors.get(color);
+    stocks.set(size, (stocks.get(size) || 0) + stock);
+    names.set(goodsSn, goodsName);
+  }
+  // 收集全部出现过的尺码，按尺码排序键排列成动态列
+  const sizes = new Set();
+  for (const colors of grouped.values()) {
+    for (const stocks of colors.values()) {
+      for (const size of stocks.keys()) {
+        sizes.add(size);
+      }
+    }
+  }
+  const sizeList = [...sizes].sort((a, b) => {
+    const ka = sizeOrder(a);
+    const kb = sizeOrder(b);
+    if (ka.common !== kb.common) {
+      return ka.common - kb.common;
+    }
+    return ka.common === 0 ? ka.index - kb.index : ka.name.localeCompare(kb.name);
+  });
+  // 行顺序：款号升序，同款号内颜色名称升序
+  const rows = [];
+  for (const goodsSn of [...grouped.keys()].sort()) {
+    for (const color of [...grouped.get(goodsSn).keys()].sort()) {
+      const stocks = grouped.get(goodsSn).get(color);
+      let rowTotal = 0;
+      for (const value of stocks.values()) {
+        rowTotal += value;
+      }
+      rows.push({ goodsSn, goodsName: names.get(goodsSn), color, stocks, rowTotal });
+    }
+  }
+  return { sizes: sizeList, rows };
+}
+
+/** 给一个单元格设置居中、换行与细边框 */
+function styleDataCell(cell) {
+  cell.border = BORDER;
+  cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+}
+
+/**
+ * 生成服装成品盘存表 Excel。
+ * argv.storehouse：仓库 id，不传则全部仓库；argv.out：输出目录，默认当前目录。
+ */
+async function generate(argv = {}) {
+  const outDir = argv.out || process.cwd();
+  const filePath = path.resolve(outDir, `服装成品盘存表-${dateStr()}.xlsx`);
+  if (fs.existsSync(filePath)) {
+    throw new Error(`输出文件已存在：${filePath}；如需替换请先删除旧文件或更换输出目录`);
+  }
+
+  // 分页拉取全部启用单品；skuIsDisable 由服务端固定为 0（只查启用单品）
+  const { list: skus } = await fetchAll(
+    (page, limit) => call('GET', '/api/agent/v1/inventory/sku-list', {
+      storehouseId: argv.storehouse,
+      page,
+      limit,
+    })
+  );
+
+  const { sizes, rows } = buildRows(skus);
+
+  // 总列数 = 序号、款号、颜色、商品名称 4 列 + 尺码动态列 + 合计、备注 2 列
+  const lastCol = 4 + sizes.length + 2;
+  const workbook = createWorkbook();
+  const sheet = workbook.addWorksheet('成品盘存表', {
+    pageSetup: { orientation: 'landscape', fitToPage: true, fitToWidth: 1, fitToHeight: 0 },
+  });
+
+  // 第 1 行：表标题，整行合并
+  const titleRow = sheet.addRow(['服装成品盘存表']);
+  titleRow.height = 38;
+  const titleCell = titleRow.getCell(1);
+  titleCell.font = { bold: true, size: 18 };
+  titleCell.alignment = { vertical: 'middle', horizontal: 'center' };
+
+  // 第 2 行：盘存日期与部门、仓库说明，分三段合并
+  const metaRow = sheet.addRow(['盘存日期：', null, dateStr(), null, null, `部门：${argv.department || ''}    仓库：${argv.storehouse ? `指定仓库 ${argv.storehouse}` : '全部仓库'}`]);
+  metaRow.height = 20;
+  for (let i = 1; i <= lastCol; i += 1) {
+    styleDataCell(metaRow.getCell(i));
+  }
+
+  // 第 3 行：表头，尺码列按数据动态生成
+  const headers = ['序号', '款号', '颜色', '商品名称', ...sizes, '合计', '备注'];
+  const headerRow = sheet.addRow(headers);
+  headerRow.height = 28;
+  headerRow.eachCell((cell) => {
+    cell.font = { bold: true };
+    cell.fill = HEADER_FILL;
+    styleDataCell(cell);
+  });
+
+  // 数据行：同一款号的多行合并序号与款号两列，序号只在每组第一行写
+  let rowNumber = 4;
+  let seq = 0;
+  let totalStock = 0;
+  let index = 0;
+  while (index < rows.length) {
+    const goodsSn = rows[index].goodsSn;
+    let end = index;
+    while (end + 1 < rows.length && rows[end + 1].goodsSn === goodsSn) {
+      end += 1;
+    }
+    const firstRow = rowNumber;
+    const lastRow = rowNumber + (end - index);
+    seq += 1;
+    for (let i = index; i <= end; i += 1) {
+      const item = rows[i];
+      const values = [
+        i === index ? seq : '',
+        i === index ? item.goodsSn : '',
+        item.color,
+        item.goodsName,
+        ...sizes.map((size) => (item.stocks.has(size) ? item.stocks.get(size) : '')),
+        item.rowTotal,
+        '',
+      ];
+      const added = sheet.addRow(values);
+      added.height = 22;
+      added.eachCell(styleDataCell);
+      totalStock += item.rowTotal;
+      rowNumber += 1;
+    }
+    if (lastRow > firstRow) {
+      sheet.mergeCells(firstRow, 1, lastRow, 1);
+      sheet.mergeCells(firstRow, 2, lastRow, 2);
+    }
+    index = end + 1;
+  }
+
+  // 末行：总计行，从序号列合并到倒数第三列，合计列写全部库存总和
+  const totalRow = sheet.addRow(['总计']);
+  totalRow.height = 24;
+  for (let i = 1; i <= lastCol; i += 1) {
+    styleDataCell(totalRow.getCell(i));
+    totalRow.getCell(i).font = { bold: true };
+  }
+  totalRow.getCell(lastCol - 1).value = totalStock;
+  sheet.mergeCells(rowNumber, 1, rowNumber, lastCol - 2);
+
+  // 列宽：固定四列 + 尺码列 + 合计、备注
+  const widths = [8, 18, 14, 32, ...sizes.map(() => 10), 12, 20];
+  widths.forEach((width, i) => {
+    sheet.getColumn(i + 1).width = width;
+  });
+  // 标题行与说明行的合并范围；仓库说明段只有一列时无需合并
+  sheet.mergeCells(1, 1, 1, lastCol);
+  sheet.mergeCells(2, 1, 2, 2);
+  sheet.mergeCells(2, 3, 2, 5);
+  if (lastCol > 6) {
+    sheet.mergeCells(2, 6, 2, lastCol);
+  }
+
+  await saveWorkbook(workbook, filePath);
+
+  const goodsCount = new Set(rows.map((row) => row.goodsSn)).size;
+  return {
+    filePaths: [filePath],
+    summary: `服装成品盘存表已生成：获取 ${skus.length} 个单品，${goodsCount} 个款号、${rows.length} 个颜色行，当前库存总计 ${totalStock}`,
+  };
+}
+
+module.exports = { generate };