【AI】多窗口流式问答设计——markdown渲染卡顿
要确保多个聊天窗口切换时 Markdown 渲染不会造成卡顿,关键不是简单地优化 Markdown 解析速度,而是要解决三个问题:
- 渲染隔离: A 窗口收到 Token 时,不能导致 B 窗口重新渲染。
- 增量渲染: 不要每收到一个 Token,就重新解析整篇 Markdown。
- 渲染缓存: 切换窗口时,已经完成的 Markdown 内容不应该重新解析。
技术栈:Vue 3 + Pinia + Dify SSE
核心思想:会话状态隔离 + 消息组件隔离 + Markdown 增量渲染 + 请求级更新节流。
一、整体优化架构
Markdown 渲染优化架构

二、聊天窗口组件隔离
不要把所有窗口的 Markdown 渲染都写在一个大型聊天组件中。
进行拆分:
1 2 3 4 5 6 7 8 9 10 11 12
| ChatPage ├── ConversationList └── ChatContainer ├── ChatWindow A │ ├── MessageItem │ └── MarkdownRenderer ├── ChatWindow B │ ├── MessageItem │ └── MarkdownRenderer └── ChatWindow C ├── MessageItem └── MarkdownRenderer
|
Vue 中使用 v-show 控制窗口显示,而不是频繁销毁组件:
1 2 3 4 5 6 7 8 9 10 11
| <template> <div v-for="session in sessions" :key="session.id" v-show="activeSessionId === session.id" > <ChatWindow :session-id="session.id" /> </div> </template>
|
这样切换窗口时,已经挂载的组件可以保留内部状态。
注意:v-show 只隐藏组件,并不会自动阻止它的响应式更新。因此还需要后面的消息级隔离。
如果会话数量很多,不要一次挂载全部窗口,使用 KeepAlive 或只保留当前窗口和少量最近访问窗口。
三、消息级组件隔离
使用独立的 MessageItem 组件:
1 2 3 4 5 6 7 8 9 10
| <!-- ChatWindow.vue --> <template> <div class="chat-window"> <MessageItem v-for="message in messages" :key="message.id" :message="message" /> </div> </template>
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
| // MessageItem.vue <script setup lang="ts"> import { computed } from 'vue';
const props = defineProps<{ message: ChatMessage }>();
const content = computed(() => props.message.content); </script>
<template> <div class="message-item"> <MarkdownRenderer :content="content" :streaming="message.status === 'streaming'" /> </div> </template>
|
注意:
- MessageItem 使用稳定的 messageId 作为 key。
- 不要给所有消息传递一个不断变化的全局对象。
- 不要在父组件中计算所有消息的 Markdown HTML。
- 不要因为一个消息变化而重建所有消息组件。
四、Markdown 增量渲染
解决长文本流式输出卡顿的核心。
假设 AI 正在生成一篇 10000 字的回答。
传统方式:
1 2 3
| watch(content, (value) => { html.value = marked.parse(value); });
|
每收到一个 Token,就重新解析全部内容。
假设最终有 3000 次 Token 更新,那么可能产生 3000 次完整 Markdown 解析。
这会造成明显的性能浪费。
4.1 缓冲区 + 节流渲染
将高频 Token 更新合并为每 50ms 一次。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
| import { ref } from 'vue'; import { marked } from 'marked';
const content = ref(''); const renderedHtml = ref('');
let buffer = ''; let timer: number | null = null;
function appendToken(token: string) { buffer += token;
if (timer !== null) return;
timer = window.setTimeout(() => { content.value += buffer; buffer = '';
renderedHtml.value = marked.parse(content.value) as string;
timer = null; }, 50); }
|
不过,这仍然是全量 Markdown 解析,只是减少了解析次数。
对于长文本,我更推荐下面的进一步优化。
4.2 已完成块缓存 + 当前块增量渲染
Markdown 内容天然可以按照块进行组织:
把已经结束的 Markdown 块进行缓存,只重新解析最后一个尚未完成的块。
例如:
1 2 3 4 5 6 7 8 9 10 11 12
| AI 正在输出:
# RAG 架构
RAG 主要由以下几个部分组成:
1. 文档解析 2. 向量化 3. 向量检索
目前正在生成: 4. 重排序
|
可以将前三部分作为已经完成的块缓存,只对最后正在生成的部分重新渲染。
伪代码:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
| interface MarkdownBlock { id: string; source: string; html: string; completed: boolean; }
const blocks: MarkdownBlock[] = [];
function updateMarkdownBlock( block: MarkdownBlock, newContent: string ) { block.source += newContent;
if (isBlockComplete(block.source)) { block.html = marked.parse(block.source) as string; block.completed = true; } else { block.html = marked.parse(block.source) as string; } }
|
这里的 isBlockComplete() 不能只判断是否出现换行符。生产实现需要识别 Markdown 块边界,并正确处理尚未闭合的代码围栏、表格、列表和引用。
如果要支持复杂 Markdown,我建议使用专门的流式 Markdown 解析器,或者自己实现可靠的块级状态机,而不是简单通过正则表达式切分。
五、切换窗口时不重新渲染 Markdown
增加一个 Markdown 缓存层。
1 2 3 4 5 6 7
| interface MarkdownCache { messageId: string; source: string; html: string; version: number; completed: boolean; }
|
基本逻辑:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
| const markdownCache = new Map<string, MarkdownCache>();
function renderMessage(message: ChatMessage) { const cache = markdownCache.get(message.id);
if ( cache && cache.source === message.content && cache.completed === (message.status === 'completed') ) { return cache.html; }
const html = marked.parse(message.content) as string;
markdownCache.set(message.id, { messageId: message.id, source: message.content, html, version: (cache?.version || 0) + 1, completed: message.status === 'completed' });
return html; }
|
缓存策略:
| 消息状态 |
Markdown 策略 |
| 正在生成 |
节流 + 当前块重新解析 |
| 生成完成 |
全量解析一次,缓存 HTML |
| 已完成且未修改 |
直接使用缓存 |
| 编辑或重新生成 |
清理对应消息缓存 |
| 切换窗口 |
不重新解析 |
注意:切换窗口时尽量不要重新创建 MarkdownRenderer。
六、处理代码块、表格等复杂内容
大模型回答中经常有:
1 2 3 4 5 6 7 8 9 10 11 12 13
|
普通段落
`` print("Hello World") ``
| 名称 | 说明 | | ----- | --- | | Redis | 缓存 | | MySQL | 数据库 |
|
这些内容在流式生成时比较特殊。
例如,代码块尚未收到结束的三个反引号时,Markdown 解析器可能无法正确判断代码块是否结束。
处理:
| Markdown 类型 |
处理策略 |
| 普通文本 |
按段落增量渲染 |
| 标题 |
检测换行后确定块完成 |
| 列表 |
当前列表整体更新 |
| 代码块 |
闭合后再做最终高亮 |
| 表格 |
当前表格完成后再做最终渲染 |
| 数学公式 |
公式边界完整后再进行 KaTeX 渲染 |
注意:代码高亮,先显示普通代码文本,代码块闭合后再执行语法高亮。