claude-wps-excel

Claude for WPS Excel 插件

WPS Office Excel AI 助手——通过自然语言对话操控表格，由 Claude API 驱动。

功能特性

• 自然语言对话：直接用中文描述需求，AI 自动生成并执行 WPS JS 代码
• 三种交互模式：Agent（自动执行）/ Plan（步骤规划）/ Ask（只读分析）
• 实时上下文感知：自动读取当前工作表、选区数据，智能匹配 Skill
• 代码执行桥：生成的代码可一键在 WPS 中执行，支持结果回传 + 一键修复
• 流式响应：SSE 流式输出，Markdown 渲染 + 代码块语法高亮
• 会话历史：自动保存对话记录，支持多会话切换和恢复
• 模块化 Skills/Commands：可扩展的技能和命令体系（9 Skills + 14 Commands）
• 连接器系统：通过 MCP 协议接入外部数据源（网络搜索、企业知识库）
• 工作流模板：预定义多步骤任务（如月度报告自动生成）
• 剪贴板增强：支持粘贴文本、表格、图片
• 模型选择：Sonnet 4.6 / Opus 4.6 / Haiku 4.5

架构概览

┌─────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  WPS Excel  │◄───►│  Proxy Server    │◄───►│  React TaskPane │
│  Plugin Host│     │  (Express :3001) │     │  (Vite :5173)   │
│  main.js    │     │  proxy-server.js │     │  src/App.tsx     │
└─────────────┘     └──────────────────┘     └─────────────────┘
       │                     │                        │
       │ WPS ET API          │ Claude CLI (SSE)       │ 用户对话
       │ 读写表格数据        │ Skill/Mode 匹配       │ Markdown 渲染
       │ 代码执行            │ Session 持久化         │ 代码高亮+执行
       │                     │ MCP Connectors         │ 模式切换

快速开始

前置条件

• Node.js >= 18
• Claude CLI：npm install -g @anthropic-ai/claude-code && claude login
• WPS Office（可选，浏览器可独立预览）

1. 克隆并配置

git clone https://github.com/claude-office-skills/claude-wps-plugin.git
cd claude-wps-plugin
cp .env.example .env

编辑 .env 选择模型（默认 Sonnet 4.5）：

VITE_CLAUDE_MODEL=claude-sonnet-4-5

2. 安装依赖 & 启动

npm install

# 一键启动（Proxy + Dev Server）
npm start

# 或分别启动
npm run proxy   # 启动代理服务器 :3001
npm run dev     # 启动前端开发服务器 :5173

3. 使用方式

方法 A：浏览器预览（无需 WPS）

打开 http://localhost:5173 即可预览插件 UI，工作在 Mock 模式（模拟 WPS 数据）。

方法 B：WPS Office 加载项（完整功能）

自动安装（推荐）：

# macOS 一键启动 + 注入 WPS
bash install-to-wps.sh

# 或双击「启动插件.command」

手动安装：

1. 确保 proxy 和 dev server 已启动
2. 打开 WPS Excel → 开发工具 → 加载项 → 浏览
3. 选择项目根目录下的 manifest.xml
4. 插件出现在 Ribbon 栏 → 点击 打开 Claude

4. 构建生产包

npm run build          # Vite 前端构建
npm run build:dist     # 完整分发包（Skill 嵌入 + 混淆 + tarball）

项目结构

claude-wps-plugin/
├── src/                           # React 前端（TaskPane 侧边栏）
│   ├── api/
│   │   ├── claudeClient.ts        # Claude API 调用（SSE 流式响应）
│   │   ├── wpsAdapter.ts          # WPS JS API 封装 + Mock 模式
│   │   └── sessionStore.ts        # 会话持久化（CRUD + 记忆）
│   ├── components/
│   │   ├── CodeBlock.tsx           # 代码块（语法高亮 + Run/Copy）
│   │   ├── MessageBubble.tsx       # 消息气泡（Markdown 渲染）
│   │   ├── QuickActionCards.tsx    # 快捷命令卡片（按模式切换）
│   │   ├── ModeSelector.tsx        # 交互模式选择器（Agent/Plan/Ask）
│   │   ├── ModelSelector.tsx       # AI 模型选择器
│   │   ├── AttachmentMenu.tsx      # 附件菜单（剪贴板/PDF/图片）
│   │   └── HistoryPanel.tsx        # 历史会话面板
│   ├── App.tsx                     # 主应用（对话 + 状态管理）
│   └── types.ts                    # TypeScript 类型定义
├── proxy-server.js                 # Express 代理服务器（:3001）
├── skills/                         # 技能系统
│   ├── bundled/                    # 内置 Skills（9 个）
│   │   ├── wps-core-api/           #   WPS ET API 完整参考
│   │   ├── code-rules/             #   代码生成规范
│   │   ├── data-cleaning/          #   数据清洗
│   │   ├── formula-operations/     #   公式运算
│   │   ├── conditional-formatting/ #   条件格式
│   │   ├── data-analysis/          #   数据分析
│   │   ├── financial-modeling/     #   金融建模
│   │   ├── chart-creation/         #   图表创建
│   │   └── template-generation/    #   模板生成
│   ├── modes/                      # 交互模式（3 个）
│   │   ├── agent/                  #   自动执行模式
│   │   ├── plan/                   #   步骤规划模式
│   │   └── ask/                    #   只读分析模式
│   ├── connectors/                 # MCP 连接器（2 个）
│   │   ├── web-search/             #   网络搜索
│   │   └── knowledge-base/         #   企业知识库
│   └── workflows/                  # 工作流模板（1 个）
│       └── monthly-report/         #   月度报告生成
├── commands/                       # 快捷命令（14 个 .md 文件）
├── wps-addon/                      # WPS 加载项运行时
│   ├── main.js                     #   Plugin Host 入口
│   ├── ribbon.xml                  #   Ribbon 栏 UI 定义
│   └── *.png                       #   图标资源
├── manifest.xml                    # WPS 加载项清单
├── .claude-plugin/plugin.json      # 插件元数据
├── .mcp.json                       # MCP 连接器配置
├── AGENTS.md                       # AI Agent 行为定义
├── CONNECTORS.md                   # 连接器使用说明
├── build-dist.mjs                  # 生产构建脚本
├── install-to-wps.sh               # 自动安装脚本
└── 启动插件.command                 # macOS 双击启动器

使用示例

在 WPS 中选中数据区域，然后在对话框输入：

• "删除 A 列中的重复内容，保留第一条"
• "把 B 列的日期统一转换成 YYYY-MM-DD 格式"
• "统计 C 列的平均值和总和"
• "删除所有空白行"
• "把第一行设置为加粗并填充灰色背景"
• "生成一个销售数据柱状图"
• "智能填充缺失的邮编数据"