汤底
September 19, 2026 · View on GitHub
一个以文字为中心的中英文海龟汤网站，由 Jev 担任主持人。支持提问、逐步提示、提交还原，以及私有创作和链接分享。
模型使用 TypeSafe AI 的 Jev，通过 Vercel AI Gateway（typesafe-ai/jev）调用。Jev 负责提问判定与还原评分，返回结构化选项、概率和置信度；网站据此展示回答和判定结果。
部署到 Vercel
站点 Key + BYOK（部署时填写自己的 Key）：
仅 BYOK（无需站点 Key）：
功能
- 四种主持回答：是、不是、不重要、暂时无法判断；展示模型原生 confidence。
- 中文 / 英文界面、深浅主题、游戏记录、主动揭晓。
- 网页创作；题目默认私有，分享链接可撤销，不进入公共题库。
- 支持 BYOK、站点提供 Key，或两者并存。
- 无账号系统；不包含匿名每日配额、内容审核或 Star 解锁。
本地运行
需要 Node.js 24 和 npm。
npm ci
cp .env.example .env.local
npm run content:sync
npm run dev
打开 localhost:3000/zh。默认使用 PGlite，无需安装 PostgreSQL；数据保存在 Git 忽略的 .data/postgres。同步和维护本地数据库前先停止开发服务，不要用多个进程同时打开该目录。
默认 BYOK：在右上角设置中输入 Vercel AI Gateway Key。Key 只保留在页面内存，刷新后需要重填；调用会产生供应商费用。没有 Key 也可以浏览题目、创作、查看提示和揭底。
Vercel 部署通过 Neon 集成创建 PostgreSQL 并自动注入连接串；域名自动取当前请求，无需手填。见部署指南。
凭证配置
| 配置 | 作用 |
|---|---|
AI_ACCESS_MODE=byok_only | 默认：玩家使用自己的 Key |
AI_ACCESS_MODE=site_only | 使用服务端 AI_GATEWAY_API_KEY |
AI_ACCESS_MODE=both | 玩家选择站点 Key 或 BYOK，不自动回退 |
唯一功能设置是 AI_ACCESS_MODE。站点 Key 保存在服务端 AI_GATEWAY_API_KEY；DATABASE_URL 由集成提供。网页只支持创作和私有链接分享，不提供文件上传/导入导出，也不会自动发布到公共题库。
BYOK 请求会经过部署者服务器，服务器能读取 Key；开源并不意味着浏览器直连供应商。本应用代码不持久化或主动记录模型 Key。更完整的信任边界见安全说明。站点 Key 模式没有内置消费限额，额度管理由部署者负责。
题库
题目统一存放在 content/puzzles/zh/ 和 content/puzzles/en/，一题一个 JSON。每个文件包含固定的 id 和 src/shared/puzzle.ts 定义的题目字段。新增题目时添加文件，再执行下面的校验和同步命令；修改题目时保留原有 id，已有游戏继续使用原来的题目版本。
npm run content:check
npm run content:sync
管理链接相当于密码；分享链接只授予游玩权限。不要把管理链接、私有题目或数据库备份提交到 Git。公开题目的汤底也随仓库公开，系统不用于防作弊。
开发与验证
npm run content:check
npm run typecheck
npm test
npm run build
测试使用隔离数据库和模拟模型，不需要真实 Key，也不消耗模型额度。覆盖访问控制、分享撤销、版本固定、凭证隔离、并发及判题结果处理。测试通过不等于模型答案永远正确。
技术栈：Next.js App Router、React、TypeScript、PostgreSQL / PGlite、Vercel AI SDK。