用途:把 Penpot 文件转成一份 DESIGN.md,即单一可移植的 Markdown 文档,让人类或 LLM 无需打开 Penpot 即可复现设计系统。文档由 YAML frontmatter(colors、typography、rounded、spacing、components 等 token 映射)与正文段落(Overview、各领域小节、Do's & Don'ts、Iteration Guide、Known Gaps)组成。
主要能力:读取页面清单、token 集与主题、库组件/颜色/字体资产,采样组件样式(填充、描边、圆角、flex 内边距与间距、文字字体/字号/字重/行高/字距、绑定 token),读取变体轴,并通过 export_shape 导出图像做视觉依据。所有读取在 execute_code 中完成,可用 penpotUtils.shapeStructure 查看结构,用 penpot_api_info 核对不熟悉的签名。
使用方式:按阶段推进——Phase 0 发现(只读盘点,确定范围、规范主题与输出路径);Phase 1 提取 token 与资产;Phase 2 采样组件(每批不超过 5 个);Phase 3 视觉特征(先导出并查看封面与代表性画板,再写美学描述);Phase 4 组装、自检并写出文件。每个阶段设有用户确认检查点。
限制:对画布完全只读,绝不修改形状、token 或库,唯一写入是本地 Markdown 文件;所有值必须可追溯到文件中读到或看到的内容,不得编造,无法提取的放入 Known Gaps;正文与组件条目应引用 frontmatter 映射而非重复原始值;存在明暗主题时须明确规范主题,另一主题作为差异小节;库颜色需按分组去重后再做语义映射;输出须符合 design-md 格式(章节顺序与 frontmatter 键固定)。覆盖已有 DESIGN.md 需显式确认。
适用场景:需要把 Penpot 设计系统文档化、供编码智能体或团队复用的场合。具体收费、价格与平台支持信息暂未提供。