Office 文档处理

本技能适用于 .docx、.xlsx 和 .pptx 文件。请首先识别文件类型，其次检查所需依赖项，最后决定是新建文件还是修改已有文件。

首要遵循规则

1. 先确认目标格式：Word 使用 python-docx，Excel 使用 openpyxl，PowerPoint 使用 python-pptx。
2. 检查所需依赖是否可成功导入。若缺失任一依赖，请明确告知用户具体缺少哪个包。禁止自动执行 pip、pip3、python -m pip、sudo 或其他类似安装命令。
3. 编辑已有文件时，默认保留原始文件，并将结果另存为新文件；仅当用户明确要求时，才覆盖原文件。
4. 优先进行结构化编辑，再做视觉层面的精细调整。避免在初期编写大量低价值的格式化代码。
5. 仅在需要高级 API 功能时，才打开 references/ 目录中对应的文档；切勿一次性将所有参考文件加载进上下文。

依赖层级

核心依赖

• python-docx：用于 Word 文档。
• openpyxl：用于 Excel 工作簿。
• python-pptx：用于 PowerPoint 演示文稿。

可选依赖

• pandas：仅在 DataFrame 与 Excel 互转时需要。
• pillow：仅在向 Excel 插入图像时需要。

检查依赖项

使用只读式导入检查（如下所示）。若检查失败，请立即中止实现，并直接报告缺失的包名。

import importlib

PACKAGE_MAP = {
    "docx": "python-docx",
    "openpyxl": "openpyxl",
    "pptx": "python-pptx",
    "pandas": "pandas",
    "PIL": "pillow",
}

missing = []
for module_name, package_name in PACKAGE_MAP.items():
    try:
        importlib.import_module(module_name)
    except ModuleNotFoundError:
        missing.append(package_name)

print(missing)

根据任务类型选择需检查的依赖项：

• .docx 类任务：检查 docx
• .xlsx 类任务：检查 openpyxl
• .pptx 类任务：检查 pptx
• 涉及 DataFrame 的 Excel 任务：还需检查 pandas
• 涉及图像的 Excel 任务：还需检查 PIL

处理 Word 文档

对 .docx 文件使用 python-docx。

新建文件

from docx import Document

document = Document()
document.add_heading("Document Title", level=1)
document.add_paragraph("This is a paragraph.")
document.save("new_doc.docx")

修改已有文件

from docx import Document

document = Document("existing_doc.docx")
document.add_paragraph("Appended content")
document.save("updated_doc.docx")

请优先阅读以下资源

• 核心 API 概览：{baseDir}/references/docx_api_summary.md
• 新建示例：{baseDir}/scripts/create_basic_doc.py
• 编辑示例：{baseDir}/scripts/edit_existing_doc.py

处理 Excel 工作簿

对 .xlsx 文件使用 openpyxl。

新建文件

from openpyxl import Workbook

wb = Workbook()
ws = wb.active
ws.title = "Data"
ws["A1"] = "Hello"
ws.append(["Data 1", "Data 2", "Data 3"])
wb.save("new_workbook.xlsx")

修改已有文件

from openpyxl import load_workbook

wb = load_workbook("existing_workbook.xlsx")
ws = wb["Sheet1"]
ws["A1"] = "Updated value"
wb.save("updated_workbook.xlsx")

请优先阅读以下资源

• 新建示例：{baseDir}/scripts/create_basic_workbook.py
• 图表指南：{baseDir}/references/xlsx_charts.md
• 高级功能说明：{baseDir}/references/xlsx_features.md
• DataFrame 集成说明：{baseDir}/references/xlsx_pandas.md

处理 PowerPoint 演示文稿

对 .pptx 文件使用 python-pptx。

新建文件

from pptx import Presentation

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[1])
slide.shapes.title.text = "Slide Title"
slide.placeholders[1].text = "This is the content placeholder."
prs.save("new_presentation.pptx")

修改已有文件

from pptx import Presentation

prs = Presentation("existing_presentation.pptx")
slide = prs.slides.add_slide(prs.slide_layouts[1])
slide.shapes.title.text = "New Slide"
slide.placeholders[1].text = "Additional content"
prs.save("updated_presentation.pptx")

请优先阅读以下资源

• API 快速参考：{baseDir}/references/pptx_api_reference.md
• 图表指南：{baseDir}/references/pptx_chart_guide.md
• 完整示例：{baseDir}/scripts/create_presentation.py

资源选取规则

• 仅需基础 Word 文件创建：从 {baseDir}/scripts/create_basic_doc.py 开始
• 修改已有 Word 文件：从 {baseDir}/scripts/edit_existing_doc.py 开始
• 仅需基础 Excel 文件创建：从 {baseDir}/scripts/create_basic_workbook.py 开始
• 涉及 Excel 图表或条件格式：先阅读 {baseDir}/references/xlsx_charts.md 或 {baseDir}/references/xlsx_features.md
• 涉及 DataFrame、CSV 转 Excel 或工作表分析：先确认 pandas 可用，再阅读 {baseDir}/references/xlsx_pandas.md
• 仅需基础 PowerPoint 生成：从 {baseDir}/scripts/create_presentation.py 开始
• 涉及 PowerPoint 图表：先阅读 {baseDir}/references/pptx_chart_guide.md

输出规则

• 始终保存至明确的目标文件名，不可仅将变更保留在内存中。
• 若用户未提供文件名，请使用清晰的默认名称，例如 report.docx、budget.xlsx 或 deck.pptx。
• 对已有文件进行编辑时，默认采用 updated_*.ext 格式命名，以防意外覆盖原文件。