Wps Skill

WPS Office Skill

简介

WPS Office 自动化操作 Skill，支持本地文档操作和 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. 安装依赖

pip install requests pyautogui pyperclip Pillow

2. 配置 Skill

编辑 config.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

使用方法

本地文档操作

# 创建 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

WPS 365 云端功能

# 智能表单
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 权限

版本信息

版本: 1.0.0

作者: MaxStorm Team

许可证: MIT

源码: https://github.com/maxstorm/wps-skill