蓝湖迁移至pixso需通过四类路径：一、导出静态图+手动重建；二、调用蓝湖api导出json+脚本导入pixso；三、蓝湖导出sketch→pixso原生导入；四、截图+pixso ai生成设计稿。
如果您正从蓝湖平台转向Pixso作为主力设计协作工具，则需将蓝湖中已沉淀的设计资产、标注信息、版本结构及团队协作上下文完整迁移至Pixso环境。蓝湖本身不支持直接导出可编辑的矢量设计源文件，因此迁移需依赖中间格式转换与结构重建策略。以下是多种可行的迁移路径：
一、通过蓝湖导出静态资源+Pixso手动重建
该方法适用于蓝湖中以PNG/JPG/SVG等静态图形式归档的设计稿，适合轻量级项目或历史版本快照复用。需在Pixso中重新搭建画布结构、组件关系与交互逻辑。
1、登录蓝湖账户，进入目标项目页面。
2、点击任一页面右上角“更多”按钮，选择“导出为PNG”或“导出为SVG”（若支持）。
3、勾选需导出的全部画板，设置分辨率为2x，点击“批量导出”并保存至本地文件夹。
4、打开Pixso，新建空白项目，拖入导出的PNG/SVG文件作为底图参考。
5、使用Pixso钢笔工具、矢量网格与自动布局功能，逐层重绘UI元素并建立组件。
6、将高频复用模块封装为团队组件库，并发布至Pixso团队空间。
二、利用蓝湖API导出JSON标注数据+Pixso脚本解析导入
该方法面向技术能力较强的团队，可提取蓝湖中的图层坐标、尺寸、文字内容、标注说明等结构化元数据，通过Pixso插件或外部脚本生成可识别的JSON Schema，再批量注入Pixso画布。
1、确认蓝湖企业版是否开通API权限，获取OAuth 2.0访问令牌与项目ID。
2、调用蓝湖API接口/v1/projects/{project_id}/pages拉取所有页面列表。
3、对每个页面调用/v1/pages/{page_id}/layers获取图层树及标注文本。
4、将返回的JSON数据按Pixso支持的导入格式映射：包括name、type（rect/text/path）、x/y/width/height、fill、fontSize等字段。
5、使用Pixso开发者工具或第三方Node.js脚本，调用Pixso RESTful API的/v1/files/{file_id}/pages/{page_id}/layers批量创建图层。
6、上传完成后，在Pixso中校验图层层级、文字渲染与响应式适配效果。
三、借助第三方中转工具完成蓝湖→Sketch→Pixso链路迁移
该路径利用蓝湖支持导出Sketch文件（.sketch）的隐藏能力（部分企业版开放），再通过Pixso原生Sketch导入引擎实现高保真迁移，可保留图层命名、分组结构、文字样式及部分符号实例关联。
1、联系蓝湖客服确认当前账号是否具备“导出Sketch源文件”权限，如未开通则申请临时授权。
2、在蓝湖项目页点击“导出”→选择“Sketch格式”，下载.zip压缩包。
3、解压后验证.sketch文件完整性，用Sketch Desktop打开确认图层树与符号面板可正常加载。
4、启动Pixso客户端或网页版，点击左上角“新建”→“导入Sketch文件”，选择该.sketch文件。
5、等待Pixso完成解析，系统将自动生成对应画布、图层组、文本样式及符号主组件。
6、检查导入后的组件实例是否仍绑定至主组件，若存在断连，使用Pixso“替换为组件”功能手动修复。
四、采用蓝湖截图+Pixso AI文生图辅助重建
该方法适用于无API权限、无Sketch导出能力，且设计稿数量较少的场景。利用Pixso内置AI能力，将蓝湖页面截图转化为可编辑设计稿，大幅缩短重绘时间。
1、在蓝湖中逐页全屏截图（建议使用Chrome快捷键Ctrl+Shift+P → 输入“Capture full size screenshot”）。
2、将截图保存为高分辨率PNG，确保文字清晰、边框无锯齿。
3、打开Pixso，新建空白画布，点击顶部工具栏“AI”图标，选择“AI生成设计稿”。
4、上传截图，在提示框中输入明确指令：请将此界面还原为可编辑的Figma风格UI设计稿，保持原有布局、字体大小、颜色和间距，输出为矢量图层结构。
5、等待AI生成结果，点击“插入到画布”，Pixso将自动创建含分组、文本框与矩形图层的初始结构。
6、对AI生成结果进行人工校准：调整文字内容、替换图标、修正自动布局参数、补全悬停状态变体。
