从 JS 宏到 AI Agent：软件工程师的 WPS 自动化实战指南

为什么是 WPS

WPS 不只是办公套件，它的 JS 宏让前端/Node 工程师可以用熟悉的 JavaScript 做自动化。你可以从 WPS官网了解最新版，通过 WPS下载安装。

1. WPS JS 宏基础

WPS JS 宏使用与 VBA 类似的对象模型，但语法是 JavaScript。下面示例把当前工作表数据读成二维数组：

function main() {
  const sheet = Application.ActiveSheet;
  const used = sheet.UsedRange;
  const data = [];
  for (let r = 1; r <= used.Rows.Count; r++) {
    const row = [];
    for (let c = 1; c <= used.Columns.Count; c++) {
      row.push(used.Cells.Item(r, c).Text);
    }
    data.push(row);
  }
  console.log(JSON.stringify(data));
}

这段代码把 UI 操作变成可复用逻辑，是自动化的第一步。

2. 从宏到自动化流水线

一个可落地的流程通常分四层：触发层（按钮、定时、文件事件）、数据层（Range、CSV、API）、逻辑层（清洗、校验、汇总）、Agent 层（AI 决策与工具调用）。工程化建议：宏代码用 Git 管理；配置与代码分离；外部调用加超时、重试、幂等；批量处理时分批执行，避免阻塞 WPS UI。

3. 接入 AI Agent 的模式

常见有三种：宏内直连 LLM（快但密钥风险高）；宏调用本地 Agent 服务（推荐）；宏推送任务到队列，由 Agent 集群消费（适合大规模）。推荐模式中，WPS 只负责采集和展示，Agent 负责鉴权、提示词、工具编排。下面是一个 Node.js Agent 服务示例：

const express = require('express');
const app = express();
app.use(express.json());
app.post('/agent', async (req, res) => {
  const rows = req.body.rows;
  const prompt = '请分析表格并给出清洗建议：' + JSON.stringify(rows);
  // 省略真实 LLM 调用
  res.json({ ok: true, suggestion: '删除空行，统一日期格式' });
});
app.listen(3000, () => console.log('Agent 已启动'));

WPS 宏可以通过 XMLHttpRequest 调用它：

function callAgent() {
  const sheet = Application.ActiveSheet;
  const used = sheet.UsedRange;
  const rows = [];
  for (let r = 1; r <= used.Rows.Count; r++) {
    const row = [];
    for (let c = 1; c <= used.Columns.Count; c++) {
      row.push(used.Cells.Item(r, c).Text);
    }
    rows.push(row);
  }
  const xhr = new XMLHttpRequest();
  xhr.open('POST', 'http://127.0.0.1:3000/agent', false);
  xhr.setRequestHeader('Content-Type', 'application/json');
  xhr.send(JSON.stringify({ rows: rows }));
  if (xhr.status === 200) {
    alert(JSON.parse(xhr.responseText).suggestion);
  } else {
    alert('Agent 调用失败：' + xhr.status);
  }
}