跳到主要内容
Ed. notes

对话界面:组件边界与流式渲染

长文 · 2026-11-12 · 合集第 6 / 10 篇

  • Vue
  • 组件设计
  • 流式渲染
第 6 / 10 篇 · 查看全部章节 → 当前:对话界面:组件边界与流式渲染

结论

对话界面按“谁拥有状态”拆分,而不是按视觉区块拆分。ChatConversation 拥有布局和交互出口,ChatMessageItem 只渲染一条消息,ChatSources 只渲染引用,ChatComposer 只管理草稿。

这样做的直接好处是:页面和浮窗可以共用同一套 UI,而 useChat() 不需要知道任何 CSS 或 DOM。

问题与设计

一个常见的写法是把请求、消息列表、输入框和来源都塞进一个 Chat.vue。第一版能跑,但很快会出现三个问题:

  • 浮窗和独立页面要复制一遍布局与状态。
  • 流式 token 每次更新都可能触发整块组件重渲染,输入框也被牵连。
  • 想测试“生成中按钮变成停止”时,必须先 mock 整个请求链路。

组件边界按职责划开后:

组件 输入 输出 不做什么
ChatConversation messages、busy、error send、stop、retry 不发请求,不解析事件
ChatMessageItem 一条 ChatMessage 无 不判断全局错误
ChatSources ChatSource[] 无 不请求来源详情
ChatComposer busy send、stop 不保存会话历史

ChatConversation 的布局是两行消息区加一行输入区:

<section aria-label="与 AI 助手的对话">
  <div role="log" aria-live="polite" aria-relevant="additions text">
    <div v-if="!messages.length">有什么想了解的?</div>
    <ChatMessageItem v-for="message in messages" :key="message.id" :message="message" />
  </div>
  <p v-if="error" role="alert">{{ error }} <button @click="$emit('retry')">重试</button></p>
  <p v-else-if="busy" role="status">正在生成回答…</p>
  <ChatComposer :busy="busy" @send="$emit('send', $event)" @stop="$emit('stop')" />
</section>

消息区使用 display: grid,外层再配合 grid-template-rows: minmax(0, 1fr) auto auto。minmax(0, 1fr) 很重要:默认的 1fr 允许内容把网格撑破,长回答会把输入框挤出容器。

单条消息按状态分支,而不是用一堆互斥布尔值:

<p v-if="message.content">{{ message.content }}</p>
<p v-else-if="message.status === 'streaming'">正在思考…</p>
<p v-else-if="message.status === 'error'">回答生成失败。请检查连接后重试。</p>
<p v-else-if="message.status === 'cancelled'">回答已停止。</p>
<ChatSources v-if="message.role === 'assistant'" :sources="message.sources" />

这里选择纯文本渲染:

.content {
  margin: 0;
  white-space: pre-wrap;
  overflow-wrap: anywhere;
}

pre-wrap 保留模型输出里的换行,overflow-wrap: anywhere 防止长 URL 或连续英文撑破卡片。没有使用 v-html,原因是流式回答天然不完整:Markdown 代码块可能只到一半,直接渲染会闪烁;更重要的是,模型输出属于不可信内容,不能直接变成 HTML。以后要支持 Markdown,也应先引入白名单清洗,再在完整消息上渲染。

来源列表在回答开始前就可以出现,因为 sources 事件先于 token 到达:

<li v-for="source in sources" :key="source.n">
  <NuxtLink :to="source.url">
    <span>[{{ source.n }}]</span>
    <span>{{ source.title }}</span>
  </NuxtLink>
</li>

source.url 由后端根据站内 slug 生成,前端不拼接路径;这样来源链接和内容管线的规则保持一致。

输入框的草稿属于组件本地状态,不属于会话历史。发送时只把 trim 后的文本抛给父组件,然后清空:

function submit() {
  if (props.busy || !draft.value.trim()) return
  emit('send', draft.value.trim())
  draft.value = ''
}

生成期间 textarea 被禁用,主按钮从“发送”换成“停止生成”。这比同时显示两个按钮更清楚:当前只有一个可执行动作。

验证

流式渲染的核心验证放在 useChat 层:先推一个 token,断言页面文本出现;再推第二个 token,断言文本按顺序拼接;最后发 done,断言状态完成。组件的视觉与布局由端到端测试补:

cd frontend
npm run test -- tests/nuxt/chat.spec.ts
npx playwright test e2e/site.spec.ts

端到端会检查 /chat 页面有标题、浮窗在笔记页可以打开,以及 390 / 768 / 1440 三个宽度下不出现横向溢出。

边界

  • 当前没有自动跟随滚动。消息超过可视区后,新 token 可能在视口外;以后补自动滚动时,要先判断用户是否仍停留在底部,不能在用户向上阅读时强行拉回。
  • 输入框用 @keydown.enter.exact.prevent 发送,中文输入法组词时按 Enter 可能提前提交。正式发布前应检查 event.isComposing,并补一条输入法场景的测试。
  • 没有 Markdown、代码高亮、复制按钮和消息重新生成;这些都应该在纯文本渲染稳定后再加。
  • 来源只展示标题和序号,不展示相似度分数;分数是调试信息,不适合直接暴露给普通读者。
  • 消息区没有虚拟列表。当前对话规模很小,长会话需要另做窗口化或分页。

下一篇看同一套对话怎样装进两个入口:独立页面和全站浮窗。