kpdfcli — WPS PDF命令行工具介绍
Lv.2潜力创作者
概述
在最新版WPS客户端的安装路径下，我们可以看到有一个wpscli文件，这是 WPS Office 提供的命令行工具。
运行路径：D:\WPS\12.1.0.27301\clitool\wpscli.exe
wpscli目前只支持kpdfcli，首次启动时会自动安装kpdfcli。
安装位置位于C:\Users\用户名\AppData\Roaming\Kingsoft\wps\addons\pool\win-x64\kpdfcli_3.1.0.227：
用户通过 wpscli.exe 在终端输入命令，kwpscliimpl.dll 负责解析参数、映射到对应子命令，kpdfcli.dll 执行实际的 PDF 文档转换、拆分、合并、水印、加密等操作。
调用格式
wpscli [--version] [--help] <subcommand> [<args>] [--json]--json — 启用 JSON 格式输出（默认纯文本）
--version — 查看版本
所有子命令均可通过 wpscli <subcommand> --help 查看具体参数说明
文档格式转换
子命令 | 功能说明 |
pdf2word | PDF 转 Word 文档 |
pdf2excel | PDF 转 Excel 电子表格 |
pdf2ppt | PDF 转 PowerPoint 演示文稿 |
pdf2md | PDF 转 Markdown |
pdf2txt | PDF 转纯文本 |
pdf2imgpdf | PDF 转为基于图像（栅格化）的 PDF |
pdf2cad | PDF 转 CAD 绘图（压缩包） |
pdf2photo | PDF 页面转图片文件 |
word2pdf | Word 文档转 PDF |
excel2pdf | Excel 电子表格转 PDF |
ppt2pdf | PowerPoint 演示文稿转 PDF |
txt2pdf | 纯文本转 PDF |
photo2pdf | 图片文件转 PDF |
cad2pdf | CAD 绘图转 PDF |
caj2pdf | CAJ 文档转 PDF |
PDF 页面与大小操作
子命令 | 功能说明 |
pdfsplit | 按页范围拆分 PDF |
pdfmerge | 合并多个 PDF 为一个 |
pdfcompress | 压缩 PDF 文件大小 |
PDF 元数据读取
子命令 | 功能说明 |
pdfinfo | 输出紧凑 JSON 行（含页数和扫描提示），用于脚本和自动化 |
PDF 保护与水印
子命令 | 功能说明 |
pdfwatermark | 为 PDF 添加水印 |
pdfremovewatermark | 移除 PDF 水印 |
pdfencrypt | 使用密码和权限加密 PDF |
安装与配置
子命令 | 功能说明 |
install | 自动检测本地 Agent 目录，将wpscli技能复制到相应的Skill目录（默认覆盖已有技能文件） |
技能的原始路径位于"C:\Users\用户名\AppData\Roaming\Kingsoft\wps\addons\pool\win-x64\kpdfcli_3.1.0.227\resources\SKILL.md"，用户可以将技能复制到WPS灵犀的技能目录中并上传。
其他命令
子命令 | 功能说明 |
feedback | 在默认浏览器中打开服务中心反馈页面 |
version | 打印 wpscli 版本（也支持 wpscli -v、wpscli --version） |
WPS客户端在安装时会自动配置环境变量：
注意检查一下变量值是否准确，因为WPS客户端更新时可能会未更新环境变量。
同时，打开 系统环境变量 → 编辑 Path 变量，添加D:\WPS\12.1.0.27301\clitool，或者将原路径更新为新路径，保存后重启终端，即可直接使用 wpscli 命令。
变量配置准确之后，用户可通过终端调用，集成到自动化脚本和批处理流程中。
wpscli 帮助信息，顶层命令列表详见"C:\Users\用户名\AppData\Roaming\Kingsoft\wps\addons\pool\win-x64\kpdfcli_3.1.0.227\resources\wpscli_help.json"。
kpdfcli 帮助信息，完整的子命令参数说明详见"C:\Users\用户名\AppData\Roaming\Kingsoft\wps\addons\pool\win-x64\kpdfcli_3.1.0.227\resources\kpdfcli_help.json"。
