常见问题与处理 | Open Design Docs

这篇文档用于处理日常使用中最常见的问题。遇到问题时，先判断自己卡在哪一步，再按对应步骤检查。

先判断问题发生在哪里

现象	通常属于哪类问题	先看哪一节
测试模型失败	阿里云 Token Plan 或模型配置问题	模型连接测试失败
点击运行后一直没有结果	生成任务等待或连接问题	生成过程长时间没有变化
上传截图后结果没参考图片	多模态或提示词问题	截图没有被理解
生成了页面但不满意	需求描述或修改方式问题	结果不满意
找不到生成文件	项目页或设计文件查看问题	找不到生成文件
预览不是最新	预览刷新问题	预览不是最新

排障就是按顺序排查问题原因。它不是要求你理解技术细节，而是先确认「配置是否正确、任务是否完成、文件是否打开、需求是否说清楚」。按顺序检查，比反复重试更容易解决问题。

模型连接测试失败

如果在欢迎页或设置里点击「测试」后失败，先按下面顺序检查：

执行模式是否选择 BYOK
API 协议是否选择 Anthropic
快速填充提供方是否选择「自定义提供方」
API Key 是否填写了阿里云 Token Plan Key
Base URL 是否填写了阿里云 Token Plan Base URL
模型名称是否按当前服务要求填写
修改后是否重新点击了「测试」

如果仍然失败，可以把下面信息发给维护者排查：

信息	在哪里看
使用的是欢迎页还是设置页	当前配置所在页面
API 协议	BYOK 配置区域
Base URL 所属环境	配置说明
模型名称	模型输入框
测试失败时页面提示	测试按钮附近或弹窗

模型连接表示 Open Design 是否能通过阿里云 Token Plan 调用 AI 模型。只有连接成功，后续生成页面、PPT、图片说明等任务才能正常执行。普通用户主要检查填写项是否和配置说明中的信息一致。

生成过程长时间没有变化

生成页面、PPT、图片时，等待一段时间是正常的。任务越复杂、要求越多，等待时间越长。

先看这几个位置：

左侧对话区是否还在新增内容
底部按钮是否还显示运行中状态
右侧「设计文件」里是否已经出现新文件
页面上是否有失败提示或连接提示

如果长时间没有变化，可以这样处理：

先等当前任务结束，或点击「停止」
把需求改短，只保留最关键目标
重新点击「发送」
如果多次卡住，进入「设置」检查模型连接测试是否成功
如果模型测试失败，先处理模型连接问题

推荐把复杂任务拆小：

先生成一个电脑端页面原型，只包含标题、目标说明、适合人群和操作步骤。先不要生成复杂动效，也不要一次做多个版本。

生成出第一版后，再继续发送：

在当前页面基础上增加常见问题和结尾行动引导。

停止是中止当前正在运行的任务。发现需求写错、任务明显跑偏或等待时间异常长时，可以先停止，再用更清楚、更短的要求重新发送。停止不会删除当前项目。

截图没有被理解

如果上传了截图但生成结果看起来没有参考图片，先不要连续重复运行。按下面顺序检查：

图片是否已上传成功，输入框上方或设计文件里是否能看到附件
需求里是否明确写了「参考截图的布局、颜色、内容或卡片结构」
当前模型是否支持视觉理解能力
如果使用文字模型，是否已切换到支持图片理解的多模态模型
是否可以临时切换到已确认支持视觉的模型

推荐补充这段修改要求：

请重新参考我上传的截图。重点参考截图里的模块顺序、左右布局、卡片排版、标题层级和按钮位置。不要照抄截图里的文字，内容仍按我当前项目主题生成。

如果还是没效果，可以把截图内容用文字补充出来：

截图大致结构是：顶部一个标题区域，中间左侧是说明文字，右侧是 3 张功能卡片，底部是常见问题。请按这个结构重新整理当前页面。

如果需要上传截图或设计稿，请确认当前使用的是支持图片理解的模型。

视觉理解能力就是让模型看懂图片内容。它用于理解截图里的布局、文字、按钮、颜色和元素关系。图片任务不一定都需要视觉理解，但「参考截图生成页面」这类任务通常需要。

结果不满意

生成结果不满意时，优先在当前项目里继续修改，不要马上回主页重新运行。

常见问题可以这样改：

问题	继续发送的修改要求
内容太空	「请增加更具体的业务例子，每个模块至少给一个实际使用场景」
文字太多	「请把每个模块压缩到 3 个要点以内，删掉重复表达」
太像广告	「请改成培训语气，减少夸张词和营销表达」
页面太花	「请减少装饰，使用更克制的颜色和更清晰的留白」
结构混乱	「请重新按『背景、目标、适合人群、操作步骤、常见问题』排序」
缺少重点	「请补充一个重点区域，说明这个内容对目标读者有什么帮助」

一次修改只提一个主要方向，会更容易看出效果。

找不到生成文件

生成完成后，文件通常会出现在两个位置。

第一个位置是左侧对话区：

找到助手回复里的「本轮产出的文件」
点击文件旁边的「打开」
右侧打开后切到「预览」

第二个位置是右侧工作区：

点击「设计文件」
按「修改时间」查看最新文件
如果文件很多，按类型筛选，例如只看 HTML 页面
找到文件后点击「打开」

如果仍然看不到，可以点击设计文件里的「刷新」，或回到左侧对话区确认本轮任务是否已完成。

设计文件是当前项目里保存文件的地方。生成出来的页面、图片、PPT、上传的截图和参考资料都在这里。找不到结果时，优先看「设计文件」和「本轮产出的文件」。

预览不是最新

如果刚修改过页面但右侧预览看起来还是旧版本，可以按下面处理：

点击预览区域里的「重新加载」或刷新按钮
关闭当前文件标签，再从「设计文件」重新打开最新文件
在设计文件里按「修改时间」找到最新文件
确认打开的是本轮生成的新文件，而不是旧文件

如果是 PPT、图片或其他文件，也按同样思路：先找最新文件，再重新打开预览。

页面显示报错

如果 Open Design 页面出现报错，先记录三类信息：

当前页面地址
报错标题或主要提示
你刚才做了什么操作

如果只是 Open Design 生成的某个页面预览报错，可以回到当前项目继续发送：

当前预览页面打开时报错，请检查并修复刚生成的页面，让它可以正常预览。

如果是设置页、主页或项目页本身无法使用，建议把报错截图和上述三类信息发给维护者。

什么时候需要找维护者协助

下面这些情况适合找维护者协助：

阿里云 Token Plan 测试一直失败
多个用户同时无法生成
图片任务确认写法正确但一直不能理解截图
页面提示账号、权限或服务不可用
同一个项目多次运行都卡住

反馈时尽量提供：

你在哪个页面操作
你点击了哪个按钮
你输入的大致需求
页面出现的提示或截图
当前使用的模型名称

这样维护者能更快判断是配置问题、模型问题，还是当前任务写法需要调整。