用途:当用户需要从 Calicat 文件取数据,且本地 calicat CLI 是执行路径时使用本技能,用来提取设计数据、交互数据、PRD 数据、画布/页面结构与截图。
链接解析:从 /design/{file_id} 提取 file_id。若 node-type=canvas,则 node-id 为 canvas_id;node-type 存在且非 canvas 时,node-id 为 selected_layer_id;无 node-type 时不要猜测,UUID 通常是图层 id,长数字串可能是画布 id,必要时用最轻量安全接口验证。仅文件链接时 canvas_id 与选中图层未知。
核心规则:优先渐进式检索,按 get_canvas_list、get_design_page_list、get_meta_data、get_design_data、get_interaction_design_data 由轻到重调用。get_meta_data 返回简化页面/图层结构(名称、ID、位置、尺寸,XML 层级);get_design_data 返回完整布局与深层 CSS 样式。若目标页面 ID 已确定且要做前端实现,跳过 get_meta_data 直接调用 get_design_data。
用法:列出工具用 calicat tools-list;调用示例为 calicat tools-call --name get_canvas_list --args '{"file_id":"123456"}' 等,支持画布列表、页面列表、图层元数据、设计数据、交互设计、PRD 列表与 PRD 全文。大载荷应重定向到临时文件,例如 calicat tools-call --name get_design_data --args '{"file_id":"123","selected_layer_id":"xyz"}' > scratch/page_design.json;Windows PowerShell/CMD 需按资料中的转义规则传递 JSON。巨型 JSON 应写脚本拆分后再逐段读取。
适用场景:单图层设计/交互分析、画布级处理、需求卡获取、整画布前端实现。整画布实现须逐页处理,默认每步 1 页,载荷很小时才 2 页。
限制:编码必须严格基于实际设计数据与用户需求,不得猜测或臆造;若访问失败,运行 calicat status,必要时 calicat logout 后 calicat login,并复核已解析的 id;涉及安装、版本、更新时阅读 references/cli-lifecycle.md。回报告时说明解析出的 id、执行的 CLI 调用、链接指向文件/画布/图层。