前言¶
在自動化腳本或對話式 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。
