SuperAPI AI 工具集

photopea-embedded-editor

设计与创作

查看项目

更新于 10-16 05:46

技能介绍

用途:在网页或 Web 应用中嵌入 Photopea 作为图像编辑器,并从宿主页面用 JavaScript 控制该实例,实现打开文件、运行脚本、导出结果等自动化图像编辑流程,也可将 Photopea 作为产品内图像编辑功能的引擎。

主要能力:覆盖嵌入、文件输入输出、脚本、导出、图层、文字、滤镜以及完整的 Photoshop 兼容 API。资料给出的脚本示例包括:按文字内容重命名所有文字图层、将每个图层分别导出为 PNG、在所有文字图层中查找替换文本、生成重复图层网格、从 URL 应用水印、以 JSON 获取全部图层信息。

使用方式:涉及嵌入 Photopea、从 JavaScript 控制嵌入实例、自动化图像编辑工作流、构建图像编辑功能,或编写脚本操作文档、图层、文字、选区、滤镜、颜色与路径时使用本技能。不要使用原始 postMessage 接线,始终使用 photopea.js 作为封装。执行前应阅读详细指南,将其安全、前置条件与验证要求视为强制项;聚焦任务可加载相关章节,端到端任务需完整阅读。

限制:本技能覆盖宿主页面集成模式,不替代 Photopea 自身的条款、API 文档或许可指引。远程 URL 加载取决于浏览器 CORS 行为、网络可用性以及用户的 Photopea 账户或会话状态。runScript 在嵌入的 Photopea 文档上下文中执行脚本,只应运行你理解的脚本,且只使用用户批准的文件。将动态值嵌入 runScript 字符串前,应先用 JSON.stringify 序列化;切勿把用户提供的 URL、图层名或文本直接拼接到 Photopea 脚本源码中。导出行为可能因文档大小、浏览器内存限制以及当前 Photopea 运行时支持的格式而异。