WPS 多维表格 + AI Skill:从写脚本到跑通测试,一条命令搞定

写在前面


大家好,我是 WPS 多维表格的深度用户。在过去几个月里,我用 WPS 多维表格搭了不少内部业务系统,从活动报名审核到图片批量处理,基本上把 AirScript 的各种玩法都踩了一遍。

踩的坑多了,我就琢磨一件事:能不能让 AI 直接帮我把脚本写好、推到线上、跑一遍验证、不对就自动改——全程不用我手动操作 WPS 网页界面?

折腾了一段时间,还真让我搞出来了。我把整套经验沉淀成了一套 WPS 多维表格 AI Skill,今天分享给大家。

另外提一句:基于同样的思路,飞书多维表格我也做了对应的一套 Skill,同样硬核,感兴趣的朋友也可以关注一下。本文聚焦 WPS。

问题在哪:官方界面的开发体验


用过 WPS 多维表格 AirScript 的朋友应该都清楚官方的标准开发流程:

  1. 打开 WPS 网页版 → 进入多维表格 → 点开脚本编辑器

  1. 在编辑器里手写代码(或者从别处复制粘贴进来)

  1. 点运行 → 看报错 → 改代码 → 再运行 → 再看结果

  1. 如果想调 webhook,还得配脚本令牌 → 用 Postman 或 curl 发请求 → 看返回 → 回编辑器改代码

每一步都在"切换界面"和"手动操作"之间反复横跳。

特别是当你在调试一个复杂脚本的时候——筛选条件写错了、字段名没加 @、返回值结构不统一——每次改完都要手动粘贴、手动点运行、手动看结果。一轮调试下来 5-10 分钟算快的,搞不好半个小时就过去了。

我的方案:AI 写 → AI 推 → AI 跑 → AI 看结果 → AI 改,全自动闭环


这套 Skill 的核心思路是:让 AI 直接在 WPS 的开发环境里作业,而不是只在对话框里给你一段代码然后说"你去试试"。

具体怎么做到的?

黑科技核心:浏览器登录态复用

先说一个官方 API 的限制:AirScript-Token 只能执行脚本(通过 webhook 调 sync_task),不能管理脚本。也就是说,脚本的创建、修改、删除、列表查看——这些"管理"操作,官方没给接口。

那代码写完怎么灌进 WPS?答案是——通过浏览器登录态。

我用 PowerShell 驱动本机 Edge 浏览器,启动时复用你已经在浏览器里登录好的 WPS 会话。然后通过浏览器页面内的 fetch() 直接调用 WPS 的脚本管理接口。这套接口普通 AirScript-Token 访问不了,但浏览器登录态可以。

整套流程是这样的:

AI 生成代码
    ↓
一条 PowerShell 命令,把代码推送到云端脚本编辑器(不需要你复制粘贴)
    ↓
自动触发脚本运行 → 表格数据即时变化
    ↓
AI 读到运行结果,判断对不对
    ↓
不对?自动改代码 → 重新推 → 重新跑(闭环迭代)
    ↓
几轮下来,一个经过充分验证的可用版本就固化了

对比传统方式,差距有多大?

环节

传统官方界面方式

Skill 浏览器自动化

写代码

AI 生成 → 你复制

AI 生成

部署到 WPS

手动打开脚本编辑器 → 粘贴

AI 一条命令推送

运行测试

手动点击"运行"

AI 自动触发

查看结果

切回表格肉眼检查

AI 自动读返回值,自动判断

改代码迭代

切回 AI → 改代码 → 再手动粘贴

AI 自动改 → 自动推 → 自动跑

一轮迭代耗时

5-10 分钟

10-30 秒

同样的需求,传统方式来回折腾一小时;这套方案,几分钟出成品。

不只是"推送",而是"验证完才交付"


这套 Skill 还有一个很重要的设计原则:不能只给代码不做验证。

市面很多 AI 工具的交付方式是这样的——你问,它给你扔一段代码,然后说"可以直接用"。至于代码在真实 WPS 环境里跑不跑得通、字段名对不对、返回结构是不是和预期一致……它不管。

我在这套 Skill 里强制规定了交付标准:

  • 先判断运行模型:AirScript 还是 SDK?1.0 还是 2.0?智能表格还是独立表格?走错路线代码白写

  • 执行前提醒备份:要操作真实在线文档时,先提醒用户备份数据和现有脚本

  • 最小可用验证:不只在脑子里验证,必须在目标文件上实际跑通

  • 验证结果的记录:用了哪个文件、执行了什么动作、结果怎样,一律记录交付

  • 未实测必须标注:如果因为权限、登录态等原因无法实测,交付时必须明确说"未在目标文件上实测"

简单粗暴地说:只要是在 Skill 管控下生成的脚本,一定是跑通了的;没跑通的,AI 自己会说你没跑通。

脚本模板库:把常见需求"填空题化"


另一个让我觉得非常爽的设计,是这整套 Skill 里沉淀了大量开箱即用的脚本模板

你不用每次都从零写代码,AI 读 Skill 后会从模板库里挑最接近你需求的骨架,然后把表名、字段名填进去,再补上你的业务规则——像做填空题一样简单。

目前的模板覆盖了这些场景:

场景

模板说明

CRUD 全套

单条/批量查询、新增、更新、删除,带字段映射和统一返回结构

批量插入

矩阵写入模式,性能比逐条插入快几十倍,支持 2000 行一批

webhook 服务骨架

40 行代码提供参数校验、表定位、字段更新、错误处理、标准返回

附件字段处理

读取附件 URL、回写处理结果、一对多展开附件

多表联动

主表 + 明细表同步更新状态、聚合附件、关联查询

规则校验

预约名额限制、重复提交检查、周次数上限,带自动清空表单

外部 API 集成

脚本主动调外部 HTTP 服务(天气、地图、AI),结果落表

字段映射驱动

外部 JSON 字段名和表内字段名不一致时,用映射表自动转换

每份模板都有一套通用 helper 函数:参数校验 requireValue、字段名规范 ensureFieldName、筛选条件构造 buildAndFilters、附件标准化 normalizeAttachments、统一返回 ok / fail…… AI 直接复用这些骨架,业务逻辑只改顶上那几行配置,不容易出错。

批量插入性能:写出"能用"和写出"高效"是两码事


有一个细节我觉得特别值得单独说——批量插入的性能。

很多人(包括很多 AI)写批量插入的代码,会本能地写成一个循环:每来一条数据就 RecordRange.Add(null, null, 1) 一次。

这么写在数据量小的时候看不出问题,但一旦数据量上到几百条,性能直接崩掉。因为每条记录都在重复做"创建范围 + 字段写入"的动作。

这套 Skill 里的模板,用的是矩阵写入模式

// 一次性 Add 所有行,然后矩阵一次性赋值const range = sheet.RecordRange.Add(null, null, rows.length);
range.Item(undefined, fieldNames).Value = values;  // 二维数组,一次性写入

简单对比一下:

方案

10 条

200 条

2000 条

逐条插入

勉强能跑

明显变慢

基本不可用

矩阵写入

秒级

秒级

按批次分段,依然可控

Skill 里还做了超大批量的切片策略:默认 2000 行一批,带附件/图片的重字段降到 200-1000 行,先小批验证再放大批次。这些都是真实业务跑出来的经验,不是拍脑袋的。

这套 Skill 能做什么,不能做什么


说清楚边界,不吹牛:

适合做的事:

  • 外部系统通过 webhook 自动往 WPS 表格写数据、查数据、更新数据

  • 表格内部按钮触发自动化处理(筛选、汇总、附件处理)

  • 定时任务批量处理表格数据

  • AI 回写:调大模型分析表格内容,结果自动落表

  • 多表联动:主表改了一条,明细表/汇总表自动同步

  • 表单收集 + 自动校验 + 自动入库

  • 从零搭建一个完整的业务数据管理流程

不适合做的事:

  • 公网零配置给陌生人一键使用(依赖本机浏览器登录态)

  • 跨平台(macOS/Linux 目前没测过)

  • 高并发实时 OLTP 场景(多维表格定位是协作工具,不是 Redis)

但说实话,对于 90% 的内部业务系统需求来说,够了。

免费分享,且用且珍惜


这套 Skill 凝结了我过去几个月所有实战经验——从踩坑到优化,从 webhook 到浏览器自动化,从批量性能到字段映射,基本上把我能想到的都放进去了。

全网你找不到第二份这么完整的 WPS 多维表格 AI Skill。

下了很大决心免费开放出来。如果你也是 WPS 多维表格的重度用户,或者正在用多维表格搭内部业务系统,希望这套 Skill 能帮你省下大量调试和踩坑的时间。

有问题欢迎在帖子里交流,我看到都会回复。


附:飞书多维表格我也同步做了一套对应 Skill,同样是全套接口 + 自动化插件 + 附件处理 + 双模式鉴权,硬核程度不输这套。感兴趣的朋友也可以关注。

【金山文档 | WPS云文档】 Excel催化剂AI编程SKILL技能大集合

https://www.kdocs.cn/l/cqJ3rEKaR9q5

WPS二次开发相关
@WPS催化剂-李伟坚
广东省
浏览 138
5
9
分享
9 +1
2
5 +1
全部评论 2
 
快乐小子新
快乐小子新 Lv.2 潜力创作者

Lv.2潜力创作者

比金山文档官方技能要更好。
· 广东省
1
回复
 
马成功老师
马成功老师 WPS资深用户Lv.2 潜力创作者KVPWPS函数专家

Lv.2潜力创作者

先收藏一下大作,回头细看
·
1
回复