核心用法
office-editor 是一个专用于处理 Microsoft Office 格式文档的技能，支持 .docx（Word）、.xlsx（Excel）和 .pptx（PowerPoint）三类文件的创建、读取与修改操作。该技能通过三大核心 Python 库实现功能：python-docx 处理 Word 文档，openpyxl 操作 Excel 工作簿，python-pptx 生成与编辑 PowerPoint 演示文稿。
使用流程遵循严格的依赖检查机制：在执行任何操作前，技能会先验证所需库是否已安装，若发现缺失则直接报告，绝不自动执行 pip 安装，避免环境污染和权限风险。对于现有文件的编辑，默认采用"另存为"策略（如 updated_*.ext），仅在用户明确要求时才覆盖原文件，有效防止数据意外丢失。
显著优点
- 格式覆盖全面：一站式解决三大主流 Office 格式的程序化操作需求
- 安全保守设计：强制依赖检查 + 禁止自动安装，降低环境破坏风险
- 数据保护机制：编辑时默认保留原件，防止误操作导致文件损坏
- 结构化工作流：要求先完成内容架构再细化样式，提升代码可维护性
- 资源分级加载：按需引用参考文档，避免一次性加载过多上下文
潜在缺点与局限性
- 依赖管理负担：用户需自行确保
python-docx、openpyxl、python-pptx等库已安装 - 高级功能受限：复杂排版、宏、VBA、嵌入式对象等高级特性支持有限
- 模板依赖：PowerPoint 操作高度依赖幻灯片版式（slide_layouts），灵活性受限
- 图像处理短板：Excel 插入图片需额外
pillow依赖，且功能相对基础 - 无实时预览：纯代码操作，无法可视化调整，调试成本较高
适合人群
- 需要批量生成标准化报告、合同、数据表的自动化办公场景
- 数据分析师将 DataFrame 结果导出为格式化 Excel 的工作流
- 开发者构建文档生成流水线，替代手动复制粘贴的重复劳动
- 对代码可控性要求高、不愿接受自动安装风险的技术用户
常规风险
- 依赖版本冲突：三大核心库与 pandas、pillow 等扩展库可能存在版本兼容问题
- 格式兼容性：生成的文件可能在不同 Office 版本或 WPS 中呈现细微差异
- 资源路径错误：
{baseDir}/references/等路径若配置不当会导致参考文档加载失败 - 内存占用：大型 Excel 文件或图片密集型 PPT 可能引发内存压力