---

name: rhythm-master description: This skill enables playing a rhythm game called "节奏大师" (Rhythm Master) similar to QQ Dance/DDR. Players press arrow keys and spacebar in time with falling notes to score points. The game features multiple difficulty levels, combo system, judgment ratings (PERFECT/GREAT/GOOD/BAD/MISS), local leaderboard, and can be extended with online leaderboards. Use this skill when the user wants to play a rhythm game, test their reflexes, or have fun with a keyboard-based music game.

节奏大师 - Rhythm Master

简介

《节奏大师》是一款键盘节奏游戏，玩家需要在正确的时机按下对应的按键（↑↓←→空格），跟随音乐节奏击打落下的音符。游戏拥有完善的判定系统、连击机制、多难度等级和排行榜功能。

何时使用此 Skill

• 用户说"我想玩节奏游戏"、"来玩音游"、"测试手速"
• 用户想要类似 QQ炫舞、osu!、太鼓达人 的游戏体验
• 用户想玩需要反应速度的键盘游戏
• 聚会时需要竞技性小游戏
• 用户明确表示想玩音乐节奏游戏

游戏特色

🎮 核心玩法

• 5键操作：← ↓ SPACE ↑ →
• 实时判定：PERFECT / GREAT / GOOD / BAD / MISS
• 连击系统：连击越高，得分倍数越高
• 生命系统：MISS会扣除生命，生命归零游戏结束

📊 难度等级

难度	速度	音符密度	适合人群
简单 (EASY)	慢	稀疏	初学者
普通 (NORMAL)	中等	中等	普通玩家
困难 (HARD)	快	密集	熟练玩家
专家 (EXPERT)	极快	极密	高手

🏆 排行榜系统

• 本地排行榜：自动保存前100名，使用浏览器 LocalStorage
• 联网排行榜：可扩展至 Firebase/自建服务器（需额外配置）
• 详细统计：保存 PERFECT/GREAT/GOOD/BAD/MISS 数量和最大连击

游戏数据与资源

游戏机制文档

• references/game_mechanics.md - 完整游戏机制说明
  • 判定系统（50ms-200ms 时间窗口）
  • 得分计算公式
  • 连击加成表
  • 评级系统（SSS/A/B/C/D）
  • 游戏模式（经典/无尽/挑战/对战/练习）

排行榜系统文档

• references/leaderboard_system.md - 排行榜实现方案
  • 本地存储实现（已内置）
  • Firebase 联网方案
  • 自建后端方案（Node.js + MongoDB）
  • 防作弊机制
  • 部署指南

游戏实现

• assets/rhythm-game.html - 完整的网页版游戏
  • 单文件 HTML，开箱即用
  • 响应式设计，支持移动端
  • 完整的游戏逻辑和UI
  • 本地排行榜功能

如何使用

启动游戏

方式一：直接打开 HTML 文件

1. 打开 assets/rhythm-game.html
2. 使用浏览器打开（推荐 Chrome/Edge/Firefox）
3. 选择难度，点击"开始游戏"

方式二：部署到网页服务器

# 使用 Python 快速启动本地服务器
cd assets
python -m http.server 8080
# 访问 http://localhost:8080/rhythm-game.html

方式三：部署到公网

• GitHub Pages
• Netlify
• Vercel
• Cloudflare Pages

游戏操作

按键布局：

左手区          空格          右手区
┌───┬───┐                    ┌───┬───┐
│ ← │ ↓ │       [SPACE]      │ ↑ │ → │
└───┴───┘                    └───┴───┘
小指  无名指      双手拇指       食指  中指

操作技巧：

1. 保持节奏感：跟着内心默数节拍
2. 预判音符：眼睛看判定线，余光看音符
3. 手位固定：保持手位不要移动
4. 宁可GOOD不断连：保持连击比准确率更重要
5. 放松心态：紧张会影响反应速度

游戏规则

1. 音符下落：音符从上方落下，到达判定线时按键

2. 判定等级：

   • 🌟 PERFECT (±50ms) - 100分
   • ✨ GREAT (±100ms) - 80分
   • 👍 GOOD (±150ms) - 50分
   • 😕 BAD (±200ms) - 20分，连击中断
   • ❌ MISS (>200ms) - 0分，扣1生命

3. 连击加成：

   • 1-10连击：1.0x
   • 11-30连击：1.1x
   • 31-50连击：1.2x
   • 51-100连击：1.5x
   • 101-200连击：2.0x
   • 200+连击：2.5x

4. 评级系统（根据准确率）：

   • SSS (100%) - 节奏之神
   • SS (95-99%) - 节奏大师
   • S (90-94%) - 节奏高手
   • A (80-89%) - 节奏达人
   • B (70-79%) - 节奏学徒
   • C (60-69%) - 节奏新手
   • D (<60%) - 节奏小白

游戏流程

1. 主菜单

🎵 节奏大师

[选择难度：简单/普通/困难/专家]

[▶ 开始游戏]
[🏆 排行榜]
[❓ 游戏说明]

2. 游戏界面

得分: 12,500  |  连击: 45  |  生命: ♥♥♥♥♥  |  时间: 45s

        [COMBO 显示区域]

    ←       ↓      SPACE      ↑       →
    ○       ○        ○        ○       ○

    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
              [判定线]

    【音符从这里落下】

3. 游戏结束

🎉 游戏结束

最终得分: 98,500
评级: S

统计：
PERFECT: 120  |  GREAT: 35  |  GOOD: 5
BAD: 0        |  MISS: 0    |  最大连击: 156

[输入名字保存分数]
[💾 保存分数] [🏆 查看排行榜] [🔙 返回主菜单]

扩展联网排行榜

快速方案：Firebase（推荐）

步骤：

1. 访问 https://firebase.google.com 创建项目
2. 获取配置信息
3. 在 rhythm-game.html 中添加 Firebase SDK
4. 修改保存分数和获取排行榜的函数

代码示例：

// 保存到云端
async function saveScoreOnline(scoreData) {
  const db = firebase.database();
  await db.ref('leaderboard').push(scoreData);
}

// 获取排行榜
async function getOnlineLeaderboard() {
  const snapshot = await db.ref('leaderboard')
    .orderByChild('score')
    .limitToLast(20)
    .once('value');
  return snapshot.val();
}

详细配置请参考 references/leaderboard_system.md

游戏特色功能

视觉效果

• 🌈 霓虹科技风格 UI
• ✨ 判定结果动态特效
• 🔥 连击数越高背景越华丽
• 💥 MISS时屏幕震动反馈
• 🎨 不同按键不同颜色区分

音效反馈

• 每个按键有不同的音高
• 判定结果有不同音效
• 连击 milestone 有特殊音效

响应式设计

• 支持桌面端和移动端
• 自适应不同屏幕尺寸
• 触摸操作支持（移动端）

技术规格

性能要求

• 目标帧率：60fps
• 输入延迟：<16ms
• 支持浏览器：Chrome 80+, Firefox 75+, Edge 80+, Safari 13+

代码结构

rhythm-game.html
├── HTML 结构
│   ├── 菜单界面
│   ├── 游戏界面
│   ├── 结算界面
│   └── 排行榜界面
├── CSS 样式
│   ├── 霓虹灯主题
│   ├── 动画效果
│   └── 响应式布局
└── JavaScript 逻辑
    ├── 游戏状态管理
    ├── 音符生成系统
    ├── 判定系统
    ├── 得分计算
    └── 排行榜存储

注意事项

键盘兼容性

• 确保键盘支持多键同时按下（防鬼键）
• 部分笔记本键盘可能有限制
• 推荐使用外接机械键盘获得最佳体验

浏览器设置

• 确保浏览器允许自动播放（如需添加背景音乐）
• 建议全屏模式游玩（按 F11）
• 关闭省电模式以保持 60fps

游戏体验优化

1. 首次游玩：建议从"简单"难度开始
2. 提高准确率：专注听节奏而非看音符
3. 保持连击：宁可准确率稍低也不要断连
4. 休息间隔：每玩3-5局休息眼睛和手指

示例对话

启动游戏

用户：我想玩节奏游戏

AI：好的！为你启动《节奏大师》🎵

这是一款键盘节奏游戏，使用 ← ↓ SPACE ↑ → 五个按键。
音符会从上方落下，到达判定线时按下对应按键！

游戏已准备好，选择难度开始吧：
- 🟢 简单 - 适合初学者
- 🔵 普通 - 标准难度
- 🟡 困难 - 需要较好反应
- 🔴 专家 - 极限挑战

你想选择哪个难度？

游戏进行中提示

AI：游戏开始！跟着节奏点击按键...

💡 小技巧：
1. 眼睛看判定线，余光看音符
2. 保持放松，紧张会影响反应
3. 宁可GOOD不断连，连击加成很重要！

当前状态：
❤️ 生命：5/5  |  ⭐ 连击：0  |  🎯 得分：0

准备好了吗？3... 2... 1... GO! 🎮

游戏结束后

AI：🎉 游戏结束！

📊 你的成绩：
━━━━━━━━━━━━━━━━━━━━━━
得分：98,500
评级：S (节奏高手)
最大连击：156

详细统计：
🌟 PERFECT：120
✨ GREAT：35
👍 GOOD：5
😕 BAD：0
❌ MISS：0
━━━━━━━━━━━━━━━━━━━━━━

太棒了！几乎没有失误！想再挑战一次更高难度吗？

文件清单

rhythm-master/
├── SKILL.md                          # 本文件 - 核心文档
├── references/
│   ├── game_mechanics.md            # 游戏机制详细说明
│   └── leaderboard_system.md        # 排行榜系统方案
└── assets/
    └── rhythm-game.html             # 完整游戏文件

许可

本 Skill 为开源项目，可自由使用、修改和分发。

---

🎵 准备好挑战你的反应极限了吗？打开 rhythm-game.html 开始游戏吧！