PxCook如何标注设计规范_提取设计稿颜色字体规范文档【规范】

PxCook可高效提取设计稿颜色、字体及组件规范并导出结构化文档。需导入PSD/Sketch源文件，依次执行颜色提取、文本样式标注、组件锚点标记，最后整合CSV、Markdown等导出内容至外部工具完成终稿。

想把设计稿里的颜色、字体这些规范系统地整理出来，形成一份清晰的文档？这事儿听起来繁琐，但用对工具，流程就能顺畅不少。PxCook 在这方面是个好帮手，它能帮你把设计稿里的关键信息识别出来，并整理成结构化的数据。具体怎么操作，咱们一步步来看。

一、导入PSD/Sketch设计稿并启用智能解析

想让PxCook准确识别颜色和文字样式，第一步得让它“读懂”你的源文件。这里有个前提：它只认带图层结构的PSD（Windows/macOS都行）和Sketch（需通过插件）文件。像PNG、JPG这类图片格式，因为丢失了图层信息，是没法提取样式细节的。

操作起来很简单：打开PxCook V3.9或更高版本，直接把PSD文件拖到软件主界面就行。如果你用的是Sketch，记得先安装官方插件，然后在Sketch里点击“导出当前画板到PxCook”，文件就会自动同步过去。

解析完成后，记得检查一下图层面板。如果所有分组、文本和形状图层都清晰可见，那就没问题。万一图层没显示出来，那很可能是因为文件里包含了嵌套的智能对象，这时候你得回到Photoshop或Sketch里，把那些对象栅格化处理一下，再重新导入。

二、批量提取颜色规范并导出色值表

颜色是设计规范的核心。PxCook能自动扫描出图层里的填充色、描边色和文本色，还能根据图层命名帮你初步归类。不过，它可不会自动给颜色起好“主色”、“辅助色”这类语义化名称，这个关键步骤还得你亲自来。

提取时，点击左侧工具栏那个滴管图标，或者直接用快捷键Ctrl/Cmd+Shift+C。接着，在画布上点选那些包含目标颜色的图层，右侧的“颜色面板”就会实时列出所有色值（HEX、RGB、HSL都有）以及使用的频次。

勾选出需要保留的颜色，右键选择“导出为CSV”就能保存到本地。这里有个至关重要的细节：导出前，务必手动把CSV表格里每一行的“颜色名称”给改好，比如“primary-500”、“text-secondary”，这样后续使用时才不会混淆。

三、提取字体样式并生成文本规范清单

字体规范同样不能马虎。字号、字重、行高、字间距……这些属性PxCook都能读取，但前提是设计稿里的文字图层没有被栅格化，也没有被额外的图层样式覆盖掉原始字体设置。

操作时，单击任何一个文本图层，左侧的智能标注区就会激活“文本样式”模块。点击“生成文本样式标注”按钮（或按快捷键2），这个图层的所有样式信息就会以浮层形式展示在画布上。

你需要重复这个操作，确保覆盖到所有典型的文本样式，比如一级标题、正文、提示文字、禁用状态等等。这里容易踩坑的是：如果同一个字号混合使用了多种字重（比如常规体和粗体），一定要分别标注，并记录清楚各自的应用场景，避免后续开发时产生歧义。

全部标注好后，在顶部菜单栏选择“文件 → 导出文本规范”，你可以选择生成Markdown或PDF格式的结构化文档初稿。

四、构建组件级设计规范框架

单个样式整理好了，接下来就是组合成组件。PxCook能通过图层的分组和嵌套关系，帮你梳理出按钮、卡片、表单等组件的视觉构成。不过，这非常依赖于设计师事先建立好的、规范的图层命名体系。

理想的做法是，在PSD或Sketch中，确保每个组件都放在独立的图层组里，并且组名遵循“类型/状态/尺寸/样式”这样的层级结构，例如“btn/primary/large/filled”。

在PxCook中展开图层面板，在对应的组件组上右键，选择“标记为组件规范锚点”。然后选中这个组，点击“区域标注”按钮（快捷键3），软件就会自动计算出它的宽高、内边距、圆角等参数。

接着，对这个组件组再执行一遍前面的颜色和文本样式提取步骤。最后导出时，记得勾选“按组件分组汇总”这个选项。这样一来，你就能得到一份自带截图和详细参数的组件规范片段了，非常直观。

五、整合输出标准化设计规范文档

PxCook的主要职责是“提取”和“输出”原始数据，它本身并不擅长文档的排版和美化。所以最后一步，我们需要把前面导出的各类素材，整合到专业的文档工具里进行最终编排。这个过程的核心就两个字：一致。必须确保最终文档里的每一个数值，都和PxCook导出的原始数据严丝合缝。

首先，把导出的CSV色值表、Markdown文本规范、组件参数截图这几类文件，统一放到一个项目文件夹里。

然后，打开你常用的文档工具，比如Notion、Axure或者Typora，新建一个文档。按照“色彩系统 → 排版系统 → 组件库 → 动效说明（如有）”的逻辑顺序，把内容粘贴进去。

在色彩部分，可以插入色卡做成可视化表格；在排版部分，加入字体对比示意图；在组件部分，插入标注好的截图，并注明关键约束条件（比如“按钮高度固定为36px”）。再次强调，所有引用的数值必须与PxCook导出的原始数据完全一致，切忌为了“整洁”而进行四舍五入或主观简化，任何细微的偏差都可能在实际开发中引发问题。

走完这五步，一份源于设计稿、数据准确、结构清晰的设计规范文档就基本成型了。整个过程虽然有些细节需要注意，但相比完全手动标注和整理，效率的提升是实实在在的。