卡顿问题排查
当客户反馈“系统卡”时，先不要笼统判断为性能问题，最好先确认卡在什么位置。不同位置的卡顿，瓶颈通常不一样。
1. 初次登录时页面 loading 很久
现象：打开系统后，首页首次加载时间长。
常见原因：前端静态资源拉取慢，或者带宽不足。
处理建议：
- 优先检查服务器带宽是否足够
- 高峰期场景建议提升峰值带宽
- 如果是跨地域访问，再结合 CDN 或就近部署一起看
2. 提问后，三个点卡很久，不吐字
现象：发送问题后，页面一直停留在输入中间状态，长时间没有输出。
常见原因：大模型并发能力不够，模型侧响应慢。
处理建议：
- 先看当前模型服务的并发和限流情况
- 让大模型侧同事检查模型实例、队列和资源使用情况
- 必要时提升模型侧并发能力
3. 进入“正在思考”后，查看思考链路很慢
现象：点击“正在思考”标题查看思考链路时，在 DataQuery（Alisa）工具里卡很久。
常见原因：服务器 CPU 不够，工具执行和渲染都被拖慢。
处理建议：
- 检查当前服务器 CPU 使用率
- 适当增加 CPU 配置
- 如果同机还跑了其他服务，也要一起评估资源争用
4. 在“正在查询数据”处卡住
现象：问题已经进入查询阶段，但一直停在“正在查询数据”。
常见原因：数据侧的数据库查询能力不够，可能是单条查询执行慢，也可能是并发查询能力不足。
处理建议：
- 先看数据侧数据库的慢查询、并发和负载情况
- 可以先尝试加 CPU
- 如果单机查询或并发压力持续较高，建议走集群方案
5. 整个页面都卡
现象：不是某一个步骤卡，而是页面整体都慢。
常见原因：客户本地电脑较老旧，性能较差。
处理建议：
- 先让客户换一台性能更好的电脑对比
- 再看是否存在浏览器过旧、标签页过多、内存不足等问题
排查顺序建议
- 先确认卡顿发生在具体哪一步
- 再判断是前端、模型、服务器，还是数据库问题
- 最后再决定是加带宽、加 CPU，还是扩容数据侧数据库