开发工具#AI 生成

DeepSeek chat-demo:无后端的开源聊天前端,把官方能力全接上

DeepSeek 开源 chat-demo:纯静态聊天前端,浏览器直连 API,无后端;支持深度思考、联网搜索与引用、附件解析、语音输入与朗读,MIT 许可。

项目资料

GitHub Ecosystem
仓库地址github.com/deepseek-ai/chat-demo
许可证
MIT
主语言
TypeScript
星标
3,759
核查时间
2026-11-16

以上快照资料以核查当日为准,可能随版本或运营策略变化。

想给 DeepSeek 的 API 配一个能用的聊天界面,过去要么自己写前端,要么套一个需要后端和数据库的开源项目。chat-demo 是 DeepSeek 官方开源的反向做法:纯静态站点,没有应用后端,浏览器直接连接配置好的 API 服务。把构建产物丢到任意静态托管上就能用,也可以直接打开 dist/index.html。GitHub API 在 2026 年 11 月 16 日显示它有 3,759 颗星。

核心功能

  • 多会话与分支:会话自动命名、重命名与删除;可以编辑提示词、重新生成回复,并在消息分支之间切换。对需要反复对比答案的场景很实用。
  • 深度思考与联网搜索:支持流式回复、深度思考、智能搜索、链接阅读与信源引用,生成可随时停止,符合条件的回复可以继续生成。
  • 附件与语音:上传、粘贴或拖拽附件;支持语音输入与朗读回复,录音时输入区第一行会显示实时音频频谱。
  • 渲染能力齐全:Markdown、代码高亮、KaTeX 数学公式与 Mermaid 图表;中英双语、明暗主题、移动端布局、位置设置,以及聊天记录导入导出。
  • 数据留在浏览器:API Key 与设置存在 localStorage,会话与原始附件存在 IndexedDB,本地数据按浏览器配置隔离。

典型使用场景

  • 快速验证 API 与提示词:不需要部署后端,本地跑起来就能测 DeepSeek 的模型能力、搜索与引用效果。
  • 内网或离线部署的聊天入口:构建产物是静态文件,放到内网静态服务器即可,不必维护 Node 服务与数据库。
  • 给产品做参考实现:官方演示了会话分支、引用展示与语音交互的做法,适合作为自研聊天前端的起点;若需要的是生成式 UI 的渲染约束,可对照 OpenUI 的设计思路。

快速上手

README 给出的流程需要 Node.js 22.12+ 与 pnpm:

git clone https://github.com/deepseek-ai/chat-demo.git
cd chat-demo
pnpm install
pnpm dev

启动后打开 http://localhost:8090。构建静态站点用 pnpm build,产物在 dist/,可部署到任意静态服务器;直接打开 dist/index.html 需要浏览器支持相应的本地存储能力。也可以先在在线演示试用。

小结

chat-demo 的价值在于把”官方能力”以最小工程量的方式交到使用者手里:没有后端、没有数据库、MIT 许可,浏览器直连 API。它的边界也要看清楚——数据存在浏览器本地,换设备或清缓存就会丢;API Key 也在 localStorage,公共设备上使用要谨慎。GitHub API 在 2026 年 11 月 16 日报告:TypeScript、MIT、3,759 颗星、未归档,最近推送 2026 年 11 月 13 日。

另外要留意工程边界:纯静态意味着所有逻辑都在客户端,API Key 一旦泄露无法靠服务端吊销,正式对内发布时应加一层自己的代理或用短期凭证;会话存在 IndexedDB,浏览器清理策略可能随时清空,重要记录要导出。相较需要后端与数据库的开源聊天项目,它把部署成本压到最低,也把数据治理的责任交给了使用者。

本条目基于 README 与在线演示整理,未在本地完整部署;实际体验与模型可用性取决于你配置的 API 服务。