Preserve approved mockups with controlled adjustments and recolorable assets (0.9.4)

USAGE.md

@@ -5,9 +5,17 @@
 使用本Skill制作时，以下三项为必做要求：
 
 1. 必须用Skill工程工具创建可构建项目，或继续已有有效工程；单页任务也适用。保留真实构建入口和输入，交付PPTX须通过工程构建生成，禁止绕过Skill手拼PPT或给成品补空工程。
-2. 用户确认小样后尽量忠实重建，保留其内容、图形及表示关系的形状，包括连线、箭头和分组边界。修复排版与可读性问题时不得擅自删减这些元素。
+2. 用户确认小样后尽量忠实重建，保留其内容、图形及表示关系的形状，包括连线、箭头和分组边界。原则上保留已确定的元素相对位置关系、可视化形式、图标及文字样式；必要排版修复不授权删减、换图标、换表现形式或重新设计。
 3. 每页完成后检查全页字号、字体、字重、间距和内容视觉分组的组合效果，确认层次清楚；发现问题后修复源、重建并查看当前画面，不以“不溢出”代替层次检查。
 
+为忠实复刻已确认小样，允许作必要的内容区字号、文本框／容器尺寸、间距、适配与对齐调整，不必机械沿用模板全部预设数值。调整须保留上述相对位置关系、可视化、图标及文字样式，字号微调保持原有层次。主动设定的设计参数优先取整数；需要细调时，按参数类型和明确单位采用统一步长，如0.5pt或0.25pt，同类元素一致。等比缩放、单位换算、字体度量、曲线路径等计算结果保留必要精度。固定页面UI、已声明字体族和锁定结构继续遵守模板契约。
+
+调整写入工程共享样式或版式，由真实builder消费并统一应用于同类实例。每次调整后，既检查文字、公式、图形是否超出文本框／内容容器，也检查完整对象及可见边缘是否超出可用正文区和页面、与固定UI碰撞或发生裁切／遮挡；修复源、重建并查看当前整页画面。见[小样调整与溢出检查](references/visual-design.md#controlled-adjustments-for-approved-mockups)。
+
+原生组件或SVG不便忠实表示的已确认元素，使用[ImageGen制作独立素材](references/visual-design.md#elements-that-need-imagegen)，以小样为参考保留原有外观、细节和关系表达，不能换成更简单的图示／图标。素材进入真实工程并如实标注图片可编辑性，其他可编辑对象保持分离；真实证据与标识使用原件，不让生成素材代替真实数据。
+
+生成图片素材交付真实透明背景、单色或少量明确分区的简单颜色，以支持调色。单色保留alpha遮罩及颜色角色，多色保留语义分层／分区遮罩及可调色／固定色映射；调色保持轮廓、透明度、细节与固定色，并检查实际换色结果。素材、遮罩和映射随工程保留。图片可调色不等于图内对象可独立编辑；现有SVG调色工具不会自动给PNG调色，按实际实现的图片编辑或工程绑定交付。
+
 具体见[工程接口](references/project-workspace.md)、[小样保真](references/visual-design.md#approved-mockup-fidelity)及[全页层次检查](references/visual-design.md#full-page-hierarchy-check)。
 
 可以直接这样请求：
@@ -78,7 +86,7 @@ Agent 读取导出的调色板、字体、网格、素材 paint 契约、结构
 
 段落还须遵守标点避头尾；检查每一行，包括末行，禁止单字或被标点包围的单字独占一行。重新排整段文字来消除问题，保持完整内容、逻辑文本块和声明字号。纯文本可使用`paragraph_layout.py`配合实际字体测量；复杂文字与PowerPoint重新换行的结果仍按实际画面检查。
 
-间距由template与共享recipe固定，调用者不传数字、阈值、偏移或临时变体。检查文字与边框、标题与正文、相邻内容和公式周围的固定关系，过窄与过宽均拒绝。多段文字用完整段落数组，段内行距与段间距分别控制；`text_block.py`读取固定padding与paragraph_gap并自动记录关系，`layout_spacing.py`按role精确核对。几何检查不能替代实际字形与画面审阅，见[固定间距](references/spacing.md)。
+间距由生效的共享recipe固定，默认取template数值；复刻已确认小样时可声明工程共享调整，同类实例统一使用。内容调用者仍不传数字、阈值、偏移或临时变体。检查文字与边框、标题与正文、相邻内容和公式周围的固定关系，过窄与过宽均拒绝。多段文字用完整段落数组，段内行距与段间距分别控制；`text_block.py`读取所传共享style的固定padding与paragraph_gap并自动记录关系，`layout_spacing.py`按role精确核对。现有工具支持的数值类型／模数保持；记录工程调整不会自动应用它，builder须实际消费。几何检查不能替代实际字形、容器／页面溢出与画面审阅，见[固定间距](references/spacing.md)。
 
 含数学内容时读取[数学制作](references/mathematics.md)，声明专用数学字体。`math_component.py`与原生导出包装器支持结构化表达式的Office Math输出；字体、字号角色和颜色由template或显式工程样式提供。它不是通用LaTeX解析器；源SVG的线性兼容文字也不等于复杂公式预览。目标应用的渲染和实际公式编辑分别验证。
 
@@ -90,7 +98,7 @@ Agent 读取导出的调色板、字体、网格、素材 paint 契约、结构
 "$PPT_PYTHON" /path/to/project/tools/ppt_project.py build --project /path/to/project
 ```
 
-构建校验输入锁并生成当前PPTX，失败时保留旧产物；不要靠已有导出物或单独调用底层编译器绕过工程。原生页面保留 Master／Layout／占位符；图表保留数据缓存和内嵌工作簿，表格保留单元格。图标按 SVG＋paint 的 palette／fixed／structural 通道处理。图表和表格示例位于 `assets/components/`，用法见[图表](references/charts.md)和[基础组件](references/components.md)。
+构建校验输入锁并生成当前PPTX，失败时保留旧产物；不要靠已有导出物或单独调用底层编译器绕过工程。原生页面保留 Master／Layout／占位符；图表保留数据缓存和内嵌工作簿，表格保留单元格。可复用调色图标按 SVG＋paint 的 palette／fixed／structural 通道处理；C28的小样复刻图片例外按独立工程素材保留并披露，不冒充可调色图标。图表和表格示例位于 `assets/components/`，用法见[图表](references/charts.md)和[基础组件](references/components.md)。
 
 ## 工程和协作