架构与依赖关系

方案定位

OpenPPT 适合这些诉求：

• 想先本地体验开源能力
• 想基于现有前端工程二次开发
• 需要评估私有化或源码接入路径

与 API 直连方案的关系

两者均属于智能PPT产品体系，但交付对象和实施方式不同：

• API 直连：在自有系统中调用标准接口，按业务流程集成能力
• OpenPPT：基于现成源码产品进行二次开发，重点在交互能力和产品形态可控

两者不是同一个交付物，也不是从属关系。
支撑 OpenPPT 的部分深度能力接口属于独立能力体系，不应等同理解为标准开放 API 的简单封装。

依赖关系

可按以下方式理解 OpenPPT 的基础依赖关系：

开源前端工程
-> 本地运行与二次开发
-> 配置平台 App Key
-> 解锁核心能力
-> 结合私有化或业务系统继续扩展

实施时应重点关注以下事项：

• 先把源码工程跑起来
• 再完成应用配置
• 最后结合你的系统和部署方式做能力接入

基础启动流程

git clone https://github.com/YOOTeam/OpenPPT
cd open-ppt
npm install
npm run dev

如何解锁核心能力

在平台创建应用，拿到 App Key 后写入配置或环境变量，再调用核心能力。

Window._APPKEYTOKEN = 'App Key'

适用团队

• 有前端团队，希望深度定制编辑器或创作流程
• 希望掌控源码、交互和私有化演进路径
• 需要在企业内部系统里深度融合 PPT 创作体验

建议阅读顺序

1. 先看“架构与依赖关系”理解方案边界
2. 再看“产品介绍”了解开源版能力范围
3. 最后看“核心功能接入指南”做本地启动与配置

注意事项

• 不要把 OpenPPT 当成“API 文档的附录”
• 不要默认所有 OpenPPT 深度能力都等同于标准开放 API
• 不要在还没跑起源码工程前，就直接按 API 直连思路去拆需求