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

package/reports/produceCostDetail.js

@@ -0,0 +1,622 @@
+// 生产成本报表明细：按生产成本报表的每一行生成一个 Excel 文件。
+// 每个文件一个工作表：上半部分是外层报表行（款式/生产单/实际成本/预估成本，两级表头），
+// 下半部分依次排布五类成本明细分区（物料、委外加工、工序外发、工人计件、其它费用），
+// 每个分区有自己的两级表头，底部是绿底合计行；物料分区额外嵌物料图片。
+const fs = require('fs');
+const path = require('path');
+const { call } = require('../cli/api');
+const { timestamp, fetchAll } = require('./util');
+const { createWorkbook, saveWorkbook, embedImage } = require('./excel');
+const { downloadImages } = require('./image');
+
+const SHEET_NAME = '生产成本报表明细';
+// 计算规则固定为接口默认的 1（按默认逻辑计算）；原脚本本地 config.json 的默认值不移植
+const CAL_WAY = 1;
+const CAL_WAY_NAME = '按默认逻辑计算';
+// 状态文案（与页面一致）
+const STATE_NAMES = {
+  1: '草稿', 2: '生产中', 3: '生产完成', 4: '待生产', 9: '撤销',
+  11: '待接单', 12: '拒绝接单', 13: '待审批', 14: '审批拒绝',
+};
+const TYPE_NAMES = { 1: '自主生产', 2: '单工序外发', 3: '委外加工（全工序外发）', 4: '成品采购' };
+// 单个明细分区的行数上限（与原脚本一致，防止异常数据撑爆文件）
+const MAX_DETAIL_ROWS = 10000;
+// 一次导出最多生成的文件数（与原脚本一致）
+const MAX_FILES = 100;
+// 金额格式：明细金额固定两位小数（与原脚本一致，不读企业配置）
+const MONEY_FORMAT = '¥#,##0.00;-¥#,##0.00';
+
+// 外层报表行：与生产成本报表页面默认可见列一致（含状态列，不含差异列）
+const OUTER_GROUPS = [
+  {
+    name: '款式信息',
+    columns: [
+      { header: '商品', field: 'goodsName', kind: 'text' },
+      { header: '款号', field: 'designSn', kind: 'text' },
+      { header: '图片', field: 'imgUrl', kind: 'image' },
+      { header: '大货号', field: 'goodsSn', kind: 'text' },
+      { header: '波段', field: 'rangesName', kind: 'text' },
+      { header: '设计师', field: 'designerName', kind: 'text' },
+      { header: '打版师', field: 'patternMakerName', kind: 'text' },
+    ],
+  },
+  {
+    name: '生产单信息',
+    columns: [
+      { header: '状态', field: 'state', kind: 'state' },
+      { header: '单号', field: 'ordersSn', kind: 'text' },
+      { header: '订单类型', field: 'orderTypeName', kind: 'text' },
+      { header: '标签', field: 'tags', kind: 'tags' },
+      { header: '生产类型', field: 'type', kind: 'type' },
+      { header: '预计交货日期', field: 'deliveryTime', kind: 'date' },
+      { header: '跟单员', field: 'followerName', kind: 'text' },
+      { header: '下单数', field: 'sumNumber', kind: 'number' },
+      { header: '裁床数', field: 'sumCutBedNumber', kind: 'number' },
+      { header: '已入库数', field: 'sumStoreInNumber', kind: 'number' },
+      { header: '未完成', field: 'sumNoFinishNumber', kind: 'number' },
+      { header: '未出数', field: 'sumNoOutNumber', kind: 'number' },
+      { header: '未入库数', field: 'sumNoStoreInNumber', kind: 'number' },
+      { header: '业务日期', field: 'businessTime', kind: 'date' },
+    ],
+  },
+  {
+    name: '实际成本',
+    columns: [
+      { header: '物料', field: 'actualMaterialCost', kind: 'money' },
+      { header: '委外加工', field: 'actualProduceOrderProcessCost', kind: 'money' },
+      { header: '工序外发', field: 'actualOutWardOrderCost', kind: 'money' },
+      { header: '工人计件', field: 'actualWorkManPieceworkCost', kind: 'money' },
+      { header: '其它费用', field: 'actualOtherCost', kind: 'money' },
+      { header: '单件成本', field: 'actualSumSingleGoodsCost', kind: 'money' },
+      { header: '件数', field: 'actualNumber', kind: 'number' },
+      { header: '总成本', field: 'actualSumCost', kind: 'money' },
+    ],
+  },
+  {
+    name: '预估成本',
+    columns: [
+      { header: '物料', field: 'estimatedMaterialCost', kind: 'money' },
+      { header: '委外加工', field: 'estimatedProduceOrderProcessCost', kind: 'money' },
+      { header: '工序外发', field: 'estimatedOutWardOrderCost', kind: 'money' },
+      { header: '工人计件', field: 'estimatedWorkManPieceworkCost', kind: 'money' },
+      { header: '其它费用', field: 'estimatedOtherCost', kind: 'money' },
+      { header: '单件成本', field: 'estimatedSumSingleGoodsCost', kind: 'money' },
+      { header: '件数', field: 'estimatedNumber', kind: 'number' },
+      { header: '总成本', field: 'estimatedSumCost', kind: 'money' },
+    ],
+  },
+];
+const OUTER_COLUMNS = OUTER_GROUPS.flatMap((group) => group.columns);
+
+// 五类成本明细分区。items/totals 是接口 costItem 里的字段名；
+// summary 描述合计行每个列字段取自 totals 的哪个字段，「合计」表示固定文字。
+const DETAIL_SECTIONS = [
+  {
+    key: 'materialItems',
+    totalsKey: 'materialTotals',
+    title: '物料',
+    hasImage: true,
+    groups: [
+      { name: '', columns: [
+        { header: '图片', field: 'materialImgUrl', kind: 'image' },
+        { header: '物料', field: 'materialDisplay', kind: 'text' },
+        { header: '单位', field: 'materialUnit', kind: 'text' },
+      ] },
+      { name: '采购成本', columns: [
+        { header: '采购单成本', field: 'purchaseAmount', kind: 'money' },
+        { header: '采购已入库数', field: 'purchaseNumber', kind: 'number' },
+        { header: '采购单价', field: 'purchaseSinglePrice', kind: 'money' },
+        { header: '单件采购成本', field: 'purchaseSingleGoodsCost', kind: 'money' },
+        { header: '单件采购用量', field: 'purchaseSingleGoodsNumber', kind: 'number' },
+        { header: '合计成本', field: 'sumPurchaseCost', kind: 'money' },
+      ] },
+      { name: '实际成本', columns: [
+        { header: '总用量', field: 'sumNumber', kind: 'number' },
+        { header: '单件用量', field: 'singleGoodsNumber', kind: 'number' },
+        { header: '库存单价', field: 'singleStoredPrice', kind: 'money' },
+        { header: '单件成本', field: 'singleGoodsCost', kind: 'money' },
+        { header: '合计成本', field: 'sumGoodsCost', kind: 'money' },
+      ] },
+      { name: '预估成本', columns: [
+        { header: '单件成本', field: 'singleGoodsCostEstimate', kind: 'money' },
+      ] },
+    ],
+    summary: [
+      ['materialDisplay', '合计'],
+      ['purchaseSingleGoodsCost', 'sumSinglePurchaseGoodsCost'],
+      ['sumPurchaseCost', 'sumProducePurchaseCost'],
+      ['singleGoodsCost', 'sumSingleGoodsCost'],
+      ['sumGoodsCost', 'sumProduceCost'],
+      ['singleGoodsCostEstimate', 'sumSingleGoodsCostEstimate'],
+    ],
+  },
+  {
+    key: 'processItems',
+    totalsKey: 'processTotals',
+    title: '委外加工',
+    hasImage: false,
+    groups: [
+      { name: '', columns: [
+        { header: '费用名称', field: 'name', kind: 'text' },
+        { header: '入库数', field: 'number', kind: 'number' },
+      ] },
+      { name: '实际成本', columns: [
+        { header: '单件成本', field: 'singleGoodsCost', kind: 'money' },
+        { header: '合计成本', field: 'sumGoodsCost', kind: 'money' },
+      ] },
+      { name: '预估成本', columns: [
+        { header: '单件成本', field: 'singleGoodsCostEstimate', kind: 'money' },
+      ] },
+    ],
+    summary: [
+      ['name', '合计'],
+      ['singleGoodsCost', 'sumSingleGoodsCost'],
+      ['sumGoodsCost', 'sumProduceCost'],
+      ['singleGoodsCostEstimate', 'sumSingleGoodsCostEstimate'],
+    ],
+  },
+  {
+    key: 'outwardItems',
+    totalsKey: 'outwardTotals',
+    title: '工序外发',
+    hasImage: false,
+    groups: [
+      { name: '', columns: [
+        { header: '工序名称', field: 'name', kind: 'text' },
+        { header: '净回收数', field: 'number', kind: 'number' },
+      ] },
+      { name: '实际成本', columns: [
+        { header: '单件成本', field: 'singleGoodsCost', kind: 'money' },
+        { header: '合计成本', field: 'sumGoodsCost', kind: 'money' },
+      ] },
+    ],
+    summary: [
+      ['name', '合计'],
+      ['sumGoodsCost', 'sumProduceCost'],
+    ],
+  },
+  {
+    key: 'pieceworkItems',
+    totalsKey: 'pieceworkTotals',
+    title: '工人计件',
+    hasImage: false,
+    groups: [
+      { name: '', columns: [
+        { header: '工序名称', field: 'name', kind: 'text' },
+        { header: '汇报数', field: 'number', kind: 'number' },
+      ] },
+      { name: '实际成本', columns: [
+        { header: '单件成本', field: 'singleGoodsCost', kind: 'money' },
+        { header: '合计成本', field: 'sumGoodsCost', kind: 'money' },
+      ] },
+      { name: '预估成本', columns: [
+        { header: '单件成本', field: 'singleGoodsCostEstimate', kind: 'money' },
+      ] },
+    ],
+    summary: [
+      ['name', '合计'],
+      ['singleGoodsCost', 'sumSingleGoodsCost'],
+      ['sumGoodsCost', 'sumProduceCost'],
+      ['singleGoodsCostEstimate', 'sumSingleGoodsCostEstimate'],
+    ],
+  },
+  {
+    key: 'otherItems',
+    totalsKey: 'otherTotals',
+    title: '其它费用',
+    hasImage: false,
+    groups: [
+      { name: '', columns: [
+        { header: '费用类型', field: 'name', kind: 'text' },
+      ] },
+      { name: '实际成本', columns: [
+        { header: '合计成本', field: 'sumGoodsCost', kind: 'money' },
+        { header: '单件成本', field: 'singleGoodsCost', kind: 'money' },
+      ] },
+      { name: '预估成本', columns: [
+        { header: '单件成本', field: 'singleGoodsCostEstimate', kind: 'money' },
+      ] },
+    ],
+    summary: [
+      ['name', '合计'],
+      ['sumGoodsCost', 'sumProduceCost'],
+      ['singleGoodsCost', 'sumSingleGoodsCost'],
+      ['singleGoodsCostEstimate', 'sumSingleGoodsCostEstimate'],
+    ],
+  },
+];
+
+const 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' } },
+};
+// 表头与标题底色：灰 / 浅蓝 / 浅绿（与原脚本一致）
+const HEADER_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFC0C0C0' } };
+const TITLE_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFD9EAF7' } };
+const SUMMARY_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE2F0D9' } };
+
+/** 文本归一化：空值返回空字符串 */
+function text(value) {
+  return value == null ? '' : String(value).trim();
+}
+
+/** 数值列取值：无法转数字时按原文返回，整数去掉小数尾巴 */
+function numeric(value) {
+  if (value === null || value === undefined || value === '') {
+    return '';
+  }
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) {
+    return text(value);
+  }
+  return parsed;
+}
+
+/** 物料列显示：名称(货号)，只有一边时只显示一边 */
+function materialDisplay(detail) {
+  const name = text(detail.materialName);
+  const sn = text(detail.materialSn);
+  if (name && sn) {
+    return `${name}(${sn})`;
+  }
+  return name || sn;
+}
+
+/** 外层报表行的单元格值 */
+function outerValue(row, column) {
+  const value = row[column.field];
+  switch (column.kind) {
+    case 'state':
+      return STATE_NAMES[value] || text(value);
+    case 'type':
+      return TYPE_NAMES[value] || text(value);
+    case 'tags':
+      return Array.isArray(value) ? value.map(text).filter(Boolean).join('、') : '';
+    case 'date':
+      return dateText(value);
+    case 'number':
+    case 'money':
+      return numeric(value);
+    case 'image':
+      return '';
+    default:
+      return text(value);
+  }
+}
+
+/** 日期列容错：取 yyyy-MM-dd 前 10 位 */
+function dateText(value) {
+  const raw = text(value);
+  if (!raw) {
+    return '';
+  }
+  const match = /^(\d{4}-\d{2}-\d{2})/.exec(raw);
+  return match ? match[1] : raw;
+}
+
+/**
+ * 把一行值按列类型写入指定行并设置样式，列数补齐到 totalCols（分区宽度之外的
+ * 空白列也要有边框，与原脚本整行样式的写法一致）；返回该行对象。
+ */
+function writeStyledRow(sheet, rowNumber, columns, values, { height = 24, summary = false, totalCols } = {}) {
+  const width = totalCols || columns.length;
+  const padded = [...values];
+  while (padded.length < width) {
+    padded.push('');
+  }
+  const row = sheet.getRow(rowNumber);
+  row.values = [];
+  for (let index = 1; index <= width; index += 1) {
+    const column = columns[index - 1];
+    const cell = row.getCell(index);
+    const value = padded[index - 1];
+    cell.value = column && column.kind === 'image' ? '' : value;
+    cell.border = BORDER;
+    if (column && column.kind === 'money') {
+      cell.numFmt = MONEY_FORMAT;
+    }
+    const isText = !column || column.kind === 'text' || column.kind === 'state' || column.kind === 'type' || column.kind === 'tags' || column.kind === 'date';
+    cell.alignment = {
+      vertical: 'middle',
+      horizontal: isText ? 'left' : 'center',
+      wrapText: !column || (column.kind !== 'number' && column.kind !== 'money'),
+    };
+    if (summary) {
+      cell.fill = SUMMARY_FILL;
+      cell.font = { bold: true };
+    }
+  }
+  row.height = height;
+  return row;
+}
+
+/**
+ * 写一个成本明细分区：标题行、两级表头、明细行、合计行。
+ * 返回写完后的下一行行号。
+ */
+function writeSection(sheet, startRow, section, costItem, images, maxCols, workbook) {
+  const columns = section.groups.flatMap((group) => group.columns);
+  const width = columns.length;
+  let rowNumber = startRow;
+
+  // 分区标题行：合并整行
+  const titleCell = sheet.getCell(rowNumber, 1);
+  titleCell.value = section.title;
+  titleCell.font = { bold: true, size: 12 };
+  titleCell.fill = TITLE_FILL;
+  titleCell.alignment = { vertical: 'middle', horizontal: 'left' };
+  for (let col = 2; col <= maxCols; col += 1) {
+    const cell = sheet.getCell(rowNumber, col);
+    cell.fill = TITLE_FILL;
+  }
+  sheet.mergeCells(rowNumber, 1, rowNumber, maxCols);
+  sheet.getRow(rowNumber).height = 26;
+  rowNumber += 1;
+
+  // 两级表头：第一行组名（无组名的列纵向合并两行，合并后显示为空白，与原脚本一致），
+  // 第二行列标题。整行样式覆盖到 maxCols，保证空白列也有边框和底色。
+  const groupRow = sheet.getRow(rowNumber);
+  const titleRow = sheet.getRow(rowNumber + 1);
+  let colIndex = 1;
+  for (const group of section.groups) {
+    group.columns.forEach((column, offset) => {
+      groupRow.getCell(colIndex).value = offset === 0 ? group.name : '';
+      titleRow.getCell(colIndex).value = column.header;
+      colIndex += 1;
+    });
+    if (group.name && group.columns.length > 1) {
+      sheet.mergeCells(rowNumber, colIndex - group.columns.length, rowNumber, colIndex - 1);
+    } else if (!group.name) {
+      for (let col = colIndex - group.columns.length; col < colIndex; col += 1) {
+        sheet.mergeCells(rowNumber, col, rowNumber + 1, col);
+      }
+    }
+  }
+  for (const row of [groupRow, titleRow]) {
+    row.height = row === groupRow ? 24 : 30;
+    for (let col = 1; col <= maxCols; col += 1) {
+      const cell = row.getCell(col);
+      cell.font = { bold: true };
+      cell.fill = HEADER_FILL;
+      cell.border = BORDER;
+      cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+    }
+  }
+  rowNumber += 2;
+
+  // 明细行与合计行
+  const items = Array.isArray(costItem && costItem[section.key]) ? costItem[section.key] : [];
+  const totals = (costItem && costItem[section.totalsKey]) || {};
+  if (items.length > MAX_DETAIL_ROWS) {
+    throw new Error(`${section.title}明细超过 ${MAX_DETAIL_ROWS} 行`);
+  }
+  if (!items.length) {
+    writeStyledRow(sheet, rowNumber, columns, ['暂无数据'], { totalCols: maxCols });
+    sheet.mergeCells(rowNumber, 1, rowNumber, width);
+    rowNumber += 1;
+    return rowNumber + 1;
+  }
+
+  items.forEach((item) => {
+    const source = section.key === 'materialItems' ? { ...item, materialDisplay: materialDisplay(item) } : item;
+    const values = columns.map((column) => (
+      column.kind === 'number' || column.kind === 'money' ? numeric(source[column.field]) : text(source[column.field])
+    ));
+    writeStyledRow(sheet, rowNumber, columns, values, {
+      height: section.hasImage ? 46 : 24,
+      totalCols: maxCols,
+    });
+    // 物料图片列嵌图；图片列单元格本身不写 URL 文本
+    if (section.hasImage) {
+      const imageColIndex = columns.findIndex((column) => column.kind === 'image') + 1;
+      const url = text(item.materialImgUrl);
+      if (url && images.has(url)) {
+        embedImage(workbook, sheet, images.get(url), rowNumber, imageColIndex, { width: 60, height: 60 });
+      }
+    }
+    rowNumber += 1;
+  });
+
+  // 合计行：summary 里声明的列取 totals 字段，其余列空
+  const summaryValues = columns.map((column) => {
+    const pair = section.summary.find(([field]) => field === column.field);
+    if (!pair) {
+      return '';
+    }
+    if (pair[1] === '合计') {
+      return '合计';
+    }
+    const value = totals[pair[1]];
+    return column.kind === 'money' || column.kind === 'number' ? numeric(value == null ? 0 : value) : text(value);
+  });
+  writeStyledRow(sheet, rowNumber, columns, summaryValues, { summary: true, totalCols: maxCols });
+  rowNumber += 1;
+  return rowNumber + 1;
+}
+
+/**
+ * 生成一个生产单的成本明细 Excel。
+ * 返回该文件的明细行数与嵌入图片数。
+ */
+async function writeOneFile(filePath, row, images) {
+  const workbook = createWorkbook();
+  const sheet = workbook.addWorksheet(SHEET_NAME, {
+    views: [{ state: 'frozen', ySplit: 2 }],
+    pageSetup: { orientation: 'landscape', fitToPage: true, fitToWidth: 1, fitToHeight: 0 },
+  });
+  const maxCols = Math.max(OUTER_COLUMNS.length, ...DETAIL_SECTIONS.map((section) => section.groups.reduce((sum, group) => sum + group.columns.length, 0)));
+
+  // 外层两级表头
+  const groupRow = sheet.getRow(1);
+  const titleRow = sheet.getRow(2);
+  let colIndex = 1;
+  for (const group of OUTER_GROUPS) {
+    group.columns.forEach((column, offset) => {
+      groupRow.getCell(colIndex).value = offset === 0 ? group.name : '';
+      titleRow.getCell(colIndex).value = column.header;
+      colIndex += 1;
+    });
+    sheet.mergeCells(1, colIndex - group.columns.length, 1, colIndex - 1);
+  }
+  groupRow.height = 26;
+  titleRow.height = 30;
+  for (const headerLine of [groupRow, titleRow]) {
+    for (let col = 1; col <= maxCols; col += 1) {
+      const cell = headerLine.getCell(col);
+      cell.font = { bold: true };
+      cell.fill = HEADER_FILL;
+      cell.border = BORDER;
+      cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+    }
+  }
+
+  // 外层报表数据行（嵌款式图）
+  writeStyledRow(sheet, 3, OUTER_COLUMNS, OUTER_COLUMNS.map((column) => outerValue(row, column)), { height: 52, totalCols: maxCols });
+  const outerImageCol = OUTER_COLUMNS.findIndex((column) => column.kind === 'image') + 1;
+  const outerUrl = text(row.imgUrl);
+  if (outerUrl && images.has(outerUrl)) {
+    embedImage(workbook, sheet, images.get(outerUrl), 3, outerImageCol, { width: 60, height: 60 });
+  }
+
+  // 成本明细标题行
+  const detailTitle = sheet.getCell(5, 1);
+  detailTitle.value = `成本明细（计算规则：${CAL_WAY_NAME}）`;
+  detailTitle.font = { bold: true, size: 12 };
+  detailTitle.fill = TITLE_FILL;
+  detailTitle.alignment = { vertical: 'middle', horizontal: 'left' };
+  for (let col = 2; col <= maxCols; col += 1) {
+    sheet.getCell(5, col).fill = TITLE_FILL;
+  }
+  sheet.mergeCells(5, 1, 5, maxCols);
+  sheet.getRow(5).height = 28;
+
+  // 五类成本明细分区
+  const costItem = row.costItem || {};
+  let rowNumber = 6;
+  let detailCount = 0;
+  for (const section of DETAIL_SECTIONS) {
+    const items = Array.isArray(costItem[section.key]) ? costItem[section.key] : [];
+    detailCount += items.length;
+    rowNumber = writeSection(sheet, rowNumber, section, costItem, images, maxCols, workbook);
+  }
+
+  // 列宽：外层列按标题与类型，其余列 18
+  OUTER_COLUMNS.forEach((column, index) => {
+    const width = column.kind === 'number' || column.kind === 'money'
+      ? 13
+      : column.kind === 'image'
+        ? 10
+        : Math.max(12, Math.min(22, column.header.length * 3 + 4));
+    sheet.getColumn(index + 1).width = width;
+  });
+  for (let col = OUTER_COLUMNS.length + 1; col <= maxCols; col += 1) {
+    sheet.getColumn(col).width = 18;
+  }
+
+  await saveWorkbook(workbook, filePath);
+  return { detailCount };
+}
+
+/** 文件名清洗：替换 Windows 非法字符，去掉首尾空格与点，最长 80 字符 */
+function safeFilename(value) {
+  const cleaned = text(value).replace(/[<>:"/\\|?*\x00-\x1f]/g, '_').replace(/^[. ]+|[. ]+$/g, '');
+  return cleaned.slice(0, 80) || '未命名';
+}
+
+/**
+ * 生成生产成本报表明细：每个生产单一个 Excel，输出到一个带时间戳的目录。
+ * argv.from/to：业务日期区间（默认不限日期，与原脚本不同处：原脚本默认近 30 天，
+ * 接口版默认全量由调用方控制）；argv.sn/ordersSn、argv.searchKey、argv.state 透传接口；
+ * argv.out：输出目录。
+ */
+async function generate(argv = {}) {
+  const outDir = argv.out || process.cwd();
+  const dirPath = path.resolve(outDir, `生产成本报表明细${timestamp()}`);
+  if (fs.existsSync(dirPath) && fs.readdirSync(dirPath).length) {
+    throw new Error(`输出目录已存在且非空：${dirPath}；如需写入请先清空目录或更换输出目录`);
+  }
+
+  const states = String(argv.state || '4,2,3')
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean);
+  const searchSn = argv.sn || argv.ordersSn;
+  const { list: rawRows, total } = await fetchAll(
+    (page, limit) => call('GET', '/api/agent/v1/report/produce-cost', {
+      from: argv.from,
+      to: argv.to,
+      state: states.join(','),
+      calWay: CAL_WAY,
+      searchKey: argv.searchKey,
+      ordersSn: searchSn,
+      page,
+      limit,
+    })
+  );
+  if (total > MAX_FILES) {
+    throw new Error(`符合条件的数据有 ${total} 行，超过安全上限 ${MAX_FILES}；请缩小筛选范围`);
+  }
+  // 接口的单号查询是模糊匹配，这里再按单号/批次号精确过滤一次（与原脚本一致）
+  const rows = searchSn
+    ? rawRows.filter((row) => text(row.ordersSn) === searchSn || text(row.produceBatchSn) === searchSn)
+    : rawRows;
+  if (!rows.length) {
+    throw new Error('没有符合条件的生产成本报表数据');
+  }
+
+  // 预下载全部图片（款式图 + 物料图），失败地址在 Map 外，对应单元格留空
+  const urls = new Set();
+  for (const row of rows) {
+    if (text(row.imgUrl)) {
+      urls.add(text(row.imgUrl));
+    }
+    const item = row.costItem || {};
+    for (const material of item.materialItems || []) {
+      if (text(material.materialImgUrl)) {
+        urls.add(text(material.materialImgUrl));
+      }
+    }
+  }
+  const images = await downloadImages([...urls]);
+
+  fs.mkdirSync(dirPath, { recursive: true });
+  const usedNames = new Set();
+  const filePaths = [];
+  const failures = [];
+  let totalDetails = 0;
+  for (const row of rows) {
+    const orderSn = row.ordersSn || row.id;
+    const goodsName = text(row.goodsName) || '未命名商品';
+    const goodsSn = text(row.goodsSn) || text(row.designSn) || '无大货号';
+    let base = safeFilename(`${orderSn}_${goodsName}(${goodsSn})`);
+    let candidate = `${base}.xlsx`;
+    let suffix = 2;
+    while (usedNames.has(candidate.toLowerCase())) {
+      candidate = `${base}_${suffix}.xlsx`;
+      suffix += 1;
+    }
+    usedNames.add(candidate.toLowerCase());
+    const filePath = path.join(dirPath, candidate);
+    try {
+      const { detailCount } = await writeOneFile(filePath, row, images);
+      filePaths.push(filePath);
+      totalDetails += detailCount;
+    } catch (e) {
+      failures.push(String(orderSn));
+    }
+  }
+  if (!filePaths.length) {
+    throw new Error('所有 Excel 均生成失败');
+  }
+
+  return {
+    filePaths,
+    summary: `生产成本报表明细已生成：报表行 ${rows.length} 行拆为 ${filePaths.length} 个 Excel（目录 ${path.basename(dirPath)}），` +
+      `成本明细 ${totalDetails} 行，计算规则「${CAL_WAY_NAME}」` +
+      (failures.length ? `，${failures.length} 个生成失败（${failures.join('、')}）` : ''),
+  };
+}
+
+module.exports = { generate };