← 返回文章列表
李奕锦的个人网站所属专题:架构之道

H5 全球智能客服架构白皮书:实用主义的工程艺术

更新于 2025-12-07年份:2025字数:2,600阅读时长:7 分钟

在构建服务于全球业务场景的 H5 客服应用时,面临"多维象限挑战":AI 流式响应与多国网络、后台管理能力与 C 端轻量化体验。本架构奉行"高可用实用主义",以若依 Vue3 为骨、Vue3 为魂、双 UI 为皮,打造可快速迭代、安全可溯源的全球化对话容器。

前言

做这个全球化 H5 客服应用,约束不少:AI 对话要流式响应,又要兼容多国弱网;后台管理要复用成熟方案,C 端还要轻。我们没追求"纯洁架构",而是选了实用路线:若依 Vue3 做底座,Vue3 打底,双 UI 分别伺候桌面和移动端,目标是快速迭代、安全可溯源。

一、基座选型:若依 + 业务定制

Time-to-Market 是第一位的。若依 Vue3 不是银弹,但用户体系、字典、权限这些后台能力不用重造,省不少事。

我们的策略是"做减法和做加法":

减法:permission.js 里把复杂 RBAC 注释掉,改成基于 Token 的轻量放行,适配 App 内嵌和第三方免登。
加法:重点砸在 /chat 核心域做业务定制。

这样一来,研发从"从零搭架子"变成"在现成底座上装修",隐性成本低很多。

二、编译与构建:Vue3 + Vite 5

Webpack 像重型卡车,Vite 5 更像轻量跑车。客服系统功能多,开发体验直接影响代码质量。

我们用 Composition API 和 script setup 拆逻辑,AI、STT、TTS 等模块可以灵活组合。生产环境 terser 压代码、去注释,海外弱网下首屏也能尽量顺滑。

三、界面策略:Element Plus + Vant 双 UI

一般不太会同时上两个 UI 库,但我们这边场景特殊:Element Plus 负责后台配置、知识库管理,Vant 负责 H5 聊天窗口,一个做桌面厚重感,一个做触控反馈。

用 unplugin-vue-components 配合 VantResolver 做按需加载,Tree-Shaking 后只打包用到的组件,体积和加载速度都能控住。

四、连通性与全球化:Hash 路由 + i18n + 全链路追踪

Hash 模式:放弃 History 的优雅 URL,用 createWebHashHistory 和 base: './'。CDN 托管、App WebView、无 Nginx 权限的第三方环境都能跑,部署在哪都能独立工作。
i18n:支持 zh/en/ja/ko,不光是翻译,URL 参数和 LocalStorage 双锚点,跳转时语言不会丢。
Trace & Security:Axios 拦截器层做自定义加密和 Trace-Id。每次 AI 对话打上标记,出问题时能快速区分是网络抖动、接口超时还是 LLM 幻觉。流式响应支持打字机效果,等待体验好一些。

五、总结

这套东西是场景逼出来的,不是堆技术。

若依提供骨架,Vite 提供构建速度,Hash 路由适应复杂部署,Trace ID 做全链路监控。后台厚重、前台轻灵,算是一个有企业级厚度又有消费级灵动的 H5 架构。

阅读时长:7 分钟


文档信息

版权声明:自由转载-非商用-非衍生-保持署名(CC BY-NC-ND 3.0)

原文链接:https://yijinlee.com/share-future/article-7

作者:李奕锦

商业用途或修改衍生请联系授权。


TL;DR

  • 基座选型:若依 Vue3 做减法(轻量 Token 放行)与加法(/chat 核心域深度定制),研发效能从"搭积木"提升到"装修豪宅"。
  • 构建与 UI:Vite 5 + Composition API 极速开发;Element Plus + Vant 双 UI 按需 Tree-Shaking,兼顾后台厚重与 H5 灵动。
  • 连通性:Hash 路由 + i18n 多语言 + Trace-Id 全链路监控 + 流式响应,打造既有企业级厚度又有消费级灵动的全球化 H5 架构。
Tags:若依 Vue3Vite 5Element PlusVantHash 路由i18n 国际化全链路追踪流式响应

该专题下的阅读路径

系统设计原则 → 工程化实践 → 技术选型与重构