【AI】多窗口流式问答设计——markdown渲染卡顿

要确保多个聊天窗口切换时 Markdown 渲染不会造成卡顿,关键不是简单地优化 Markdown 解析速度,而是要解决三个问题:

  1. 渲染隔离: A 窗口收到 Token 时,不能导致 B 窗口重新渲染。
  2. 增量渲染: 不要每收到一个 Token,就重新解析整篇 Markdown。
  3. 渲染缓存: 切换窗口时,已经完成的 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 渲染

注意:代码高亮,先显示普通代码文本,代码块闭合后再执行语法高亮。

最后更新: 2026年11月17日 16:47