weaver-work-cli 0.1.29 → 0.1.31

package/dist/shortcuts/contract/ooxml/docx.js

@@ -0,0 +1,295 @@
+/**
+ * 最小 docx 填充引擎（零依赖）。
+ *
+ * 只处理 word/document.xml，语义与源脚本 quote_to_contract.py 的 fill_docx 对齐：
+ * - 正文段落（不含表格内）先做具名占位符 + 匿名空白填充（低阈值）。
+ * - 表格单元格里「空值格」只认高阈值（≥95）的精确命中，避免误填签名栏。
+ * - 改写策略与 python-docx 的 set_para_text 一致：首个 w:t 写入新文本，其余清空。
+ * - 明细追加表自带 tblBorders，不依赖模板存在 Table Grid 样式。
+ *
+ * XML 处理为分段正则扫描（机器生成的 OOXML 结构稳定），不做通用 XML 解析。
+ */
+import { readFileSync } from 'node:fs';
+import { readZipEntry, rewriteZip } from './zip.js';
+import { encodeXml, decodeXml } from './xlsx.js';
+/** 注意：带 /g 的正则对象 .test() 有状态，统一用 SOURCE 现场构造。 */
+export const PLACEHOLDER_SOURCE = '\\{\\{[^}]{1,60}\\}\\}|\\$\\{[^}]{1,60}\\}|【[^】]{1,60}】';
+export const BLANK_SOURCE = '_{2,}|＿{2,}|【\\s*】|\\{\\s*\\}';
+export function hasPlaceholder(text) {
+    return new RegExp(PLACEHOLDER_SOURCE, 'u').test(text);
+}
+export function hasBlank(text) {
+    return new RegExp(BLANK_SOURCE, 'u').test(text);
+}
+/** 取占位符之前的标签（以 ：/: 结尾），退化取段内第一个词组。 */
+export function labelBefore(text, pos) {
+    const seg = text.slice(0, pos);
+    const matches = [...seg.matchAll(/([^\s，,；;。]{1,20})[：:]\s*$/gu)];
+    if (matches.length)
+        return matches[matches.length - 1][1];
+    const m2 = /([^\s，,；;。]{2,20})[：:]/u.exec(seg);
+    return m2 ? m2[1] : '';
+}
+function fillText(text, floor, filler, log) {
+    const orig = text;
+    // 1) 具名占位符
+    text = text.replace(new RegExp(PLACEHOLDER_SOURCE, 'gu'), (token) => {
+        const label = token.replace(/^[\{$【]+/u, '').replace(/[}\}】]+$/u, '').trim();
+        const { key, score } = filler.bestKey(label, floor);
+        const value = key ? filler.valOf(key) : '';
+        if (value) {
+            log.push({ label, key, score, type: 'named' });
+            return value;
+        }
+        log.push({ label, key, score, type: 'named_unfilled' });
+        return token;
+    });
+    // 2) 匿名空白
+    let out = '';
+    let idx = 0;
+    let changed = false;
+    for (const m of text.matchAll(new RegExp(BLANK_SOURCE, 'gu'))) {
+        const start = m.index ?? 0;
+        const label = labelBefore(text, start);
+        const { key, score } = filler.bestKey(label, floor);
+        const value = key ? filler.valOf(key) : '';
+        if (value) {
+            out += text.slice(idx, start) + value;
+            log.push({ label, key, score, type: 'blank' });
+            changed = true;
+        }
+        else {
+            out += text.slice(idx, start + m[0].length);
+            log.push({ label, key, score, type: 'blank_unfilled' });
+        }
+        idx = start + m[0].length;
+    }
+    out += text.slice(idx);
+    return { text: out, changed: changed || out !== orig };
+}
+function collectRanges(xml, tag) {
+    const open = new RegExp(`<${tag}(\\s[^>]*)?>`, 'gu');
+    const close = new RegExp(`</${tag}>`, 'gu');
+    const ranges = [];
+    const events = [];
+    for (const m of xml.matchAll(open))
+        events.push({ pos: m.index ?? 0, open: true });
+    for (const m of xml.matchAll(close))
+        events.push({ pos: m.index ?? 0, open: false });
+    events.sort((a, b) => a.pos - b.pos || (a.open ? -1 : 1));
+    let depth = 0;
+    let currentStart = -1;
+    for (const e of events) {
+        if (e.open) {
+            if (depth === 0)
+                currentStart = e.pos;
+            depth++;
+        }
+        else {
+            depth--;
+            if (depth === 0 && currentStart >= 0) {
+                const end = e.pos + tag.length + 3;
+                ranges.push({ start: currentStart, end });
+                currentStart = -1;
+            }
+        }
+    }
+    return ranges;
+}
+function paragraphFullText(pXml) {
+    let text = '';
+    for (const m of pXml.matchAll(/<w:t(?:\s[^>]*)?>([\s\S]*?)<\/w:t>/gu))
+        text += decodeXml(m[1]);
+    return text;
+}
+function setParagraphText(pXml, newText) {
+    let first = true;
+    return pXml.replace(/<w:t((?:\s[^>]*)?)>([\s\S]*?)<\/w:t>/gu, (_all, attrs) => {
+        if (first) {
+            first = false;
+            const spaceAttr = /xml:space/.test(attrs) ? attrs : attrs + ' xml:space="preserve"';
+            return `<w:t${spaceAttr}>${encodeXml(newText)}</w:t>`;
+        }
+        return '<w:t xml:space="preserve"></w:t>';
+    });
+}
+function topRanges(xml, tag) {
+    // 只取深度 0 的顶层范围
+    return collectRanges(xml, tag);
+}
+function isInside(pos, ranges) {
+    return ranges.some((r) => pos >= r.start && pos < r.end);
+}
+/** 填充 docx 模板：body 段落低阈值、表格空格高阈值、可选追加明细表。 */
+export function fillDocx(templatePath, filler, options = {}) {
+    // 硬门禁与源脚本一致：没有真实模板 docx 不得生成合同
+    const entriesXml = readDocumentXml(templatePath);
+    const log = [];
+    let xml = entriesXml;
+    // ---- 表格处理（先做，避免被段落低阈值抢填）
+    const tableRanges = topRanges(xml, 'w:tbl');
+    for (let ti = tableRanges.length - 1; ti >= 0; ti--) {
+        const range = tableRanges[ti];
+        const tableXml = xml.slice(range.start, range.end);
+        const patched = fillTable(tableXml, filler, log);
+        xml = xml.slice(0, range.start) + patched + xml.slice(range.end);
+    }
+    // ---- 正文段落（表格之外的顶层段落）
+    const paraRanges = collectRanges(xml, 'w:p').filter((r) => !isInside(r.start, topRanges(xml, 'w:tbl')));
+    for (let i = paraRanges.length - 1; i >= 0; i--) {
+        const r = paraRanges[i];
+        const pXml = xml.slice(r.start, r.end);
+        const full = paragraphFullText(pXml);
+        if (!full)
+            continue;
+        const { text, changed } = fillText(full, 60, filler, log);
+        if (changed) {
+            xml = xml.slice(0, r.start) + setParagraphText(pXml, text) + xml.slice(r.end);
+        }
+    }
+    // ---- 追加费用明细
+    if (options.detail !== 'none' && options.sections?.length) {
+        xml = appendDetailTable(xml, options.sections, options.amount ?? null);
+    }
+    const filled = log.filter((m) => !m.type.endsWith('_unfilled'));
+    const unfilled = log.filter((m) => m.type.endsWith('_unfilled'));
+    return { buffer: rewriteDocument(templatePath, xml), result: { filled, unfilled } };
+}
+function fillTable(tableXml, filler, log) {
+    // 逐行处理单元格，收集右侧标签
+    const rowRanges = collectRanges(tableXml, 'w:tr');
+    let patched = tableXml;
+    // 从后往前替换，避免位移
+    const cellLabels = [];
+    for (const row of rowRanges) {
+        const rowXml = tableXml.slice(row.start, row.end);
+        const cellRanges = collectRanges(rowXml, 'w:tc');
+        const cells = cellRanges.map((cr) => ({
+            start: cr.start,
+            xml: rowXml.slice(cr.start, cr.end),
+        }));
+        for (let ci = cells.length - 1; ci >= 0; ci--) {
+            const cell = cells[ci];
+            const cellText = paragraphFullText(cell.xml);
+            if (cellText && !hasBlank(cellText) && !hasPlaceholder(cellText))
+                continue;
+            let label = '';
+            for (let j = ci - 1; j >= 0; j--) {
+                const cand = cells[j];
+                const candText = paragraphFullText(cand.xml).trim();
+                if (candText && !hasBlank(candText) && !hasPlaceholder(candText)) {
+                    label = candText.replace(/[：:]$/u, '');
+                    break;
+                }
+            }
+            if (!label)
+                continue;
+            cellLabels.push({ cellStart: row.start + cell.start, cellXml: cell.xml, label });
+        }
+    }
+    // cellStart 是相对 tableXml 的绝对位置；从后往前替换
+    cellLabels.sort((a, b) => b.cellStart - a.cellStart);
+    for (const { cellStart, cellXml, label } of cellLabels) {
+        const patchedCell = fillTableCell(cellXml, label, filler, log);
+        patched = patched.slice(0, cellStart) + patchedCell + patched.slice(cellStart + cellXml.length);
+    }
+    return patched;
+}
+function fillTableCell(cellXml, label, filler, log) {
+    const paraRanges = collectRanges(cellXml, 'w:p');
+    let patched = cellXml;
+    let hit = false;
+    for (let i = paraRanges.length - 1; i >= 0; i--) {
+        const r = paraRanges[i];
+        const pXml = cellXml.slice(r.start, r.end);
+        const full = paragraphFullText(pXml);
+        const { key, score } = filler.bestKey(label, 95);
+        const value = key ? filler.valOf(key) : '';
+        if (!value)
+            continue;
+        if (full.trim() === '') {
+            log.push({ label, key, score, type: 'cell' });
+            patched = patched.slice(0, r.start) + addRunToParagraph(pXml, value) + patched.slice(r.end);
+            hit = true;
+            break;
+        }
+        const { text, changed } = fillText(full, 95, filler, log);
+        if (changed) {
+            log.push({ label, key, score, type: 'cell' });
+            patched = patched.slice(0, r.start) + setParagraphText(pXml, text) + patched.slice(r.end);
+            hit = true;
+        }
+        break;
+    }
+    void hit;
+    return patched;
+}
+function addRunToParagraph(pXml, value) {
+    const run = `<w:r><w:t xml:space="preserve">${encodeXml(value)}</w:t></w:r>`;
+    const closeIdx = pXml.lastIndexOf('</w:p>');
+    if (closeIdx < 0)
+        return pXml;
+    return pXml.slice(0, closeIdx) + run + pXml.slice(closeIdx);
+}
+function appendDetailTable(xml, sections, amount) {
+    const border = '<w:tblBorders>' +
+        ['top', 'left', 'bottom', 'right', 'insideH', 'insideV']
+            .map((s) => `<w:${s} w:val="single" w:sz="4" w:space="0" w:color="000000"/>`)
+            .join('') +
+        '</w:tblBorders>';
+    const cell = (text, bold = false) => '<w:tc><w:tcPr/><w:p><w:r>' +
+        (bold ? '<w:rPr><w:b/></w:rPr>' : '') +
+        `<w:t xml:space="preserve">${encodeXml(text)}</w:t></w:r></w:p></w:tc>`;
+    const row = (...cells) => `<w:tr>${cells.join('')}</w:tr>`;
+    const rows = [row(cell('费用类别', true), cell('项目', true), cell('数量', true), cell('金额（元）', true))];
+    for (const sec of sections) {
+        for (const item of sec.items) {
+            rows.push(row(cell(`${sec.code}、${sec.title}`), cell(String(item.name ?? item.desc ?? '')), cell(item.qty === null || item.qty === undefined || item.qty === '' ? '' : String(item.qty)), cell(formatAmount(item.amount))));
+        }
+        if (sec.total !== null && sec.total !== undefined) {
+            rows.push(row(cell('小计'), cell(`${sec.code}、${sec.title}`), cell(''), cell(formatAmount(sec.total))));
+        }
+    }
+    if (amount !== null && amount !== '') {
+        rows.push(row(cell('合计'), cell('合同总金额'), cell(''), cell(formatAmount(amount))));
+    }
+    const pageBreak = '<w:p><w:r><w:br w:type="page"/></w:r></w:p>';
+    const heading = '<w:p><w:pPr><w:outlineLvl w:val="0"/></w:pPr><w:r><w:rPr><w:b/><w:sz w:val="32"/></w:rPr>' +
+        '<w:t xml:space="preserve">附件：产品及服务费用明细</w:t></w:r></w:p>';
+    const table = `<w:tbl><w:tblPr><w:tblW w:w="0" w:type="auto"/>${border}</w:tblPr>${rows.join('')}</w:tbl>`;
+    const sectPr = xml.lastIndexOf('<w:sectPr');
+    const insertAt = sectPr >= 0 ? sectPr : xml.lastIndexOf('</w:body>');
+    if (insertAt < 0)
+        return xml + pageBreak + heading + table;
+    return xml.slice(0, insertAt) + pageBreak + heading + table + xml.slice(insertAt);
+}
+function formatAmount(v) {
+    if (v === null || v === undefined || v === '')
+        return '';
+    const s = String(v).replace(/[,￥¥]/gu, '').trim();
+    const f = Number(s);
+    if (!Number.isFinite(f))
+        return String(v);
+    return f === Math.trunc(f) ? f.toLocaleString('en-US') : f.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+}
+function readDocumentXml(templatePath) {
+    let buffer;
+    try {
+        buffer = readFileSync(templatePath);
+    }
+    catch {
+        throw new Error('合同模板缺失：必须先取到真实的 .docx 模板才能生成合同。取不到就停止并请用户提供模板文件；禁止把报价单内容直接生成成一份合同。');
+    }
+    try {
+        return readDocumentXmlFrom(buffer);
+    }
+    catch {
+        throw new Error('模板不是有效的 .docx（可能拿到的是 HTML 或压缩包）：请重新取模板；禁止用非 docx 文件当模板，也禁止绕过模板直接生成合同。');
+    }
+}
+function readDocumentXmlFrom(buffer) {
+    return readZipEntry(buffer, 'word/document.xml');
+}
+function rewriteDocument(templatePath, documentXml) {
+    return rewriteZip(templatePath, { 'word/document.xml': documentXml });
+}

package/dist/shortcuts/contract/ooxml/xlsx.js

@@ -0,0 +1,221 @@
+/**
+ * 最小 xlsx 读取器（零依赖，机器生成的常规工作簿）。
+ *
+ * 输出与源脚本 quote_to_contract.py 对齐：
+ * - sheetNames：工作表名列表（供用户选择，禁止自动选）。
+ * - readGrid：返回每行每列的原始值 + 纵向合并的 text/num 两张映射，
+ *   供 parseQuote 的「文本列可继承、数值列只归首行」语义使用。
+ */
+import { readZip, readZipEntry } from './zip.js';
+const DATE_BUILTIN = new Set([14, 15, 16, 17, 18, 19, 20, 21, 22, 27, 30, 36, 45, 46, 47]);
+function colToIndex(ref) {
+    let n = 0;
+    for (const ch of ref) {
+        if (ch >= 'A' && ch <= 'Z')
+            n = n * 26 + (ch.charCodeAt(0) - 64);
+        else
+            break;
+    }
+    return n;
+}
+function rowToNumber(ref) {
+    const m = /\d+/.exec(ref);
+    return m ? parseInt(m[0], 10) : 0;
+}
+function excelSerialToIso(serial) {
+    // Excel 序列：1900-01-01 = 1，含 1900 闰年 bug 偏移
+    const days = Math.floor(serial) - 25569;
+    const ms = days * 86400000;
+    const d = new Date(ms);
+    const iso = d.toISOString().slice(0, 10);
+    return iso;
+}
+export function listSheetNames(buffer) {
+    const workbook = readZipText(buffer, 'xl/workbook.xml');
+    const rels = readZipText(buffer, 'xl/_rels/workbook.xml.rels');
+    const relMap = new Map();
+    for (const m of rels.matchAll(/<Relationship[^>]*Id="([^"]+)"[^>]*Target="([^"]+)"[^>]*\/?>/gu)) {
+        relMap.set(m[1], m[2]);
+    }
+    const names = [];
+    for (const m of workbook.matchAll(/<sheet[^>]*name="([^"]*)"[^>]*r:id="([^"]+)"[^>]*\/?>/gu)) {
+        names.push(decodeXml(m[1]));
+        void relMap.get(m[2]);
+    }
+    return names;
+}
+function readZipText(buffer, name) {
+    return readZipEntry(buffer, name);
+}
+/** 解析 styles.xml，返回 cellXfs 中每个 xf 的 numFmtId 及自定义格式串。 */
+function loadDateStyles(buffer) {
+    let styles = '';
+    try {
+        styles = readZipText(buffer, 'xl/styles.xml');
+    }
+    catch {
+        return () => false;
+    }
+    const customFormats = new Map();
+    for (const m of styles.matchAll(/<numFmt[^>]*numFmtId="(\d+)"[^>]*formatCode="([^"]*)"[^>]*\/?>/gu)) {
+        customFormats.set(parseInt(m[1], 10), decodeXml(m[2]));
+    }
+    const xfIds = [];
+    const cellXfs = styles.indexOf('<cellXfs');
+    if (cellXfs >= 0) {
+        const section = styles.slice(cellXfs, styles.indexOf('</cellXfs>', cellXfs));
+        for (const m of section.matchAll(/<xf[^>]*numFmtId="(\d+)"[^>]*\/?>/gu)) {
+            xfIds.push(parseInt(m[1], 10));
+        }
+    }
+    return (styleIndex) => {
+        const id = xfIds[styleIndex] ?? 0;
+        if (DATE_BUILTIN.has(id))
+            return true;
+        const custom = customFormats.get(id);
+        if (!custom)
+            return false;
+        // 排除纯时间格式：必须含年/月/日标记之一
+        return /[ymd]/i.test(custom.replace(/\[[^\]]*\]/g, ''));
+    };
+}
+export function readGrid(buffer, sheetIndex) {
+    const workbook = readZipText(buffer, 'xl/workbook.xml');
+    const rels = readZipText(buffer, 'xl/_rels/workbook.xml.rels');
+    const relMap = new Map();
+    for (const m of rels.matchAll(/<Relationship[^>]*Id="([^"]+)"[^>]*Target="([^"]+)"[^>]*\/?>/gu)) {
+        relMap.set(m[1], m[2]);
+    }
+    const sheetMatches = [...workbook.matchAll(/<sheet[^>]*r:id="([^"]+)"[^>]*\/?>/gu)];
+    const hit = sheetMatches[sheetIndex];
+    if (!hit)
+        throw new Error(`sheet 序号越界：${sheetIndex}`);
+    let target = relMap.get(hit[1]);
+    if (!target)
+        throw new Error('workbook.xml.rels 缺少 sheet 关系，无法定位工作表。');
+    if (target.startsWith('/'))
+        target = target.slice(1);
+    else if (!target.startsWith('xl/'))
+        target = 'xl/' + target;
+    // 共享字符串
+    const shared = [];
+    try {
+        const sst = readZipText(buffer, 'xl/sharedStrings.xml');
+        for (const m of sst.matchAll(/<si>([\s\S]*?)<\/si>/gu)) {
+            shared.push([...m[1].matchAll(/<t[^>]*>([\s\S]*?)<\/t>/gu)].map((t) => decodeXml(t[1])).join(''));
+        }
+    }
+    catch {
+        // 无共享字符串表：全部 inline
+    }
+    const isDate = loadDateStyles(buffer);
+    const sheetXml = readZipText(buffer, sheetName(target, buffer));
+    const values = new Map();
+    let maxRow = 0;
+    let maxCol = 0;
+    for (const cm of sheetXml.matchAll(/<c([^>]*?)\/>|<c([^>]*?)>([\s\S]*?)<\/c>/gu)) {
+        const attrs = cm[1] || cm[2];
+        const inner = cm[3] ?? '';
+        const ref = /r="([A-Z]+\d+)"/u.exec(attrs)?.[1];
+        if (!ref)
+            continue;
+        const row = rowToNumber(ref);
+        const col = colToIndex(ref);
+        const type = /t="([^"]+)"/u.exec(attrs)?.[1] ?? 'n';
+        const styleIndex = parseInt(/s="(\d+)"/u.exec(attrs)?.[1] ?? '0', 10);
+        let text = '';
+        let num = null;
+        let dateIso = null;
+        const v = /<v[^>]*>([\s\S]*?)<\/v>/u.exec(inner)?.[1];
+        if (type === 'inlineStr') {
+            text = [...inner.matchAll(/<t[^>]*>([\s\S]*?)<\/t>/gu)].map((t) => decodeXml(t[1])).join('');
+        }
+        else if (v !== undefined) {
+            if (type === 's') {
+                text = shared[parseInt(v, 10)] ?? '';
+            }
+            else if (type === 'str') {
+                text = decodeXml(v);
+            }
+            else if (type === 'b') {
+                text = v.trim() === '1' ? '1' : '0';
+            }
+            else {
+                const parsed = Number(v);
+                if (Number.isFinite(parsed)) {
+                    num = parsed;
+                    if (isDate(styleIndex) && parsed > 59) {
+                        dateIso = excelSerialToIso(parsed);
+                        text = dateIso;
+                    }
+                    else {
+                        text = formatNumber(parsed);
+                    }
+                }
+                else {
+                    text = decodeXml(v);
+                }
+            }
+        }
+        if (!values.has(row))
+            values.set(row, new Map());
+        values.get(row).set(col, { text, num, dateIso });
+        if (row > maxRow)
+            maxRow = row;
+        if (col > maxCol)
+            maxCol = col;
+    }
+    // 合并单元格：纵向 -> 文本列全继承；数值列只归首行
+    const textMerged = new Map();
+    const numMerged = new Map();
+    for (const m of sheetXml.matchAll(/<mergeCell[^>]*ref="([A-Z]+\d+):([A-Z]+\d+)"/gu)) {
+        const c1 = colToIndex(m[1]);
+        const r1 = rowToNumber(m[1]);
+        const c2 = colToIndex(m[2]);
+        const r2 = rowToNumber(m[2]);
+        if (r2 <= r1)
+            continue; // 纯横向合并，忽略
+        const top = values.get(r1)?.get(c1) ?? { text: '', num: null, dateIso: null };
+        for (let r = r1; r <= r2; r++) {
+            for (let c = c1; c <= c2; c++) {
+                if (!values.get(r)?.has(c)) {
+                    textMerged.set(`${r}:${c}`, top);
+                }
+            }
+        }
+        for (let c = c1; c <= c2; c++)
+            numMerged.set(`${r1}:${c}`, top);
+    }
+    return { values, textMerged, numMerged, maxRow, maxCol };
+}
+function sheetName(target, buffer) {
+    const names = new Set(readZip(buffer).map((e) => e.name));
+    if (names.has(target))
+        return target;
+    // worksheets/sheetN.xml 大小写或路径差异兜底
+    const alt = [...names].find((n) => n.toLowerCase() === target.toLowerCase());
+    if (alt)
+        return alt;
+    throw new Error(`找不到工作表 XML：${target}`);
+}
+function formatNumber(n) {
+    if (Number.isInteger(n))
+        return String(n);
+    return String(parseFloat(n.toPrecision(15)));
+}
+export function decodeXml(s) {
+    return s
+        .replace(/&lt;/gu, '<')
+        .replace(/&gt;/gu, '>')
+        .replace(/&quot;/gu, '"')
+        .replace(/&apos;/gu, "'")
+        .replace(/&#(\d+);/gu, (_, d) => String.fromCodePoint(parseInt(d, 10)))
+        .replace(/&amp;/gu, '&');
+}
+export function encodeXml(s) {
+    return s
+        .replace(/&/gu, '&amp;')
+        .replace(/</gu, '&lt;')
+        .replace(/>/gu, '&gt;')
+        .replace(/"/gu, '&quot;');
+}

package/dist/shortcuts/contract/ooxml/zip.js

@@ -0,0 +1,158 @@
+/**
+ * 最小 OOXML ZIP 读写层（零运行时依赖）。
+ *
+ * 只覆盖 docx/xlsx 实际用到的形态：
+ * - 读：解析 central directory，STORED 与 DEFLATE 均支持（node:zlib inflateRawSync）。
+ * - 写：全部 STORED 无压缩写出（ZIP 规范允许，Word/Excel 正常打开）。
+ * - 改：读取原包全部条目，替换指定条目内容后重写，保留其余条目原样。
+ */
+import { inflateRawSync } from 'node:zlib';
+import { readFileSync } from 'node:fs';
+const LOCAL_SIG = 0x04034b50;
+const CENTRAL_SIG = 0x02014b50;
+const EOCD_SIG = 0x06054b50;
+function readDosDateTime(buf, offset) {
+    return { time: buf.readUInt16LE(offset), date: buf.readUInt16LE(offset + 2) };
+}
+export function readZip(buffer) {
+    // 定位 EOCD（容忍注释）
+    let eocd = -1;
+    for (let i = buffer.length - 22; i >= Math.max(0, buffer.length - 22 - 65536); i--) {
+        if (buffer.readUInt32LE(i) === EOCD_SIG) {
+            eocd = i;
+            break;
+        }
+    }
+    if (eocd < 0)
+        throw new Error('不是有效的 ZIP/OOXML 文件（找不到 EOCD）。');
+    const count = buffer.readUInt16LE(eocd + 10);
+    let offset = buffer.readUInt32LE(eocd + 16);
+    const entries = [];
+    for (let n = 0; n < count; n++) {
+        if (buffer.readUInt32LE(offset) !== CENTRAL_SIG)
+            throw new Error('ZIP central directory 损坏。');
+        const method = buffer.readUInt16LE(offset + 10);
+        const compressedSize = buffer.readUInt32LE(offset + 20);
+        const nameLen = buffer.readUInt16LE(offset + 28);
+        const extraLen = buffer.readUInt16LE(offset + 30);
+        const commentLen = buffer.readUInt16LE(offset + 32);
+        const localOffset = buffer.readUInt32LE(offset + 42);
+        const name = buffer.toString('utf8', offset + 46, offset + 46 + nameLen);
+        // 从 local header 取真实数据起点（local extra 长度可能不同）
+        const localNameLen = buffer.readUInt16LE(localOffset + 26);
+        const localExtraLen = buffer.readUInt16LE(localOffset + 28);
+        const dataStart = localOffset + 30 + localNameLen + localExtraLen;
+        const raw = buffer.subarray(dataStart, dataStart + compressedSize);
+        const data = method === 0 ? Buffer.from(raw) : inflateRawSync(raw);
+        entries.push({ name, data });
+        offset += 46 + nameLen + extraLen + commentLen;
+    }
+    return entries;
+}
+export function readZipEntry(buffer, name) {
+    const hit = readZip(buffer).find((e) => e.name === name);
+    if (!hit)
+        throw new Error(`OOXML 包缺少 ${name}，不是有效的 Office 文档。`);
+    return hit.data.toString('utf8');
+}
+function crc32(data) {
+    let table = crc32Table;
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++) {
+        crc = (crc >>> 8) ^ table[(crc ^ data[i]) & 0xff];
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+const crc32Table = (() => {
+    const table = new Int32Array(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;
+    }
+    return table;
+})();
+function dosDateTime() {
+    const d = new Date();
+    return {
+        time: (d.getHours() << 11) | (d.getMinutes() << 5) | Math.floor(d.getSeconds() / 2),
+        date: (((d.getFullYear() - 1980) & 0x7f) << 9) | ((d.getMonth() + 1) << 5) | d.getDate(),
+    };
+}
+export function writeZip(entries) {
+    const { time, date } = dosDateTime();
+    const chunks = [];
+    const central = [];
+    let offset = 0;
+    for (const entry of entries) {
+        const nameBuf = Buffer.from(entry.name, 'utf8');
+        const crc = crc32(entry.data);
+        const local = Buffer.alloc(30);
+        local.writeUInt32LE(LOCAL_SIG, 0);
+        local.writeUInt16LE(20, 4); // version
+        local.writeUInt16LE(0, 6); // flags
+        local.writeUInt16LE(0, 8); // STORED
+        local.writeUInt16LE(time, 10);
+        local.writeUInt16LE(date, 12);
+        local.writeUInt32LE(crc, 14);
+        local.writeUInt32LE(entry.data.length, 18);
+        local.writeUInt32LE(entry.data.length, 22);
+        local.writeUInt16LE(nameBuf.length, 26);
+        local.writeUInt16LE(0, 28);
+        chunks.push(local, nameBuf, entry.data);
+        const cen = Buffer.alloc(46);
+        cen.writeUInt32LE(CENTRAL_SIG, 0);
+        cen.writeUInt16LE(20, 4);
+        cen.writeUInt16LE(20, 6);
+        cen.writeUInt16LE(0, 8);
+        cen.writeUInt16LE(0, 10);
+        cen.writeUInt16LE(time, 12);
+        cen.writeUInt16LE(date, 14);
+        cen.writeUInt32LE(crc, 16);
+        cen.writeUInt32LE(entry.data.length, 20);
+        cen.writeUInt32LE(entry.data.length, 24);
+        cen.writeUInt16LE(nameBuf.length, 28);
+        cen.writeUInt16LE(0, 30);
+        cen.writeUInt16LE(0, 32);
+        cen.writeUInt16LE(0, 34);
+        cen.writeUInt16LE(0, 36);
+        cen.writeUInt32LE(0, 38);
+        cen.writeUInt32LE(offset, 42);
+        central.push(cen, nameBuf);
+        offset += 30 + nameBuf.length + entry.data.length;
+    }
+    const centralBuf = Buffer.concat(central);
+    const eocd = Buffer.alloc(22);
+    eocd.writeUInt32LE(EOCD_SIG, 0);
+    eocd.writeUInt16LE(0, 4);
+    eocd.writeUInt16LE(0, 6);
+    eocd.writeUInt16LE(entries.length, 8);
+    eocd.writeUInt16LE(entries.length, 10);
+    eocd.writeUInt32LE(centralBuf.length, 12);
+    eocd.writeUInt32LE(offset, 16);
+    eocd.writeUInt16LE(0, 20);
+    return Buffer.concat([...chunks, centralBuf, eocd]);
+}
+/** 读原包、替换/追加条目、重写。 */
+export function rewriteZip(sourcePath, replacements) {
+    const entries = readZip(readFileSync(sourcePath));
+    const out = [];
+    const done = new Set();
+    for (const entry of entries) {
+        if (entry.name in replacements) {
+            const data = replacements[entry.name];
+            out.push({ name: entry.name, data: typeof data === 'string' ? Buffer.from(data, 'utf8') : data });
+            done.add(entry.name);
+        }
+        else {
+            out.push(entry);
+        }
+    }
+    for (const [name, data] of Object.entries(replacements)) {
+        if (!done.has(name)) {
+            out.push({ name, data: typeof data === 'string' ? Buffer.from(data, 'utf8') : data });
+        }
+    }
+    return writeZip(out);
+}