功能定位：为什么“看日志”成了课堂第一痛点
在 HelloWorld IDE & Sandbox 里，学生只需点▶️即可运行 60+ 语言，但“运行失败”弹窗常把新手卡住：终端刷出 40 行红色堆栈，却不知哪一句是自己写的。v6.3.0 把“零样本调试”做成默认面板，核心目标只有一个——把排错时间从两位数分钟压到个位数分钟，且无需教师贴身指导。
与传统方案相比，旧流程是“复制终端→贴到搜索引擎→逐条比对”，现在改为“上传日志→AI 直接圈出代码行→生成 patch 预览”。经验性观察：课堂实测 30 人同时报错时，教师答疑轮次从 3 轮降到 1 轮，课堂节奏不被拖堂。
三条最短路径：桌面、平板、手机分别怎么进
桌面端（Win / macOS / Linux）
运行失败后，右下角自动弹出“零样本调试”蓝色按钮；若误关，可再进：Menu → Help → Diagnostic → Zero-Shot Debugger。上传文件大小上限 5 MB，默认已勾选“仅上传 stderr+stdout”，不含源码，合规风险低。
平板端（iPadOS & Android 13+）
由于屏幕限制，先点顶部闪电图标展开“运行抽屉”，再点“...”→Export Log → AI Debug。系统会弹出系统级分享表，可选“保存到文件”或“直接上传”。注意：iPad 分屏状态下上传按钮可能被键盘遮挡，需先收起键盘。
手机端（PWA 小程序）
运行失败后，状态栏会出现红色“!”浮标，长按即可调出“一键诊断”。若网络为教育网 CN 节点，上传耗时约 2 秒；若用海外节点，可能 7–10 秒，建议课前统一让学生切到Settings → Network → Endpoint: cn-helloworld.ai。
操作分支：当 AI 也“看不懂”时要干嘛
AI 返回“Unable to locate source”通常有三种诱因：1) 日志被截断，2) 代码用了宏展开，3) 多文件项目未打包。此时面板会提供“高级上传”开关，勾选后可附加 project.zip（最大 20 MB），AI 会基于抽象语法树再跑一次定位，耗时约 30 秒。
如果仍失败，可回退到人工模式：点击“Copy raw log”→贴到教师群。该按钮会保留 ANSI 颜色码，方便教师用本地 less -R 还原高亮。
副作用与取舍：隐私、额度、课堂纪律
警告：上传日志即代表同意“临时云处理协议”
日志会在官方对象存储保留 24 h 用于模型迭代，之后自动清理。若含学生姓名、学号，建议先用“查找替换”脱敏。官方尚未提供本地私有化模型，敏感代码请谨慎上传。
免费版每日 50 次 AI 请求，含补全+调试。课堂 30 人、每人报错 2 次即可耗尽额度。经验性观察：教师提前把“常见编译错误”做成 snippet，可让 60% 问题在本地解决，剩余 40% 再动用 AI，额度足够覆盖全天。
与第三方 Bot 协同：把日志推送到钉钉、飞书
在Settings → Integration → Webhook 填入群机器人地址，勾选“仅推送摘要”。AI 返回的 patch 会以 Markdown 格式发送，包含文件行号与 diff 片段，方便教师在群里直接@学生。权限最小化原则：关闭“推送完整代码”开关，避免 diff 被扩散。
故障排查表：现象→原因→验证→处置
| 现象 | 最可能原因 | 验证动作 | 处置 |
|---|---|---|---|
| 上传后一直“转圈” | 教育网节点 TLS 1.3 被中间设备重置 | 浏览器 DevTools → Network，看是否 4xx | 切到海外节点或手机热点重试 |
| AI 定位行号错位 | 宏展开后行号漂移 | 对比原始行号与预处理输出 | 用“高级上传”带 project.zip |
| 返回空白 patch | 日志仅含“Killed”，无错误栈 | 查看容器内存指标是否超限 | 减少数组尺寸或申请延长容器内存 |
适用/不适用场景清单
- 适用：高校大班课、算法赛日常训练、技术博客作者给读者提供可运行 Demo。
- 不适用：含个人隐私数据的医疗项目、需等保三级合规的政企内训、离线断网考场。
判断标准：若代码不能离开本地电脑，就不要上传；若只是常见语法/逻辑错误，可放心用 AI 加速。
最佳实践 6 条：让日志一次就传完、一次就修完
- 课前统一把 Endpoint 切到国内节点，减少 TLS 重传。
- 学生机默认勾选“Auto-save before run”，保证日志与最新代码对齐。
- 教师提前录制 1 分钟 GIF，演示“如何点 AI Debug”，降低心理门槛。
- 把每日 AI 额度可视化：顶部导航条会实时显示剩余次数，颜色变黄即提醒省着用。
- 遇到“Killed by signal 9”先让学生自查内存，而非直接上传，避免浪费次数。
- 日志上传后，先让学生自己读 AI 给出的 patch，再举手确认，培养先思考后求助的习惯。
FAQ：官方已确认的 5 个高频疑问
上传的日志会保存多久？
24 小时后自动删除，期间仅用于模型迭代，不会对外公开。
额度用完还能看日志吗？
可以，只是 AI 不再生成 patch；仍可手动复制原始日志自行分析。
Swift 6 并发误报 Data race 怎么办？
在 assistant 面板输入 /sentinel off 可临时关闭 sentinel，等待后续编译器更新。
能否本地部署 AI 模型？
截至当前的最新版本未开放本地模型，官方论坛仅表示“在评估”，暂无时间表。
日志文件过大被截断如何处理？
用“高级上传”打包 project.zip，或在代码里减少循环打印，分批次输出。
收尾：下一步行动清单
看完本文，你只需做 3 件事就能让课堂排错效率翻倍：1) 把本文“最佳实践 6 条”贴到课程主页；2) 课前 5 分钟带学生走一遍“零样本调试”按钮；3) 打开Settings → Network 确认国内节点已启用。运行失败不再等于课时失控，而是 3 分钟内的可控插曲。
