用 Vibe Coding 搭建个人娱乐记录站

技术 ai
0

缘起

每到年底，我总会回顾这一年看过哪些书、追过哪些剧、玩过哪些游戏。但记忆总是零散的，往往只能想起最近几部。我想要一个像豆瓣那样的记录系统，但更私密、更定制化，方便检索和统计。

技术选型

这次用了 Vibe Coding 的方式，用自然语言描述需求，让 Claude Code 辅助完成大部分编码工作。从想法到可运行的 MVP 只用了几个小时。

数据源选择：NeoDB

确定了要做什么，接下来就是"数据从哪来"的问题。调研了几个方向：

数据源

优点

缺点

豆瓣 API

数据全面

官方 API 已关闭，第三方不稳定

TMDB/IGDB

数据质量高

需要多个平台整合，开发成本高

手动输入

完全可控

太麻烦，难以坚持

NeoDB

免费 API + 数据存储

相对小众

最终选择 NeoDB，因为：

  1. 统一的元数据库：书籍、电影、剧集、游戏全覆盖

  2. 免费的 API：不需要自己维护庞大的元数据

  3. 开源友好：支持个人项目和商业使用

NeoDB 本身就是一个"记录中心"，用户可以在平台上标记消费记录，然后通过 API 同步到个人站点，完美解决了数据源问题。

部署方案

一开始部署到了阿里云服务器，但 NeoDB 是海外服务，API 请求需要科学上网，代理稳定性一直是个问题。

后来直接用 Vercel 部署：

  • 前端：Vercel（免费、全球 CDN）

  • 数据库：Neon Serverless PostgreSQL（免费额度）

  • API：Vercel Serverless Functions

和 NeoDB API 在同一区域，延迟更低，完全免费，自动 CI/CD。

技术栈

前端:
  - 框架: Next.js (React)
  - 样式: Tailwind CSS
  - 部署: Vercel
​
后端:
  - API: Vercel Serverless Functions
  - 数据库: Neon PostgreSQL
  - ORM: Prisma
​
数据源:
  - 元数据: NeoDB API
  - 同步: 定时任务 + Webhook

项目链接