关键技术（wps插件打包）

wps插件打包npm run build # 第1步编译前端npm run fetch:node # 第2步下载便携版 Nodenpm run build:package # 第3步打成 zip 分发包产物在dist-package/dqbreport_x.y.z.zip把这个 zip 给客户即可。npm run dev— 开发调试JSONdev: vite --port 3889启动 Vite 开发服务器3889 端口WPS 从http://127.0.0.1:3889加载。只是开发用与打包无关。npm run build— 编译前端第 1 步JSONbuild: vite build把src/下的 Vue 组件编译打包成静态文件输出到dist/index.html assets/*.js。这是客户浏览器实际运行的代码。npm run fetch:node— 下载便携 Node第 2 步JSONfetch:node: powershell ... scripts/fetch-node.ps1下载一个独立的 node.exe到dist-server/。因为客户电脑没装 Node.js必须带一个运行时后端服务才能跑起来。npm run build:package— 打分发包第 3 步JSONbuild:package: node scripts/package.js这是核心脚本package.js它把所有东西组装进dist-package/dqbreport_版本.zip打进 zip 的内容作用node.exe便携 Node 运行时客户无需安装 Nodedist/前端静态产物src/Node 后端源码代理、SQLite、配额等服务node_modules/后端运行依赖剔除devDependencies 减小体积、避免超长路径public/头像、HTML 等静态资源package.json提供type: module元信息install-and-run.cmd/run-server.vbs/write-publish.ps1客户一键安装启动脚本publish.xmlWPS 加载项注册文件指向http://127.0.0.1:3890/最后用 Windows 自带tar压成 zip失败则回退 PowerShellCompress-Archive。其余命令与打包无关npm run preview— 本地预览dist/产物npm run server— 单独启动 Node 后端node src/server/server.jsnpm run lint/npm run format— 代码检查/格式化客户拿到 zip 后发生什么解压 zip → 双击 install-and-run.cmd ↓ 用自带的 node.exe 启动 src/server/server.js监听 3890 ↓ write-publish.ps1 把 publish.xml 写入 %APPDATA%\kingsoft\wps\jsaddons\ ↓ WPS 启动 → 读 publish.xml → 从 http://127.0.0.1:3890/ 加载加载项 ↓ Node 服务提供dist/ 前端页面 API 代理 SQLite会员/配额注意事项必须按顺序build:package会先校验缺dist/或dist-server/node.exe直接报错退出package.js#L32-L40改了前端代码→ 必须重新npm run build否则 zip 里还是旧产物改了后端代码proxyRoutes/authRouter/database→ 不用编译直接重新build:package即可src/ 是原样复制publish.xml里的端口是3890package.js#L79与客户机安装脚本配套你本机开发用的 publish.xml 是 3889两者不冲突