243 个工具全拆解：WPS Skills 工具清单与高频调用套路

2026/11/4 19:16:23

AI 技能
MCP 服务
AI 应用
AI 插件
人工智能

【免费下载链接】wps-skills

WPS Skills | WPS Office 智能助手 | WPS Office AI Assistant

项目地址：https://gitcode.com/gh_mirrors/wp/wps-skills

如果你正在找WPS Skills 工具清单，这篇指南一次讲透：WPS Skills 是一个让 AI 编程助手（Claude Code、Cursor 等）通过自然语言操控 WPS Office 的 MCP 工具集，共提供243 个工具（231 个 MCP 专业工具 + 12 个内置工具），覆盖 Excel、Word、PPT 三大办公场景。下面按"分布 → 分应用拆解 → 高频套路"三步，带你快速建立对整套工具的心智地图。📋

一、WPS Skills 是什么：一句话定位

WPS Skills =MCP Server + Skills 框架：

MCP Server 层：注册 231 个专业工具，AI 通过它下发指令，核心代码在 wps-office-mcp/src/tools/index.ts
Skills 层：用自然语言指导 AI"何时调用哪个工具"，分别位于 skills/wps-excel/SKILL.md、skills/wps-word/SKILL.md、skills/wps-ppt/SKILL.md
执行层：macOS 走 HTTP 轮询插件，Windows 走 COM 接口，最终真正操作你打开的 WPS 文档

💡 你不需要记 243 个工具名——AI 会自己选。你需要理解的是工具分布和套路，这样才能把话说对。

二、243 个工具的分布全景

应用	工具数	主要能力
Excel	82	公式 / 数据清洗 / 图表 / 透视表 / 工作表 / 格式 / 行列 / 批注保护
Word	28	格式 / 内容 / 文档管理 / 页眉页脚 / 模板填写 / 校对
PPT	112	幻灯片 / 形状 / 图片 / 表格 / 美化 / 动画 / 图表 / 3D / 数据可视化
通用	9	保存 / 连接检测 / 文本选取 / 格式转换
内置	12	连接检查 / 万能方法调用 / 数据缓存
合计	243	支持 macOS、Windows、Linux

工具注册总入口在 wps-office-mcp/src/tools/index.ts，内置工具在 wps-office-mcp/src/server/mcp-server.ts 中注册。

三、Excel 82 个工具拆解：公式与数据是主力

Excel 工具按 10 个功能组划分，源码分别位于 wps-office-mcp/src/tools/excel/ 下各文件：

功能组	数量	代表工具（`wps_excel_`前缀省略）
工作表	16	`create_sheet`/`switch_sheet`/`freeze_panes`/`auto_fill`/`auto_sum`
数据	12	`read_range`/`write_range`/`clean_data`/`remove_duplicates`/`sort_range`
格式化	10	`set_cell_format`/`merge_cells`/`set_column_width`/`set_data_validation`
工作簿	10	`open_workbook`/`get_cell_value`/`set_cell_value`/`clear_range`
行列	8	`insert_rows`/`delete_columns`/`group_rows`/`hide_rows`
高级数据	7	`auto_filter`/`fill_series`/`text_to_columns`/`subtotal`
公式	6	`set_formula`/`generate_formula`/`diagnose_formula`/`evaluate_formula`
批注保护	7	`add_comment`/`protect_sheet`/`lock_cells`/`set_array_formula`/`set_hyperlink`
图表	4	`create_chart`/`update_chart`/`export_chart_as_image`
透视表	2	`create_pivot_table`/`update_pivot_table`

记忆口诀：Excel 侧"读数据、算公式、出图表"三件事占了绝大多数工具，日常调用集中在read_range、set_formula、clean_data、create_chart、create_pivot_table这几个上。📊

四、PPT 112 个工具拆解：数量最多，美化是王牌

PPT 是工具数量最多的模块（112 个），源码在 wps-office-mcp/src/tools/ppt/，按 13 个功能组划分：

功能组	数量	代表工具（`wps_ppt_`前缀省略）
幻灯片操作	22	`delete_slide`/`duplicate_slide`/`move_slide`/`add_shape`/`set_background`
演示文稿管理	8	`create_presentation`/`open_presentation`/`set_slide_theme`
高级美化	8	`apply_color_scheme`/`beautify_all_slides`/`create_kpi_cards`/`set_background_gradient`
背景与页面信息	8	`set_slide_number`/`set_ppt_footer`/`set_shape_z_order`
文本框 / 动画切换	7 + 8	`set_textbox_text`/`add_animation`/`set_slide_transition`
图表与流程图	7	`insert_ppt_chart`/`create_flow_chart`/`create_org_chart`/`create_timeline`
数据可视化	7	`create_progress_bar`/`create_gauge`/`create_donut_chart`/`auto_layout`
表格	6	`insert_table`/`set_table_style`/`set_table_row_style`
形状基础 / 杂项	11 + 11	`get_shapes`/`group_shapes`/`set_3d_rotation`/`find_ppt_text`

高级美化能力（KPI 卡片、自动排版、一键美化全部幻灯片）定义在 wps-office-mcp/src/tools/ppt/beautify-advanced.ts，对应的审美规则与配色方案写在 skills/wps-ppt/SKILL.md——它内置了商务、科技、创意三套配色库和对齐/对比/留白原则。✨

五、Word 28 个 + 通用 9 个 + 内置 12 个

Word（28 个），按格式化 / 内容 / 文档管理 / 校对四组划分，源码在 wps-office-mcp/src/tools/word/：

高频四件套：insert_text、find_replace、set_font、generate_toc
模板填写：smart_fill_field（智能识别下划线、冒号、占位符）+replace_bookmark_content，比硬替换更安全
文档管理：get_open_documents、switch_document、insert_header/insert_footer

通用（9 个），跨应用可用，源码在 wps-office-mcp/src/tools/common/：

转换：convert_to_pdf、convert_format
状态与操作：save、save_as、ping、wire_check、get_app_info、get_selected_text、set_selected_text

内置（12 个），注册在 wps-office-mcp/src/server/mcp-server.ts：

类型	工具
连接与状态	`wps_check_connection`/`wps_get_active_document`/`wps_get_active_workbook`/`wps_get_active_presentation`
快捷读写	`wps_insert_text`/`wps_get_cell_value`/`wps_set_cell_value`
万能出口	`wps_execute_method`（可调用任意 WPS 方法，兜底未知操作）
数据缓存	`wps_cache_data`/`wps_get_cached_data`/`wps_list_cache`/`wps_clear_cache`

💡wps_execute_method是"保险丝"：231 个显式工具没覆盖到的操作，AI 可以通过它直接下发 WPS 原生方法。

六、高频调用套路：把话说到 AI 听得懂

理解工具后，真正的技巧在于用自然语言触发正确的工具组合。以下是经过 Skills 工作流验证的四类高频套路：

套路 1：先问上下文，再动手（所有操作的起手式）

AI 的标准流程是：get_sheet_list/get_open_documents/get_slide_count→ 确认目标 → 执行 → 反馈。你只要保证**说清"哪个文件、哪个区域"**即可：

✅ "在'销售表'里，把 A1:F20 整理一下"
❌ "帮我处理下那个表"

套路 2：公式类——描述意图，不要写函数名

Excel Skill 的核心场景。你说"根据产品名称查价格"，AI 会先调用generate_formula读取表头上下文，再生成VLOOKUP/XLOOKUP公式并写入（详见 skills/wps-excel/SKILL.md 的场景示例）。公式报错时直接贴错误值：

"这个公式报 #REF!，帮我看看" → 触发diagnose_formula
"统计北京地区销售额大于 5000 的订单数" → 触发COUNTIFS生成

套路 3：数据清洗——报菜名式打包指令

一次说清所有清洗动作，AI 会用clean_data组合执行：

"把 A1:D100 的重复行删掉，去掉前后空格，空行也删了"
对应操作组合：trim+remove_duplicates+remove_empty_rows

套路 4：PPT 美化——给风格，不给细节

PPT Skill 内置配色方案库，你只需要报风格关键词：

"用商务风配色美化全部幻灯片，标题左对齐" →apply_color_scheme+unify_font+align_objects
"给这页加个淡入动画，页面间加切换效果" →add_animation+set_slide_transition

套路 5：跨应用——先转换，再流转

通用工具convert_to_pdf处理"导出 PDF"；跨应用内容迁移（如 Excel 数据进 Word 表格）由跨应用助手协调，说明写在 skills/wps-office/SKILL.md 的应用识别规则里。🔄

七、快速上手与常见坑

安装验证：按 INSTALL.md 完成npm install && npm run build，先跑wps_check_connection确认链路通了再谈功能
工具返回 null：90% 是 WPS 里没打开对应类型的文档——先打开文件，再下指令
WPS 未响应：重启 WPS，确认加载项已安装（安装后必须重启才生效）
记住优先级：连接类 > 读取类 > 写入类。任何复杂任务，AI 都会先"看"再"写"，你提供准确的文件名和区域范围就是最大的助力

小结：243 个工具看似庞大，实际就是"Excel 管数据、Word 管文档、PPT 管展示、通用管流转、内置管兜底"五层结构。把区域说清、把意图讲白，剩下的交给 AI 自己选工具。🎯