AiPPT 插件文档

title: AiPPT 插件文档总入口 date: 2026-08-27 tags:

  • AiPPT
  • 文档入口 aliases:
  • AiPPT 插件文档
  • AiPPT 三端插件文档 status: active

AiPPT 插件文档

系统和调用时序

2. 系统上下文

flowchart TB
    User[用户]
    Host[PowerPoint或WPS]
    Ribbon[Ribbon和右键菜单]
    Web[共享Web页面]
    Bridge[client-communication]
    Adapter[平台实现]
    PPT[PPT对象模型]
    API[AiPPT API]
    Storage[文件、缓存和设置]

    User --> Host
    User --> Ribbon
    Ribbon --> Web
    Web --> Bridge
    Bridge --> Adapter
    Adapter --> PPT
    Web --> API
    Adapter --> Storage
指向原始笔记的链接

5. PPT调用时序

sequenceDiagram
    participant Page as Web页面
    participant Comm as client-communication
    participant Adapter as 平台Adapter
    participant Model as PPT对象模型

    Page->>Comm: 调用统一接口
    alt Windows或macOS
        Comm->>Adapter: impl/cpp.ts和postMessageToClient
    else WPS模块接口
        Comm->>Adapter: impl/wps.ts
    else WPS兼容协议
        Comm->>Adapter: wps-dispatcher.ts
    end
    Adapter->>Model: 操作Slide或Shape
    Model-->>Adapter: 结果
    Adapter-->>Page: Response
指向原始笔记的链接

快速入口

你要做什么先读
五分钟了解项目快速认识
了解PPT插件有哪些类型PPT插件类型与技术选型
比较三端功能状态AiPPT三端能力矩阵
构建或更新WebView离线包WebView实现与打包
开发或发布Windows插件Windows插件实现与打包
开发或发布macOS插件macOS插件实现与打包
构建或部署私有化WPS私有化WPS实现与部署
修改Web与Native通信AiPPT Web通信协议与平台适配
修改AiPPT生成流程AiPPT智能生成业务逻辑
修改模板和素材库模板与素材库业务逻辑
修改导出、压缩或拼图导出压缩与PPT拼图业务逻辑
修改设计工具或工具箱设计工具与工具箱业务逻辑
查看全部组件图和调用时序AiPPT系统图与调用时序

快速认识

AiPPT把在线或离线Web页面放进PowerPoint、WPS窗口，再通过平台代码操作当前PPT。

三部分代码

部分做什么
Web页面AiPPT生成、模板、素材、设计工具、导出和账户
平台插件打开窗口，接收Web消息，操作Slide和Shape
服务端登录、生成、模板、素材、设计保存和导出任务

三个平台

  • Windows PowerPoint：COM插件（Add-in Express + C# Office Interop + WPF/WebView2），适合完整PPT操作和Windows本地能力，安装包使用NSIS，见Windows插件实现与打包。
  • macOS PowerPoint：PPAM/VBA提供PowerPoint入口，Swift dylib负责窗口、网络和Native能力，安装包使用PKG并经过Apple公证，见macOS插件实现与打包。
  • 私有化WPS：WPS JS加载项（TaskPane/WebDialog + window.Application），页面和加载项部署在私有化Web服务，通过publish.html注册到WPS，见私有化WPS实现与部署。

一次功能调用

以“插入模板单页”为例：

用户在Web页面选择单页
→ 页面下载PPTX
→ 调用Libraries.addSlide
→ Windows/macOS发消息给Native
   或WPS直接调用window.Application
→ 宿主把Slide插入当前PPT

项目组成

项目用途
aippt-frontend-addin共享Web页面、WPS加载项、私有化后台
aippt_windows_addinWindows COM插件和桌面程序
aippt-macos-addinmacOS PPAM、Swift dylib和桌面App

平台文档

平台定位文档
WebView共享页面的online、offline和desktop构建及两端同步WebView实现与打包
WindowsCOM插件与WPF/WebView2窗口，NSIS安装包Windows插件实现与打包
macOSPPAM/VBA入口加Swift dylib，PKG安装并公证macOS插件实现与打包
私有化WPSWPS JS加载项，私有化部署和publish.html注册私有化WPS实现与部署

业务文档

业务文档
AI生成PPTAiPPT智能生成业务逻辑
模板、单页、图片、图标、插图和上传模板与素材库业务逻辑
PDF、PPTX、视频、压缩和拼图导出压缩与PPT拼图业务逻辑
对齐、布局、字体、颜色、PPT清理和工具箱设计工具与工具箱业务逻辑

常用名词

名词含义
Presentation一个PPT文件
Slide一页幻灯片
Shape页面中的文本框、图片、图形或组合
RibbonPowerPoint/WPS顶部功能区
Task Pane/CTP停靠在宿主侧边的面板
WebDialog浮动Web窗口
PPAMPowerPoint加载项文件，常用于VBA和Ribbon
Office InteropC#调用PowerPoint对象模型的接口
WPS JS APIwindow.Application提供的WPS对象模型

共享层和参考

文档状态

状态含义
active当前主文档
reference调查快照或图形附录
draft内容未核完

关系图谱