大数跨境

deepseek-ai/chat-demo

deepseek-ai/chat-demo 苏哲管理咨询
2026-11-16
0
导读:deepseek-ai/chat-demo 是一款对接 DeepSeek API 的纯前端静态聊天界面,无需独立后端,浏览器直接请求 API 服务。项目支持在线访问,也可下载压缩包解压后双击 inde

编者摘要: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 服务的文件不会被删除。

开发命令

命令
说明
pnpm dev
启动开发服务
pnpm build
构建产物到 dist/
pnpm type
TypeScript 类型检查
pnpm lint
oxlint 代码检查
pnpm format
oxfmt 代码格式化

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 / 公式渲染

【声明】内容源于网络
0
0
苏哲管理咨询
为企业及组织提供AI+战略、数智化转型咨询及观点、建议等
内容 2542
粉丝 0
苏哲管理咨询 为企业及组织提供AI+战略、数智化转型咨询及观点、建议等
总阅读97.5k
粉丝0
内容2.5k