对话界面:组件边界与流式渲染
结论
对话界面按“谁拥有状态”拆分,而不是按视觉区块拆分。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、代码高亮、复制按钮和消息重新生成;这些都应该在纯文本渲染稳定后再加。
- 来源只展示标题和序号,不展示相似度分数;分数是调试信息,不适合直接暴露给普通读者。
- 消息区没有虚拟列表。当前对话规模很小,长会话需要另做窗口化或分页。
下一篇看同一套对话怎样装进两个入口:独立页面和全站浮窗。