前言¶
python-docx 和 openpyxl 能做文档,但有些排版它们给不了:多栏分栏、带文字环绕的浮动文本框、WordArt、带底纹和合并单元格的表格、图表,以及打开后能自动更新的目录和域。这些能力在底层 OOXML 里要么缺失,要么要手写大量 XML,维护成本高。WPSComposer 就是针对这类需求出现的:它通过 WPS Office 的 COM 自动化接口驱动真实排版引擎,让 Agent 直接产出版面精确的文档。下面介绍这个 Skill 的定位、能力和用法。
这是什么¶
WPSComposer 是一个社区来源的 Agent Skill,坐标 @user_54452af8/wpscomposer,当前版本 1.0.0,发布和维护者为 user_54452af8,分类为 office-efficiency。它解决的问题是:当用户要求生成文档,且输出质量依赖真实排版引擎(而不是静态 OOXML 拼装)时,提供可靠的 WPS 操作能力。
按官方简介,它尤其擅长把 Markdown 文件转换成排版精美的 WPS 文档、PPT 和表格。覆盖 WPS Office 三件套:Writer(docx)、Spreadsheets(xlsx)、Presentation(pptx)。
核心功能¶
按官方简介,WPSComposer 的核心能力是通过 WPS Office COM 自动化生成富版面文档,具体包括:
- 多栏分栏布局
- 带文字环绕的浮动文本框
- WordArt(艺术字)
- 带底纹、合并单元格的表格
- 图表
- 打开后可自动更新的目录和域
这些正是 python-docx / openpyxl 无法直接产出的版面特性。Skill 同时覆盖 Writer、Spreadsheets、Presentation 三个应用。
安装与启用¶
官方地址:
https://api.skillhub.cn/user_54452af8/wpscomposer
SkillHub 页面:
https://www.skillhub.cn/skills/user_54452af8/wpscomposer
按 SkillHub 页面信息,当前评分 100000,下载 1466 次,安装 0 次,标签 requires_api_key=false(即不需要 API Key)。需要说明的是,已抓取资料中没有给出 Cursor、Codex CLI、Claude Code 三种工具各自的安装命令差异,也没有 SKILL.md 的本地目录约定,因此这里不展开,实际安装方式以官方页面为准。
典型用法¶
按官方简介,典型用法是把 Markdown 文件交给这个 Skill,转换成排版精美的 WPS 文档、PPT 或表格。触发词包括 “WPS”、”rich layout document”、”排版文档”、”用 WPS 生成”,或者当输出质量需要真实排版引擎而非静态 OOXML 时使用。
需要注意,已抓取资料中没有包含 SKILL.md 的详细调用示例和参数说明,因此这里不杜撰命令或配置字段。要复现完整流程,请打开官方地址查阅源码。
适用场景与注意¶
适合的场景:
- 需要 python-docx / openpyxl 做不到的版面效果(分栏、浮动文本框环绕、WordArt、复杂表格底纹、图表、自动更新目录和域)
- 从 Markdown 批量产出版式精美的 WPS 文档、PPT、表格
- 需要真实排版引擎兜底的文档生成任务
需要注意的限制:
- 依赖本机安装的 WPS Office,并通过 COM 自动化调用,环境里必须可用
- 当前版本 1.0.0,属社区来源(community),安装量为 0,使用前建议先在测试文档上验证版面
- 详细参数和调用方式以官方源码为准,本文未覆盖部分不猜测
结尾¶
WPSComposer 的价值在于把「真实排版引擎」这条路径补上:当静态 OOXML 生成方式触到天花板时,它通过 WPS Office COM 自动化给出可落地的替代方案,覆盖 Word、Excel、PPT 三种文档。官方地址:
https://api.skillhub.cn/user_54452af8/wpscomposer