应用的分享、导出与导入（App Sharing / Export / Import）

Pop 允许用户将自己创建的应用以文件形式导出，并在其他设备或发送给其他用户使用。同时，其他人分享的应用也可以轻松导入到你的 Pop 系统中。

应用导入导出功能极大增强了 Pop 的开放性、协作能力与工具生态拓展性。

一、为什么要导出 / 导入应用？

✔ 将自己的工具分享给同事或朋友

例如你做了一个“文本去敏工具”，可以直接导出给他人使用。

✔ 应用迁移到另一台电脑

适用于多设备使用者或重装系统。

✔ 团队应用资产管理

团队可以通过 Export / Import 的方式快速交换工具。

✔ 发布到未来的 Pop 应用市场（App Store）

如果你未来计划上架应用，也需要用到导出格式。

二、应用导出的内容包含什么？

当你导出一个应用时，Pop 会生成一个 .json 文件，其中包含：

内容	说明
工作流（Workflow）	节点、参数、逻辑、连接关系
布局（Layout）	应用的 UI 布局（组件、分屏、表单位置等）
应用元信息（Meta）	名称、分类、图标、版本号、创建者等
默认输入设置	表单默认值、字段映射关系
节点运行设置	超时、模型选择、变量设置等

也就是说，这个 JSON 文件是一个完整的应用快照，导入后可立即运行。

三、如何导出应用？

在应用中心 → “我的应用” 中，选择任意应用，然后点击：

导出 / Export

系统会生成一个：

my-app-name.popapp.json

你可以：

保存到本地
分享给他人
上传到云盘
存入团队仓库
备份到 Git

这是目前最推荐的应用备份方式。

四、如何导入应用？

点击应用中心页面右上角：

导入应用

选择一个 .popapp.json 文件即可。

导入后系统将：

解析工作流结构
解析布局配置
创建一个新的应用条目
自动加入「我的应用」分类
立即可运行

如果导入的应用中包含重复名称，系统会自动生成新的 ID 或提示你手动更名。

五、导入应用时可能出现的问题

❌ 1. JSON 格式损坏

文件不完整或被编辑器格式化导致。

➡️ 解决：重新导出或检查 JSON 结构。

❌ 2. 依赖的模型未配置

例如工作流中使用了 GPT-4，但本地未配置 OpenAI。

➡️ 解决：在系统设置中配置所需模型。

❌ 3. 外部文件引用不存在

极少情况，例如某些业务类节点读取了固定路径。

➡️ 解决：调整节点中的路径或输入字段。

❌ 4. Pop 版本不兼容（未来可能）

某些节点功能或布局结构版本不一致。

➡️ 解决：更新 Pop 或使用兼容模式。

六、应用分享的最佳实践

为了让你的应用更易于传播，建议你：

✔ 为应用写清楚简介

说明应用用途、输入格式、输出类型。

✔ 设计简洁直观的参数输入

减少使用门槛。

✔ 设置默认参数

提高第一次运行成功率。

✔ 使用 Markdown 展示结果

可读性更高。

✔ 避免硬编码路径

保持可移植性。

✔ 在应用卡片中添加漂亮图标

提高展示效果。

七、小结

Pop 的应用导出与导入功能让你可以：

在不同电脑间迁移你的工具
轻松分享给同事与朋友
为未来的应用市场做好准备
保存工作流与布局的完整快照
构建属于你自己的工具生态