Commit Graph
4 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 cfef896fd6 二七王:UI 清单统一底牌术语,细化叫分按钮,确认 S-1 语义
术语修订(本文先行,design/protocol 待同步):
- 底牌 = 发牌时没发给玩家、留在桌面的 8 张(原「暗牌」)
- 埋牌底牌 = 庄家埋牌扣下的 8 张(原「底牌」)
改后底栏按钮名实相符(底牌钮看底牌、扣底钮看埋牌底牌),原「术语陷阱」
一节改写为「术语已统一」。新增 §0.0 术语节置于全文之首。
全文 35 处表述与精灵键名同步(DARK_CARD→BOTTOM_CARD、
BOTTOM_CARD→BURY_CARD、ANCARD_3S→BOTTOM_3S)。

S-3 定论:底牌可见性按 design 手册办——庄家全程可看,闲家仅 70 分坐庄局
可看,其余局按钮不显示。服务端无需改动,现有下发面正好支持。

新增两条服务端待补:
- S-4 拆分 bottomcards 字段名:底牌保持 bottomcards,埋牌底牌改 burycards
  (maipai / PushCards / 结算 bottom 分组)。前端未开工,现在改代价最小。
- S-5 同步 design.md 与 packet_protocol.md 的术语,并列出待改位置清单。
  三份文档术语不一致会直接违反 SSOT,属最危险的那类分歧。

S-1 语义确认:当前捡分对应判定倍率的实时预览(大光×3/小光×2/过庄×1/
升N级×N)。要求随 chupai1/2/3、PushCards、shangzhuang 一起下发
curmultiple,不新开推送包;get_upgrade 现成可用。

叫分按钮(据更新后的 叫分按钮面板.png):
- 配色按档位位置固定,只因不可叫变灰,不随子数变。
- 按钮底与右上角角标底画在同一张图上,4 帧。
- 叫分分数用数字精灵(新增资源 NUM_CALL_SCORE),角标子数用文字精灵。
- 每档由 4 个精灵改为 3 个。
数字口径相应从「一律图片多帧」改为分工:美术字用图片、纯数据小字用文字精灵。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 17:48:49 +08:00
joywayerandClaude Opus 5 5dda571250 二七王:UI 清单落实 A/B/C 组决策,新增服务端待补项
规格确认(T-4/6/7/8/10/11/12/15/16/18/19/22/23/26 全部落地):
- 叫分按钮配色按【档位位置】固定三档(浅黄/金黄/橙)+ 灰=已叫过,
  按钮底与角标底各 4 帧。特别标注:参考图角标 1子/2子/4子 是 mock,
  颜色不随子数变(反证:常规算子下 50~5 档同为 6 子却是两种颜色)。
- 选主大数字=该花色张数、角标=对数;手牌标记 3 帧(拖/正2正7/其他主牌)。
- 底栏功能按钮定为 5 个,新增「扣底」;并显著标注术语陷阱——底栏「底牌」
  按钮看的是【暗牌】、「扣底」按钮看的才是【底牌】,而协议里两批牌共用
  bottomcards 字段名,要求前端用 anCards/diCards 区分。
- 结算底牌文案的 x 后面是扣底倍数;牌型标签只做「毙」;准备标识用平台的;
  数字一律用图片多帧(参考图数字带描边渐变)。
- 发牌动画:从右往左铺开。算奖叠加层点遮罩关闭、并列显示奖数。
- 自己发的提示本地回显,作为悲观 UI 的受控例外并写明成立理由
  (提示不含对局状态、服务端不校验真实性)。
- T-5 手牌排序定为对齐服务端 order_cards 主牌序,选主后整体重排。

新增 §7.5 服务端待补项:
- S-1 抓分倍数字段:协议现无,出牌阶段拿不到任何倍数;服务端 get_upgrade
  现成可用,建议补 curmultiple,语义待最终确认。
- S-2 下发应选中的牌:get_followcard 已返回 mustcard,仅用于内部校验、
  未下发;建议只发给 nextseat 一家(整表下发会泄露他家手牌结构)。
- S-3 ⚠️ 底栏「底牌」按钮要求所有人可看暗牌,与 design §4「非 70 分时
  暗牌只有庄家可见」及协议下发面直接冲突;给出三个方案,确认前前端按
  最保守的 (a) 限定可见范围实现。

新增 D-13(扣底查看面板)、验收清单增至 15 条。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 13:25:33 +08:00
joywayerandClaude Opus 5 ddb4f7d6a2 二七王:UI 清单增补布局配置规范,并据 4 张新/改参考图更新
新增/更新的参考图带来的确定项:
- 小局结算.png 更新:两个小字标签定为「牌局分」(grade_jf) /「算奖分」(grade_aw),
  关闭 T-13;新增「算奖牌型」「下一局」两个按钮。
- 算奖牌型显示.png:算奖明细走独立的半透遮罩叠加层(aset.seatlist[i].cards),
  关闭 T-14。
- 自己是闲家时的踩有分没分按钮.png:提示入口 = 底栏三按钮,占用庄标区域、
  与庄标互斥;气泡资源定为 3x2 六帧,按「头像在气泡哪一侧」选箭头朝向,
  关闭 D-5。
- 创建房间选项参考图:属他游戏内容,只取视觉范式;二七王实际为 4 行
  (局数/扣卡/玩法多选/查牌),无人数行,D-1 降级为「缺定稿」。
- 左上家出牌区确认为右上家的左右镜像,关闭 D-12。

§6 由「布局坐标表」重写为「布局配置规范与配置清单」:
- 所有布局参数一律外提为配置,业务代码零裸值(工程总则 §6 / client 02 §2)。
- 定义 5 种布局器 point / line / fan / grid / attach,参数名直接对齐框架
  AlignmentUtils 的入参,配置可原样喂入、零转换。
- fan 给出唯一的自适应间距算法;bySeat 表达三个显示位的差异;
  另有 textStyle 预设与 CARD_SIZE 尺寸档,改一处全局跟随。
- 补充配置文件组织与「与平台 PLAYER_INFO_LAYOUT 坐标一致性」的衔接要求。

待办变化:关闭 T-1/T-13/T-14 与 D-5/D-12,新增 T-22..T-28。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 08:14:30 +08:00
joywayerandClaude Opus 5 6fc9f15976 二七王:新增前端 UI 资源与精灵清单(docs_dev)+ 归档 9 张参考图
对照 design.md 全流程与 packet_protocol.md 下发字段,把二七王前端所需的
图片资源、声音、精灵、图层、群组、坐标整理成可执行规格书,供美术出图与
gameabc 编辑器建资源使用。

要点:
- 核实号段占用:精灵 1001-3000 段内仅 3000 被占(Spirit3000/Layer602),
  实际可用 1001-2999;图层 101-200/301-400、群组 201+、图片 501+ 全空闲。
- 牌面资源定为 10x6=60 帧通用排版(黑桃/红桃/梅花/方块 A-K + 双王 + 6 牌背),
  开大/中/小三套尺寸;给出唯一权威的 cardIdToFrame 转换与 10 条校验样例。
  服务端 flower 编号(1方块..4黑桃)与美术花色顺序相反,转换须按花色段倒序数。
- 标明平台已提供、子游戏不重建的部分(头像/昵称/分数、聊天语音气泡、
  RecordView、帮助、建房界面骨架与 25 号确认按钮)。
- 座位方向据 class.paiju.js:264 get_nextseat 定论:下家 =(seat+1)%3、显示在右上。
- 汇总 12 项待出设计稿(D-1..D-12)与 20 项待确认规格(T-2..T-21)。

ID 均为规划建议值,编辑器建成后须回填校准;坐标为参考图实测估值。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-24 22:40:44 +08:00