Initial import of HEROLL source and design documents

2026-10-26 16:05:39 +08:00
commit fdb55672c1
1846 changed files with 290692 additions and 0 deletions
@@ -0,0 +1,27 @@
+screen_id,screen_name,entry,primary_controls,required_states,exit,checkpoint_boundary,acceptance,source_tag
+UI-001,本地开始页,app boot,"开始新局|继续|清除本局|设置","noSave|hasSave|corruptSave","进入棋盘|设置",before new run,无账号 体力 商店 抽卡或联网入口,VALIDATION_ADDED
+UI-002,棋盘HUD,FloorSetup,"40个实际地块|点数|层数|条件式Boss压力|HP|四装备槽|Roll|丹药|暂停","awaitRoll|moving|bossCountdown|bossActing|inputLocked|tileResolving",tile event or pause,after prior atomic resolution,1点严格移动1个实际地块;stage0不显示Boss压力;DiceGauge调试关显示0/2或4..0且演出不可跳过,RUNTIME_OBSERVED
+UI-003,骰子结果,DiceResolve,"dieA|dieB|点数和","rolling|settled",Moving,roll result committed,结果静止可读至少250ms且无重掷入口,RUNTIME_OBSERVED
+UI-004,第三骰选择,ThirdDieChoice,"A|B|C|替换A|替换B|放弃","choiceReady|committing",Moving,choice committed,三种选择明确且放弃不回滚RNG,VALIDATION_ADDED
+UI-005,自动战斗HUD,Battle Fight,"玩家/敌人血条|1-4敌人数|小Boss标识|状态|伤害数字|药水","prepare|spawn|fight|paused|victory|death",PostBattle or revive,battle result committed,1-4骷髅严格生成1-4只怪物;小Boss入口可辨;普通入口无加速按钮且唯一主动输入为药水,RUNTIME_OBSERVED
+UI-006,装备掉落比较,RewardChoice,"新旧装备|属性差|装备|分解|关闭","slotEmpty|upgrade|downgrade|batch",Checkpoint,reward choice committed,关闭自动分解全部未处理装备,RUNTIME_OBSERVED
+UI-007,商店,Merchant event,"3固定槽|3随机槽|余额|刷新|退出","available|soldOut|insufficient|rerolled",Board,each purchase or reroll,恰好6槽且无广告赠点按钮;商品均使用局内点数,SOURCE_CONFIRMED
+UI-008,地块安装,purchased TILE,"棋盘合法格|确认|取消","selecting|invalid|pending",Shop or Board,install committed,只能选择合法普通格且取消保留待安装商品,VALIDATION_ADDED
+UI-009,宝箱,EV-141,"宝箱|装备卡|装备|分解|退出","closed|opened|resolved",Board,event committed,无广告重抽按钮;装备结果只提交一次,RUNTIME_OBSERVED
+UI-010,营火,EV-138,"恢复预览|领取","ready|resolved",Board,event committed,只显示基础治疗且不溢出最大生命,VALIDATION_ADDED
+UI-011,铁匠铺,EV-137,"装备|成功率|直接领取|挑战","noGear|ready|success|destroyed",Board,forge result committed,失败销毁和分解点数同屏可见且无概率增强按钮,RUNTIME_OBSERVED
+UI-012,祝福点,EV-144,"单卡|接受","revealed|accepted",Board,blessing committed,无广告换卡或重抽按钮,SOURCE_CONFIRMED
+UI-013,挖掘,EV-140,"5x5格|剩余次数|形状预览|退出","ready|digging|complete",Board,dig result committed,基础5次;每次按完整形状原子揭示并发奖,VALIDATION_ADDED
+UI-014,传奇装备,EV-139,"传奇装备卡|装备|分解","revealed|resolved",Board,reward committed,品质固定传奇且走标准装备比较,VALIDATION_ADDED
+UI-015,彩票,EV-142,"费用5|抽取|结果|退出","insufficient|ready|rolling|resolved",Board,event committed,概率结果由eventRng确定且刷新不重抽,VALIDATION_ADDED
+UI-016,21点,EV-143,"下注3|手牌|庄家牌|要牌|停牌|结果","insufficient|playerTurn|dealerTurn|win|lose|push",Board,event committed,Ace固定1避免额外规则且庄家17停牌,VALIDATION_ADDED
+UI-017,抓娃娃,EV-151,"20胶囊|摇杆/抓取|次数|结果","ready|aiming|grabbing|complete",Board,event committed,基础次数且无广告补次数;胶囊碰撞和奖励在确定逻辑tick结算,SOURCE_CONFIRMED
+UI-018,黄金马车,EV-152,"4辆遮盖车|选择|奖励","ready|revealed|resolved",Board,event committed,只能选一次且HP阈值快照在进入时锁定,VALIDATION_ADDED
+UI-019,骰子机,EV-164,"三骰|启动|匹配表|奖励","ready|rolling|matched|none",Board,event committed,显示原始三骰并按源码匹配表发奖,SOURCE_CONFIRMED
+UI-020,泡泡龙,EV-166,"棋盘|瞄准线|剩余发数|计时|奖励","ready|aiming|flying|complete",Board,event committed,基础3发且无广告补发;碰撞不依赖渲染帧,SOURCE_CONFIRMED
+UI-021,源码祝福复活,lethal damage with Revive,"祝福图标|恢复结果","resolving|success|stillDead",Battle,revive blessing result committed,只结算一次;失败则直接进入DEFEAT,SOURCE_CONFIRMED
+UI-022,广告复活（不暴露）,disabled,none,notExposed,Fail,none,普通UI与调试台均不可达;无恢复和放弃广告按钮,DEFERRED_NOT_EXPOSED
+UI-023,Boss胜利,boss PostBattle,"胜利|构筑摘要|结束本局","enter|summary|confirmed",Start,result acknowledged,不含倍增广告 付费或剧情,VALIDATION_ADDED
+UI-024,失败结算,no revive,"失败|层数|构筑摘要|结束本局","enter|summary|confirmed",Start,result acknowledged,无促销弹窗且不可在失败页增强,VALIDATION_ADDED
+UI-025,暂停,board or battle,"继续|设置|退出本局","boardPause|battlePause|confirmExit",prior screen or Start,no new checkpoint,暂停冻结逻辑时钟且退出需二次确认,VALIDATION_ADDED
+UI-026,隐藏调试台,7 taps or CtrlShiftD,"seed|floor|DDA|强制事件/掉落/死亡|4x|恢复|导出","closed|open|commandResult|error",prior screen,debug command committed,调试命令走Domain API并标记debug true,VALIDATION_ADDED