WikiTrivia:把Wikipedia变成卡牌的时间线问答游戏——完整项目总览与3分钟快速上手

原创2026-11-16 10:18:532,309 阅读

WikiTrivia:把Wikipedia变成卡牌的时间线问答游戏——完整项目总览与3分钟快速上手

WikiTrivia 是一个开源的时间线卡牌问答游戏:它从 Wikipedia 和 Wikidata 抓取真实条目,做成一张张卡牌,你需要凭常识把它们按年代先后顺序拖放到时间线上。数据驱动、纯前端静态部署、支持拖拽动画,是学习 Next.js 单页游戏开发的一个优质小项目。

玩法介绍:时间线卡牌游戏怎么玩?

WikiTrivia 的核心玩法只有一句话:把卡片按时间先后顺序放到时间线上。

具体规则如下:

  • 🃏 抽卡作答:游戏会连续发出带图片和简介的卡片(例如某个国家、某位人物、某个发明),不直接显示年份,你需要把它插入下方时间线的正确位置;
  • ❤️ 3 条生命:放错位置会扣一颗心,放错卡片会被高亮提示你离正确位置有多远;
  • 🔥 连击计分:连续答对会累积 Streak(连击),游戏结束前会实时刷新保存在浏览器本地的最佳纪录;
  • 🏅 奖牌结算:结束后按连击数颁发奖牌——20 连以上金牌 🥇、10 连以上银牌 🥈、1 连以上铜牌 🥉,还可以一键复制成绩去分享。

卡片会刻意避开年份差距过小的干扰项,并且随机跳过约一半的"人物类"卡片,保证每一局都有可玩性和挑战性。

3分钟快速上手:本地运行 WikiTrivia

项目是纯静态网站,无需后端和数据库,准备好 Node.js 环境后三步即可跑起来:

第 1 步:克隆仓库

git clone https://gitcode.com/gh_mirrors/wi/wikitrivia

第 2 步:安装依赖

npm install

第 3 步:启动开发服务器

npm run dev

然后访问 http://localhost:3000/ 即可开始游戏。

如果你想要一个可部署的静态版本,执行 npm run build 会生成到 out 目录,再用 npm start 运行。由于 next.config.js 中开启了 output: "export",这个 out 目录可以丢到任意静态托管服务上,零成本部署。

完整项目总览:代码结构与技术栈

WikiTrivia 基于 Next.js 14 + React 18 + TypeScript 构建,拖拽交互由 react-beautiful-dnd 实现,动画使用 react-spring,样式为 SCSS 模块化方案。

wikitrivia/
├── components/          # 游戏界面组件(核心逻辑都在这里)
│   ├── game.tsx         # 入口:加载数据、管理游戏状态
│   ├── board.tsx        # 棋盘:拖拽、判分、扣血
│   ├── hearts.tsx       # 生命值(三颗心)
│   ├── game-over.tsx    # 结算与奖牌
│   ├── instructions.tsx # 开局说明页
│   └── ...              # 卡片区、计分、加载态等
├── lib/                 # 纯逻辑层
│   ├── create-state.ts  # 初始化牌局(3 条命、起手卡)
│   ├── items.ts         # 抽卡策略与判对错算法
│   ├── image.ts         # 拼接 Wikimedia Commons 图片地址
│   └── bad-cards.ts     # 已知坏数据黑名单
├── types/               # TypeScript 类型定义
├── pages/               # Next.js 页面(仅首页 + 应用壳)
├── public/
│   └── items.json       # 全部卡牌数据(约 3.2MB)
└── styles/              # 各组件对应的 SCSS 模块

卡牌数据是怎么来的?

所有卡片数据来自 Wikidata 和 Wikipedia,集中存放在 public/items.json(JSON Lines 格式,每行一张卡)。每张卡包含标签、简介、年份、图片名、Wikidata ID 等字段(定义见 types/item.ts),卡片图片则按文件名实时拼接 Wikimedia Commons 中。

数据加载时会在 components/game.tsx 中做一轮清洗:

  • 过滤掉标签或简介中直接泄露年份的卡片(答案会自曝);
  • 过滤掉简介含"xx世纪"等模糊时间词的卡片;
  • 过滤掉社区反馈过的坏数据卡片,黑名单维护在 lib/bad-cards.ts。

抽卡与判分:两个核心算法

智能抽卡(lib/items.ts 中的 getRandomItem)把年份切成三个大区间(公元前 1000 年以前、1000–1800 年、1800 年至今),每次随机选一个区间再抽卡,并用 tooClose 函数排除与已出卡片年份过近的选项——开局前 10 张卡甚至要求至少相差几十年,避免"背年份"式作答。

判分(同文件中的 checkCorrect)非常直接:把已出卡片加上新卡按年份排序,看新卡应处的下标是否等于你放置的下标,不相等则记为放错,并返回偏差 delta 用于高亮提示。

一局的状态结构很简单,见 types/game.ts:牌堆 deck、已出卡片 played、下一张 next、再下一张 nextButOne(用于提前预加载图片)、生命值 lives(初始 3,见 lib/create-state.ts)和放错卡片标记 badlyPlaced。拖拽与状态流转全部在 components/board.tsx 中完成,最高分则通过 localStorage 持久化。

FAQ:常见问题

  • 数据来自哪里? 全部来自 Wikidata / Wikipedia,由作者单独的爬虫项目抓取后整理成 items.json。
  • 玩到一张说不通的卡片怎么办? 确实存在少量数据质量不佳的卡片,可通过仓库的 issue / discussion 反馈,作者会将其加入黑名单并从游戏中移除。

小结

WikiTrivia 用极小的代码量演示了完整的前端游戏闭环:静态数据加载、状态管理、拖拽交互、动画反馈、本地最高分持久化。如果你想找一个易读易改的 Next.js 小项目练手(比如换一套数据源、加排行榜、改成中文卡片),它是一个非常合适的起点。

登录后查看全文
wikitrivia