tomevault-io MD 转 Word 文档
你是排版师——流水线的最后一道工序，把所有Markdown变成客户拿到手的Word文档。标题层级乱 = 目录生成错，图片路径断 = 正文留白，分页不对 = 整本标书散架。所以：配置精确、路径正确、转换零损耗。
核心功能
将 响应文件/ 目录下的 Markdown 文件转换为格式化的 Word (.docx) 文档，
支持标题层级、表格、图片嵌入、页眉页脚、分页等。
支持单册输出（合并为一个文件）和多册输出（按册别生成多个文件）。
工作流程
1. 读取项目信息（仅读取文本文件，不要读取图片）
⚠️ 重要：只读取 .md 文本文件，不要使用 Read 工具读取 .png 或 .jpg 图片文件
1.1 从分析报告读取项目名称和册别结构
# 读取 分析报告.md，提取项目名称
# 通常在 "## 项目概况" 章节的 "项目名称" 行
提取字段：
- 项目名称：用于页眉文字和输出文件名
- 采购编号：可选，用于页眉补充信息
- 册别结构：从"投标文件册别结构"章节提取册别数量和每册包含的文件列表
1.2 从商务文件读取公司名称
扫描 响应文件/ 目录下的 Markdown 文件（如报价函、封面等），提取公司全称：
# 在已编写的商务文件中搜索公司名称
# 通常在报价函或封面文件的签章区域
提取字段：
- 公司全称：用于页脚
注意：
- 只需读取
.md文件获取项目信息 - 不要读取
.png、.jpg等图片文件 - 图片的处理由
generate_docx.js脚本自动完成
1.3 判定输出模式
根据册别结构判定输出模式：
- 单册模式：分析报告未提及册别结构或标注"单册" → 生成一个 Word 文件
- 多册模式：分析报告指定了多册结构 → 每册生成一个独立 Word 文件
2. 运行生成脚本
⚠️ 重要：不要复制脚本到工作目录！直接通过命令行参数调用原始脚本。
脚本路径固定为：/mnt/oldroot/home/bird/xyy/smartbid-platform/packages/bidsmart-skills/skills/bid-md2doc/scripts/generate_docx.js
通过 JSON 参数传入配置：
node /mnt/oldroot/home/bird/xyy/smartbid-platform/packages/bidsmart-skills/skills/bid-md2doc/scripts/generate_docx.js '{
"inputDir": "{工作目录}/响应文件",
"outputFile": "响应文件-{公司简称}-{项目简称}.docx",
"headerText": "{项目全称} 响应文件",
"footerCompany": "{公司全称}"
}'
2.1 单册模式
一次调用，不指定 excludeFiles（使用默认排除列表）：
node {脚本路径} '{"inputDir":"{workDir}/响应文件","outputFile":"响应文件-{公司简称}-{项目简称}.docx","headerText":"{项目全称} 响应文件","footerCompany":"{公司全称}"}'
2.2 多册模式
多次调用，每次传不同参数：
# 第一册：资格证明文件
node {脚本路径} '{"inputDir":"{workDir}/响应文件","outputFile":"投标文件（资格证明文件）-投标人.docx","headerText":"{采购编号} 投标文件（资格证明文件）","footerCompany":"{公司全称}","includeFiles":["00-资格证明文件.md"]}'
# 第二册：商务技术文件
node {脚本路径} '{"inputDir":"{workDir}/响应文件","outputFile":"投标文件（商务技术文件）-投标人.docx","headerText":"{采购编号} 投标文件（商务技术文件）","footerCompany":"{公司全称}","excludeFiles":["核对报告.md","装订指南.md","00-资格证明文件.md"]}'
字段说明：
inputDir：响应文件/的绝对路径outputFile：输出文件名headerText：页眉文字footerCompany：页脚公司名excludeFiles：排除的文件列表（可选，有默认值）includeFiles：仅包含的文件列表（可选，优先于 excludeFiles）
4. 报告生成结果
输出以下信息：
- 生成的 .docx 文件路径和大小
- 处理的 Markdown 文件数量
- 嵌入的图片数量
- 排除的文件列表
排除规则
以下文件不转换为 Word：
核对报告.md— 内部质检文件，不进入最终文档装订指南.md— 内部参考文件，不进入最终文档- 用户指定的其他排除文件
图片处理
generate_docx.js 支持 Markdown 图片语法 ：
- 自动读取图片文件并嵌入 Word
- 图片宽度不超过页面内容区（约15cm），高度按比例缩放
- 支持 PNG 和 JPEG 格式
- 图片不存在时插入红色
[图片缺失: filename]占位文字
⚠️ 重要：不需要使用 Read 工具读取图片文件
generate_docx.js脚本会自动处理所有图片的读取和嵌入- Claude 只需确保 Markdown 中的图片路径正确（相对于
响应文件/目录） - 无需验证图片内容或尺寸，脚本会自动处理
generate_docx.js 渲染行为
编写 Markdown 时必须了解 generate_docx.js 的以下渲染规则，否则 Word 输出会出现排版问题：
自动分页规则
##标题（H2）自动在前方插入分页：每个##标题都会从新的一页开始- 这意味着封面、签章区等不需要分页的内容，绝不可使用
#或##标题标记 - 封面应使用
**加粗正文**格式（参见 bid-commercial-proposal SKILL.md 3.0.1）
空白行处理
- 禁止使用
：generate_docx.js 已内置清理逻辑，会自动移除所有 实体 - 使用普通空行（连续两个换行符）即可实现段落间距
- 封面留白、签章区间距通过正常的 Markdown 空行处理
ImageRun 类型
- 嵌入图片时必须指定
type参数（'png'或'jpg'），否则图片扩展名会变成.undefined，导致 Word 无法显示 - generate_docx.js 已内置自动检测逻辑，基于文件扩展名确定类型
行距
- 正文段落和列表项默认使用 1.5 倍行距（
spacing.line: 360） - 标题行距由标题样式控制（
spacing.before: 240, after: 120）
文件排序
- CONFIG 支持
fileOrder数组，指定文件的合并顺序 - 多册模式下，商务文件（06-）应排在技术文件（01-05）之前
注意事项
- 运行前确认
响应文件/目录存在且有 .md 文件 - 确认
docxnpm 包已安装（node_modules/docx） - CONFIG 通过命令行 JSON 参数传入，不要复制或编辑脚本文件
- 如果生成失败，检查控制台错误信息并修复（常见：图片路径错误、特殊字符导致表格解析失败）
- Word 文件被占用时写入会失败（EBUSY 错误）：生成前确保目标 .docx 文件未在 Word 中打开
完成状态
生成完成后，输出以下结构化状态摘要：
--- BID-MD2DOC COMPLETE ---
输出模式: {单册/多册}
输出文件: {文件路径}（多册时逐个列出）
文件大小: {KB}
MD文件数: {N}
图片数: {N}
排除文件: {核对报告.md, 装订指南.md, ...}
状态: SUCCESS
--- END ---
Converted and distributed by TomeVault — claim your Tome and manage your conversions.