# Send Wps Skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "wps-skill",
    "name": "Wps Skill",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/lilei0311/wps-skill",
    "canonicalUrl": "https://clawhub.ai/lilei0311/wps-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/wps-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wps-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "config.json",
      "scripts/excel_converter.py",
      "scripts/image_handler.py",
      "scripts/main.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "wps-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T17:54:04.841Z",
      "expiresAt": "2026-05-08T17:54:04.841Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wps-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wps-skill",
        "contentDisposition": "attachment; filename=\"wps-skill-1.3.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "wps-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/wps-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/wps-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/wps-skill",
    "agentUrl": "https://openagent3.xyz/skills/wps-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/wps-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/wps-skill/agent.md"
  }
}
```
## Documentation

### 简介

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
📦 批量处理 - 批量转换文档格式

### Markdown 转换功能（新增）

📝 MD → Word - 完整 Markdown 转 Word（支持标题、列表、表格、代码块等）
📝 Word → MD - Word 文档导出为 Markdown
📊 MD → Excel - Markdown 转 Excel（表格变工作表，列表变数据）
📊 Excel → MD - Excel 转 Markdown
🎬 MD → PPT - Markdown 转 PPT（标题变幻灯片）
🎬 PPT → MD - PPT 转 Markdown
🖼️ MD 含图片 - Markdown 转 Word 并处理图片

### 图片处理与图文混排（新增）

🖼️ Word 图片插入 - 向 Word 文档插入图片，支持对齐和标题
🖼️ Word 图片网格 - 批量插入图片形成网格布局
📐 Word 图文混排 - 支持左图右文、右图左文、上图下文等布局
🖼️ PPT 图片插入 - 向 PPT 幻灯片插入图片
📐 PPT 图文混排 - PPT 幻灯片图文混排（4种布局）
🖼️ Excel 图片插入 - 向 Excel 单元格插入图片
📐 Excel 图文混排 - Excel 单元格图文混排
🎨 图片处理 - 调整图片尺寸、批量压缩

### 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 功能时需要：

访问 https://open.wps.cn
注册开发者账号
创建应用获取 App ID 和 App Secret
将凭证填入 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

### Markdown 转换功能（新增）

# Markdown 转 Word（完整版）
python3 scripts/main.py md_to_docx file=文档.md output=文档.docx title="我的文档"

# Word 转 Markdown
python3 scripts/main.py docx_to_md file=文档.docx output=文档.md

# Markdown 转 Excel（表格变工作表）
python3 scripts/main.py md_to_xlsx file=数据.md output=数据.xlsx title="销售数据"

# Excel 转 Markdown
python3 scripts/main.py xlsx_to_md file=数据.xlsx output=数据.md

# Markdown 转 PPT（标题变幻灯片）
python3 scripts/main.py md_to_pptx file=汇报.md output=汇报.pptx title="项目汇报"

# PPT 转 Markdown
python3 scripts/main.py pptx_to_md file=汇报.pptx output=汇报.md

# Markdown 转 Word（含图片处理）
python3 scripts/main.py md_with_images_to_docx file=文档.md output=文档.docx image_width=4

### 图片处理与图文混排（新增）

Word 图文混排

# 向 Word 文档插入图片
python3 scripts/main.py insert_image docx=文档.docx image=图片.png width=4 align=center caption="图片标题"

# 插入图片网格
python3 scripts/main.py insert_image_grid images="1.png,2.png,3.png" cols=2 width=3 output=相册.docx

# 创建图文混排布局
python3 scripts/main.py create_text_image_layout text="说明文字" image=图片.png layout=left output=图文.docx

PPT 图文混排（新增）

# 向 PPT 幻灯片插入图片
python3 scripts/main.py insert_image_to_ppt pptx=汇报.pptx slide=1 image=图片.jpg left=1 top=1 width=4

# 创建 PPT 图文混排
python3 scripts/main.py create_ppt_text_image_layout \\
  pptx=汇报.pptx \\
  slide=1 \\
  text="这是说明文字" \\
  image=图片.jpg \\
  layout=left \\
  image_width=4

Excel 图文混排（新增）

# 向 Excel 单元格插入图片
python3 scripts/main.py insert_image_to_excel \\
  xlsx=数据.xlsx \\
  sheet=Sheet1 \\
  cell=A1 \\
  image=图片.jpg \\
  width=100

# 创建 Excel 图文混排
python3 scripts/main.py create_excel_text_image_layout \\
  xlsx=数据.xlsx \\
  sheet=Sheet1 \\
  cell=A1 \\
  text="说明文字" \\
  image=图片.jpg \\
  layout=right \\
  image_width=100

布局方式说明：

layout=left - 图片左，文字右
layout=right - 图片右，文字左
layout=top - 图片上，文字下
layout=bottom - 文字上，图片下

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

### 本地功能实现

使用 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: lilei0311
- Version: 1.3.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T17:54:04.841Z
- Expires at: 2026-05-08T17:54:04.841Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/wps-skill)
- [Send to Agent page](https://openagent3.xyz/skills/wps-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/wps-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/wps-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/wps-skill)