这个项目有什么用
chat-demo 是 DeepSeek 官方提供的静态聊天示例,由 DeepSeek API 驱动,不需要自建应用后端——浏览器直接连接配置好的 API 服务。它适合想快速体验 DeepSeek 对话能力、或想拿一份现成前端参考实现来改的开发者。
它解决的问题
- 省去从零搭聊天界面的工作:多会话管理、流式输出、Markdown 渲染、附件上传等常见能力已经内置。
- 省去搭建后端代理:项目本身是纯静态站点,构建产物放到静态服务器即可运行,也可以直接双击
index.html本地使用。 - 省去配置界面:API Key 在 Settings 中填写,保存在浏览器本地。
典型使用场景
- 个人快速试用 DeepSeek 对话服务,不想安装任何东西时直接打开在线版本。
- 团队需要一个可自托管的轻量聊天前端,把
dist/部署到静态服务器。 - 开发者阅读源码,了解流式对话、消息分支、历史导入导出等功能的前端实现方式。
适合前端开发者、需要内网或自建部署的小团队,以及想研究聊天界面实现的人。
核心特性
- 多会话与消息分支:支持自动生成标题、重命名、删除会话,可编辑提问、重新生成回复,并在不同消息分支之间切换。
- 流式回复与扩展能力:支持流式输出、深度思考、智能搜索、链接阅读与来源引用,可停止生成或继续符合条件的回复。
- 多模态输入:支持上传、粘贴、拖拽附件,语音输入与朗读回复;移动端录音时输入区首行会显示实时音频频谱。
- 富文本渲染:内置 Markdown、语法高亮、KaTeX 数学公式与 Mermaid 图表。
- 本地化与主题:提供简体中文与英文、明暗主题、移动端布局、位置设置,以及聊天历史的导入导出。
- 本地优先的数据存储:API Key 与设置存于 localStorage,会话与原始附件存于 IndexedDB,按浏览器配置与站点来源隔离。
怎么安装
前提条件:Node.js 22.12+ 与 pnpm。如果只是想试用,可以跳过安装,直接打开在线版本,或从 Releases 下载压缩包解压后双击 index.html,无需安装与构建,首次聊天前需在 Settings 中填写 API Key。
从源码运行:
- 克隆仓库并进入目录:
git clone https://github.com/deepseek-ai/chat-demo.git cd chat-demo - 安装依赖:
pnpm install - 启动开发服务器:
pnpm dev然后打开 http://localhost:8090。
- 如需构建静态站点:
pnpm build产物输出到
dist/,可部署到静态 Web 服务器,或直接打开dist/index.html。直接打开文件要求浏览器支持file://页面上的存储,且 API 服务允许其跨域请求。
怎么使用
最基础的用法:启动开发服务器或打开构建产物后,先在 Settings 中填入 API Key,然后在输入框发起对话即可。
默认配置方面,rspack.config.ts 使用 https://api.deepseek.com,可通过 createConfig({ apiOrigin, devServer }) 自定义 API 源与开发服务器代理。聊天默认使用 deepseek-flash,走 Anthropic 兼容的 Messages / Files API;语音功能使用 ASR / TTS 端点。请求中带有搜索、链接阅读、标题与 latest_reminder 等扩展,因此所配置的服务需要支持对应能力,附件支持的格式由服务端校验决定。
数据管理方面,Settings 中的历史导入导出使用 ZIP 归档;导入经确认并校验成功后,会替换全部本地会话与附件。导出包含会话和本地可用的原始图片,但不包含 API Key、设置以及非图片的原始附件。Settings → Data → Delete all chats 会在确认后清空本地会话、原始附件与未发送草稿,并停止进行中的回复、返回新会话;API Key 与设置保留,已上传到 API 服务的文件不会被删除。发送消息、上传附件和使用语音功能时,相关内容会发送到所配置的 API 服务。
适用场景与注意事项
适合需要轻量、可自托管聊天前端的场景,也适合作为学习流式对话与前端存储设计的参考实现。由于没有应用后端,API Key 保存在浏览器 localStorage 中,本地数据按浏览器配置与站点来源隔离,不适合需要统一账号体系、集中审计或多用户共享密钥的团队。
- 需要联网访问所配置的 API 服务;语音、搜索、链接阅读等功能依赖服务端支持对应能力。
- 直接以
file://打开时,受浏览器存储策略与跨域限制影响,可能无法正常工作。 - 导入历史会覆盖本地全部会话与附件,操作前需确认。
- 项目采用 MIT 协议,可自由使用与修改。
项目地址
仓库地址:https://github.com/deepseek-ai/chat-demo
项目主页:https://deepseek-ai.github.io/chat-demo/
作者/组织:deepseek-ai
这是一个结构清晰的静态聊天前端示例,功能覆盖较全,适合作为自托管对话界面或前端实现参考。
















iphone duo wireless charging 7天前0
iphone duo wireless charging