MS Office 编辑工具

通过直接操作解压后的 Office XML 来编辑 Word（.docx）和 Excel（.xlsx）文件，支持文本、样式、表格、图片、页眉页脚、工作表和元数据的读取与修改。

运行方式

直接运行，无需安装依赖：

node skill.js <file> <command> [JSON-input] [options]

重要： 请使用文件的绝对路径。

只读命令

写入命令

样式参数（style-apply 使用）

样式修改示例

# 加粗+红色
node skill.js doc.docx style-apply '{"find":"焊接","bold":true,"color":"FF0000"}'

# 改字体+字号
node skill.js doc.docx style-apply '{"find":"标题","fontSize":32,"fontFamily":"黑体"}'

# 添加黄色高亮
node skill.js doc.docx style-apply '{"find":"重要","highlight":"yellow"}'

# 下划线+斜体
node skill.js doc.docx style-apply '{"find":"备注","underline":"single","italic":true}'

# 中英文字体分别设置
node skill.js doc.docx style-apply '{"find":"标题","fontFamily":{"ascii":"Arial","eastAsia":"宋体"}}'

对比命令

比较两个 docx 文档的差异，输出 Markdown 格式报告。

差异报告内容

• 段落差异：LCS 对齐 + 相似度配对检测修改，词级 diff 显示具体变化（删除线 旧 / 加粗 新增）
• 表格差异：逐单元格对比，输出变更位置
• 图片差异：MD5 哈希对比，检测内容变化
• 页眉页脚：文本内容对比
• 元数据：属性值变化对比

diff 示例

# 完整差异报告
node skill.js /path/old.docx diff /path/new.docx

# 仅查看概要统计
node skill.js /path/old.docx diff /path/new.docx --summary

# 报告保存到文件
node skill.js /path/old.docx diff /path/new.docx -o /tmp/diff_report.md

通用选项

输出格式

统一 JSON 输出：{"ok": true, "command": "xxx", "data": {...}}

XLSX 只读命令

XLSX 写入命令

XLSX 样式参数（xlsx-style-apply 使用）

边框参数

简写模式（全边框统一设置）：

{"border": {"style": "thin", "color": "000000"}}

详细模式（各边独立设置）：

{"border": {"top": {"style": "thin", "color": "000000"}, "bottom": {"style": "medium"}}}

边框样式值：thin, medium, thick, dotted, dashed, double, hair, none

对齐参数

{"alignment": {"horizontal": "center", "vertical": "center", "wrapText": true}}

XLSX 使用示例

# 工作簿概览
node skill.js file.xlsx xlsx-info

# 读取第一个工作表的全部数据
node skill.js file.xlsx xlsx-sheet-read 0

# 读取指定单元格
node skill.js file.xlsx xlsx-cell-read 0 B2

# 读取区域
node skill.js file.xlsx xlsx-range-read 0 A1:C5

# 写入单元格
node skill.js file.xlsx xlsx-cell-write 0 A1 "Hello World"
node skill.js file.xlsx xlsx-cell-write 0 B1 100

# 批量写入二维数据
node skill.js file.xlsx xlsx-range-write 0 A1 '[["姓名","年龄"],["张三",25],["李四",30]]'

# 重命名工作表
node skill.js file.xlsx xlsx-sheet-rename 0 "销售数据"

# 修改样式
node skill.js file.xlsx xlsx-style-apply 0 A1 '{"bold":true,"color":"FF0000"}'
node skill.js file.xlsx xlsx-style-apply 0 A1 '{"fontSize":14,"backgroundColor":"FFFF00"}'
node skill.js file.xlsx xlsx-style-apply 0 A1 '{"border":{"style":"thin","color":"000000"}}'
node skill.js file.xlsx xlsx-style-apply 0 A1 '{"alignment":{"horizontal":"center","vertical":"center"}}'
node skill.js file.xlsx xlsx-style-apply 0 A1 '{"bold":true,"fontSize":16,"border":{"style":"thin"},"alignment":{"horizontal":"center"}}'

# 合并/取消合并单元格
node skill.js file.xlsx xlsx-cell-merge 0 A1:D1
node skill.js file.xlsx xlsx-cell-unmerge 0 A1

# 元数据操作（docx/xlsx 通用）
node skill.js file.xlsx meta-read
node skill.js file.xlsx meta-update '{"dc:title":"报表标题"}'

技术说明

• 使用 JSZip 解压/打包 Office 文件（docx/xlsx 本质都是 ZIP）
• 直接操作 XML 字符串，不依赖 XML 解析库
• docx 文本替换：直接在 <w:t> 元素内容上替换，保留原有格式
• docx 样式修改：修改 <w:rPr> 中的格式属性
• xlsx 文本存储：通过 xl/sharedStrings.xml 索引引用
• xlsx 样式系统：集中式 xl/styles.xml + 索引引用
• 括号平衡 XML 提取：替代正则匹配嵌套标签