应确认设计稿为多画板/artboard格式，拖拽导入时勾选“导入所有画板”，或通过【新建项目】→“从设计文件创建”并手动全选画板；sketch需重置插件授权并全选artboard发送；xd需启用全局导出标记后导出全部artboard。
如果您在使用PxCook时需要一次性导入包含多个页面的设计稿（如多画板PSD、多Artboard Sketch或含多页的XD文件），但发现仅加载了首页或部分页面，则可能是由于文件结构未被正确识别或导入设置未启用多页支持。以下是解决此问题的步骤：
一、确认设计稿是否为多画板/多Artboard格式
多页设计稿在主流设计工具中实际以“多画板”（Photoshop）、“多Artboard”（Sketch/XD）形式存在，而非传统PDF式分页。PxCook仅识别原生画板结构，不支持将普通图层堆叠模拟为多页。
1、在Photoshop中检查顶部菜单栏是否显示“画板”选项卡，且图层面板中存在多个带编号的画板图层组。
2、在Sketch或Adobe XD中确认画布区域右侧是否存在多个并列Artboard，且每个Artboard均有独立名称与尺寸标识。
3、若设计稿为单画布内手动平铺多个界面（无画板/Artboard结构），则必须先在原设计软件中将其转换为标准画板格式，否则PxCook无法识别为多页。
二、拖拽导入时启用全画板加载
PxCook默认支持一次性导入全部画板，但需确保操作路径符合规范，避免因交互误操作导致仅加载首个画板。
1、关闭当前已打开的任何项目，确保处于PxCook主界面空白状态。
2、直接将PSD/Sketch/XD文件从系统文件管理器中按住不放，拖拽至PxCook主窗口中央区域（非菜单栏、非侧边栏、非项目列表）。
3、松手后弹出导入配置弹窗，勾选“导入所有画板”（Photoshop）或“导入全部Artboard”（Sketch/XD），取消勾选“仅导入可见画板”或“仅当前选中Artboard”类选项。
4、点击“确定”后等待解析完成，左侧项目树中应显示与原始文件中画板数量一致的独立节点。
三、通过“新建项目”流程强制全量解析
当拖拽导入异常时，可绕过快捷入口，使用结构化新建流程触发完整文件扫描，适用于含嵌套画板组或命名不规范的复杂PSD。
1、点击PxCook左上角【文件】→【新建项目】，在弹出窗口中选择“从设计文件创建”。
2、点击“浏览”，定位并选中目标多页设计文件，**不要双击打开，而是点击右下角“打开”按钮**。
3、进入元数据预览页后，观察下方“检测到X个画板/Artboard”提示，若数字与预期不符，点击“重新扫描画板结构”按钮（位于提示文字右侧）。
4、扫描完成后，手动勾选全部画板条目前方的复选框，再点击“下一步”完成导入。
四、处理Sketch多页文档的插件同步异常
Sketch用户若使用旧版插件上传，可能因缓存或权限限制导致仅同步首页。此时需清除插件状态并重置连接。
1、在Sketch中打开设计文件，点击右上角插件图标 → 找到“PxCook Sync” → 选择“Disconnect from PxCook”。
2、打开PxCook，进入【设置】→【插件管理】→ 点击“重置Sketch插件授权”。
3、重启Sketch，重新打开同一文件，在右侧检查器中确认所有Artboard旁均出现蓝色“导出标记”图标。
4、全选全部Artboard（Ctrl+A），右键选择“Send to PxCook”，此时插件将批量提交所有选中Artboard，而非仅当前视口内可见项。
五、应对XD多页文档的导出标记遗漏
Adobe XD默认不自动为所有Artboard添加导出标记，需主动启用全局标记功能，否则PxCook仅接收已标记页面。
1、在XD中打开多页文件，点击右上角“共享”→“开发资源”→ 确保“启用开发资源”已开启。
2、按下Ctrl+Shift+E（Windows）或Cmd+Shift+E（Mac）调出“导出设置”面板。
3、在面板顶部切换至“全局设置”标签页，勾选“为所有Artboard自动添加导出标记”。
4、返回画布，任意位置右键 → 选择“导出所有Artboard到PxCook”，系统将推送全部页面至PxCook项目中。
