Initial import of HEROLL source and design documents

HEROLL_OUTGAME_2.0.1/18-主线进度与星级挑战/01-模块设计文档.md

@@ -0,0 +1,56 @@
+# 18 主线进度与星级挑战：原作模块设计
+
+## 功能定位
+
+管理局外选关、进度奖励和星级挑战；关内战斗只保留衔接配置。
+
+## 功能流程
+
+选择已开放关卡或挑战 → 进行局内玩法 → 更新通关或星级进度 → 领取对应关卡、层数或星数奖励。
+
+以上按原作配置关系整理功能步骤，具体条件与数值见下文及规则说明。
+
+## 子功能构成
+
+| 子功能 | 设计内容 |
+| --- | --- |
+| 关卡入口及模式 | stage/EPlayMode/isEnabled定义关卡目录，标题、场景和Boss字段描述关卡内容；局内衔接字段完整保留。 |
+| 关卡结算奖励 | EPlayMode、stage、loop、diceGauge与isClear共同区分奖励条件，rewardID/rewardCount给出奖励。 |
+| 层数奖励 | Type和Loop定位奖励档，itemID/itemCount记录收益，isSack是独立奖励标记。 |
+| 星级挑战条件参数 | challengeText连接挑战描述，value是条件参数；没有正文时不根据数值猜测挑战语义。 |
+| 星数奖励档 | starCount定位累计星数档，三组rewardID/value保留对应奖励，-1奖励ID作为原始哨兵保存。 |
+
+## 功能构成与规则关系
+
+stageinfo 的 stage/EPlayMode/isEnabled 定义关卡目录；stagerewardinfo 以 stage/loop/isClear 等字段分支发奖；starchallenge 描述挑战值，starchallengereward 按 starCount 配置奖励档。
+
+## 关键规则与数值
+
+| 原作规则 | 数值 | 来源 |
+| --- | --- | --- |
+| 星级挑战开放阶段配置 | Values=2 | E-gameconfig / StringId=starChallengeUnlockStage / CSV记录31 |
+| 星数1对应道具101×50；其他奖励ID=-1保留哨兵值 | starCount=1；rewardID1=101；value1=50；rewardID2=-1；rewardID3=-1 | E-starchallengereward / StringId=0 / CSV记录4 |
+
+## 完整数值表
+
+| 配置表 | 记录数 | 完整数据 |
+| --- | --- | --- |
+| stageinfo | 53 | [CSV](./03-表格/stageinfo.csv) |
+| stagerewardinfo | 159 | [CSV](./03-表格/stagerewardinfo.csv) |
+| loopreward | 30 | [CSV](./03-表格/loopreward.csv) |
+| starchallenge | 3 | [CSV](./03-表格/starchallenge.csv) |
+| starchallengereward | 201 | [CSV](./03-表格/starchallengereward.csv) |
+
+[规则说明](./02-规则说明.md) · [数值说明](./03-数值说明.md) · [字段字典](./03-表格/字段字典.csv) · [数组逐项明细](./03-表格/数组逐项明细.csv)
+
+[返回总纲](../00-局外系统模块总纲.md)
+
+## 相关功能模块
+
+| 模块 | 关联内容 |
+| --- | --- |
+| [账号大厅与功能解锁](../01-账号大厅与功能解锁/01-模块设计文档.md) | 负责大厅入口、新手引导、功能开放和持久化键清理。 |
+| [资源背包与体力](../02-资源背包与体力/01-模块设计文档.md) | 统一道具类型、礼包内容、资源来源以及大厅到局内的资源映射。 |
+| [永久装备与合成](../03-永久装备与合成/01-模块设计文档.md) | 负责局外装备身份、装备位、品质星级、升级消耗和基础属性配置。 |
+| [领地地块与研究](../11-领地地块与研究/01-模块设计文档.md) | 负责局外地块收集配置、地块技能、研究和地块包挂机。 |
+