展开本页目录
开始前准备什么
- 本地练习资料可免费编辑与检查；执行Stitch需要可访问账号和已配置的官方MCP或SDK，云端额度/计划以账户页面为准。
- 在隔离练习项目操作，保留projectId、screenId和版本；本稿未调用目标云端，不能据此声称生成完成。
- 列出项目实例
- 写明应用范围
- 排除非页面实例
- 压缩选择字段
- 应用并读回
- 比较选中与未选中
- 保存范围验收
1. 列出项目实例
从get_project读取screenInstances，保存id、sourceScreen和type。
同一资源可能有画布实例，不凭画布坐标认定它是可编辑页面。
2. 写明应用范围
在清单标记预约页apply=true，票务页apply=false。
先确定业务范围再提交请求，避免全选后再试图恢复。
3. 排除非页面实例
过滤type为DESIGN_SYSTEM_INSTANCE的对象。
设计系统本身不是目标屏幕，不应出现在selectedScreenInstances里。
官方界面与功能位置
以下为官方文档配图，具体版本与账号入口以当前产品为准。本课练习输入与验收对照见相邻步骤。
4. 压缩选择字段
为请求每项仅保留id和sourceScreen。
把x、y、width、height留在本地台账，不传给官方apply工具。
5. 应用并读回
调用当前SDK的designSystem.apply或对应MCP工具，保存返回屏幕。
失败先查看字段和身份，不连续重复写请求制造多个结果。
6. 比较选中与未选中
检查预约页主色改变，同时票务页仍保留旧色。
若未选中页也变化，保留证据并检查是否操作了共享源或选错实例。
7. 保存范围验收
交付选择清单、请求字段和实际前后图。
没有执行云端时本地样例仅证明选区规则，不声称页面已更新。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 选择只含真实预约页。
- 请求项恰有id与sourceScreen。
- 未选中的票务页有单独回看记录。
常见问题
为什么套设计系统会报参数无效？
读取项目 screenInstances，写清预约页应用、票务页不应用，排除 DESIGN_SYSTEM_INSTANCE 等非页面对象。按实际实例选择字段提交后逐页回读，不把设计资产本身当普通页面更新。
改设计系统会把所有页面一起改吗？
不要默认。更新资产与应用到哪些已有屏幕是不同动作，本课保存明确选区，并对未选中页面另做复查。