1. WPS开放平台 加载项概述

2. wpsjs

   Github

   wpsjs

   Owner

   laihaojie

   Updated

   Nov 26, 2025

   
   二次开发wpsjs

3. wpsjs工具包使用 from 官方kdocs

4. WPS加载项部署运行问题排查方法

5. WPS加载项开发「上道」指南

6. linux.wps.cn/docs 开发指南 2020年的

7. 如何将加载项整合到自己的项目

第一阶段：逆向分析与需求明确 (Deconstruction & Analysis)

• 步骤 1：作为用户，完整体验和梳理功能 (Functional Walkthrough)
• 要做什么： 亲自操作现有的 C# 插件，把每一个功能点都跑一遍。
• 产出物： 一份详细的 《功能清单》 或思维导图。
• 清单内容应包括：
• 界面元素： 有哪些按钮、输入框、下拉菜单、树形结构？
• 用户操作： 用户可以做什么？（例如：输入账号密码、点击登录、展开树节点、勾选指标、点击“提取”按钮）。
• 系统反馈： 操作后界面有什么变化？（例如：登录成功后跳转、提示错误信息、按钮变为可用/不可用）。
• 最终结果： 最终在 Excel 中生成了什么？（例如：数据被填入到哪些单元格？是否有特定的格式、颜色、公式？）。

• 步骤 2：识别业务逻辑与数据来源 (Identify Business Logic & Data Sources)
• 要做什么： 基于第一步的功能清单，分析背后隐藏的数据和逻辑。您需要像一个侦探一样思考。
• 需要回答的关键问题：
• 登录： 登录请求是发往哪里？是一个内部的 Web API 地址吗？还是直接连接了某个数据库？（可以找后端或原开发人员确认，或者使用抓包工具如 Fiddler/Charles 尝试捕获网络请求）。
• 指标树： 树里的数据是从哪里来的？是每次启动时从服务器加载的，还是硬编码在程序里的？
• 提取数据： 当点击“提取”后，插件是向服务器发送了请求，由服务器计算好数据返回？还是插件本身在本地进行了复杂的计算？
• 产出物： 一份 《数据接口需求文档》 的草稿。这份文档将成为您与后端工程师沟通的“圣经”。

• 步骤 3：定义新插件与 Excel 的交互 (Define Excel Interaction)
• 要做什么： 聚焦于 C# 插件对 Excel 的所有操作。
• 需要记录的细节：
• 写入位置： 数据是写入到当前活动工作表，还是会新建一个工作表？是从 A1 单元格开始，还是用户可以自己选择位置？
• 写入内容： 写入的仅仅是文本和数字吗？有没有日期、公式？
• 格式调整： 是否有设置单元格背景色、字体加粗、合并单元格等操作？
• 产出物： 一份 《WPS JS-SDK 需求清单》。这个清单明确了您在新插件中需要调用哪些类型的 WPS API。

第二阶段：技术设计与规划 (Technical Design & Planning)

• 步骤 4：确认技术架构与选型 (Architecture & Tech Stack)
• 要做什么： 正式确定新插件的技术方案。
• 决策点：
• 前端框架： 确定使用 Vue 还是 React。（根据您或团队的熟悉程度决定）。
• UI 库： 确定使用 Ant Design、Element Plus 或其他组件库。
• 后端确认： 与后端团队沟通，确认他们将使用什么技术（Java/Python/Node.js）来实现您在步骤 2 中定义的 API。
• API 规范： 确定 API 的认证方式（例如使用 JWT Token）和数据交换格式（统一使用 JSON）。

• 步骤 5：设计界面和 API 详规 (UI & API Specification)
• 要做什么： 将需求转化为具体的设计方案。
• 具体工作：
• UI 设计： 基于步骤 1 的功能清单，画出新插件的界面草图（Wireframe）。您可以选择复用旧的布局，也可以借此机会进行优化。
• API 详细设计： 与后端工程师一起，将步骤 2 的草稿完善成一份正式的 《API 接口文档》。文档需要明确每个接口的 URL、请求方法 (GET/POST)、请求参数、返回数据的详细结构。

第三阶段：开发与实现 (Development & Implementation)

• 步骤 6：后端 API 开发与模拟 (Backend First / Mocking)
• 要做什么： 后端工程师根据 API 文档进行开发。
• 您的角色： 在后端没有开发完成时，您可以使用 Mock 工具（如 Mock.js, Postman Mock Server）模拟 API 接口，让您的前端开发可以独立进行，不受阻塞。

• 步骤 7：前端开发 (Frontend Development)
• 要做什么： 这是您的核心工作。
• 开发顺序建议：
1. 搭建项目： 使用 Vite 或框架脚手架搭建前端工程。
2. 构建静态页面： 先不考虑任何逻辑，将登录页面、主功能页面（包含树和按钮）的静态 UI 搭建出来。
3. 对接 Mock/真实 API： 实现登录逻辑、从 API 获取数据并渲染指标树。
4. 集成 WPS JS-SDK： 在所有业务逻辑跑通后，最后一步才是调用 WPS JS-SDK，实现将数据写入 Excel 的功能。

第四阶段：测试与部署 (Testing & Deployment)

• 步骤 8：联调与测试 (Integration Testing)
• 要做什么： 将您开发好的前端插件，与后端开发好的真实 API 对接，在 WPS 客户端内进行完整的业务流程测试。
• 测试重点： 从登录到最终数据写入 Excel 的整个流程是否通畅，数据是否正确，边界情况（如网络错误、无数据）处理是否得当。

• 步骤 9：打包与部署 (Packaging & Deployment)
• 要做什么： 将您的项目打包成最终的插件。
• 具体工作：
1. 前端项目打包： 执行 npm run build，生成最终的 HTML, JS, CSS 静态文件。
2. 配置清单文件： 编写 jsaddin.xml 文件，指向您的入口 HTML。
3. 部署： 将打包后的前端静态文件和 jsaddin.xml 文件部署到用户可以访问的 Web 服务器上。
4. 分发： 将插件的加载路径或安装包提供给最终用户。