AiPPT 插件文档

title: 私有化 WPS 实现与部署 date: 2026-08-27 tags:

  • AiPPT
  • WPS
  • 私有化
  • 构建
  • 部署 status: active

私有化 WPS 实现与部署

快速入口

私有化WPS交付的是静态目录、ZIP和publish.html，不是Windows EXE或macOS PKG。目标宿主是WPS Windows、Linux和UOS WPS演示。

你要做什么详细文档
最快构建和查看产物WPS私有化构建与部署 > 1. 最快构建
部署、校验和交付WPS私有化构建与部署
在客户端注册插件WPS插件注册流程 > 1. 最短注册步骤
排查固定用户登录WPS私有化登录流程 > 1. 登录机制速览
判断功能是否支持WPS私有化功能清单 > 1. 能力边界速览
查看完整组件和交付物私有化WPS总览

最快构建步骤由详细文档维护：

1. 最快构建

在aippt-frontend-addin根目录执行：

pnpm run build:private -- https://abc.com

https://abc.com是私有化部署域名。示例：

pnpm run build:private -- http://privateweb.wxbjq.top

需要Node.js 22.x，依赖明细见 3. 构建依赖。

产物位置：dist/private-YYYYMMDD-HHMMSS/目录和同名总ZIP，包含offline.zip、online.zip、admin-private.zip、wps-com.zip、publish.html、BUILD_INFO.txt、SHA256SUMS。目录明细见 6. 输出目录。

成功判定：构建无报错结束，上述目录和总ZIP生成且七个文件齐全。交付和部署验证统一使用 12. 交付检查单。

构建或部署失败查 10. 常见失败。

指向原始笔记的链接

1. 实现组成

WPS加载项外壳
→ packages/aippt-plugin-wps-com
→ ribbon.xml、publish.html、TaskPane和WebDialog
 
共享业务页面
→ packages/aippt-plugin-webview
→ offline、online页面
 
私有化管理后台
→ packages/aippt-plugin-admin-private

WPS页面通过impl/wps.ts或wps-dispatcher.ts调用window.Application，不经过Windows C#或macOS Swift Bridge。

通信细节见AiPPT Web通信协议与平台适配。

2. 构建和交付边界

pnpm run build:private统一构建offline、online、admin-private和wps-com，并生成带时间戳的交付目录和总ZIP。

构建参数、输出目录、SHA256、安全项和交付检查只在WPS私有化构建与部署维护。本页不复制这些明细。

交付物清单由详细总览维护：

3. 交付物

一次完整私有化构建输出：

offline.zip
online.zip
admin-private.zip
wps-com.zip
publish.html
BUILD_INFO.txt
SHA256SUMS

构建命令和产物目录见 WPS私有化构建与部署。

指向原始笔记的链接

3. 注册方式

私有化WPS使用网页注册：

部署wps-com目录
→ 浏览器打开publish.html
→ 唤起ksoWPSCloudSvr协议和本地中继
→ WPS加载jsplugins.xml
→ 重启WPS
→ 顶部出现AiPPT Tab

操作步骤、Windows和Linux/UOS差异、失败现象见WPS插件注册流程。

4. 登录方式

默认使用服务端配置的固定用户静默登录。Token和用户信息写入WPS FileSystem缓存，TaskPane与WebDialog读取同一份状态。

缓存位置、竞态、401和安全边界见WPS私有化登录流程。

5. 能力边界

页面或Ribbon按钮存在不代表WPS已经实现对应能力。发布前以WPS私有化功能清单为准，并记录实际验证的WPS版本。

跨平台对比见AiPPT三端能力矩阵。

6. 详细文档目录

私有化WPS的实现细节继续保留在AiPPT插件/私有化WPS/：

关系图谱

反向链接