GitHub 热门项目推荐:chat-demo(TypeScript|4529 Star)

这个项目有什么用

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。

从源码运行:

  1. 克隆仓库并进入目录:
    git clone https://github.com/deepseek-ai/chat-demo.git
    cd chat-demo
  2. 安装依赖:
    pnpm install
  3. 启动开发服务器:
    pnpm dev

    然后打开 http://localhost:8090。

  4. 如需构建静态站点:
    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

这是一个结构清晰的静态聊天前端示例,功能覆盖较全,适合作为自托管对话界面或前端实现参考。

© 版权声明
THE END
喜欢就支持一下吧
点赞8 分享