Bid Md2doc

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 文件
• 确认 docx npm 包已安装（node_modules/docx）
• CONFIG 通过命令行 JSON 参数传入，不要复制或编辑脚本文件
• 如果生成失败，检查控制台错误信息并修复（常见：图片路径错误、特殊字符导致表格解析失败）
• Word 文件被占用时写入会失败（EBUSY 错误）：生成前确保目标 .docx 文件未在 Word 中打开

完成状态

生成完成后，输出以下结构化状态摘要：

--- BID-MD2DOC COMPLETE ---
输出模式: {单册/多册}
输出文件: {文件路径}（多册时逐个列出）
文件大小: {KB}
MD文件数: {N}
图片数: {N}
排除文件: {核对报告.md, 装订指南.md, ...}
状态: SUCCESS
--- END ---

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: youyouhe
• Source: youyouhe/bidsmart-claude-skills
• License: MIT

Install and usage instructions live in the source repository linked above.