cli-anything-wps

通过 COM 自动化接口操控 WPS Office 的命令行工具。支持 WPS 文字（Writer）、WPS 表格（Calc）和 WPS 演示（Impress）。

前置条件

• Windows 操作系统
• WPS Office（已安装，版本 12.0+）
• Python 3.10+
• pywin32：pip install pywin32

安装

pip install -e .
cli-anything-wps --help

JSON 数据驱动 PPT 自动生成 ⭐ 生产环境核心工作流

这是最常用的模式：搜数据 → 生成 matplotlib 图表 → 写 JSON → WPS COM 一键生成。

完整流程（6步）

1. 提取模板背景: 模版.pptx → template_bg.png (960x540)
2. WebSearch 搜索数据: 招生分数线/学科排名/招生计划/科研数据
3. matplotlib 生成图表: 柱状图/饼图/折线图/横向柱/气泡图
4. 编写 data.json: 12-15页 elements[] 编排（标题≤4字 + 间距≥24pt）
5. python build_xxx.py: WPS COM 逐页构建
6. 输出: PPTX + PDF 双格式

标准页序

S1 封面 → S2 目录 → S3-S10 内容页(图+表+卡片) → S11 总结卡片 → S12 致谢

元素类型路由

关键约束 ⚠️

• 标题与内容间距：标题 y=14 h=40(结束于y≈54)，第一个内容元素必须起始于 y≥76-78(≥24pt gap)
• 标题最多4字，居中，SimHei 40-44pt，品牌色，无装饰线
• JSON中文引号：文本内引用用「」代替 ""
• 所有元素不出画布：960×540，y+h≤518
• WPS COM：Fill.ForeColor.RGB，SaveAs(path, 32)导出PDF
• 执行前清理：taskkill //F //IM wps.exe //T

参考案例

WPS/ 目录下16个项目：

# 完整执行示例
python -c "import zipfile; ..."  # 提取模板
python gen_charts.py              # 生成图表
python -c "import json; json.load(open('data.json','r',encoding='utf-8'))"  # 验证JSON
taskkill //F //IM wps.exe //T
python build_xxx.py               # 构建PPTX+PDF

CLI 命令结构

wps
├── document          # 文档管理: new/open/save/info
├── writer            # 文字: add-paragraph/heading/list/table/image
├── calc              # 表格: set-cell/get-cell/set-range/merge-cells
├── impress           # 演示: add-slide/remove-slide/set-content/add-element
├── style             # 样式: create/modify/list/apply/remove
├── preset            # 设计预设: list/info/apply
├── export            # 导出: render output.pptx -p pptx
└── session           # 会话: status/undo/redo/history

使用示例

# 创建文档
cli-anything-wps document new --type writer --name "报告" -o report.json
cli-anything-wps --project report.json writer add-heading -t "年度报告" -l 1
cli-anything-wps --project report.json export render report.docx -p docx

# JSON模式（Agent使用）
cli-anything-wps --json document new --type writer --name "test"

设计预设

质量审查（5维度）