蓝湖设计稿导入pxcook需通过四种方式：一、导出png图片直接添加；二、用蓝湖sketch插件同步后导入.sketch文件；三、调用蓝湖api获取json并转换为.pxcook格式；四、截图拼接长图后启用智能标注。
如果您需要将蓝湖平台中的设计稿导入PxCook进行查看与标注，但蓝湖未提供直接导出适配PxCook的格式，则需通过中间文件或截图方式实现内容迁移。以下是完成该迁移任务的具体操作路径：
一、导出蓝湖设计稿为标准图片资源
该方法适用于仅需在PxCook中查看视觉效果、无需测量与切图的轻量级迁移场景。蓝湖支持将单页设计稿以PNG格式导出，PxCook可直接导入本地图片并建立画板结构。
1、在蓝湖网页端打开目标项目，进入需迁移的设计稿页面。
2、点击右上角“更多”按钮，选择“导出为PNG”选项。
3、勾选“包含标注信息”和“保留原始尺寸”，点击“下载”保存至本地指定文件夹。
4、打开PxCook桌面客户端，新建项目，点击“添加画板”→“从本地图片添加”，选中刚下载的PNG文件。
5、确认画板命名与尺寸无误后，点击“确定”，该图片即作为独立画板加载进PxCook工作区。
二、使用蓝湖Sketch插件同步至Sketch再导入PxCook
该方法适用于设计师使用Sketch作为主力工具且蓝湖项目已关联Sketch源文件的场景。PxCook原生支持Sketch文件（.sketch）解析，可完整保留图层结构、文字样式与测量关系。
1、确保已安装蓝湖官方Sketch插件，并在Sketch中登录同一蓝湖账号。
2、在Sketch菜单栏选择“Plugins”→“Lanhu”→“Sync from Lanhu”，选择需同步的设计稿版本。
3、等待同步完成，检查图层命名、分组与符号实例是否完整。
4、在PxCook中新建项目，点击“添加画板”→“从Sketch文件添加”，定位并选中已同步的.sketch文件。
5、勾选“自动创建画板”与“保留图层层级”，点击“导入”，PxCook将解析全部页面与图层信息。
三、通过蓝湖API获取JSON数据并转换为PxCook兼容格式
该方法适用于批量迁移多个页面且具备基础脚本能力的用户。蓝湖开放平台提供设计稿元数据接口，返回包含尺寸、图层属性、文本内容等结构化JSON，可经脚本处理生成PxCook识别的.pxcook格式（本质为ZIP封装的JSON+资源）。
1、前往蓝湖开发者中心申请项目API Key，并开通“设计稿详情读取”权限。
2、调用/api/v1/projects/{project_id}/pages/{page_id}接口，获取单页JSON描述数据。
3、使用Python脚本解析响应体，提取width、height、layers数组及每个图层的type、frame、text字段。
4、按PxCook文档定义的.pxcook结构组织数据：根目录下含manifest.json（声明画板信息）与layers/子目录（存放图层JSON）。
5、将生成的文件夹压缩为ZIP，重命名为design.pxcook，拖入PxCook窗口即可加载。
四、手动截图拼接为长图后导入PxCook并启用智能标注
该方法适用于无法访问蓝湖后台权限、无插件支持或仅需快速验证布局的临时迁移需求。PxCook内置OCR与矢量识别能力，对高质量长图可自动生成可测距文本框与色值提示。
1、在蓝湖网页端逐屏滚动设计稿，使用系统截图工具（如Windows Snip & Sketch或macOS Shift+Cmd+4）截取全屏视图。
2、将多张截图按顺序导入Photoshop或在线工具（如Photopea），垂直拼接为单张长图，导出为PNG格式。
3、在PxCook中新建项目，点击“添加画板”→“从本地图片添加”，选择拼接后的长图。
4、右键画板缩略图，选择“启用智能标注”，PxCook将自动识别文字区域、按钮边界与间距关系。
5、双击任意识别出的文字块，可编辑其内容并同步更新标注说明，注意：此模式下切图功能不可用，仅支持测量与评论。
