项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-15 · 当前星标 ★ 1665
使用教程
环境要求
- Node.js 22.12 或更高版本
- pnpm 包管理器
- 现代浏览器(需要支持在 file:// 页面使用存储)
- 可用的 DeepSeek API Key
- 如需直接打开构建结果,API 服务需允许跨域请求
安装与启动步骤
-
1准备运行环境
先安装 Node.js 22.12+,再安装 pnpm。README 未给出具体安装命令,请按各自官方文档完成安装并确认版本满足要求。
-
2克隆项目代码
把仓库克隆到本地并进入项目目录,后续命令都在该目录下执行。
git clone https://github.com/deepseek-ai/chat-demo.git cd chat-demo -
3安装项目依赖
在项目根目录执行依赖安装,等待 pnpm 完成下载;如网络较慢可先配置好可用的镜像源。
pnpm install -
4启动开发服务
启动本地开发服务器,随后在浏览器访问 http://localhost:8090 打开聊天界面。
pnpm dev -
5填写 API Key
首次对话前,在页面设置中填入自己的 API Key,并确认 API 服务地址为你要使用的服务。
-
6构建静态站点
需要部署时执行构建,产物输出到 dist/ 目录,可放到静态 Web 服务器,或直接打开 dist/index.html。
pnpm build
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
API Key | 是 | 在页面设置中填入,用于浏览器直连 API 服务发起对话 | sk-xxxxxxxx |
如何确认成功
浏览器打开 http://localhost:8090 能看到聊天界面,设置中填入 API Key 后发送消息可获得回复。
常见问题
Q:这个项目需要自己搭后端吗?
A:不需要。它是纯静态应用,浏览器直接连接所配置的 API 服务,只需提供 API Key 即可。
Q:可以直接双击 index.html 使用吗?
A:可以,但要求浏览器支持在 file:// 页面使用存储,且所连 API 服务允许该来源的跨域请求,否则请用静态服务器部署 dist/。
Q:访问 localhost:8090 打不开怎么办?
A:确认 pnpm dev 仍在运行且没有报错;若端口被占用,可先释放 8090 端口,或改用 pnpm build 的产物部署到静态服务器。
Q:没有 pnpm 能用 npm 吗?
A:README 只给出 pnpm 的使用方式,建议先安装 Node.js 22.12+ 再安装 pnpm,按文档命令执行以避免依赖解析差异。
注意事项
- API Key 只保存在浏览器本地设置中,不要写进代码仓库或公开分享。
- 直接打开 dist/index.html 受浏览器存储与跨域策略限制,正式使用建议部署到静态 Web 服务器。
- 项目为纯前端静态实现,模型能力完全依赖你所配置的 API 服务。
核心亮点
- TypeScript 编写,类型完整,便于二次开发和维护
- 提供完整可运行的对话交互流程,省去从零搭 UI 的成本
- 结构清晰,适合作为学习对话产品前端架构的参考模板
不足之处
- 功能偏示例性质,缺少生产级能力如鉴权、多会话管理等
- 文档与社区规模有限,长期维护情况待观察
适用场景
- 快速搭建聊天机器人前端原型
- 学习对话类产品的前端交互与流式渲染实现
- 作为内部 Demo 或 PoC 的起点进行定制开发
替代项目
chatbot-ui、NextChat、lobe-chat
上一篇:SnowCatQQ
下一篇:没有了!
同类项目推荐
ChatPLUG
开源
中文开放域对话,知识增强更懂你
A Chinese Open-Domain Dialogue System
tiny-robot
开源
拿来即用的 AI 对话界面组件,快速搭出企业级聊天应用
TinyRobot 是一个 AI 对话组件库,提供了丰富的 AI 交互组件,助力开发者快速构建企业级 A···
DAMO-ConvAI
开源
达摩院对话AI代码库,直接复现工业级对话模型
DAMO-ConvAI: The official repository which contains the codebase for Alibaba DAMO Co···
gpt_mobile
开源
一个 App 同时问遍所有大模型,自带 Key 即用
Chat app for Android that supports answers from multiple LLMs at once. Bring your ow···
slack-machine
开源
用 Python 快速搭建可扩展的 Slack 机器人
A simple, yet powerful and extendable Slack bot
UnilmChatchitRobot
开源
用 UniLM 打造会夸人的中文闲聊机器人
Unilm for Chinese Chitchat Robot.基于Unilm模型的夸夸式闲聊机器人项目。
xiaogpt
开源
让小米音箱秒变 ChatGPT 语音入口,动口就能聊
Play ChatGPT and other LLM with Xiaomi AI Speaker
ChatterBot
开源
几行代码训练你的聊天机器人,快速上手对话系统
ChatterBot is a machine learning, conversational dialog engine for creating chat bot···
WeatherBot
开源
用中文聊天气,Rasa 机器人秒回,带网页界面
一个基于 Rasa 的中文天气情况问询机器人(chatbot), 带 Web UI 界面
