失败提示需【精准定位】失败类型+位置,如“语法错误:第12行缺少右括号”;下方紧接带上下文的修正代码块并【加粗】修复部分;服务端错误禁用归责话术,改用自动降级提示,本地错误才明确指向用户输入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当用户在码上飞AI中执行代码生成、调试或部署操作失败时,需要立即看到清晰、可行动的失败提示文案,避免用户反复重试或盲目修改输入。
明确失败原因并指向具体位置
在错误弹窗或控制台输出中,第一行必须用【精准定位】格式写出失败类型+触发位置,例如:“语法错误:第12行缺少右括号”“API调用超时:请求https://api.mashangfei.ai/v3/run 超过8秒”。不写“系统异常”“操作未成功”这类模糊表述。
这一步不能省略行号或URL——用户不会自己翻50行代码找问题,也不会凭空猜测哪个接口挂了。
提供可直接复现的最小修复动作
方法一:给出带上下文的修正示例
在错误信息下方紧接一段代码块(用灰色等宽字体),只展示从出错行向上取1行、向下取1行的片段,并把修复部分用【加粗】标出。例如:
→ const result = await fetch('/api/data')
→ if (result.status === 200) {
→ return 【result.json()】
→ } else {
方法二:用动词短语直给指令
不写“建议您检查网络”,而写“点击右上角刷新按钮重试”“将model参数从gpt-4改为qwen2.5”“删除第7行末尾多余逗号”。每条指令必须能被用户3秒内理解并执行。
区分服务端与本地错误的语气策略
第一步:判断错误来源是否含HTTP状态码或“Connection refused”“timeout”字样
第二步:若确认是服务端问题,提示中禁用“请检查您的输入”“请确认配置”等归责用户的话术
第三步:改用“当前服务暂不可用,已自动切换至离线缓存模式”或“我们正在恢复节点,您可先保存当前代码草稿”
本地错误(如JSON解析失败、变量未定义)才使用“您输入的JSON格式有误”“变量user_id未在作用域中声明”这类指向明确的表述。
注意:【服务端错误禁止显示堆栈中的内部路径或函数名】,比如不要出现“at /srv/mashangfei/core/runner.js:217:12”。

















