DeepSeek Chat Demo 的官方仓库是一个静态聊天前端,会从浏览器直接调用配置的 API 服务。本地运行需要 Node.js 22.12 或更高版本、pnpm 和 API 密钥:克隆仓库、安装依赖,再启动开发服务器即可。这与登录 DeepSeek Chat 消费者网站不同,Demo 使用 API 访问。本文依据 2026 年 11 月 16 日查看的官方 README 和 API 文档编写,没有输入密钥或实际运行项目。
要点
deepseek-ai/chat-demo是开源前端示例,不是模型托管服务或带后端的完整产品。本地运行需 Node.js 22.12+、pnpm、网络和 DeepSeek API 密钥;README 默认地址为
http://localhost:8090。密钥和设置保存在 localStorage,会话和原始附件使用 IndexedDB。浏览器端密钥不适合公开生产部署。
DeepSeek Chat、托管 Demo 和本地克隆的访问方式和数据流向不同,先选对入口。
先选对 DeepSeek 入口
| 入口 | 用途 | 需要什么 | 适合场景 |
|---|---|---|---|
| DeepSeek Chat | 消费者聊天网站,目前显示登录流程 | 网站访问权限 | 使用托管聊天产品。Chat 登录不等于 API 密钥。 |
| 官方在线 Demo | DeepSeek 发布的前端演示 | Demo 和 API 服务接受的密钥 | 不克隆源码,快速体验界面。 |
| 本地仓库 | 在电脑上运行前端源码 | Node.js 22.12+、pnpm、网络、API 密钥 | 阅读或修改参考客户端。 |
DeepSeek 11 月 13 日公告链接了在线 Demo、代码仓库和 Build a Chatbot 指南。它们是 API 相关资源。API 快速入门要求 API 密钥;不要假设消费者 Chat 登录包含 API 额度,也不要认为两种服务的计费或数据处理相同。

本地运行官方仓库
以下步骤根据当前 README 整理,本文没有实际运行这些命令。
安装 Node.js 22.12 或更高版本和 pnpm,并检查命令:
node --version pnpm --version克隆官方仓库并进入目录:
git clone https://github.com/deepseek-ai/chat-demo.git cd chat-demo安装依赖并启动开发服务器:
pnpm install pnpm dev打开
http://localhost:8090。这些命令只提供静态前端,不会启动应用后端。在 Demo 的 Settings 中输入通过 DeepSeek API 平台申请的密钥。README 说明首次聊天前必须输入。不要把密钥贴到公开问题、共享录屏、源码文件或公开客户端配置中。
发送无敏感信息的提示并确认回复出现。若请求失败,检查密钥、API 端点和账户的模型访问权限。本文没有核实账户资格、价格或地区可用性。
README 还列出 pnpm build,构建结果位于 dist/;也可以解压 Release 后直接打开 index.html。不过 file:// 页面存储和跨源请求取决于浏览器与 API 服务,首次试用建议用在线 Demo 或本地开发服务器。预算估算可参考 DeepSeek API 价格说明。
密钥和聊天数据存在哪里
README 说明密钥与设置保存在浏览器 localStorage,会话和原始附件保存在 IndexedDB,并按浏览器配置文件和网站来源隔离。发送消息、附件或语音功能时,相关内容可能交给配置的 API 服务。清除本地聊天不会删除已经上传到 API 服务的文件。处理敏感内容前应查看当前 README 和 API 条款。
浏览器直接连接 API,因此密钥会供该浏览器配置文件中的客户端使用。个人试用较方便,但不能防止共用该配置文件的人读取密钥。不要将私钥嵌在公共前端中部署。生产应用应通过服务端保护凭据、限制访问和用量,并制定数据保留规则。DeepSeek 的 聊天机器人指南介绍 API 功能,不是此 Demo 的安全审计。
按目标选择入口
| 目标 | 从这里开始 | 主要取舍 |
|---|---|---|
| 使用托管聊天产品 | DeepSeek Chat | 走网站登录流程,不是 Demo 仓库。 |
| 快速看参考界面 | 在线 Demo | 需要 API 凭据并调用配置的 API。 |
| 学习代码或改界面 | 克隆并运行仓库 | 自行管理依赖和浏览器端密钥。 |
| 为多人做公开应用 | 从 API 文档开始设计服务端边界 | Demo 不是现成的多用户服务。 |
如果你要网页搜索或链接读取,先核对官方 API 指南中支持的功能和结果传递方式。模型调用本身不等于完整的浏览器 Agent 流程,可参考工具如何参与 Agent 推理和如何检查研究引用。浏览器优先的方案是不同问题,可看 AI 浏览器比较和什么是 Agent 浏览器。DeepSeek Harness 用户可另看浏览器插件设置。
如需了解命令行控制浏览器的另一种流程,可看 agent-browser CLI 教程。
常见问题排查
找不到
pnpm: 按官方安装说明安装,重新开终端后运行pnpm --version。页面打开但对话失败: UI 加载不代表 API 验证通过。检查密钥、账户权限、端点和网络错误。
误用了 Chat 网站密码: 消费者网站与 API 平台不同。通过 API 平台管理密钥,不能用登录密码代替。
部署时要求前端密钥: 不要继续公开。放进浏览器代码的值不是服务端机密;应由自己的服务端管理凭据,并参考本地 Web 应用验证方法。
要分享可复现问题: 记录仓库版本、浏览器、端点类型、模型和脱敏错误。核对结果及来源可参考引用核查指南。
常见问题
DeepSeek Chat Demo 和 DeepSeek Chat 是同一个产品吗?
不是。chat.deepseek.com 是消费者产品;chat-demo 仓库是向配置的 API 服务发送请求的前端,在线 Demo 是另一种体验方式。
不用 API 密钥能使用 Demo 吗?
官方 README 要求首次聊天前在 Settings 输入 API 密钥。消费者网站登录是独立服务,不能替代 Demo 需要的密钥。
本地运行需要后端吗?
开发命令提供静态前端,不需要应用后端。浏览器会直接连接配置的 API 服务。
Demo 把聊天和设置存在哪里?
README 说明密钥和设置存于 localStorage,会话和原始附件存于 IndexedDB。请求数据会发送至配置的 API 服务。
可以把带有 API 密钥的 Demo 部署给客户吗?
不要在公开客户端暴露私有密钥。浏览器端存储和直接 API 调用适合个人评估;生产应用需要服务端凭据管理和访问控制。
来源
2026 年 11 月 16 日核验:官方 README、package 脚本、API 地址配置、API 快速入门、Build a Chatbot和11 月 13 日公告。已尝试核验 Reddit、X 和 YouTube,但没有找到符合条件且可访问的用户反馈,因此本文保持草稿。'''
常见问题
DeepSeek Chat Demo 和 DeepSeek Chat 是同一个产品吗?
不是。chat.deepseek.com 是消费者产品;chat-demo 仓库是向配置的 API 服务发送请求的前端,在线 Demo 是另一种体验方式。
不使用 API 密钥能运行 Demo 吗?
官方 README 要求首次聊天前在 Settings 输入 API 密钥。消费者网站登录是独立服务,不能替代 Demo 需要的 API 密钥。
本地运行需要后端吗?
开发命令会提供静态前端,不需要应用后端。浏览器直接连接配置的 API 服务。
Demo 将聊天和设置存在哪里?
README 说明密钥和设置存于浏览器 localStorage,会话和原始附件存于 IndexedDB。请求中发送的数据会到达配置的 API 服务。
可以用自己的 API 密钥把 Demo 部署给客户吗?
不要在公开客户端暴露私有 API 密钥。浏览器端存储和直接 API 调用更适合个人评估;生产应用需要服务端凭据管理和访问控制。