想做AI聊天应用的人,大多卡在同一个地方:模型接得上,界面做不好。流式输出、消息分支、附件、语音、Markdown渲染,每一项单拎出来都不难,凑成一个顺手的对话框就很难。
DeepSeek这次直接把自家网页端那套界面开源了,仓库叫chat-demo。上线三天,2137星、377个fork。
背景:全家桶API开放,顺手把前端也给了
这个仓库11月12日才建,几乎是跟着DeepSeek开放全家桶API一起放出来的。
这波API把深度思考、联网搜索、文件输入、链接阅读、语音这些原本只在App里能用的能力,全部打包进了接口;甚至把search、fetch、ocr、asr、tts拆成独立端点,可以单独调用。
官方原话大意是:我们的App只是个基础款,脏活累活交给我们,你们去整大活。
于是就有了这个chat-demo:一个把新API能力全演示一遍的前端,TypeScript写的,MIT协议,谁都能拿走改。
它到底是什么
一句话:纯静态的聊天前端,没有后端。
浏览器直接连你配置的API服务,不需要中间层转发。这意味着你可以把它扔到任何静态服务器上,甚至不解压部署,双击就行。
官方给了两种用起来的方式:
一是去Releases下载压缩包,解压后双击index.html,不用安装、不用构建,第一次聊天前去设置里填API Key;二是在线体验,仓库首页就挂着地址,打开就能聊,Key存在自己浏览器里。
想改代码就走源码,Node.js22.12以上、pnpm装好:
git clone https://github.com/deepseek-ai/chat-demo.gitcd chat-demopnpm installpnpm dev打开localhost:8090。要部署就pnpm build,产物在dist/。
功能清单比想象中全
很多官方demo只做「输入框+回答」,这个不是,基本把网页端能看到的交互都搬过来了:
- 多会话,标题自动生成,支持重命名、删除;可以编辑已发的提问、重新生成回答、在消息分支之间来回切换
- 流式输出、深度思考、智能搜索、链接阅读,回答带来源引用;能中途停止,也能对符合条件的回答继续生成
- 附件上传、粘贴、拖拽三件套;语音输入和朗读回答,移动端录音时输入框第一行还有实时频谱
- Markdown、代码高亮、KaTeX公式、Mermaid图表
- 简体中文和英文、浅色深色主题、移动端布局、位置设置、历史导入导出
其中历史导入导出用的是ZIP包,导出含会话和本地图片原件,但不含API Key和设置。导入会在确认校验后替换全部本地数据,这点官方写得很清楚,自己用之前最好先备份。
技术栈:轻,但没偷懒
React18、zustand管状态、Rspack2打包,TypeScript,没有后端框架。
数据全留在浏览器:API Key和设置在localStorage,会话和附件原件在IndexedDB,用idb封装;ZIP导入导出用fflate。
Markdown这块我觉得最见功力。它没直接套现成的渲染器,而是用mdast加micromark自己拼了一条管线,还接了llm-math扩展专门处理模型吐出来的公式,配合Prism和KaTeX、Mermaid,图表公式都能落。
协议走的是Anthropic兼容的Messages/Files接口,默认模型deepseek-flash;搜索、链接阅读、自动标题这些走扩展字段,语音走ASR和TTS端点。
配置也很干净,rspack.config.ts里默认指向官方API,想换地址或者加代理,调createConfig({apiOrigin, devServer})就行。
我觉得最妙的设计是「零后端」这个选择。demo的门槛被压到最低,同时也把API的边界演示得很明白:哪些事服务端包了,哪些事得客户端自己做。
几个要注意的点
第一,它是demo,不是SDK。账号体系、计费、审计、风控这些业务逻辑还得自己补,别指望直接上线。
第二,API Key存在前端localStorage。自己用、内网演示没问题,真要公开部署,最好加一层自己的服务端代理。
第三,本地数据按浏览器用户配置和站点源隔离,换设备不会同步,卸载浏览器就没了。
第四,搜索、链接阅读、语音这些能力依赖服务端支持,接第三方兼容网关时可能对不上,附件格式也是服务端说了算。
适合谁
想快速验证DeepSeek新API到底能干什么的,拿它当实验台最省事;想抄一个成熟聊天UI的,这个仓库的分支对话、渲染管线、语音交互都能直接参考;做内部工具或者客户演示的,打包成静态文件扔服务器上就完事。
只想要个能聊天的玩具,下载Releases双击index.html,三分钟就能跑起来,确实省事。
项目地址:https://github.com/deepseek-ai/chat-demo
热门跟贴