千问ai生成图片卡在99%是websocket中断或缓冲区阻塞所致，需先查日志确认问题在前端渲染（采样完成）还是后端推理未启动；再按浏览器类型启用websocket、禁用硬件加速、调整quic或改用0.0.0.0启动服务并放行5000端口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
千问AI生成图片卡在99%进度不动，不是网络加载慢，而是浏览器与本地部署服务之间的WebSocket连接被意外中断或缓冲区阻塞，换浏览器可能解决部分兼容性问题，但无法绕过底层通信故障。
先确认是不是真卡在99%
打开生成页面右下角的「高级设置」→ 查看「日志输出」面板，如果最后一行是INFO:root:Sampling step 49/50或类似提示，说明模型已在本地完成全部采样，卡住的是前端渲染环节；如果日志停在INFO:root:Starting sampling...且无后续，那问题出在后端推理未启动，换浏览器毫无作用。
这一步必须做，否则盲目换浏览器只会浪费时间。
Chrome系浏览器强制启用WebSocket支持
方法一：启动时加参数绕过安全限制
关闭所有Chrome窗口→ 在终端中执行：chrome --unsafely-treat-insecure-origin-as-secure="http://localhost:5000" --user-data-dir=/tmp/chrome-test http://localhost:5000
该命令临时赋予localhost:5000全权限，避免Chrome因混合内容策略中断WebSocket连接。
方法二：禁用硬件加速
Chrome设置 → 系统 → 关闭「使用硬件加速模式（如果可用）」→ 重启浏览器。
【关键原因】某些NVIDIA驱动版本（如535.126+）与Chrome硬件加速存在纹理上传冲突，会导致Canvas渲染卡死在99%，而Firefox或Edge不受影响。
Firefox专用修复路径
第一步：地址栏输入about:config → 搜索network.http.max-persistent-connections-per-server → 双击改为6
第二步：搜索dom.webnotifications.enabled → 设为false
第三步：访问http://localhost:5000前，先在新标签页打开http://localhost:5000/health确认服务存活
第四步：按Ctrl+Shift+R硬刷新，不加载缓存
用户要生成可打印的中文字帖/练习纸、导出多页 A4 PDF 报告，或把 SVG 设计稿零误差还原到 Canvas 时使用。本技能是「Canvas 内容工厂闭环」的总控，编排：网格渲染引擎(13 种教育网格+拼音标注) → 多页 PDF 导出(A4 合成) → SVG 精准复刻(坐标误差<0.001px)。触发词：生成字帖、练习纸、导出 PDF、SVG 转 Canvas、印刷级还原、A4 报告、米字格田字格。
Firefox默认对localhost连接更宽松，但若启用了Web Notifications，会与千问Turbo的进度回调事件冲突，导致UI线程挂起。
Edge用户快速验证方案
直接在Edge地址栏输入：edge://flags/#enable-quic → 将「QUIC协议」设为Disabled → 重启Edge
QUIC在Windows 11 22H2+系统上与千问本地服务的HTTP/1.1长连接存在握手竞争，容易造成99%假死。
这一步做完立刻生效，无需清理缓存或重装。
真正该换的不是浏览器，而是启动方式
如果你用python app.py直接运行，默认只监听127.0.0.1，而某些浏览器（尤其是企业版Edge）会将localhost解析为::1（IPv6），导致连接失败却显示99%假进度。
正确做法：改用python app.py --host 0.0.0.0 --port 5000启动服务，确保IPv4/IPv6双栈可访问。
【致命前提】必须确认防火墙放行5000端口，否则即使换十种浏览器也卡99%。
