Initial import of HEROLL source and design documents

HEROLL_OUTGAME_DEV_v1.0/01-账号大厅与功能解锁/设计与规则.md

@@ -0,0 +1,141 @@
+# 账号大厅与功能解锁：原作设计与规则
+
+版本：HEROLL 2.0.1 原作还原文档 v1.0。
+
+## 1. 功能定位
+
+大厅是局外功能的统一入口。玩家通过主线进度和账号开放日序逐步接触不同玩法；引导负责把玩家带到指定界面，并在目标阶段提供奖励。入口是否开放、入口排序和引导是否完成是不同状态。
+
+## 2. 主要状态
+
+下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。
+
+| 状态 | 用途 |
+| --- | --- |
+| 已通关阶段 | 用于检查功能进度条件 |
+| 账号开放日序 | 用于按日开放的内容 |
+| 功能开放键 | 记录内容入口资格 |
+| 引导步骤 | 区分当前步骤与已完成步骤 |
+
+## 3. 功能规则
+
+### 3.1 功能开放
+
+模式选择、巡逻、每日副本、讨伐等分别读取自己的开放条件，不能以“某个局外功能已开放”替代所有模块的判断。阶段值保留原索引，不擅自全部加1。
+
+### 3.2 新手引导
+
+引导步骤可以清理已有界面、等待前后动画、设置遮罩以及指定触摸推进方式。进入目标界面与领取引导奖励分开描述；奖励读取该条引导的道具ID和数量。
+
+### 3.3 入口显示
+
+模式展示顺序由入口排序表决定。社区入口按语言使用对应配置；通知标题正文与玩法奖励无关，不能当成邮件奖励内容。
+
+## 4. 操作流程
+
+以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。
+
+1. 选择要展示的功能入口，读取其开放条件。
+2. 结合账号进度显示入口及当前引导目标。
+3. 进入目标界面后交给相应模块处理操作。
+4. 引导完成状态和模式开放状态分别更新；具体完成事件以引导配置为准。
+
+## 5. 关键数值与计算
+
+| 项目 | 数值 | 状态 |
+| --- | --- | --- |
+| 模式选择解锁门槛配置 | Values=1 | 原作配置确认 |
+| 离线保存阻止开关原值；不等同已确认运行行为 | Values=1 | 原作配置确认 |
+| 坐骑开放日序配置；首日索引未闭合 | Values=6 | 原作配置确认 |
+
+### 引导目标与奖励（全表）
+
+| ID | 名称/键 | clearStage | 奖励ID（按奖励类型解析） | 奖励数量 |
+| --- | --- | --- | --- | --- |
+| 0 | 勇士星星 | 2 | 101 | 5 |
+| 1 | 每日商店 | -1 | 101 | 5 |
+| 2 | 抽取商店 | -1 | 101 | 5 |
+| 3 | 竞技场 | 3 | 101 | 5 |
+
+## 6. 原作中文内容
+
+中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。
+
+| 来源表 | ID | 名称 | 效果/条件文本 |
+| --- | --- | --- | --- |
+| newbieguide | 0 | 勇士星星 |  |
+| newbieguide | 1 | 每日商店 |  |
+| newbieguide | 2 | 抽取商店 |  |
+| newbieguide | 3 | 竞技场 |  |
+| localpush | 0 | 自动狩猎奖励累积100%！ |  |
+| localpush | 1 | 🎲能量补充完成🎲 |  |
+| localpush | 2 | ⚪文物弹珠台补充完成⚪ |  |
+| localpush | 3 | 勇士成长了许多！ |  |
+| localpush | 4 | 奖励正在等着你来拿！ |  |
+| localpush | 5 | 村庄发布灾难警报🚨 |  |
+| communitydata | 100 | Reddit |  |
+| communitydata | 101 | Discord |  |
+| communitydata | 102 | LINE |  |
+| communitydata | 103 | (官方)X |  |
+| communitydata | 104 | Facebook |  |
+| communitydata | 105 | 社群聊天室 |  |
+| communitydata | 106 | Instagram |  |
+
+## 7. 开发权威表
+
+| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
+| --- | --- | --- | --- |
+| 新手引导步骤 | [tutorial.csv](./tutorial.csv) | 149 | [中文目录](./tutorial-中文目录.csv) |
+| 引导目标与奖励 | [newbieguide.csv](./newbieguide.csv) | 4 | [中文目录](./newbieguide-中文目录.csv) |
+| 模式入口排序 | [modesortingorder.csv](./modesortingorder.csv) | 6 | [中文目录](./modesortingorder-中文目录.csv) |
+| 通知内容 | [localpush.csv](./localpush.csv) | 6 | [中文目录](./localpush-中文目录.csv) |
+| 社区入口 | [communitydata.csv](./communitydata.csv) | 7 | [中文目录](./communitydata-中文目录.csv) |
+| 持久标记清理排期 | [permanentkeyremoveschedule.csv](./permanentkeyremoveschedule.csv) | 1 | [中文目录](./permanentkeyremoveschedule-中文目录.csv) |
+
+[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
+
+全局键按模块名称关联收录；其具体含义优先以正文已确认的规则为准。
+
+| 配置键 | 原值 |
+| --- | --- |
+| relicContentsUnlockStage | 0,7 |
+| starChallengeUnlockStage | 2 |
+| specialShopTabUnlockStage | 1 |
+| enhancedGachaUnlockStage | 2 |
+| modeSelectUnlockStage | 1 |
+| potionBattleUnlockStage | 3 |
+| IsOfflineSaveBlock | 1 |
+| potionBattleBlock | 0 |
+| IsSaveFailKick | 1 |
+| afkPatrolUnlockStage | 1 |
+| infinityUnlockStage | 4 |
+| infinityBlock | 0 |
+| destinyUnlockStages | 5,5,5,7, 7 |
+| dayOfWeekDungeonUnlockStage | 4 |
+| dayOfWeekDungeonBlock | 0 |
+| saveHoldTime | 50 |
+| CollectionUnlockStage | 6 |
+| seasonEventBlock | 0 |
+| raidUnlockStage | 5 |
+| raidBlock | 0 |
+| outgameTileUnlockStage | 3 |
+| autoUnlockStage | 1 |
+| idleDungeonUnlockStage | 1 |
+| idleDungeonBlock | 0 |
+| mountUnlockDay | 6 |
+
+## 8. 开发验收与禁止误写
+
+| 输入 | 检查内容 | 预期 |
+| --- | --- | --- |
+| 读取gameconfig中StringId=modeSelectUnlockStage | 查询本条配置并核对界面/配置输出 | Values=1 |
+| 读取gameconfig中StringId=IsOfflineSaveBlock | 查询本条配置并核对界面/配置输出 | Values=1 |
+| 读取gameconfig中StringId=mountUnlockDay | 查询本条配置并核对界面/配置输出 | Values=6 |
+
+验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。
+
+## 9. 当前待补充边界
+
+账号阶段索引、按日开放的首日编号以及引导结束事件尚需进一步核对；不在本版填写通用默认条件。
+
+[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)