编者摘要:deepseek-ai/chat-demo 是一款对接 DeepSeek API 的纯前端静态聊天界面,无需独立后端,浏览器直接请求 API 服务。项目支持在线访问,也可下载压缩包解压后双击 index.html 本地运行,首次使用需在设置填入 API Key。
它功能丰富,支持多会话管理、消息分支切换、流式输出、深度思考、联网搜索、链接阅读与引用标注;可上传拖拽附件、语音输入与朗读,支持 Markdown、代码高亮、KaTeX 公式、Mermaid 图表渲染,提供双语、明暗主题与移动端适配,聊天记录支持 ZIP 包导入导出。
数据存储在浏览器:API Key 存于 localStorage,对话与附件保存在 IndexedDB;导入会覆盖本地记录,导出不含密钥和非图片附件,清空对话不会删除已上传至服务端的文件。开发基于 Node.js 与 pnpm,内置开发、构建、类型检查等命令,默认适配 deepseek-flash 模型,兼容 Anthropic 消息接口,可自定义 API 地址。项目开源分发需附带许可证,适合快速搭建轻量化私有对话前端。
附录:chat-demo项目
基于 DeepSeek API 的静态聊天演示项目。无需后端服务,浏览器直接对接配置好的 API 服务。
你可以访问在线演示地址,或者从发布页下载压缩包,解压后直接双击 index.html 本地使用,无需安装、无需构建。首次对话前,请在设置里填入你的 API Key。
快速开始
安装 Node.js 22.12+ 和 pnpm,然后执行:
git clone https://github.com/deepseek-ai/chat-demo.gitcd chat-demopnpm installpnpm dev
打开http://localhost:8090/
构建静态站点:
pnpm build
产物输出到 dist/ 目录。可以部署到静态网页服务器,或者直接打开 dist/index.html。
直接本地打开文件(
file://)有前提:浏览器允许file://页面使用本地存储,并且目标 API 服务允许该页面跨域请求。
功能特性
-
多会话管理:自动生成会话标题、支持重命名、删除对话;支持编辑提示词、重新生成回答、切换消息分支 -
流式输出、深度思考、智能搜索、网页链接读取、引用来源标注;可中断生成,符合条件的回答支持继续续写 -
附件支持:上传、粘贴、拖拽文件;语音输入、语音朗读回答;移动端录音时,输入框上方会实时显示音频频谱 -
渲染 Markdown、代码高亮、KaTeX 数学公式、Mermaid 流程图 -
简体中文 / 英文双语、浅色 / 深色主题、移动端适配、地区设置、聊天记录导入导出
数据与存储
你的 API Key 和各项配置保存在浏览器 localStorage;对话记录和原始附件存放在 IndexedDB。本地数据按浏览器用户配置和站点来源隔离。发送消息、上传附件、使用语音功能时,相关内容会发送到你配置的 API 服务。
设置 - 数据里的导入导出使用 ZIP 压缩包。确认并校验成功后,导入操作会覆盖全部本地对话和附件。导出包包含对话记录与本地存在的原图;不包含 API Key、配置项、非图片类原始附件。归档格式与保存细节见:history/README.md
设置 → 数据 → 删除全部对话:确认后清空所有本地会话、原始附件、未发送草稿;终止正在生成的回答,回到新建对话。API Key 和配置保留;已经上传到 API 服务的文件不会被删除。
开发命令
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
rspack.config.ts默认对接 https://api.deepseek.com。可以用 createConfig({ apiOrigin, devServer }) 自定义 API 地址和开发服务器代理。
聊天默认使用 deepseek-flash,兼容 Anthropic 风格的 Messages / Files 接口;语音能力使用 ASR / TTS 端点。请求自带搜索、读链接、标题生成、latest_reminder 扩展字段,因此你对接的后端服务必须支持对应能力。支持的附件格式由服务端校验决定。
目录结构
src/├── app/ 页面布局、主题、全局样式├── components/ 聊天、设置、Markdown 等UI组件├── i18n/ 中英翻译文本├── services/│ ├── api/ API 请求、SSE、协议类型定义│ ├── chat/ 会话、消息分支、存储、历史导入导出│ ├── markdown/ Markdown 解析、代码高亮、图表渲染│ └── speech/ 录音、语音朗读播放└── utils/ 通用工具函数
许可证
许可证文件见LICENSE。构建脚本会自动把许可证复制到 dist/LICENSE;分发本应用时需要一并带上。第三方依赖遵循各自的许可证协议。
补充要点
✅纯前端静态项目,无后端,浏览器直连 API,适合私有化部署、二次改界面✅ 本地打开 index.html 就能跑,也支持 pnpm 源码开发✅ 对话、图片存在浏览器本地,密钥只存在本地,不上传给前端项目本身✅ 支持思考模式、联网搜索、读链接、文件上传、语音、Mermaid / 公式渲染

