# 牌局计时器 — 完整产品文档

## 产品定位
牌局计时器是一款完全免费的在线德州扑克盲注计时工具。用户无需下载、无需注册，浏览器打开即可使用。产品面向德扑酒馆老板、扑克俱乐部运营者、德州扑克赛事主办方、以及朋友聚会玩家四类核心用户群体。

## 解决的问题
1. 德扑酒馆多桌同时进行时，服务员需要记住每桌的盲注级别和剩余时间，容易出错
2. 俱乐部缺乏统一的赛制管理工具，不同桌使用不同规则
3. 赛事主办方需要专业级投影显示，人工操作容易出现失误
4. 朋友聚会缺乏专业感，新手不知道何时升盲

## 功能详情

### 语音自动播报
使用浏览器内置的 Web Speech API 进行中文语音合成。当盲注级别变化时自动播报新级别和盲注金额。剩余一分钟时播报下一级预告。最后十秒逐秒倒数播报。支持一键静音。

### 全屏投影
一键进入全屏模式，适配 16:9 比例投影。可投屏到电视、投影仪、或通过 OBS 采集用于直播。全屏模式下显示当前盲注级别、倒计时、小盲/大盲金额，简洁专业的赛事级视觉。

### 6款视觉主题
- **经典 (Classic)**: 深蓝渐变背景，金色点缀，适合大多数场景
- **扑克之夜 (Poker Night)**: 绿色为主调，赌场绿感，适合酒馆/俱乐部
- **赛博朋克 (Cyberpunk)**: 紫色霓虹色调，科技感强，适合年轻人群
- **奢华 (Luxury)**: 暗金质感，高端大气，适合VIP室/高端俱乐部
- **复古 (Retro)**: 暖棕色调，怀旧风格，适合私人牌局
- **简约 (Minimal)**: 纯黑极简，专注计时，适合赛事投影

### 4套专业赛制预设
1. **SNG 9人桌 (sng-9)**: 买入20,000，10级盲注，~2小时赛程
2. **SNG 6人桌 (sng-6)**: 买入15,000，12级盲注，~2小时赛程
3. **单挑 Heads-Up (heads-up)**: 买入10,000，12级盲注，快节奏对决
4. **多桌 MTT (mtt)**: 买入30,000，含3次休息间隔，~5小时赛程

所有赛制支持自定义编辑，可调整每一级的盲注金额、时长、以及添加/删除休息间隔。

### 其他功能
- 暂停/继续计时
- 跳过/回退盲注级别
- 重置赛制
- 设置面板自定义
- 导出/导入赛制配置
- 游戏状态自动保存（刷新页面不丢失）
- 键盘快捷键（空格暂停、左右箭头跳级、F全屏、M静音）

## 技术架构
- 前端框架: React 18 + TypeScript
- 构建工具: Vite 6
- 样式: Tailwind CSS 3
- 部署: Cloudflare Pages
- 后端: Cloudflare Pages Functions (线索收集)
- 数据库: Cloudflare D1
- 语音: Web Speech API
- 存储: localStorage
- 图标: 内联 SVG

## 使用方式
1. 打开 https://poker-timer-7ir.pages.dev/
2. 首页选择赛制预设或直接进入
3. 点击"开始"启动计时
4. 可选：点击全屏按钮投屏
5. 可选：打开设置面板自定义赛制

## 常见问题
Q: 需要下载安装吗？
A: 完全不需要。浏览器打开就能用，手机、平板、电脑全支持。微信里也能直接打开。

Q: 网络断了还能用吗？
A: 计时器主要逻辑在本地运行，中途断网不影响计时。语音播报也离线可用。

Q: 可以自定义盲注结构吗？
A: 当然。进入计时器后打开设置面板，自由编辑每一级的盲注和时长。保存后下次直接加载。

Q: 适合酒馆/俱乐部使用吗？
A: 非常适合。全屏投影到电视上，所有桌同步计时；语音自动播报，服务员无需手动操作。已有多家俱乐部在使用。

## 域名与部署
- 主域名: https://poker-timer-7ir.pages.dev
- 托管: Cloudflare Pages
- 构建: Git Push 自动触发部署

## 关键词 (用于搜索优化)
德州扑克计时器, 盲注计时器, 升盲倒计时, 扑克计时器, 牌局计时, 在线计时器, SNG计时器, MTT计时器, 德扑酒馆工具, 扑克俱乐部工具, 免费盲注计时, Texas Hold'em timer, poker blind timer, poker clock