byclaude-office-skills· 1 MCP server
Stars
7
Category
WPS Office Excel AI 数据处理助手 — 侧边栏对话式操作表格
$git clone https://github.com/claude-office-skills/claude-office-pluginInstalls into the current project.
Install claude-office-plugin by running `git clone https://github.com/claude-office-skills/claude-office-plugin`, then use it for the current task and follow its documentation at https://github.com/claude-office-skills/claude-office-plugin.
| 1 | # Claude for WPS Excel 插件 |
| 2 | |
| 3 | WPS Office Excel AI 助手——通过自然语言对话操控表格,由 Claude API 驱动。 |
| 4 | |
| 5 |  |
| 6 |  |
| 7 |  |
| 8 | |
| 9 | ## 功能特性 |
| 10 | |
| 11 | - **自然语言对话**:直接用中文描述需求,AI 自动生成并执行 WPS JS 代码 |
| 12 | - **三种交互模式**:Agent(自动执行)/ Plan(步骤规划)/ Ask(只读分析) |
| 13 | - **实时上下文感知**:自动读取当前工作表、选区数据,智能匹配 Skill |
| 14 | - **代码执行桥**:生成的代码可一键在 WPS 中执行,支持结果回传 + 一键修复 |
| 15 | - **流式响应**:SSE 流式输出,Markdown 渲染 + 代码块语法高亮 |
| 16 | - **会话历史**:自动保存对话记录,支持多会话切换和恢复 |
| 17 | - **模块化 Skills/Commands**:可扩展的技能和命令体系(9 Skills + 14 Commands) |
| 18 | - **连接器系统**:通过 MCP 协议接入外部数据源(网络搜索、企业知识库) |
| 19 | - **工作流模板**:预定义多步骤任务(如月度报告自动生成) |
| 20 | - **剪贴板增强**:支持粘贴文本、表格、图片 |
| 21 | - **模型选择**:Sonnet 4.6 / Opus 4.6 / Haiku 4.5 |
| 22 | |
| 23 | ## 架构概览 |
| 24 | |
| 25 | ``` |
| 26 | ┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐ |
| 27 | │ WPS Excel │◄───►│ Proxy Server │◄───►│ React TaskPane │ |
| 28 | │ Plugin Host│ │ (Express :3001) │ │ (Vite :5173) │ |
| 29 | │ main.js │ │ proxy-server.js │ │ src/App.tsx │ |
| 30 | └─────────────┘ └──────────────────┘ └─────────────────┘ |
| 31 | │ │ │ |
| 32 | │ WPS ET API │ Claude CLI (SSE) │ 用户对话 |
| 33 | │ 读写表格数据 │ Skill/Mode 匹配 │ Markdown 渲染 |
| 34 | │ 代码执行 │ Session 持久化 │ 代码高亮+执行 |
| 35 | │ │ MCP Connectors │ 模式切换 |
| 36 | ``` |
| 37 | |
| 38 | ## 快速开始 |
| 39 | |
| 40 | ### 前置条件 |
| 41 | |
| 42 | - **Node.js** >= 18 |
| 43 | - **Claude CLI**:`npm install -g @anthropic-ai/claude-code && claude login` |
| 44 | - **WPS Office**(可选,浏览器可独立预览) |
| 45 | |
| 46 | ### 1. 克隆并配置 |
| 47 | |
| 48 | ```bash |
| 49 | git clone https://github.com/claude-office-skills/claude-wps-plugin.git |
| 50 | cd claude-wps-plugin |
| 51 | cp .env.example .env |
| 52 | ``` |
| 53 | |
| 54 | 编辑 `.env` 选择模型(默认 Sonnet 4.5): |
| 55 | |
| 56 | ``` |
| 57 | VITE_CLAUDE_MODEL=claude-sonnet-4-5 |
| 58 | ``` |
| 59 | |
| 60 | ### 2. 安装依赖 & 启动 |
| 61 | |
| 62 | ```bash |
| 63 | npm install |
| 64 | |
| 65 | # 一键启动(Proxy + Dev Server) |
| 66 | npm start |
| 67 | |
| 68 | # 或分别启动 |
| 69 | npm run proxy # 启动代理服务器 :3001 |
| 70 | npm run dev # 启动前端开发服务器 :5173 |
| 71 | ``` |
| 72 | |
| 73 | ### 3. 使用方式 |
| 74 | |
| 75 | #### 方法 A:浏览器预览(无需 WPS) |
| 76 | 打开 `http://localhost:5173` 即可预览插件 UI,工作在 Mock 模式(模拟 WPS 数据)。 |
| 77 | |
| 78 | #### 方法 B:WPS Office 加载项(完整功能) |
| 79 | |
| 80 | **自动安装**(推荐): |
| 81 | ```bash |
| 82 | # macOS 一键启动 + 注入 WPS |
| 83 | bash install-to-wps.sh |
| 84 | |
| 85 | # 或双击「启动插件.command」 |
| 86 | ``` |
| 87 | |
| 88 | **手动安装**: |
| 89 | 1. 确保 proxy 和 dev server 已启动 |
| 90 | 2. 打开 WPS Excel → **开发工具 → 加载项 → 浏览** |
| 91 | 3. 选择项目根目录下的 `manifest.xml` |
| 92 | 4. 插件出现在 Ribbon 栏 → 点击 **打开 Claude** |
| 93 | |
| 94 | ### 4. 构建生产包 |
| 95 | |
| 96 | ```bash |
| 97 | npm run build # Vite 前端构建 |
| 98 | npm run build:dist # 完整分发包(Skill 嵌入 + 混淆 + tarball) |
| 99 | ``` |
| 100 | |
| 101 | ## 项目结构 |
| 102 | |
| 103 | ``` |
| 104 | claude-wps-plugin/ |
| 105 | ├── src/ # React 前端(TaskPane 侧边栏) |
| 106 | │ ├── api/ |
| 107 | │ │ ├── claudeClient.ts # Claude API 调用(SSE 流式响应) |
| 108 | │ │ ├── wpsAdapter.ts # WPS JS API 封装 + Mock 模式 |
| 109 | │ │ └── sessionStore.ts # 会话持久化(CRUD + 记忆) |
| 110 | │ ├── components/ |
| 111 | │ │ ├── CodeBlock.tsx # 代码块(语法高亮 + Run/Copy) |
| 112 | │ │ ├── MessageBubble.tsx # 消息气泡(Markdown 渲染) |
| 113 | │ │ ├── QuickActionCards.tsx # 快捷命令卡片(按模式切换) |
| 114 | │ │ ├── ModeSelector.tsx # 交互模式选择器(Agent/Plan/Ask) |
| 115 | │ │ ├── ModelSelector.tsx # AI 模型选择器 |
| 116 | │ │ ├── AttachmentMenu.tsx # 附件菜单(剪贴板/PDF/图片) |
| 117 | │ │ └── HistoryPanel.tsx # 历史会话面板 |
| 118 | │ ├── App.tsx # 主应用(对话 + 状态管理) |
| 119 | │ └── types.ts # TypeScript 类型定义 |
| 120 | ├── proxy-server.js # Express 代理服务器(:3001) |
| 121 | ├── skills/ # 技能系统 |
| 122 | │ ├── bundled/ # 内置 Skills(9 个) |
| 123 | │ │ ├── wps-core-api/ # WPS ET API 完整参考 |
| 124 | │ │ ├── code-rules/ # 代码生成规范 |
| 125 | │ │ ├── data-cleaning/ # 数据清洗 |
| 126 | │ │ ├── formula-operations/ # 公式运算 |
| 127 | │ │ ├── conditional-formatting/ # 条件格式 |
| 128 | │ │ ├── data-analysis/ # 数据分析 |
| 129 | │ │ ├── financial-modeling/ # 金融建模 |
| 130 | │ │ ├── chart-creation/ # 图表创建 |
| 131 | │ │ └── template-generation/ # 模板生成 |
| 132 | │ ├── modes/ # 交互模式(3 个) |
| 133 | │ │ ├── agent/ # 自动执行模式 |
| 134 | │ │ ├── plan/ # 步骤规划模式 |
| 135 | │ │ └── ask/ # 只读分析模式 |
| 136 | │ ├── connectors/ # MCP 连接器(2 个) |
| 137 | │ │ ├── web-search/ # 网络搜索 |
| 138 | │ │ └── knowledge-base/ # 企业知识库 |
| 139 | │ └── workflows/ # 工作流模板(1 个) |
| 140 | │ └── monthly-report/ # 月度报告生成 |
| 141 | ├── commands/ # 快捷命令(14 个 .md 文件) |
| 142 | ├── wps-addon/ # WPS 加载项运行时 |
| 143 | │ ├── main.js # Plugin Host 入口 |
| 144 | │ ├── ribbon.xml # Ribbon 栏 UI 定义 |
| 145 | │ └── *.png # 图标资源 |
| 146 | ├── manifest.xml # WPS 加载项清单 |
| 147 | ├── .claude-plugin/plugin.json # 插件元数据 |
| 148 | ├── .mcp.json # MCP 连接器配置 |
| 149 | ├── AGENTS.md # AI Agent 行为定义 |
| 150 | ├── CONNECTORS.md # 连接器使用说明 |
| 151 | ├── build-dist.mjs # 生产构建脚本 |
| 152 | ├── install-to-wps.sh # 自动安装脚本 |
| 153 | └── 启动插件.command # macOS 双击启动器 |
| 154 | ``` |
| 155 | |
| 156 | ## 使用示例 |
| 157 | |
| 158 | 在 WPS 中选中数据区域,然后在对话框输入: |
| 159 | |
| 160 | - `"删除 A 列中的重复内容,保留第一条"` |
| 161 | - `"把 B 列的日期统一转换成 YYYY-MM-DD 格式"` |
| 162 | - `"统计 C 列的平均值和总和"` |
| 163 | - `"删除所有空白行"` |
| 164 | - `"把第一行设置为加粗并填充灰色背景"` |
| 165 | - `"生成一个销售数据柱状图"` |
| 166 | - `"智能填充缺失的邮编数据"` |
| 167 | |
| 168 | Claude |