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 雲端功能（需要憑證）

• 📊 智慧表單 - 表單建立、資料收集
• 📄 智慧文件 - 線上協作文件
• 📊 多維表格 - 檢視管理、欄位管理、高階查詢
• 📊 流程圖 - 流程圖建立和匯出

  小蔥技能站7w4.net，專業的AI技能分享平臺。

• 🧠 思維導圖 - 思維導圖建立和匯出

安裝

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

這個Skill功能豐富、文件詳細，但對常用功能的支援有缺陷。格式轉換功能名不副實，實際無法真正完成PDF等格式轉換。GUI自動化操作存在影響其他視窗的風險，需謹慎使用。適合需要WPS雲端協作功能且有一定技術辨別能力的使用者，不建議依賴其格式轉換功能處理重要文件。