用途:该技能调用 Pencil MCP 工具 snapshot_layout(客户端可能命名为 mcp__pencil__snapshot_layout),获取 Pencil 设计页面的布局结构快照,输出带边界与约束信息的树状结构,用于理解节点层级与布局关系、规划元素移动或对齐、检查内容被裁剪或元素重叠等问题。
使用前提:仅当用户明确提到“Pencil”,或当前对话上下文明确属于 Pencil 设计任务时才使用;否则不要触发,例如“分析布局”可能指 HTML/CSS 布局分析。
输入参数:filePath(可选,指定 .pen 文件路径,默认当前活动文档);maxDepth(可选,限制节点树下探深度,0 表示仅顶层节点,建议设为 2 或 3 以避免上下文溢出);parentId(可选,仅返回该节点子树的布局);problemsOnly(可选,布尔值,设为 true 时只返回存在布局问题的节点,如被父节点裁剪,默认 false)。
使用方式:先确定范围(整页用 maxDepth=1,局部用 parentId),再调用 snapshot_layout(...),最后分析返回的树结构与布局信息。
适用场景:获取顶层框架布局以查看空白区域、查看特定框架的子元素定位、深入检查某区域的布局问题。触发短语包括“Pencil 布局快照”“分析 Pencil 页面结构”“检查 Pencil 布局问题”“获取 Pencil 节点层级”。
限制与注意事项:资料未提供具体安装命令、版本要求或收费信息。资料列出的常见陷阱包括框架版本与依赖库兼容性、配置文件格式错误、环境变量设置、多版本依赖冲突及大数据量下的性能问题,但这些属于通用提示,未给出该技能的具体配置细节。