前言¶
在自动化脚本或对话式 Agent 里处理 PDF、Office、CAD 互转时，常见做法是本地装一堆转换库、自己维护依赖，或把文件上传到第三方在线转换站。前者环境重、格式边界难兜；后者又涉及合规与密钥管理。若你希望转换能力来自 WPS Office 官方、又能通过 Skill 交给模型按步骤执行，可以了解 SkillHub 上的 WPS CLI（坐标 @wps/wpscli，当前版本 1.0.4）。
这是什么¶
WPS CLI 是珠海金山办公软件有限公司在 SkillHub 发布的 enterprise 来源 Skill，分类为 office-efficiency。它面向「多格式文档转换与 PDF 常用操作」：在 Agent 读取 SKILL.md 后，可按技能说明发起 PDF 与 Word/PPT/Excel/CAD/图片/HTML 等格式之间的转换，以及拆分、合并、加解密、压缩、增删页等 PDF 处理（具体命令与参数以安装包内技能文档为准）。
官方资源地址：
- Skill 元数据：
https://api.skillhub.cn/wps/wpscli - SkillHub 展示页：
https://www.skillhub.cn/skills/wps/wpscli
核心功能¶
以下能力均来自 SkillHub 页面与预抓取简介，为同一套官方描述中的已列出项：
由 PDF 转出或处理
- PDF 转 Word、PPT、Excel、CAD、图片、HTML
- PDF 拆分、合并、加密、解密、压缩
- 删除 PDF 页、插入 PDF 页
由其他格式生成 PDF 或互转
- Word、Excel、PPT、图片、CAD 转 PDF
- CAD 转图片
技能标签标明 requires_api_key=true：使用前需要按技能文档配置 WPS 相关 API 密钥，未配置时转换类步骤通常无法完成。
安装与启用¶
下面介绍通过 SkillHub CLI 安装到当前 Agent 可识别的 skills 目录。若本机尚未安装 skillhub，可先按官方安装说明检查或安装 CLI。
1、确认是否已安装 SkillHub CLI
command -v skillhub && skillhub --version
2、未安装时安装 CLI（完整安装或仅 CLI）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
3、将 WPS CLI 装到当前环境的 skills 目录
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在对应目录已确定的前提下执行（包名以 SkillHub 坐标为准）：
skillhub install @wps/wpscli --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 替换为你实际使用的 Agent skills 路径。安装后按各客户端要求重启或刷新技能列表，使 @wps/wpscli 生效。
4、通过对话让 Agent 安装（SkillHub 页面提供的提示）
也可将下列意图发给支持 Skill 的 Agent，由其按 https://skillhub.cn/install/skillhub.md 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@wps/wpscli`。
典型用法¶
公开页面未提供可逐条复制的转换命令示例；典型流程是：先完成安装与 API Key 配置（字段名与获取方式见安装后的 SKILL.md），再在对话中说明源文件路径、目标格式与操作类型（例如「将某 PDF 转为 Word」或「合并两个 PDF」），由 Agent 按技能文档调用 WPS 官方转换能力。
建议在同一轮对话中写清：
- 输入文件路径与是否存在多文件（合并、拆分场景）。
- 目标格式或 PDF 操作类型（与上文核心功能列表一致）。
- 输出路径或命名约定。
避免在未核对技能文档的情况下臆造 CLI 子命令或环境变量名。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 SkillHub 技能的客户端，且文档处理以 WPS 生态为准的团队。
- 希望把「格式转换 + PDF 维护」收敛到官方能力、由 Agent 编排步骤，而不是自建转换链路的场景。
需要注意
- API Key：标签
requires_api_key=true，部署前确认密钥来源、权限与留存策略符合企业要求。 - 版本：SkillHub 展示为 v1.0.4；升级可用
skillhub对@wps/wpscli做更新，并再次确认SKILL.md是否有变更。 - 数据与合规：enterprise 来源技能，处理敏感文档前应确认调用方式是否满足内网或出境策略。
- 统计信息：SkillHub 预抓取元数据中评分为 100000，下载约 7099（页面展示可能与统计刷新时间有关，以 SkillHub 为准）。
结尾¶
WPS CLI 把金山官方的 PDF 与多格式转换、PDF 常用编辑能力封装成 Agent Skill，适合在 office-efficiency 类工作流里减少自建转换栈。安装入口与坐标见 SkillHub：https://www.skillhub.cn/skills/wps/wpscli，元数据地址：https://api.skillhub.cn/wps/wpscli。
