今天的主题是实现微信的聊天的气泡效果，主要用 Vue3 搭配一个叫 TinyRobot 的气泡组件。你想想，别再手写每一行 CSS，那真是个大坑。哈哈。

说实话，我Zui开始接触 Vue3 时还以为它只是个“轻量级”框架，没想到它还Neng帮你搞定这么炫酷的聊天 UI。 只要把消息对象放进 BubbleList 就Neng自动渲染成左对齐或右对齐、带头像、带小箭头的气泡。 而且整个过程dou是声明式的，你根本不用去管 DOM 树怎么变形。

小技巧：Ru果你想让用户发出的消息右对齐，只需要在 roleConfigs 给 user 角色加上 placement:"end" 就行。 代码kan起来像这样：

const roleConfigs = {
  user: { placement: 'end' },
  assistant: { placement: 'start' }
};

嘿，别忘了给 avatar 注入图标或图片，这样 UI 就geng完整啦。

流式聊天就是那种 AI 一边推理一边把结果逐字符刷出来。 Vue3 的响应式系统非常适合这件事：只要把字符串挂在 ref 上，组件就会跟着geng新。

下面演示一个Zui简易的流式例子：

import { ref } from 'vue';
const streamContent = ref;
async function start {
  const text = '正在生成中…';
  streamContent.value = '';
  for  {
    streamContent.value += ch;
    await new Promise);
  }
}

Bubble 会自动把 streamContent 渲染到气泡里不需要你手动写动画。

Bubble 内部维护一个 state 对象，用来记录“是否展开推理过程”“工具调用结果是否展开”“点赞状态”等等。 Ru果你需要自定义某条消息展开时Zuo点别扭事，只需监听 state-change 并抛给外层处理即可。

Bubble Ke以渲染文字、图片、甚至自定义卡片。 例如Ru果想插入一张生成好的图片，只要在 content 数组里加上 type:'image_url' 即可：

{
  type:'image_url',
  image_url:{ url:'https://img.example.com/123.png' }
}

Bubble 内置了图像渲染器，你也Ke以通过 contentRenderMode 切换同框还是拆成多框显示。

说实话，我也被这个问题困惑过一次。原来啊，百度主要抓取的是静态页面和常规 JS 渲染后产生的内容。Ru果页面全部靠 SPA 动态加载，而没有明显关键词或 sitemap，就hen容易被忽略。所以别忘了在 meta 标签里写清楚标题和描述，让搜索引擎知道这是一篇关于 Vue3 气泡组件实现流式聊天的小教程。

创建项目：使用 Vite 或 HBuilder 打开一个 Vue3 + TypeScript 模板。 安装 TinyRobot：npm i @opentiny/tiny-robot 在根目录下创建 BubbleProvider 包裹整个 App，并传入全局配置，例如 avatar 默认图标和内容渲染匹配规则。 在聊天页面里直接放 TrBubbleList 并传入 messages 数组与 roleConfigs。

"我先把代码贴出来然后慢慢解释"

- 用 console.log kan下 message 对象结构；Ru果发现多余字段，Ke以直接删掉，保持干净。

- Ru果 Bubble 没有渲染，那就检查一下 props 名字是不是写错了；比如用 contentRenderMode 写成了 content-render-mode 会报错。

- 对于长文本，Ke以开启 autoScroll 并加一个阈值，让滚动只在用户接近底部时生效；否则会打断查kan历史记录。

- 想给气泡加阴影或者圆角？直接改 CSS 自己写吧，TinyRobot Yi经暴露了不少 CSS Custom Property Ke以用来调色板和圆角度数。

- Ru果你发现浏览器卡顿，那可Neng是因为图片太大；记得压缩或者 lazy load 吧！哈哈哈。

- “我之前以为是 bug，其实是我忘记给 msg 加 id”——这类错误Zui好在数组里每条消息dou加唯一 id，否则后面geng新会出错哦！

- 对于多语言场景，把 content 换成对象，然后根据 locale 切换对应字段即可，不必重写 UI。

- 把你的聊天界面上传到 GitHub 或 Gitee，然后开启 CI/CD 自动化部署到 Netlify 或 Vercel，这样搜索引擎Nenggeng快抓取到Zui新内容，也Neng得到geng高访问量哦！

- 开源社区欢迎贡献 bug 修复和功Neng ，尤其是新的渲染器类型，比如 Markdown 卡片、表格展示等等。

- 给你的项目写一份 README，把核心思路、安装步骤以及 Demo 链接dou贴进去，让别人一眼kan懂如何使用。

一句话：

告别手写 CSS 的痛点，用 Vue3 + TinyRobot 气泡组件，你就Neng轻松搞定流式聊天界面再也不用担心布局炸弹啦！说真的，我Yi经用它Zuo了一款内部客服助手，效果超赞～.