项目简介

ChatGPT-Vercel 是一款基于 OpenAI 接口与 Vercel Edge Functions 打造的 ChatGPT 网页客户端，由开发者 ourongxing 开源。与官方网页版相比，它最吸引人的地方在于「自定义程度极高」和「细节打磨到位」——从界面主题、Prompt 预设、连续对话，到 Token 实时统计、余额查询、对话分享图片，几乎把日常使用 ChatGPT 时的所有高频需求都做了原生支持。该项目在 GitHub 上斩获了超过 3.2k Star、2.8k Fork，属于同类项目中的明星作品。

项目的技术栈也颇有看点：v1.0 正式版采用 Solid-Start 作为前端框架，整体使用 TypeScript 编写，部署侧借助 Vercel 的 Edge Functions 实现了流式响应，让回答逐字输出，对话体验非常顺滑。它在功能强大的同时保持了轻量，无论是自用还是分享给身边不懂技术的亲友，都非常合适。

核心功能与架构

优雅简洁又功能强大的 UI

很多 ChatGPT 第三方客户端在功能堆叠时会让界面变得臃肿，而 ChatGPT-Vercel 选择了「克制」路线。整体设计走极简风，支持明暗双主题，代码块、Markdown、数学公式的渲染都经过细致调校。它还支持 PWA（渐进式 Web 应用），可以像原生 App 一样安装到桌面或手机主屏，离线时也能访问缓存页面。

多对话管理与独立设置

项目的另一大亮点是「多对话」体系。不同于早期只能维持一个聊天窗口的版本，现在的每个对话都有独立的标题、图标、系统提示词（角色设定）、Temperature 等参数，并且拥有自己的 URL。例如 https://your-domain.com/session/xxxxx 这样的链接直达某个具体对话，非常适合做「翻译助手」「代码评审」「周报生成」等场景的分工。

强大的 Prompt 预设与搜索

内置了非常丰富的 Prompt 预设模板，按下空格键或 / 键即可唤出搜索面板，支持模糊匹配和高亮显示。这意味着你可以用极快的速度切换「小红书文案生成器」「英语口语教练」「SQL 优化助手」等场景，而不必每次都手敲提示词。

实时 Token 统计与打断

每次提问时，界面会实时计算有效上下文 + 输入内容的 Token 消耗，并显示在输入框附近。当回答开始后，你随时可以点击「停止」按钮中断生成，避免不必要的费用浪费。配合「有效上下文」概念——自动剔除已删除或报错的对话——可以让长对话的成本控制得更加精细。

对话导出与分享

支持将当前对话一键生成图片（电脑端自动复制到剪贴板，手机端下载）或 Markdown 文本（直接复制到剪贴板），方便分享到社交媒体或归档整理。同时也支持对话和设置的导入/导出，相当于轻量级的本地备份方案。

余额查询与微信推送

对重度用户来说，查询 OpenAI 账户余额是刚需。ChatGPT-Vercel 内置了多种余额查询方式，并支持定时任务，把余额变动推送到微信。这在大多数同类项目里是看不到的，体现了作者对「真实使用场景」的深度理解。

基于 Solid-Start + Edge Functions 的技术架构

v1.0 之后的版本不再使用 SSR（服务端渲染），前端完全由 Solid-Start 驱动。OpenAI 的请求经由 Vercel Edge Functions 中转，天然支持流式响应（ReadableStream），这意味着你看到的不再是「等好几秒再一次性蹦出答案」，而是逐字逐句地实时生成。本地开发则需要 Node 18+，因为 Edge Functions 依赖原生的 fetch 和 ReadableStream API。

快速上手

方式一：一键部署到 Vercel（推荐）

最快的方式是直接使用 Vercel 的 Deploy Button。整个流程不需要写一行代码：

1. 点击仓库页面的「Deploy with Vercel」按钮：

2. 登录 Vercel 账号后，Vercel 会自动 fork 一份代码到你的 GitHub 仓库，并在导入页面要求你填写环境变量 OPENAI_API_KEY。这个 Key 就是你在 OpenAI 控制台 生成的 API 密钥。

3. 点击 Deploy，等待约 1～2 分钟，Vercel 就会为你分配一个 *.vercel.app 的子域名，直接打开就能使用。

如果你希望后续能持续同步作者的更新，建议先手动 Fork 仓库，然后在 Vercel 中导入你自己的 GitHub 仓库。以后想升级，只需在 GitHub 仓库页面点击 Sync fork 即可一键同步。

方式二：本地开发调试

如果你想对源码做二次开发，可以按照以下步骤操作：

# 1. 升级到 Node 18+
node -v  # 确认版本号 >= 18

# 2. 克隆你自己的仓库
git clone https://github.com/your-username/chatgpt-vercel.git
cd chatgpt-vercel

# 3. 使用 pnpm 安装依赖（推荐）
pnpm i

# 4. 启动本地开发服务器
pnpm dev

需要特别注意，本地开发时调用 OpenAI 接口需要走代理，因为 API 域名在境内无法直接访问。你可以通过设置 OPENAI_API_PROXY 环境变量指向一个中转地址，或者直接 vercel deploy 部署到 Vercel 的开发环境上进行远程调试。

环境变量配置

项目支持以下常用环境变量：

| 变量名 | 说明 | 示例

项目信息

参考链接

• GitHub 仓库
• 项目主页