核心用法
WPS Office Skill 是一套面向办公自动化的 Python 技能,提供三大核心能力模块:本地文档操作、Markdown 格式转换、WPS 365 云端协作。
本地操作无需任何凭证,支持 Word/Excel/PPT 的创建、打开、格式批量转换。通过 subprocess 调用本地 WPS 应用,结合 pyautogui 实现键盘输入模拟以填充文档内容。
Markdown 转换是亮点功能,支持 Markdown 与 Office 三件套的双向转换(MD↔Word/Excel/PPT),并原生支持图片处理,可将含图片的 Markdown 一键转为带图文混排的 Word 文档。图片布局支持左图右文、右图左文、上下排列等 4 种模式。
云端功能基于 WPS 开放平台 API,支持智能表单、多维表格、流程图、思维导图等协作场景,需配置 app_id 和 app_secret。
显著优点
1. 格式互通生态完整:少有的同时支持 Markdown→Office 和 Office→Markdown 双向转换的工具,特别适合技术写作与商务汇报的格式桥接
2. 图文混排自动化:内置图片网格、图文布局等高级排版功能,省去手动调整格式的繁琐
3. 本地优先设计:核心功能完全本地运行,无网络依赖,保护敏感文档隐私
4. 批量处理能力:支持目录级批量格式转换,适合文档资产整理场景
潜在局限
1. GUI 自动化依赖:pyautogui 模拟键盘输入需系统辅助功能权限,且可能与用户当前操作窗口产生意外交互
2. 平台兼容性:subprocess 调用方式在 Windows/macOS/Linux 上命令差异较大,跨平台稳定性需验证
3. 云端功能门槛:WPS 365 需注册开发者账号并妥善保管凭证,配置流程对普通用户不够友好
4. T3 来源可信度:社区项目背景,非企业级维护,长期更新保障存疑
适合人群
- 技术博主/开发者:需要将 Markdown 技术文档转为商务格式的场景
- 办公自动化从业者:批量文档处理、模板化报告生成
- 中小型团队:轻量级云端协作需求,不愿承担 Office 365 高昂订阅成本
常规风险
- 权限风险:macOS 需授予辅助功能权限,存在过度授权可能
- 凭证泄露:config.json 明文存储
app_secret,若误提交至版本控制将造成凭证泄露 - 路径遍历:文件路径验证仅依赖
os.path.exists,存在目录遍历攻击风险 - 供应链依赖:依赖 python-docx、openpyxl 等库,需持续关注 CVE 漏洞