W

WPS Office 自动化

作者:鹿Sir办公效率v3

自动化操作 WPS Office:本地创建 Word/Excel/PPT 文档、打开文件、Markdown 格式转换与批量处理,并支持 WPS 365 云端智能表单、智能文档、多维表格、流程图与思维导图。当用户需要操作 WPS、批量转换文档格式、创建 Office 文档或使用 WPS 365 云端协同时触发。触发词:WPS、WPS Office、文档创建、格式转换、批量转换、智能表单、多维表格。

下载量
264
点赞
66
价格
免费

技能文档

---
name: wps-office
title: WPS Office 自动化
description: 自动化操作 WPS Office:本地创建 Word/Excel/PPT 文档、打开文件、Markdown 格式转换与批量处理,并支持 WPS 365 云端智能表单、智能文档、多维表格、流程图与思维导图。当用户需要操作 WPS、批量转换文档格式、创建 Office 文档或使用 WPS 365 云端协同时触发。触发词:WPS、WPS Office、文档创建、格式转换、批量转换、智能表单、多维表格。
category: 办公效率
---

# WPS Office 自动化

## 简介

WPS Office 自动化操作技能,支持本地文档操作和 WPS 365 云端协作功能。

## ⚠️ 安全警告

### 本地自动化风险
- **GUI 自动化**:本 Skill 使用 `pyautogui` 进行键盘输入模拟,可能会与当前活动窗口交互
- **文件操作**:Skill 会创建、打开和修改文件,请确保在受信任的环境中使用
- **权限要求**:macOS 需要授予辅助功能权限才能使用自动化功能

### 云端凭证安全
- **凭证存储**:WPS 365 功能需要配置 `app_id` 和 `app_secret`,建议:
  - 不要在公共设备或共享环境中配置
  - 定期更换凭证
  - 使用环境变量而非明文配置文件(即将支持)
- **API 调用**:所有 WPS 365 API 调用使用 HTTPS 加密传输

### 建议
- 首次使用建议在沙盒环境或虚拟机中测试
- 审查 `scripts/main.py` 源码确认功能符合预期
- 如不需要 WPS 365 功能,可留空 `app_id` 和 `app_secret`

## 功能特性

### 本地文档操作(无需凭证)
- 📄 **创建文档** - 创建 Word、Excel、PPT 文档
- 📂 **打开文档** - 打开已有文档
- 📋 **文档列表** - 列出文档目录中的文件
- 🔄 **格式转换** - 支持 MD 转 Word/RTF/HTML
- 📦 **批量处理** - 批量转换文档格式

### WPS 365 云端功能(需要凭证)
- 📊 **智能表单** - 表单创建、数据收集
- 📄 **智能文档** - 在线协作文档
- 📊 **多维表格** - 视图管理、字段管理、高级查询
- 📊 **流程图** - 流程图创建和导出
- 🧠 **思维导图** - 思维导图创建和导出

## 技能工作流

### 步骤1:安装依赖

```bash
pip install requests pyautogui pyperclip Pillow
```

### 步骤2:配置技能

编辑 `config.json`:

```json
{
  "default_save_path": "~/Documents/WPS",
  "wps_path": "",
  "app_id": "",
  "app_secret": ""
}
```

### 步骤3:获取 WPS 开放平台凭证(可选)

仅在使用 WPS 365 功能时需要:

1. 访问 https://open.wps.cn
2. 注册开发者账号
3. 创建应用获取 App ID 和 App Secret
4. 将凭证填入 config.json

### 步骤4:执行本地文档操作

```bash
# 创建 Word 文档
python scripts/main.py create type=writer filename=报告.docx

# Markdown 转 Word
python scripts/main.py convert file=文档.md format=docx

# 批量转换
python scripts/main.py batch_convert dir=~/Documents format=pdf
```

### 步骤5:执行 WPS 365 云端操作

```bash
# 智能表单
python scripts/main.py form_list

# 智能文档
python scripts/main.py doc_list

# 多维表格
python scripts/main.py sheet_list
python scripts/main.py sheet_views sheet_id=sheet_001

# 流程图
python scripts/main.py flow_list

# 思维导图
python scripts/main.py mind_list
```

## API 实现说明

### 本地功能实现
- 使用 `subprocess` 调用 WPS Office 应用程序
- 使用 `pyautogui` 模拟键盘输入(创建带内容的文档)
- 文件格式转换使用本地 WPS 引擎或 Python 库

### WPS 365 云端功能实现
- 使用 WPS 开放平台 REST API
- OAuth 2.0 认证流程
- 所有 API 调用使用 HTTPS 加密
- 支持自动 token 刷新

### API 端点
- 认证: `POST /auth/v1/token`
- 表单: `/forms/v1/*`
- 文档: `/docs/v1/*`
- 表格: `/sheets/v1/*`
- 流程图: `/flows/v1/*`
- 思维导图: `/minds/v1/*`

## 故障排除

### 本地功能问题
- **WPS 无法打开**:检查 WPS 是否已安装
- **自动化无响应**:检查 macOS 辅助功能权限
- **格式转换失败**:确保文件格式受支持

### WPS 365 功能问题
- **API 调用失败**:检查 app_id 和 app_secret 是否正确
- **网络超时**:检查网络连接,API 服务器是否可访问
- **权限不足**:检查应用是否有足够的 API 权限

使用说明

# WPS Office 自动化

自动化操作 WPS Office:本地文档创建、打开、格式转换与批量处理,WPS 365 云端协同。

## 使用

对助手说:

```text
帮我把这个 Markdown 转成 Word 文档
```

```text
把 ~/Documents 里的文档批量转成 PDF
```

## 前置条件

- 本机安装 WPS Office;macOS 需授予辅助功能权限
- Python 依赖:`pip install requests pyautogui pyperclip Pillow`
- WPS 365 云端功能需在 config.json 配置开放平台凭证(可选)

## 说明

- 本地功能无需凭证:创建 Word/Excel/PPT、MD 转换、批量处理
- 云端功能支持智能表单、智能文档、多维表格、流程图、思维导图
- 凭证建议用环境变量管理,不要提交到公共仓库

如何安装此技能?

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

浏览技能市场

支持平台:Qoder · QoderWork · Claude · Codex 等 AI 编程助手