WPS Office 全家桶

技能文档

---
name: wps-office-suite
title: WPS Office 全家桶
category: 办公效率
description: 跨平台 Office 自动化技能，四引擎（WPS / MS Office / LibreOffice / 纯 Python）智能识别本机已装软件，覆盖 Word/Excel/PPT 的创建、编辑、排版、公式、图表、排序筛选、格式转换与 PDF 导出，并提供合同审查、发票 OCR 入账、会议纪要、文档翻译、周报月报、定时任务等增强能力。当用户要求操作 Word、Excel、PPT、WPS 文档，或需要报表自动化、文档格式转换时触发。
---

# WPS Office 全家桶

> 🏗️ **四引擎智能识别**：自动检测本机已安装软件，按 WPS → MS Office → LibreOffice → 纯Python 顺序选择最合适引擎
> ✨ **纯Python模式增强**：排序、筛选、图表、公式、统计、条件格式、数据验证、合并单元格、命名区域跨平台支持
> 🔄 **自动重试**：WPS 卡住自动重试 3 次；⚡ **硬件自适应**：动态调整超时和线程
> 🧮 **公式解释器**：Excel 公式 → 自然语言解释；📝 **Markdown 转换**：MD → Word/PPT
> 📑 **长文档排版**：目录/编号/图表索引/交叉引用一键处理；🆕 **条件格式/数据验证跨引擎 IO**
> 🎙️ **会议纪要**：音频转写 → 摘要 → Word（三段式要素化 + 说话人标注）
> 🌐 **文档翻译**：Word/Excel/PPT 专业翻译；✉️ **邮件智能回复**；📊 **周报/月报生成**
> ⏰ **定时任务**：schtasks/crontab 注册管理；👁️ **目录监听**：规则表驱动的自动化流水线
> ☁️ **kingdoc 桥接**：上传金山文档与云端差异检查（可选组件，未装自动降级）

## 技能工作流

### 步骤1：环境自检与引擎识别



```bash
python scripts/wps_test.py
```



```bash
python scripts/wps_excel.py engine-info
```



```bash
python scripts/wps_word.py create --title "测试文档"
python scripts/wps_excel.py create --name "预算表" --sheets "收入,支出"
python scripts/wps_ppt.py create --title "推广方案"
```

## ⚡ 硬件自适应

| 硬件等级 | CPU / 内存 | 超时 | 并行数 | 适用场景 |
|---------|-----------|------|-------|---------|
| 高性能 | 8核+ / 16G+ | 30s | 8线程 | 批量处理、大文件 |
| 中等 | 4核+ / 8G+ | 60s | 4线程 | 日常办公 |
| 低性能 | 2核 / 4G | 120s | 1线程 | 轻量任务 |


### 步骤2：创建与编辑文档

```bash
python scripts/wps_word.py create --title "测试文档"
python scripts/wps_excel.py create --name "预算表" --sheets "收入,支出"
python scripts/wps_ppt.py create --title "推广方案"
python scripts/wps_word.py edit --file "report.docx" --text "新增内容"
python scripts/wps_word.py format --file "report.docx" --font "微软雅黑" --size 14 --align center --bold
```

### 步骤3：数据处理与高级功能

```bash
# 公式 / 排序 / 筛选 / 图表 / 统计
python scripts/wps_excel.py formula --file "Sales.xlsx" --sheet "Q1" --cell "C1" --formula "=SUM(A1:B1)"
python scripts/wps_excel.py sort --file "Sales.xlsx" --sheet "Q1" --sorts '[{"column":"Price","ascending":false}]'
python scripts/wps_excel.py chart --file "Sales.xlsx" --sheet "Q1" --type bar --data "A1:B10" --title "销售趋势"

# 自然语言数据分析 / 对话式查询
python scripts/wps_excel.py nl-analyze --file data.xlsx --query "按月份统计销售额并画出趋势图"
python scripts/nl2sql_engine.py query --file data.xlsx --query "按部门分组统计平均工资"

# AI 增强统一入口（合同审查 / 翻译 / 纪要 / 周报等 9 大动作）
python scripts/wps_ai.py --action meeting --file audio.wav --output 纪要.docx
python scripts/wps_ai.py --action contract --file 合同.docx --output 审查版.docx
```

### 步骤4：导出、转换与归档

```bash
python scripts/wps_word.py export --file "report.docx" --format pdf
python scripts/format_converter.py batch --input-dir ./docs --input-format docx --output-format pdf
python templates/generate_templates.py --dir ./output   # 生成代码化文档模板
```

### 步骤5：故障排查与归档

- 出错时先查统一索引表（见 [references/troubleshooting.md](references/troubleshooting.md)），按错误 ID 定位解决方案
- 环境异常运行 `python scripts/wps_test.py` 自检；COM 残留运行 `python scripts/com_health.py release-all`
- 完整 CLI 参数见 [references/cli-reference.md](references/cli-reference.md)，实战案例见 [references/best-practices.md](references/best-practices.md)

---

## 功能矩阵

## 🔧 功能矩阵

| 功能 | WPS | MS Office | LibreOffice | 纯Python |
|------|-----|-----------|-------------|----------|
| **创建/编辑/格式 — Word** | ✅ | ✅ | ✅（回退） | ✅ |
| **表格/图片/目录 — Word** | ✅ | ✅ | ❌ | ✅ |
| **创建/编辑/公式/图表 — Excel** | ✅ | ✅（回退） | ✅（回退） | ✅ |
| **排序/筛选/统计 — Excel** | ✅ | ✅（回退） | ✅（回避） | ✅ |
| **条件格式/数据验证 — Excel** | ✅ | ✅（回退） | ❌ | ✅（v4.8 新增） |
| **幻灯片/主题/插入 — PPT** | ✅ | ❌ | ❌ | ❌ |
| **PPT 创建/多页 — PPT** | ✅ | ✅ | ✅（回退） | ✅ |

> ✅（回退）= 原生引擎不支持时，自动回退到纯 Python 实现


---

## 文件限制速查

## ⚠️ 文件限制速查

| 限制项 | 阈值建议 | 超出后处理方式 |
|--------|---------|--------------|
| **单文件大小** | < 50MB 直接处理 | > 50MB 先分片（拆 Sheet/Section） |
| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |
| **Excel 行数** | < 100,000 行 | 超过时分 Sheet 存储 |
| **PPT 页数** | < 100 页 | 拆分为多个文件 |
| **并发操作** | 同一引擎 1 个实例 | 串行等待，避免并行写同一文件 |
| **文件名长度** | < 200 字符 | 过短路径避免中文 |


---

## 能力边界说明

## ⚠️ 能力边界说明

| 限制项 | 说明 | 解决方案 |
|--------|------|---------|
| **文件大小** | 单文件 < 50MB 直接处理 | 大文件先分片处理（硬件自适应自动延长超时） |
| **批量文件数** | 建议 ≤ 50 个/批 | 超过时分批调用 |
| **复杂度** | 透视表/VBA/ActiveX 不支持 | 使用 pandas 或手动处理 |
| **网络文件** | 不支持 HTTP/URL 下载 | 先手动下载到本地，再调用 Skill |
| **并发限制** | 同一时间只能操作同一引擎的一个实例 | 等待上次操作完成再发起 |
| **中文名文件路径** | 建议改用英文路径 | 路径中避免中文和特殊字符 |
| **实时协作** | 不支持多人同时编辑同一文件 | 通过手动分发和合并 |


---

## 版本兼容矩阵

## 📊 版本兼容矩阵

| Python | WPS Office | LibreOffice | Windows | macOS | Linux | 状态 |
|--------|-----------|-------------|---------|-------|-------|------|
| 3.8+ | 2019+ | - | ✅ | ⚠️ | ❌ | 基础 |
| 3.8+ | 365 | - | ✅ | ✅ | ❌ | 最佳 |
| 3.8+ | - | 7.0+ | ✅ | ✅ | ✅ | 跨平台推荐 |
| 3.8+ | - | - | ✅ | ✅ | ✅ | 纯Python |

> ⚠️ = 部分功能受限（纯Python模式），❌ = 对应引擎不可用

---


## ⚠️ 安全须知

**✅ 五道防线保障安全**：
1. **引擎自检**：启动时自动检测可用引擎，崩溃自动重启
2. **路径校验**：`safe_path()` 全面校验，拒绝非法路径和特殊字符
3. **错误中文化**：所有错误 ID 提供详细中文说明和操作步骤
4. **数据零上传**：所有处理在本地完成，不上传任何内容到互联网
5. **显式 Opt-in**（v4.6.1 引入）：外部服务（ASR/LLM）仅在用户显式指定 method 时调用，auto 模式仅使用本地引擎

**📝 注意事项**：
- 批量操作时，桌面会创建 `WPS_Backup` 文件夹保存副本
- macOS 上 WPS 不支持所有功能
- 纯 Python 模式下格式设置有限，复杂排版建议安装 WPS
- 所有文件操作在本地进行，不会联网
- LibreOffice Headless 模式下不支持实时预览
- 技能 每 7 天自动检查更新，不会频繁打扰
- **模板为纯代码生成，不包含二进制文件，更安全可靠**
- **v4.7 新增公式解释器、MD 转换均为纯本地实现，不读取外部凭证或 API Key**


---

## 参考资料

- 故障排除手册（避坑 20+ 条 / FAQ / 错误 ID 速查）→ [references/troubleshooting.md](references/troubleshooting.md)
- 最佳实践案例（10 个）→ [references/best-practices.md](references/best-practices.md)
- CLI 参数速查 → [references/cli-reference.md](references/cli-reference.md)
- 更新日志 → [references/changelog.md](references/changelog.md)

使用说明

# WPS Office 全家桶

跨平台 Office 自动化技能：四引擎（WPS / MS Office / LibreOffice / 纯 Python）智能识别本机环境，覆盖 Word/Excel/PPT 创建编辑、公式图表、排序筛选、格式转换，以及合同审查、发票入账、会议纪要、文档翻译、周报月报、定时任务等增强能力。

## 使用

```bash
python scripts/wps_test.py                      # 环境自检
python scripts/wps_word.py create --title "测试文档"
python scripts/wps_excel.py create --name "预算表" --sheets "收入,支出"
python scripts/wps_excel.py nl-analyze --file data.xlsx --query "按月份统计销售额并画趋势图"
python scripts/wps_word.py export --file "report.docx" --format pdf
```

## 工作原理

首次运行自动检测本机已装软件并按「WPS → MS Office → LibreOffice → 纯 Python」选择引擎，按 CPU/内存自适应调整超时与并行数；纯 Python 模式基于 python-docx / openpyxl / python-pptx 实现跨平台兜底。所有处理默认在本地完成，外部服务仅在显式指定时调用。故障排查见 references/troubleshooting.md，完整命令见 references/cli-reference.md。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。