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

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

## 解决的问题
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)**: 买入30,000（重买上限120,000），13级盲注，~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小时赛程

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

### 其他功能
- 电视投屏模式：/tv 大屏显示 + /remote 手机遥控，房间码配对，服务端权威计时（手机可锁屏）
- 暂停/继续计时
- 跳过/回退盲注级别
- 重置赛制
- 设置面板自定义
- 导出/导入赛制配置
- 游戏状态自动保存（刷新页面不丢失）
- 键盘快捷键（空格暂停、左右箭头跳级、F全屏、M静音）

## 技术架构
- 前端框架: React 18 + TypeScript
- 构建工具: Vite 6
- 样式: Tailwind CSS 3
- 部署: 宿主 Nginx 静态托管（VIP Poker 主仓 vippoker-timer 前端包）
- 后端: VIP Poker 后端（Express）房间同步服务（WebSocket）
- 数据库: Redis（房间状态，24h 无操作自动回收）；留资走企业微信群机器人，不落库
- 语音: Web Speech API
- 存储: localStorage
- 图标: 内联 SVG

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

## 常见问题
<!-- 与 index.html 的 FAQPage、src/HomePage.tsx 的可见 FAQ、noscript、public/ai-data.json 逐字一致 -->
Q: 升盲计时器需要下载安装吗？
A: 不需要。手机、平板、电脑用浏览器打开就能用，无需下载 App，微信里也能直接打开；电视端另有安卓 TV 版客户端，可选安装。

Q: 收费吗？
A: 完全免费，无使用次数限制，无需注册账号。

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

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

Q: 支持 SNG、MTT 这些赛制吗？
A: 内置 SNG 9 人桌、SNG 6 人桌、Heads-Up 单挑与 MTT 锦标赛预设，也可以自定义盲注结构。

Q: 升盲计时器能投到电视大屏上吗？
A: 可以。全屏投影到电视大屏、投影仪或 OBS 采集卡，所有桌子同步同一场计时进度；锦标赛倒计时页面在电视上一屏可读。

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

## 域名与部署
- 主域名: https://timer.vippoker.vip
- 托管: 宿主 Nginx 静态托管（构建产物 dist/ → /var/www/vippoker-timer/dist）
- 构建: `npm run build`（含 SEO 站点地址注入），部署样例见 deploy/README.md

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