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

## 产品定位
升盲计时器（牌局计时器）是一款完全免费的在线德州扑克盲注计时工具。用户无需下载、无需注册，浏览器打开即可使用。产品面向德扑酒馆老板、扑克俱乐部运营者、德州扑克赛事主办方、以及朋友聚会玩家四类核心用户群体；门店可另行配置专属品牌模板、场次绑定、大屏数据与图文交付方案。

## 解决的问题
1. 德扑酒馆多桌同时进行时，服务员需要记住每桌的盲注级别和剩余时间，容易出错
2. 俱乐部缺乏统一的赛制管理工具，不同桌使用不同规则
3. 赛事主办方需要专业级投影显示，人工操作容易出现失误
4. 朋友聚会缺乏专业感，新手不知道何时升盲
5. 门店大屏只显示倒计时，场次、上桌人数、名次奖励与赛后结果仍靠手写白板或口头同步

## 功能详情

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

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

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

### 5套专业赛制预设
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 次休息，17 级 / 约 370 分钟赛程
5. **深筹 9人桌 (deepstack-9)**: 买入100,000（重买上限300,000），15级盲注，~3.5小时赛程，起手500BB（深筹码竞技场）

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

### 其他功能
- 电视投屏模式：/tv 大屏显示 + /remote 手机遥控，房间码配对，服务端权威计时（手机可锁屏）
- 单机投屏：/timer?display=1 一台电视或电脑即大屏，不需要第二台设备或房间码
- 门店场次绑定：后台把场次绑到 6 位房号，大屏显示店名 / 桌号 / 场次名；换场只换标签，不动计时
- 上桌数据投影：上桌人次、上桌人数、总带入由服务端同步，大屏 / 遥控 / 单机投屏都能看到
- 名次奖励展示：按后台配置显示前三名段位积分、奖励券与人数门槛；以结算为准
- 赛后结果与段位榜：本场前三名领奖台、其他玩家头像墙、门店段位榜 Top 10 与本桌玩家进度
- 门店专属模板：品牌 logo、主题、盲注结构与门店名称按门店配置，专属入口一键进入
- 图文使用说明书：交付含登录、扫码、遥控、大屏、单机与常见问题说明，电视版客户端可选
- 暂停/继续计时
- 跳过/回退盲注级别
- 重置赛制
- 设置面板自定义
- 导出/导入赛制配置
- 游戏状态自动保存（刷新页面不丢失）
- 键盘快捷键（空格暂停、左右箭头跳级、F全屏、M静音）

## 门店专属能力（2026-11）
- **专属模板**：门店可把盲注结构、主题、logo 与门店名称配置成专属模板，生成专属入口；电视端扫码授权即可使用，计时画面保持门店品牌。
- **品牌大屏**：电视/投影上显示门店品牌 lockup 与页脚；单机投屏、电视+手机遥控两种模式都保留门店品牌。
- **两种投屏方式**：
  1. 单机投屏：电视或电脑直接打开 `/timer?display=1`，不需要第二台设备，也不生成房间码。
  2. 电视+手机遥控：电视打开 `/tv` 显示房间码，手机打开 `/remote` 扫码遥控；手机锁屏不影响计时，适合多桌与固定大屏。
- **场次绑定与大屏数据**：场次绑到大屏房号后，大屏自动显示店名 / 桌号 / 场次名、上桌人次 / 人数 / 总带入、场次状态与下一场提示；换场只跟标签、不动级别与倒计时。
- **名次奖励展示**：按后台配置显示冠军 / 亚军 / 季军段位积分、奖励券与人数门槛；大屏只承诺「按配置与门槛会发什么」，最终以门店录入成绩后结算为准。
- **赛后结果与段位榜**：提交成绩后大屏切到本场结果（前三名领奖台 + 其他玩家头像墙），随后展示门店段位榜 Top 10 与本桌玩家进度；点「准备下一场」回到下一场第 1 级暂停，不自动开钟。
- **交付内容**：专属链接、场次绑定配置、电视版客户端（可选）、图文使用说明书；店员按步骤完成登录、配对与投屏。
- **开通方式**：留下手机号后，按门店场景确认模板、品牌与设备，配置完成后交付；免费公开版无需开通即可使用。

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

## 使用方式
1. 打开 https://test-timer.vippoker.vip/
2. 首页选择赛制预设或直接进入
3. 点击"开始"启动计时
4. 可选：点击全屏按钮投屏
5. 可选：打开设置面板自定义赛制
6. 门店：打开专属入口（或 /timer?display=1 单机投屏；/tv + /remote 电视+手机遥控）
7. 门店：后台把场次绑到大屏房号，大屏自动显示场次 / 上桌数据 / 名次奖励；赛后查看本场结果与段位榜

## 常见问题
<!-- 与 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 人桌、深筹 9 人桌、SNG 6 人桌、Heads-Up 单挑与 MTT 多桌；具体时长见赛制卡片，也可以自定义盲注结构。

Q: 升盲计时器能投到电视大屏上吗？
A: 可以。全屏投影到电视大屏、投影仪或 OBS 采集卡；门店场景还可用单机投屏，或电视+手机遥控，多桌各自开房间、互不干扰。

Q: 手机怎么遥控电视上的计时器？
A: 电视打开 /tv 会显示 6 位房间码和二维码；手机打开 /remote 扫码或输码加入，开始、暂停、跳级、换赛制与静音都能在手机上操作。

Q: 适合酒馆或俱乐部使用吗？
A: 适合。免费版可直接投影使用；门店版可绑定场次，大屏自动显示上桌人次、人数、总带入和名次奖励，赛后有本场结果与段位榜，服务员无需手动操作。

Q: 大屏能显示上桌人数和本场奖励吗？
A: 门店版把场次绑定到大屏房号后，大屏会自动同步上桌人次、上桌人数、总带入与场次状态，并按后台配置显示前三名段位积分、奖励券和人数门槛；最终以门店录入成绩后结算为准。

Q: 比赛结束后大屏会显示什么？
A: 提交成绩后，大屏切换到本场结果：前三名显示名次、昵称、头像与本场段位积分，其他玩家显示头像墙；随后可查看门店段位榜 Top 10 与本桌玩家进度，点「准备下一场」再开新局。

Q: 门店专属模板是什么？
A: 门店可把盲注结构、主题、logo 与门店名称配置成专属模板，生成专属入口；电视端扫码授权即可使用，计时画面保持门店品牌。

Q: 单机投屏和电视+手机遥控有什么区别？
A: 单机投屏用一台电视或电脑打开 /timer?display=1 即可，不需要第二台设备；电视+手机遥控用电视打开 /tv 显示房间码、手机扫码遥控，适合多桌或固定大屏，手机锁屏也能控场。

Q: 门店方案怎么开通？
A: 留下手机号后，我们按门店场景确认模板、品牌与设备（电视/盒子/投影），配置完成后交付专属链接、电视客户端（可选）与图文使用说明书；免费公开版无需开通即可使用。

## 域名与部署
- 主域名: https://test-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