11 月 13 日,DeepSeek 发布了全家桶应用 API,同时在 GitHub 开源了官方网页端示例 chat-demo。
和常见的"一个输入框 + 调一下文本流接口"的玩具 Demo 不同,DeepSeek 这次开源的是一个纯浏览器直连 API 的完整网页应用 :除了流式对话,它把深度思考、联网搜索、边想边搜、网页链接阅读、多模态文件上传、语音输入、流式语音朗读、完整消息分支树,以及 ZIP 历史归档导入导出全部装进了同一个前端工程里。
官方原版基于 React 18 + Zustand 编写,仅 src 下的生产源码(不含图标静态载荷)就有 18,412 行。
看到这个项目时,作为一名 Vue 开发者,我脑子里立刻冒出了一个念头:如果用 Vue 3 来重构这套应用,能不能 100% 复刻它的核心功能,顺手再补上开发者呼声很高的 MCP 工具和 Skill 指令管理,同时把代码量压得更低?
说干就干。借助 OpenTiny 开源的 Vue 3 AI 对话组件库与运行时套件 TinyRobot,我结合 AI 用了几个小时就跑通了核心复刻与三轮架构演进:
- 核心功能 100% 还原 :完整保留原版协议、消息分支树、搜索引用、文件补传与语音链路,甚至连导出的 v3 ZIP 历史归档包都能和官方 React 版双向无缝互导 (基于
chat-demo v0.1.1版本的核心功能完整复刻,实际工程落地中局部样式和边角细节上可能会存在少许差异); - 功能更强 :在左下角新增了 MCP 工具连接调用 与 Skill 指令管理(支持本地 Markdown、文件夹及 GitHub 仓库导入);
- 代码更少 :在统一
oxfmt格式化口径的统计快照下,生产源码从官方的 18,412 行 一路精简至 13,368 行 ,净减 5,044 行(减少 27.40%)------而且这 13,368 行里还包含了新增的 MCP 与 Skill 逻辑!
先直接看同数据条件下的实机界面对照:

~DeepSeek 官方 React 原版界面~

~Vue 3 + TinyRobot 复刻版界面(左下角新增 MCP / Skills 扩展入口)~
这篇文章就结合真实源码与三次架构迭代(中间还踩了一个"引入高级套件后代码反而变多"的反直觉大坑),聊聊如何用 Vue 3 + TinyRobot 高效构建一个功能完整的复杂 AI 对话应用。
一、真正的复刻难点,全藏在"聊天框"之外
很多人觉得写个 AI 聊天页面很简单:v-for 渲染几条消息,fetch 读一下 SSE 文本流就完事了。但当你真正拆开 DeepSeek 官方 chat-demo 的源码,就会发现一个成熟 AI 网页应用的复杂度,90% 都藏在水面之下:
- 不是普通纯文本流,而是富语义内容块协议 官方
chat-demo及本次复刻采用的是 Anthropic 兼容的 Messages / Files 扩展接口(模型为deepseek-flash)。一次回复里可能交错包含流式思考过程(带thinking签名透传)、服务端联网搜索(deepseek_web_search)、网页阅读(deepseek_read_url)、正文角标引用浮层,以及右侧独立的搜索来源抽屉。若简单替换为纯文本流接口,会丢失这些结构化内容块,难以完整还原对应交互。 - 不是线性消息数组,而是完整的"消息分支树" 修改某条历史提问、点击重新生成、左右切换历史回答版本、在符合条件时继续生成------会话底层保存的是一棵完整的树,UI 渲染和上下文组装只投影当前选中的分支路径。
- 复杂的多模态文件与语音生命周期 文件支持点击选择、剪贴板粘贴、全窗口拖拽上传,带有并发上传状态与失败重试;更细节的是,当用户从 ZIP 归档导入历史对话时,本地图片并没有服务端
file_id(或者旧file_id已过期),发送前必须自动读取 IndexedDB 本地原件静默补传,并把新serverId回写到会话树所有引用该附件的节点上。语音侧则包含最长 120 秒的浏览器 WAV 录音(带实时波形绘制与 ASR 转写)和流式 PCM TTS 边下边播。 - 富文本与多端体验细节 Markdown 渲染需要同时搞定 Prism 浅/深色语法高亮、KaTeX 数学公式、Mermaid 流程图与源码视图切换;同时支持中英双语、浅色/深色/跟随系统主题、桌面三栏与移动端抽屉自适应。
- 官方 v3 ZIP 归档双向互操作 从官方 React 版导出的 ZIP 归档包,导入我们的 Vue 版需要恢复出所有消息分支与图片原件;反过来从 Vue 版导出再导回官方版,也需要做到兼容;且一旦导入校验或事务中途失败,不能破坏浏览器里已有的旧历史。

深色模式与右侧搜索结果来源面板

移动端自适应布局与富文本公式渲染
在这次复刻中,原版经过验证的底层 API 协议解析、归档格式转换与音频处理逻辑保留了上游 MIT 授权实现及出处声明;而整个视图层、响应式状态编排、会话运行时与交互组件,则完全基于 Vue 3 + TinyRobot 重建。
二、不止于 100% 复刻:新增 Skills 与 MCP 扩展能力
既然用上了专门面向 AI 场景的组件库,只做到"和原版一样"还不够过瘾。我们在侧边栏底部新增了 ✧ MCP / Skills 扩展面板,给这个纯前端应用装上了两项实用增强:
1. Skills 指令管理(一键从本地或 GitHub 导入)
日常使用大模型时,我们经常需要切换不同的预设规范(如代码审查规范、翻译风格、SQL 编写约束)。在扩展面板中:
- 支持直接选择本地
.md文件导入为 Skill; - 直接集成了 TinyRobot 内置的
<TrSkillImportForm />组件,支持从本地文件夹或 GitHub 仓库直接导入 Skill; - 勾选启用的 Skill 会持久化在本地,并在后续每次对话时自动注入请求的
system上下文。
2. 浏览器直连 MCP 工具服务
通过集成官方 @modelcontextprotocol/sdk 的 StreamableHTTPClientTransport,应用支持在网页端直接配置并连接支持 CORS 的 HTTPS(或本机 HTTP)MCP 服务:
- 自动完成协议握手与工具分页发现(包含分页游标防死循环保护);
- 自动解析并展示每个工具的
inputSchema参数结构; - 用户填写参数并弹窗确认后发起真实远程调用,返回结果会快照绑定当时的服务、工具名与参数,点击即可一键拼入聊天输入框交给 DeepSeek 继续推理。

~连接本机真实 HTTP MCP 服务并完成工具发现与调用~
工程边界说明 :受限于纯前端浏览器沙箱,网页无法直接拉起本机
stdio进程(若有需要可通过本地 HTTP 桥接接入);同时这里的 MCP 设计为用户显式选择并确认调用,与 DeepSeek 服务端的原生联网搜索各走各的真实协议链路,不拿 Mock 假数据冒充工具调用。
三、三次架构演进:为什么代码能少写 5,044 行?
复刻过程中最值得分享的,其实不是"一次写完",而是我们为了追求更少的代码、更清晰的架构边界所经历的三次演进------中间还踩了一个非常有代表性的坑。
在完全相同的统计口径下(全部使用 oxfmt 0.48.0 默认规则格式化 src,统计 TS/TSX/Vue/CSS/HTML/JSON,排除测试、构建产物与图标静态载荷,保留所有静态业务数据),四个阶段的代码量变化如下:
| 版本阶段 | 生产源码行数 | 源码字节数 | 相对官方行数变化 |
|---|---|---|---|
| DeepSeek 官方原版 (React) | 18,412 | 531,178 | 基线 |
| 阶段一:TinyRobot 独立组件组合版 | 14,065 | 414,462 | -23.61% |
| 阶段二:仅接入 ChatUI 界面套件版 | 14,396 | 421,592 | -21.81%(反增 331 行!) |
| 阶段三:Kit + Chat Runtime 重构版 | 13,368 | 395,835 | -27.40%(净减 5,044 行) |
阶段一:用原子组件搭积木(18,412 行 → 14,065 行)
第一版我们采用最直观的思路:使用 @opentiny/tiny-robot 提供的 TrLayout、TrSender、TrBubble、TrAttachments、TrDragOverlay 等独立组件替换原版手写的聊天界面部件,把 React + Zustand 改写为 Vue 3 响应式状态。
这一步让生产源码净减少了 4,347 行。但复盘源码时我们发现:会话列表缓存、流式请求取消(AbortController)、自动保存防抖队列等通用聊天逻辑,依然是我们自己在业务 store 里手写的。
阶段二:反直觉的一幕------上了 ChatUI 套件,代码怎么还多了 331 行?
TinyRobot 其实提供了更高层的 @opentiny/tiny-robot-chat 对话应用套件。于是我们在新目录接入了 <TrChatUI />,用它内置的侧边栏、历史分组列表、欢迎页、消息流自动滚动、输入框和右侧面板取代了原本分散的页面编排。
结果跑完代码统计脚本一看:代码量不仅没降,反而从 14,065 行涨到了 14,396 行!
拆解源码后,原因一目了然:
- 只接入了 UI 层,尚未交出运行时 :虽然界面交给了
TrChatUI渲染,但底层会话状态、流式合并和取消生命周期仍然由旧的业务useChatStore自己维护,反而多写了一层把业务状态转换成ChatUIData的适配代码; - 新旧样式叠加:旧版布局 CSS 没清理干净,又叠加上了套件覆盖样式。
这也给我们提了一个醒:UI 由组件库渲染,不代表状态和生命周期也交给了框架。
阶段三:让 Kit + Chat Runtime 真正成为运行时主体(降至 13,368 行)
找到病灶后,我们在第三阶段做了一次彻底的"瘦身重构":把通用聊天运行时完全移交给 @opentiny/tiny-robot-kit 与 @opentiny/tiny-robot-chat。
重构后的职责划分变得非常清爽:
text
用户输入 / 附件 / 语音
│
▼
Chat Runtime Actions (useChatRuntimeFromConversation)
│
▼
Kit 会话与消息引擎 (useConversation + 每会话 useMessage Engine)
├──► DeepSeek ResponseProvider (仅专注服务端搜索/思考签名/文件补传协议)
├──► IndexedDB 存储适配 ◄──► DeepSeek v3 ZIP 原子归档互操作
└──► 当前分支只读投影 ──► useChatRuntimeAdapter ──► TrChatUI 内置界面
这一轮重构下来,生产源码相对上一阶段净减少了 1,028 行:
- 移除了自管的会话缓存状态机、请求
AbortController生命周期与流刷新调度,交由 Kit 的useConversation与useMessage接管; - 移除了手写的设置下拉框定位、键盘上下导航与点击外部关闭逻辑,直接复用
TrDropdownMenu; - 移除了手写的 MCP JSON-RPC / SSE 底层通信代码,改用官方 SDK;
- 清理了旧布局冗余规则与重复主题变量。
要知道,剩下的 13,368 行里,静态扩展名、地区数据与多语言相关文件占了 1,825 行(其中仅 uploadExts.ts 一个静态扩展名数组就占了 986 行),v3 ZIP 归档兼容占了 1,753 行。在保留全部静态业务数据并新增了 MCP/Skill 功能的前提下,比官方原版少写 27.40% 的源码,这就是框架分层复用带来的直观收益。
四、源码拆解:TinyRobot 为什么既能"省代码",又不限制深度定制?
做过复杂 AI 应用的前端同学常会遇到这种两难:用高度封装的 Chat 组件库,改不动底层协议;全部自己手搓,又得重复造几千行气泡、输入框和滚动控制的轮子。
在这次复刻 deepseek-chat-demo-vue 的过程中,TinyRobot 的三层渐进式架构很好地化解了这个矛盾:
- 第一层
@opentiny/tiny-robot(原子组件层) :提供TrBubble、TrSender、TrAttachments、TrDragOverlay、TrDropdownMenu、TrSkillImportForm等高质量基础积木; - 第二层
@opentiny/tiny-robot-kit(无头运行时层) :提供与具体 UI 解耦的useConversation、useMessage、ResponseProvider等组合式 API,托管多会话切换、流式块消费、请求取消与节流持久化; - 第三层
@opentiny/tiny-robot-chat(对话套件层) :提供开箱即用的TrChat、TrChatUI与useChatRuntimeAdapter,一站式搞定三栏响应式布局、历史会话管理、自动贴底滚动与侧边栏抽屉。
下面挑两个项目里的真实代码片段(省略了部分细节,完整实现见文末公开源码分支),看看它是怎么工作的。
1. 用 useConversation + 自定义 ResponseProvider 无损承载复杂协议
在 src/services/chat/store.ts 中,我们不需要把 DeepSeek 复杂的消息分支树强行拍平成纯字符串,而是利用 Kit 消息对象的扩展字段承载完整的 deepseek 领域消息,并在发起对话时将自定义的 createDeepSeekProvider 挂载到对应会话的 engine 上:
ts
// src/services/chat/store.ts(核心结构节选)
import { useConversation, type ChatMessage } from '@opentiny/tiny-robot-kit'
import { useChatRuntimeFromConversation } from '@opentiny/tiny-robot-chat'
import { createDeepSeekProvider } from './provider.js'
const wrap = (message: Message): ChatMessage => ({
id: message.id,
role: message.role,
content: '',
deepseek: message, // 完整保留思考过程、签名、搜索引用与分支父子指针
historyEpoch,
})
export const conversation = useConversation({
autoSaveMessages: true,
autoSaveThrottle: 250,
storage: {
loadConversations: loadList,
loadMessages: async (id) => { /* 从 IndexedDB 加载并包装为 ChatMessage[] */ },
saveConversation: async (item) => db.renameSession(item.id, item.title || ''),
saveMessages: async (id, messages) => { /* 按会话串行落盘 */ },
deleteConversation: async (id) => db.deleteSession(id),
},
useMessageOptions: {
responseProvider: async () => { throw new Error('No DeepSeek request prepared') },
onCompletionChunk({ currentMessage, choice }) {
const message = choice.delta?.deepseek as AssistantMessage
Object.assign(currentMessage, wrap(message))
},
},
})
// 发送时为当前会话引擎注入 DeepSeek 专属 ResponseProvider,由 Kit 接管流消费与取消
function run(id: string, initial: AssistantMessage, request: Request) {
const engine = engines.get(id)!
engine.responseProvider.value = createDeepSeekProvider({ /* 领域回调 */ })(id, initial, request)
void engine.send()
}
export const kitRuntime = useChatRuntimeFromConversation({
conversation,
send: ({ conversationId }) => sendMessage(conversationId),
})
而在 provider.ts 里,我们只需专心处理 DeepSeek 独有的业务逻辑(比如附件过期补传、拼装启用后的 skillContext()、解析搜索与思考 SSE 事件),取消信号 signal 和引擎状态流转全部由 Kit 托管。
2. useChatRuntimeAdapter + TrChatUI:保留受控输入的灵活性
为什么我们在 App.vue 里没有直接使用开箱即用的默认集成组件 <TrChat />,而是采用了套件公开的 useChatRuntimeAdapter + TrChatUI 组合?
因为 DeepSeek 原版有一个非常细腻的产品体验:每个会话各自保留未发送的草稿,且语音转写结果、上传附件和 MCP 工具返回值都要能写入当前草稿 。而当前版本的默认 <TrChat /> 在切换会话时会自动清空内置输入草稿。
通过 useChatRuntimeAdapter + TrChatUI 配合语义化插槽,我们既复用了整套布局、历史会话列表、自动滚动和右栏抽屉,又精准保留了受控输入与自定义消息渲染器:
html
<!-- src/App.vue(核心结构节选) -->
<TrChatUI
class="deepseek-chat-suite"
:data="adapter.data.value"
:ui="ui"
:is-empty="!chat.activeId"
v-model:input-value="text"
:right-aside-open="!!sourcePanel"
active-right-aside-panel-id="sources"
@create-conversation="open(null)"
@switch-conversation="({ conversationId }) => open(conversationId)"
@rename-conversation="({ conversationId, title }) => renameSession(conversationId, title)"
@submit="submit"
@cancel="stop"
>
<!-- 左侧栏底部:注入 MCP / Skills 与设置入口 -->
<template #layout-left-aside-footer>
<div class="suite-sidebar-footer">
<button class="extensions-entry" @click="extensionsOpen = true">✧ MCP / Skills</button>
<button class="settings-entry" @click="openSettings()">设置</button>
</div>
</template>
<!-- 右侧栏:直接挂载搜索来源面板 -->
<template #layout-right-aside>
<Sources v-if="sourcePanel" />
</template>
<!-- 输入框头部与底部插槽:挂载待发附件、深度思考与智能搜索开关 -->
<template v-if="attachments.length" #sender-header>
<DraftAttachments :items="attachments" />
</template>
<template #sender-footer>
<div class="composer-actions">
<button :class="['toggle', { selected: settings.thinking }]" @click="setThinking(!settings.thinking)">
深度思考
</button>
<button :class="['toggle', { selected: settings.search }]" @click="setSearch(!settings.search)">
智能搜索
</button>
</div>
</template>
</TrChatUI>
不需要魔改组件库源码,也不用把整个页面塞进一个大插槽里"假装用了套件",通用能力吃透框架红利,特殊交互留给薄适配层------这正是企业级 AI 组件库最舒服的打开方式。
五、不止于"能跑就行":深水区并发竞态与分层验证
很多复刻项目只测一下"发你好、收回复"就宣布大功告成了。但在真实使用中,切会话、断网、导归档往往是同时发生的。我们在项目中引入了独立故障注入审查与 Playwright 自动化回归,修掉了不少极易被忽视的深水区问题:
- 被淘汰引擎的"跨导入幽灵写入" :这是最隐蔽的一个数据竞态------当老会话引擎已被移出活跃缓存,但它在 Kit 内部的异步保存队列还没排空时,用户恰好导入了一个包含相同会话 ID 的新 ZIP 归档包。如果不加防护,迟到的旧保存就会静默覆盖新归档,甚至混入错误的根节点导致聊天正文变空!为此我们引入了
historyEpoch代次标记并等待所有在途 turn/save 排空,在存储层拒绝旧代快照写入。 - 慢速 IndexedDB 导航竞态:用户点击一个慢加载历史会话后立刻点击"开启新对话",通过导航代次(Navigation Token)与串行队列,避免迟到的异步读取把界面切回旧会话。
- "有
<svg>不等于看得见图" :在早期版本中,自动化断言只检查了 Mermaid 容器渲染出了<svg>节点;但实机截图审查发现,DOMPurify 的默认清理规则把 Mermaid 图表里的<foreignObject>节点文字洗空了!补齐专用清理配置并加上节点文字可见性与恶意载荷回归断言后,才把这一渲染隐患闭环。
项目整体通过了明确的分层验证:
- 静态与构建检查 :
vue-tsc类型检查通过,oxlint0 警告 / 0 错误 ;Rspack 生产构建产物支持任意静态子目录托管,也支持通过file://直接打开本地页面; - 常规端到端回归 :Playwright 常规回归 38 项通过、0 失败、0 flaky,覆盖分支切换、ZIP 互导、故障回滚、桌面/移动与浅深色布局;
- 真实 DeepSeek API 实测:在最终重构版单独启用实测并通过,覆盖流式对话、独立思考、联网搜索、网页链接阅读、图片文字识别、ASR 语音识别与 TTS 语音合成。
六、一分钟上手:在你的 Vue 项目里体验 TinyRobot
如果你也想体验这个复刻版应用,或者正在用 Vue 3 给自己的产品开发 AI 助手、Copilot 侧边栏、智能客服或 Agent 工作台,现在就可以动手试试。
在线体验 DeepSeek Vue 复刻版
- 在线演示地址 :opentiny.github.io/tiny-robot/... (注:打开左下角「设置 → 数据管理」填入你自己的 DeepSeek API Key 即可在浏览器本地直连体验,Key 仅保存在你当前浏览器的
localStorage中,导出历史归档时也不会包含 Key。)
在自己的 Vue 3 工程中安装 TinyRobot
如果你只需要轻量组件(如输入框 TrSender、消息气泡 TrBubble),只需几行代码就能跑起对话界面;如果你想一步到位搭建完整多会话应用,可以直接安装 Chat 套件与基础组件包:
sh
pnpm add @opentiny/tiny-robot-chat @opentiny/tiny-robot
如果你接入的是标准 OpenAI 兼容接口,使用 useChatRuntime + TrChat 不到 25 行代码就能直接搭起带历史会话管理、流式生成与取消控制的完整对话页面:
html
<script setup lang="ts">
import { TrChat, useChatRuntime, type ChatProviderConfig } from '@opentiny/tiny-robot-chat'
import '@opentiny/tiny-robot/dist/style.css'
import '@opentiny/tiny-robot-chat/dist/style.css'
const modelProviders: ChatProviderConfig[] = [
{
type: 'openai',
apiUrl: 'https://your-service.example.com/v1/chat/completions', // 替换为实际服务或后端转发地址
models: [{ id: 'your-model-id', label: '你的模型名' }],
},
]
const runtime = useChatRuntime({ modelProviders })
</script>
<template>
<TrChat :runtime="runtime" />
</template>
相关开源仓库与文档
- TinyRobot GitHub 仓库 (欢迎点个 Star ⭐ 支持开源):github.com/opentiny/ti...
- TinyRobot 官方文档与快速开始 :docs.opentiny.design/tiny-robot/...
- 复刻版 Vue 完整源码(
deepseek-chat-demo-vue分支) :github.com/opentiny/ti... - DeepSeek 官方开源原版
chat-demo:github.com/deepseek-ai...
从原版 18,000 多行全套细节,到借助 TinyRobot 的组件、Kit 引擎与 Chat 套件减少近三成代码并轻松扩展出 MCP 与 Skills------好的 AI 前端基础设施不一定能替你决定业务协议,但可以把那些繁琐的流式状态机、滚动贴底、附件拖拽、多端布局和工具表单替你默默处理好,让你把精力真正留给有价值的 AI 业务创新。
如果你正在用 Vue 做 AI 应用,不妨去 TinyRobot 仓库 逛逛,有任何想法或需求也欢迎直接提 Issue 交流!