WPS Office 全家桶

问题：跨环境的 Office 文档自动化困境

在企业或开发者的日常工作中，编写脚本来自动处理 Word、Excel、PPT 文件是常见需求。然而，这面临一个核心矛盾：目标机器上的办公软件环境各不相同。有的装了 WPS Office，有的只有 Microsoft Office，有的则是 Linux 下的 LibreOffice，甚至可能什么都没装。硬编码特定引擎的调用（如直接操作 WPS COM 接口）会导致脚本在不同环境下频繁失败，维护成本高昂。

如何工作：智能引擎与纯 Python 双轨制

WPS Office 全家桶 技能通过两个关键设计来解决上述问题。

1. 四引擎智能检测与路由

技能启动时，会自动探测宿主机的软件环境，按 WPS -> MS Office -> LibreOffice -> 纯Python 的优先级选择最合适的执行引擎。这意味着：

• 无需配置：开发者无需预先判断或手动指定引擎，技能会自动选择当前可用的最佳方案。
• 能力透明：通过内置的命令（如 python scripts/wps_excel.py engine-info）可以查看当前激活的引擎及其功能矩阵。引擎选择是透明的，开发者可以专注于业务逻辑。
• 优雅降级：如果高优先级引擎（如 WPS）不可用或支持不全，技能会无缝回退到纯 Python 模式（基于 python-docx, openpyxl, python-pptx）来完成大部分核心操作。

2. 覆盖全场景的文档操作与 AI 增强

技能并非简单的格式转换器，它提供了一套完整的文档处理工作流：

• 基础操作：创建、编辑、格式化文档；处理表格、公式、图表；生成幻灯片。
• 高级分析：智能分析 Excel 数据，自动生成图表并嵌入表格；将自然语言公式转换为 Excel 公式（NL2Formula），或解释现有公式的含义。
• 内容生成与增强：基于模板生成周报、月报；从音频转写生成会议纪要；将 Markdown 转换为格式完整的 Word/PPT；支持文档的智能翻译与内容的 AI 续写/改写。
• 可靠性与容错：内置硬件自适应（根据 CPU/内存动态调整超时与并行数）、自动重试机制（WPS 卡住时重试 3 次）、以及详尽的故障排除指南和错误代码（如 E001 到 E015），确保脚本运行的健壮性。

适用边界与关键注意点

尽管功能全面，但在使用前需明确其边界：

• 纯 Python 模式的局限：在无法调用 WPS 或 MS Office 时，纯 Python 模式（如 openpyxl）能处理大多数格式和数据操作，但对 条件格式、数据验证（v4.8 已部分支持）、幻灯片动态添加、VBA 宏 等依赖原生引擎的功能支持有限。
• 文件规模限制：建议单文件大小控制在 50MB 以内，批量处理文件数建议 ≤50个/批。超过时建议进行分片处理（如拆分 Sheet 或章节）。
• 引擎版本要求：如需使用 WPS 引擎，要求 WPS Office 2019+ 或 WPS 365，且安装后必须重启电脑。在 Linux 下使用 LibreOffice 引擎则需提前安装。
• 本地优先：所有处理均在本地完成，不上传数据。但涉及 ASR 或 LLM 的功能（如会议纪要、智能回复）需要用户显式配置后才会调用外部服务，纯本地模式优先。