展开本页目录
开始前准备什么
- 本地练习资料可免费编辑与检查；执行Stitch需要可访问账号和已配置的官方MCP或SDK，云端额度/计划以账户页面为准。
- 在隔离练习项目操作，保留projectId、screenId和版本；本稿未调用目标云端，不能据此声称生成完成。
- 锁定同一屏幕
- 获取两种下载地址
- 下载并检查类型
- 检查HTML内容
- 配对截图和源码
- 处理过期资源
- 交付导出清单
1. 锁定同一屏幕
从项目读取目标screen，记录screenId和版本时间。
不要一个方法用旧引用、另一个方法重新选最新页面。
2. 获取两种下载地址
分别await screen.getHtml()和screen.getImage()。
官方SDK返回URL，不是HTML字符串或图片字节。
3. 下载并检查类型
在授权环境取回两个URL，将HTML和图片写到不同文件。
若返回错误页或鉴权失败，保存状态并停止，不按扩展名伪装成功。
官方界面与功能位置
以下为官方文档配图，具体版本与账号入口以当前产品为准。本课练习输入与验收对照见相邻步骤。
4. 检查HTML内容
确认文件含HTML结构与页面文字，而非一行https链接。
如果下载页面依赖外链资源，另外记录依赖，不默认单文件离线可用。
5. 配对截图和源码
给两份文件相同screen键与取得时间，打开检查标题、布局和文案。
图片与HTML不一致时先核对来源，不手工改图掩盖版本差异。
6. 处理过期资源
地址失效时从同一目标screen重新读取新下载地址。
不要把旧URL当永久公开资源写进长期教程素材。
7. 交付导出清单
保存本地文件、内容类型和屏幕身份，删除日志中不必要的临时敏感参数。
未执行下载时仍为待验证，不称源码已运行。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- HTML文件含实际页面而非下载URL字符串。
- 图片和HTML匹配同一screen。
- 错误页不被当成功资源。
常见问题
getHtml返回一串网址，怎么不是网页代码？
锁定同一 screen，分别获取 getHtml 与 getImage 的实际下载 URL，在授权环境下载到不同文件。检查 Content-Type 和内容后成对保存版本，不能把 URL 字符串写成 index.html。
截图和源码看着不一样，是导出坏了吗？
先检查screenId、读取时间以及是否分别选了不同版本。把两类资源成对保存后再排查外链资源和渲染依赖。