SuperAPI AI 工具集

penpot-rename-layers

前端与建站

查看项目

更新于 10-16 07:57

技能介绍

用途:将 Penpot 文件中的图层重命名为其代表的语义 HTML 元素名(nav、header、main、section、article、button、input、label、h1–h6、p、ul、li、img),无对应元素时使用 kebab-case 角色名(如 card-grid、button-group、field-row)。语义化命名是无障碍审计、设计到代码映射和干净交付的前提。

主要能力:先只读盘点图层结构,按名称状态分为自动生成、有意义、自定义三类;再产出 before→after 重命名计划,标注 bucket、置信度与理由;最后分批写入。重命名仅写 shape.name,不改几何属性,可逆且安全。

使用方式:通过 execute_code 调用,识别自动生成名(如 Rectangle 12)可自动修复,已有有意义名称的图层需人工确认;主组件形状(isComponentMainInstance 为 true,包括其内部形状)默认禁止重命名。用 export_shape 做可视校验,用 penpotUtils.shapeStructure 读取结构。按 Phase 0 发现、Phase 1 语义推断、Phase 2 分批重命名推进,每批不超过 100 个,自上而下(先父后子)并保持幂等。

适用场景:无障碍审计(标题层级)、设计到代码评审、设计交付前的图层整理。

限制:不触碰几何、不重构组件、不自动修复其他问题;命名用语义 HTML 名逐字或 kebab-case,禁用 PascalCase。资料未提供具体安装命令与价格信息。