daoqi/erqiwang_youle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
66 Commits 1 Branch 0 Tags
cfef896fd66f9a40022fe0bcc6c4da9a6ce822e8
Commit Graph
7 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 2c3464b6f0 二七王：UI 清单关闭 7 项待确认，补平台图层清单与验收检查表 
从平台代码/编辑器数据查证后关闭：
- T-2 解散投票：平台全包（Layer 420 CheckFree_Layer + GameUI.openCheck
  + Desk.self_apply_free_room 一族），子游戏只处理解散结算包，D-10 缩到
  只剩结算面板。
- T-3 建房图层：Layer 27 CreateRoom_Layer；Layer 28 SeniorOptions_Layer
  是代开房/抽水，与玩法规则选项无关，不走它。

按参考图算定 / 技术自决：
- T-21 手牌间距：单排 spacingMin=-78（36 张露 32px，与实测 33px 吻合），
  双排 -65。
- T-27 埋牌分行：上排 floor(n/2)、下排 ceil(n/2)；参考图 17/19 按 mock 处理。
- T-25 line 增加可选 items 支持逐项不等宽，底栏功能钮组与埋牌/出牌操作条
  改用它。
- T-17 倒计时归零停在 0 不隐藏（隐藏会被误读为已超时/已跳过）。
- T-28 EQW_Layout 为权威，配置区手工同步并列入验收。

另补：
- §0.2 增列平台已占用的 14 个图层（创建房间/解散/帮助/设置/加载/重连/
  战绩/聊天语音等），凡列出者子游戏不必重建。
- 新增 §7.3 验收检查清单 12 条，逐条对应一处已知易错点。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 09:01:52 +08:00
joywayerandClaude Opus 5 b85c286dde 二七王：精灵复制范围收回，仅算奖牌型一处使用 
上一次提交把复制方案扩到了建房选项、并把已出牌区列为候选，超出了
实际要求。现纠正：

- 已出牌区维持预置（28 × 3），不改复制，撤销原 T-29 候选项。
- 建房规则选项改回预置 20 个（3 类别标题 + 8 选项 × 2 + 房卡附注），
  选项集固定、数量小，不需要复制；渲染仍由 §1.1 的配置数据驱动。
- 选用判据表改为明确结论：全项目只有「算奖牌型」用复制，其余一律预置。
  精灵段有近 2000 空位，预置的 ID 开销不构成压力，不必给每处都背上
  显式清理负担。

原 T-30 顺延为 T-29。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 08:30:32 +08:00
joywayerandClaude Opus 5 766ef7eae3 二七王：UI 清单补冲关定义，算奖牌型与建房选项改精灵复制 
- 补「冲关」的准确定义（class.arith.js:1277 get_chongguan）：它就是
  design §8.1 常规算奖的服务端命名，不是独立规则。列出 count/wang/cards
  三个返回值的去向与计数规则，并点明两处易错：连对链必须先有 ≥3 王才
  计算；固定主牌 ≥10 张只触发亮牌、不算奖。前端不重算，一律取下发值。

- 算奖牌型叠加层改用 SpriteCopyUtils 精灵复制：cards 张数无小上限
  （四王 + 长连对链 + 八个 7 + 八个 2 可达 20+ 张），预置既可能不够又
  常年空占。编辑器只建 5 个精灵（遮罩 + 3 容器 + 1 模板），省约 19 个 ID，
  关闭 T-24。

- 建房界面按「类别标题（牌局/模式/规则）+ 选项组」重构：
  选项组分单选 / 多选 / 单选（可不选）三型，后者复用复选图；
  每个选项 = 选择框图片 + 文字精灵；选择框资源定为 2x2 四帧
  （单选未选/单选选中/复选未选/复选选中），帧号 =
  (useCheckbox?3:1)+(selected?1:0)；类别标题一张图 3 帧。
  整个界面由「类别→选项组→选项」配置数据驱动渲染，渲染代码不认识
  具体玩法名，roomtype 靠每项自带的 bit 拼串。同样改精灵复制，
  编辑器只建 4 个精灵（原预置方案需 21 个）。

- 新增「预置 vs 精灵复制」的选用判据表，并据此标出下一个候选：
  已出牌区 84 个预置精灵（T-29，需先确认复制精灵满足 z 序与出牌动画）。

- 新增 T-29 / T-30。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 08:23:25 +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