0.1.0

好友德州 v0.1.0

这是“好友德州”的首次源码发布，面向希望自行搭建服务、快速和朋友组织私人牌局的熟人玩家及开发者。项目不提供公共运营服务，也不面向互联网公开传播。

发布方式

本 Release 不会直接附带 Web、Windows、Android、HarmonyOS 安装包，仅发布 Git 标签对应的源码快照。

客户端需要写入自建游戏服务地址，语音需要部署者自己的腾讯云 TRTC 配置，Android 与 HarmonyOS 正式分发还涉及各自的平台签名，因此各平台产物应由部署者根据自己的环境构建、签名和测试。

从空服务器开始部署，请参阅自建部署指南。已有部署的版本升级流程请参阅生产环境更新手册。

首发功能

跨平台客户端

• 基于 Flutter OH 的统一客户端代码。
• 已完成 Web、Windows、Android 和 HarmonyOS 构建验证。
• HarmonyOS 声明支持手机、平板和 PC/二合一设备。
• 横屏牌桌、全屏移动端体验和多尺寸窗口自适应。

好友房与完整牌局

• 房间码和可选房间密码，牌桌人数随朋友加入动态扩展，最多 10 人。
• 房主标识与离桌后的自动房主转移。
• 服务端权威的德州扑克流程、位置、盲注、主池、边池、摊牌和结算。
• 自定义盲注、最大带入、玩家自主带入、手间补码和输光自动补码。
• 1/4 池、1/3 池、1/2 池、2/3 池、满池、1.2 倍超池、全下及按小盲整数倍自定义下注。
• 普通行动 30 秒；仅剩两名未弃牌玩家时为 60 秒；每人每手两张 30 秒加时卡。
• 每手结束 10 秒自动准备，并可主动取消。
• 空桌位换座与满桌双方确认换位。
• 满足全下与无需后续行动条件时协商发一次或发两次，双方同意后运行两块公共牌并分别结算。
• 弃牌状态、赢家特效、中文牌型、主动亮牌及经对方同意的私下看牌。

牌桌交流

• 牌桌文字聊天、快捷语和表情，收起状态提供未读提醒。
• 本地屏蔽与管理员持久化文字禁言。
• TRTC 牌桌自由麦、成员与说话状态、播放音量和逐玩家语音屏蔽。
• 点击玩家头像发送带全桌动画和音效的赞赏或嘲讽。
• 下注、全下、过牌和弃牌独立音效。

账户、筹码和管理

• 注册、登录、短期 Access Token 与轮换式 Refresh Token。
• 无支付接口的娱乐虚拟筹码充值、钱包流水、牌局记录与结算历史。
• 用户可修改登录用户名、牌桌昵称和密码。
• 一次性首管理员初始化入口及服务端权限校验。
• 管理员可管理账号、在线状态、筹码、所在房间、密码、注册开关和文字禁言，并可强制玩家离房。
• 批量创建、停用、恢复和软删除账号，关键操作保留审计记录。

服务端与数据

• Go 权威游戏服务，REST API 与 WebSocket 实时协议。
• WebSocket 事件序列、请求幂等、断线补发和私人快照恢复。
• PostgreSQL 持久化账户、会话、钱包、房间、牌局、聊天、结算账本和管理审计。
• 版本化数据库迁移、迁移校验和与并发迁移锁。
• Docker 多阶段构建及健康/就绪检查。
• 已完成真实 PostgreSQL 集成测试，以及 10 个独立 WebSocket 客户端连续 100 手的筹码守恒验收。

当前限制

• 项目定位为熟人封闭牌局，不包含真实货币、支付或提现功能。
• 当前生产架构为单游戏服务实例；Redis 多实例协调、自动故障恢复和完整备份演练仍在后续计划中。
• 语音功能依赖部署者自行申请和配置腾讯云 TRTC。
• iOS 尚未作为 v0.1.0 的正式构建交付目标。
• 各平台安装包需由部署者自行构建、签名并在目标设备上验证。

获取源码

git clone https://github.com/wm-develop/Texas.git
cd Texas
git checkout v0.1.0

首次部署前请完整阅读自建部署指南，不要把数据库密码、TRTC 密钥、生产域名配置或平台签名提交到仓库。