在线节拍器,专为吉他练习设计。基于 Web Audio API 精准时序,支持自定义拍号与倒计时停止。
- BPM 调节 — 20–300 范围,滑块 / 按钮 / 键盘快捷键 / 预设
- 拍号 — 2/4, 3/4, 4/4, 6/8, 8/8 预设 + 自定义 (numerator 1–16)
- 定时停止 — 倒计时归零自动停止播放
- 视听反馈 — 强拍 / 弱拍区分音色,节拍指示灯脉冲动效
- 暗色模式 — 一键切换,localStorage 持久化
- 个性化设置 — 5 种主题色、4 种拍子音色、4 种指示灯动效、4 种边框特效
| 层面 | 选型 |
|---|---|
| 框架 | Vue 3 + TypeScript |
| 构建 | Vite |
| 样式 | Tailwind CSS 4 |
| UI 组件 | shadcn-vue (Reka UI) |
| 图标 | lucide-vue-next |
| 音频 | Web Audio API |
| 包管理 | pnpm |
| 部署 | Docker + Nginx |
# 安装依赖
pnpm install
# 启动开发服务器 (HMR)
pnpm dev
# 生产构建
pnpm build
# 预览构建产物
pnpm preview# 构建并启动
docker compose up -d
# 访问 http://localhost:8080手动构建镜像:
docker build -t beattool .
docker run -d -p 8080:80 beattoolsrc/
├── main.ts # 入口
├── App.vue # 根组件,全局状态
├── vite-env.d.ts # Vite 类型声明 + __APP_VERSION__
├── assets/css/main.css # Tailwind 4 + shadcn 变量 + 主题色
├── lib/utils.ts # cn() 工具函数
├── components/
│ ├── ui/ # shadcn-vue 组件 (Button, Slider)
│ ├── MetronomeDisplay.vue # BPM 数字 + -/+ 按钮
│ ├── BpmSlider.vue # BPM 滑块
│ ├── TimeSignature.vue # 拍号预设按钮
│ ├── CustomTimeSignature.vue # 自定义拍号弹窗
│ ├── PlayButton.vue # 播放/停止 (呼吸光圈)
│ ├── BeatIndicator.vue # 节拍指示灯 (可切换动效)
│ ├── CountdownDisplay.vue # 倒计时弹窗 (预设 + 手动)
│ ├── PresetTempo.vue # 速度预设芯片
│ ├── SettingsModal.vue # 设置弹窗 (主题/音色/动效/边框)
│ └── TimingDebug.vue # 节拍校对面板
└── composables/
├── useMetronome.ts # 节拍引擎 (Web Audio API)
├── useCountdown.ts # 倒计时逻辑
└── useSettings.ts # 偏好设置 (localStorage 持久化)
Chrome / Firefox / Edge 最新版。需要 Web Audio API 支持。
- 修复:设置面板改为 Done 确认机制 — 选择暂存本地,点击 Done 一次性应用全部更改
- 修复:拖拽 BPM 滑块时连续爆音 — BPM/分母 watch 加入 250ms 防抖
- 修复:Teleport 弹窗(设置/自定义拍号/倒计时)不继承主题色 — data-theme 上移到 html 元素
- 优化:版本号移至卡片底部,与作者署名合并为一行
- 修复:改变 BPM/拍号后重音位置偏移(
beatsAfterAnchor=0使第一时间公式与播音对齐) - 优化:节拍指示灯闪烁后 80ms 自动熄灭,不再常亮到下一拍
- 新增:设置弹窗 Done 按钮
- 新增:设置面板 — 齿轮按钮打开弹窗,可切换主题色(5 色)、拍子音色(4 种)、指示灯动效(4 种)、边框特效(4 种)
- 新增:作者署名 "by Tyrant Blue"
- 新增:设置项 localStorage 持久化(@vueuse/core useStorage)
- 重构:useSettings composable 集中管理所有偏好设置
- 修复:切换 BPM/拍号后重音位置错误,改为统一从第 1 拍(重音)重新开始
- 优化:重音节拍指示灯特效增强 — 更大尺寸、更强阴影、常驻提示环
- 修复:停止播放后短时间内再次播放会出现重复声音,改为 close AudioContext 彻底销毁已排队的音频节点
- 修复:播放中切换 BPM 或拍号时出现重复节拍声音,改为切换时销毁并重建 AudioContext
- 新增:README 更新日志
- 修复:停止播放后声音不停止(GainNode 静音 + 版本号模板显示)
- 优化:调度器唤醒间隔固定 25ms,解决快速拍号下掉拍问题
- 新增:页面标题 BeatTool + 版本号
- 新增:节拍校对面板(预期间隔、实际间隔、累计漂移)
- 优化:自定义拍号弹窗 + 滚轮输入
- 优化:倒计时预设(5/10/15/20/30 分钟)+ 弹窗编辑
- 修复:BPM 始终以四分音符为基准,切换拍号时速度感不变
- 初始版本:BPM 调节、拍号预设/自定义、倒计时停止、暗色模式、动效
MIT