logo
0
0
Login
Jaguarliu<18829516908@163.com>
init

汉兜 Handle

🎯 汉兜 Handle

中文汉字版 Wordle 游戏 | 古诗词猜字游戏

一个基于中国古诗词的汉字猜谜游戏,灵感来源于 Wordle

在线体验 License Vue 3

🚨 请勿剧透!PLEASE DO NOT SPOIL 🚨


✨ 特色功能

  • 🎨 古诗词主题 - 基于中国古典诗词的汉字猜谜游戏
  • 🎯 智能提示 - 通过颜色反馈帮助玩家猜测正确答案
  • 📱 响应式设计 - 完美适配桌面端和移动端
  • 🌙 深色模式 - 支持明暗主题切换
  • 📊 游戏统计 - 记录游戏历史和成绩
  • 🎉 分享功能 - 一键分享游戏结果
  • 🔄 每日更新 - 每天都有新的挑战
  • 🎵 拼音支持 - 支持多音字和特殊发音

🚀 快速开始

在线体验

直接访问 handle.antfu.me 开始游戏!

本地运行

# 克隆项目 git clone https://github.com/antfu/handle.git cd handle # 安装依赖 pnpm install # 启动开发服务器 pnpm dev # 访问 http://localhost:4444

🎮 游戏规则

  1. 目标:根据古诗词线索,猜出正确的汉字组合
  2. 输入:每次输入一个汉字
  3. 反馈
    • 🟩 绿色:字符正确且位置正确
    • 🟨 黄色:字符正确但位置错误
    • 灰色:字符不在答案中
  4. 限制:每天只能玩一次,共有6次猜测机会

🛠️ 开发环境设置

环境要求

安装步骤

# 1. 安装依赖 pnpm install # 2. 启动开发服务器 pnpm dev # 3. 构建生产版本 pnpm build # 4. 预览构建结果 pnpm preview # 5. 运行测试 pnpm test # 6. 代码检查 pnpm lint

📁 项目结构

handle/ ├── src/ │ ├── components/ # Vue 组件 │ │ ├── WordBlocks.vue # 字符块组件 │ │ ├── CharBlock.vue # 单个字符组件 │ │ └── ... │ ├── data/ # 游戏数据 │ │ ├── poems.ts # 古诗词数据 │ │ ├── pome.json # 古诗词元数据 │ │ └── polyphones.json # 多音字数据 │ ├── logic/ # 游戏逻辑 │ │ ├── check.ts # 答案检查逻辑 │ │ ├── types.ts # 类型定义 │ │ └── ... │ ├── locales/ # 国际化文件 │ │ ├── zh-cn.json # 简体中文 │ │ └── zh-tw.json # 繁体中文 │ └── styles/ # 样式文件 ├── public/ # 静态资源 ├── tools/ # 构建工具 └── test/ # 测试文件

🔧 技术栈

  • 前端框架Vue 3 - 渐进式 JavaScript 框架
  • 构建工具Vite - 下一代前端构建工具
  • CSS 框架UnoCSS - 即时原子化 CSS 引擎
  • 工具库VueUse - Vue 组合式 API 工具集
  • 类型检查TypeScript - JavaScript 的超集
  • 测试框架Vitest - 基于 Vite 的测试框架
  • 代码规范ESLint - 代码质量检查工具

📝 古诗词数据维护

数据文件说明

数据结构

古诗词数据包含以下字段:

  • title - 诗词标题
  • author - 作者
  • content - 诗词内容
  • answer - 答案汉字
  • hint - 提示信息

🤝 贡献指南

我们欢迎所有形式的贡献!

如何贡献

  1. Fork 本仓库
  2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开一个 Pull Request

贡献类型

  • 🐛 Bug 修复
  • 新功能开发
  • 📝 文档改进
  • 🎨 UI/UX 优化
  • 🔧 代码重构
  • 📊 数据更新(古诗词等)

代码规范

  • 遵循项目的 ESLint 配置
  • 提交前运行 pnpm lint 检查代码
  • 为新功能添加相应的测试
  • 保持代码简洁和可读性

📄 许可证

本项目基于 MIT 许可证开源

Copyright © 2021-PRESENT Anthony Fu


📢 重要声明

注意

汉兜的答案库至 2023 年 2 月 28 日为止将不再更新;后续的题目将从过往一年的题目中随机抽取。

仓库以 MIT 协议开放,在注明原始仓库与作者的条件下,欢迎 Fork 与修改。

感谢大家对汉兜的支持与喜爱!❤️


如果这个项目对你有帮助,请给它一个 ⭐️

🎮 开始游戏 | 📖 查看文档 | 🐛 报告问题