PxCook不支持解析图层蒙版，因其仅识别文字、颜色、尺寸等量化属性，无法读取PSD中的蒙版通道或剪切蒙版结构；需在Photoshop中应用蒙版后导出PNG，或通过插件导出含mask字段的JSON配合使用。
如果您在使用PxCook查看设计稿时无法直观识别图层蒙版或遮罩信息，则可能是由于该软件本身不支持解析和渲染蒙版数据。PxCook作为一款面向前端开发的切图标注工具，其核心功能聚焦于文字、颜色、间距、尺寸等可量化属性的自动识别，并不具备解析PSD或Sketch文件中位图蒙版、矢量蒙版或剪切蒙版结构的能力。以下是确认与应对该限制的具体方法：
一、确认设计稿格式与蒙版兼容性
PxCook仅支持对PSD文件中的基础图层结构（如文字图层、纯色填充、栅格化图像）进行识别，无法读取图层样式中的蒙版通道、图层混合模式或智能对象嵌套关系。其2.0.1版本未包含蒙版元数据解析模块。
1、检查原始设计稿是否为PSD格式且已拼合图层：若使用了“图层蒙版”或“矢量蒙版”，需在Photoshop中右键点击蒙版缩略图，选择“应用图层蒙版”后再保存PSD。
2、确认图层是否处于可见且未被锁定状态：PxCook仅扫描可见图层堆栈，隐藏图层、带锁图标图层或被上层完全覆盖的图层将不参与识别流程。
3、观察PxCook界面右侧属性面板：若某图层在面板中仅显示“图像”或“形状”类型，且无“蒙版”“Mask”“Alpha通道”等字段，则表明该图层的蒙版信息未被提取。
二、通过导出预合成图像验证蒙版结果
当设计稿中存在蒙版效果时，实际视觉呈现依赖于蒙版与图层内容的实时合成。PxCook无法动态渲染该过程，但可通过导出已应用蒙版的静态图像来间接验证效果是否符合预期。
1、在Photoshop中选中含蒙版的图层，按Ctrl+Shift+Alt+E（Windows）或Cmd+Shift+Option+E（macOS）执行“盖印可见图层”操作。
2、将新生成的合并图层拖至最顶层，关闭其余所有图层眼睛图标，确保仅保留该图层可见。
3、以“另存为”方式导出为PNG格式，并在PxCook中重新导入该PNG文件：此时蒙版效果已固化为像素级透明度，PxCook可正常识别边缘透明区域及Alpha值分布。
三、借助第三方插件或中间格式转换
部分设计师采用Bridge+Script或专用PSD解析库提取蒙版边界路径，再转换为PxCook可识别的JSON标注描述。该方式绕过原生限制，但需额外配置环境。
1、在Photoshop中安装“PSD Layer Info Exporter”脚本，运行后生成包含“maskBounds”“maskEnabled”字段的JSON文件。
2、使用文本编辑器打开该JSON，查找目标图层名称下的"mask"对象，确认其"enabled":true及"x""y""width""height"参数是否存在有效数值。
3、将该JSON文件与原始PSD一同放入PxCook项目文件夹，并在PxCook设置中启用“高级元数据解析”开关（若存在）；若无此选项，则说明当前版本不支持该扩展协议。
