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,92 @@
+# 签到新人与回归：原作设计与规则
+
+版本：HEROLL 2.0.1 原作还原文档 v1.0。
+
+## 1. 功能定位
+
+签到、新人和回归是三类不同福利。签到按日序提供奖励，新人和回归提供有限时长或次数的增益。签到漏天补领也由专门字段配置。
+
+## 2. 主要状态
+
+下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。
+
+| 状态 | 用途 |
+| --- | --- |
+| 签到类型与日序 | 定位奖励 |
+| 签到领取记录 | 区分各日奖励 |
+| 新人加成剩余时间次数 | 区分两种限制 |
+| 回归资格及增益 | 单独记录 |
+
+## 3. 功能规则
+
+### 3.1 签到
+
+签到类型和日序共同决定奖励。补签方式及价格独立记录，不等于错过的天数可以一律免费补领。
+
+### 3.2 新人
+
+新人增益4320分钟，即3天；额外加速50、奖励加成20。加速次数字段为-1、奖励次数1；-1原值保留，不自行解释为无限。
+
+### 3.3 回归
+
+距上次登录20160分钟，即14天，是回归门槛配置；增益持续4320分钟，即3天，奖励加成100，奖励与加速均配置3次，并关联回归任务。
+
+## 4. 操作流程
+
+以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。
+
+1. 判断是签到、新人还是回归入口，分别读取其配置。
+2. 签到按类型和日序显示奖励与补签方式。
+3. 新人和回归同时显示持续时间与剩余次数。
+4. 回归任务交由任务模块读取，不与普通签到进度合并。
+
+## 5. 关键数值与计算
+
+| 项目 | 数值 | 状态 |
+| --- | --- | --- |
+| 回归：离线20160分钟（14天），buff4320分钟（3天），加成和次数另列 | comebackTime=20160；buffTime=4320；rewardBuffPercent=100；rewardBuffCount=3；playSpeedBuffCount=3 | 原作配置确认 |
+| 新人：buff4320分钟，加速50、奖励20；次数-1的哨兵语义未闭合 | buffTime=4320；additionalSpeed=50；rewardBuffPercent=20；playSpeedBuffCount=-1；rewardBuffCount=1 | 原作配置确认 |
+
+### 回归资格与福利（全表）
+
+| ID | 名称/键 | 回归离线门槛（分钟） | 加成持续分钟（以注释为准） | 额外奖励百分数 | 奖励加成次数 | 加速次数 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 100 | DefaultConfig | 20160 | 4320 | 100 | 3 | 3 |
+
+### 新人加速与奖励（全表）
+
+| ID | 名称/键 | 加成持续分钟（以注释为准） | additionalSpeed | 额外奖励百分数 | 加速次数 | 奖励加成次数 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 100 | DefaultConfig | 4320 | 50 | 20 | -1 | 1 |
+
+## 6. 原作中文内容
+
+中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。
+
+本模块主要由数值和键值组成，原作文本对照见同目录CSV。
+
+## 7. 开发权威表
+
+| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
+| --- | --- | --- | --- |
+| 逐日签到与补签 | [attendance.csv](./attendance.csv) | 42 | [中文目录](./attendance-中文目录.csv) |
+| 签到排期 | [attendanceconfig.csv](./attendanceconfig.csv) | 2 | [中文目录](./attendanceconfig-中文目录.csv) |
+| 回归资格与福利 | [comebackconfig.csv](./comebackconfig.csv) | 1 | [中文目录](./comebackconfig-中文目录.csv) |
+| 新人加速与奖励 | [newbiebuffconfig.csv](./newbiebuffconfig.csv) | 1 | [中文目录](./newbiebuffconfig-中文目录.csv) |
+
+[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
+
+## 8. 开发验收与禁止误写
+
+| 输入 | 检查内容 | 预期 |
+| --- | --- | --- |
+| 读取comebackconfig中StringId=DefaultConfig | 查询本条配置并核对界面/配置输出 | comebackTime=20160；buffTime=4320；rewardBuffPercent=100；rewardBuffCount=3；playSpeedBuffCount=3 |
+| 读取newbiebuffconfig中StringId=DefaultConfig | 查询本条配置并核对界面/配置输出 | buffTime=4320；additionalSpeed=50；rewardBuffPercent=20；playSpeedBuffCount=-1；rewardBuffCount=1 |
+
+验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。
+
+## 9. 当前待补充边界
+
+日切边界、漏签可补日期以及-1次数字段的运行含义尚待确认。
+
+[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)