bettergi-scripts-list/repo/js/DailyHarvestStats/README.md
Zongye Lyu 13ee4f68b5
fix(js): 每日收获统计 v1.3 — 各指标独立、不连坐(负收获/异常只丢该项,不拖累其余) (#3484)
### 背景(修的什么 bug)
两阶段统计里,摩拉、狗粮是「硬指标」。旧逻辑是**连坐**:只要其中一项在「采集后」出现负收获(例如中间强化圣遗物把狗粮经验吃成负数)或读数超限,就把**整段所有指标**(连正常的摩拉、原石一起)直接丢弃、什么都不记。用户实测发现「只要有一项可能为负,其他都不会被记录」。

### 改动
1. **各指标独立结算,不再连坐**(`computeEnd`)
   - 某硬指标**测量失败/未启用**(起点或终点非数字)→ 只该项不计,静默跳过;
   - 某硬指标**负收获 / 超上限** → 只该项不计,并记入 `dropped`(异常,需提示);
   - 只有**三项都无有效值**时才整段跳过;否则正常写记录,**只写有效项**的字段与累计。
   - 原石(软指标)仍单独处理:负/超限静默不计。

2. **负值/异常「表现出来」的方式**
   - 结算时通知点名:`⚠️ 部分指标异常已单独跳过(狗粮经验=-50),其余指标已正常计入本段。`
   - 报告里那天该项显示「—」(不计入),其余指标数字照常。

3. **报告层适配「某天只有部分指标」**(避免 NaN / 误导)
   - 缺字段的指标显示「—」;日均按「该指标真正测得的天数」算(不被没测那天按 0 稀释);趋势图剔除缺测点;`今天 vs 日均` 仅在今天测到摩拉时才显示;txt/通知不再拼出「+--」。

4. **加固(来自对抗式代码审查)**
   - `NaN` 能绕过硬指标区间守卫(`NaN` 与任何值比较都为 false)→ 改用 `Number.isFinite`,与原石软指标一致地拒绝,杜绝把 `NaN` 写进累计的隐患;
   - 整周/整月一天都没测到摩拉时,旧代码会显示「本周摩拉 0(日均 0)」并把周环比算成 −100% → 改为置 `null`、显示「—」,周环比保持空。

### 兼容性 & 测试
- 数据结构不变,旧存档向后兼容、无需迁移;`saved_files` 不变,升级不丢数据。
- 纯逻辑单元测试 **124/124 通过**(含:负值只丢该项、两项都负才跳过、部分失败不连坐、NaN 防御、无摩拉周不出 −100%、报告层不 NaN/不稀释 等)。
- 另用真实 DOM(jsdom)实跑混合缺项数据:无运行期错误、表格无 undefined/NaN、趋势图正确剔除缺测点。
- 仍需 1920×1080、无影响画面滤镜;无新增设置项。
2026-08-18 17:09:31 +08:00

165 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 每日收获统计
只统计**采集脚本运行期间**的收获(摩拉、可分解狗粮经验、原石):采集**前**读一次起点,采集**后**读一次终点,收获 = 终点 − 起点。中间你手动花费摩拉、强化圣遗物消耗狗粮的部分**天然被排除**。
```
📊 每日收获统计 [账户: default-profile]
⏱ 起算 2026/6/19,已统计 5 个采集日 · 连续采集 5 天
── 摩拉 ──
已累计 2,500,000 / 今天 480,000 / 日均 500,000
── 狗粮经验 ──
已累计 12万 / 今天 3万 / 日均 2.4万
── 原石 ──
已累计 720 / 今天 40 / 日均 40
本周 3,500,000(日均 50万)· 今天较昨天 +12.5%
```
## 一、关键:要在调度组里放**两次**
同一个脚本,在你的采集任务**前后各放一个**,并分别设置「运行阶段」:
```
[每日收获统计 · 采集前(记起点)] ← 记下采集开始时的摩拉/狗粮
↓
[你的锄地/采集任务...]
↓
[每日收获统计 · 采集后(结算)] ← 收获 = 现在 − 起点,记账并报告
```
## 进阶用法:记录你「手动游玩」的真实收获
不只自动采集能用——如果你想统计**自己亲自上线游玩**(开宝箱、做每日委托、探索、手动锄地等)期间真正到手的奖励,同样可以用它:
1. **上线前**:单独把运行阶段设为「采集前」跑一次,记下起点;
2. **尽情游玩**;
3. **下线后**:再把运行阶段设为「采集后」跑一次结算。
这段时间你亲手获得的摩拉 / 狗粮经验就会被如实记录,并入累计与日均——相当于给自己的一次游玩做了一份「收获战报」。
(同理:这期间若有花费 / 强化会冲抵收获,介意的话把结算放在花费操作之前,详见第四节。)
## 二、它为什么这么算
- 只测「采集窗口」内的变化,所以**你手动花的钱、平时强化圣遗物消耗的狗粮,都不会算进收获**。
- **负收获不计**:采集只会让数值增加;若出现终点<起点(疑似读数异常或非采集变动),该段直接跳过、不污染累计。
- **累计** = 各采集日收获之和;**日均** = 累计 ÷ 采集天数。
- **连续采集天数**:从最近一个采集日往前数、服务日相连的天数(断一天就归 1)。**周 / 月汇总**与**今天 vs 昨天 / 本周 vs 上周**环比同步算给你看。
- **原石是「软指标」**:它和摩拉走同一张背包「贵重物品」页,读摩拉时**顺手再读一个数**,零额外成本。但它**只为兜底**——原石读不到 / 读数异常时按 0 计、**绝不影响**摩拉与狗粮的结算。⚠️ 固定锄地路线上宝箱不刷新,原石收获**常年≈0 属正常**;它更适合统计你**手动游玩**(开新宝箱、做委托、探索)那一趟的原石进账(见上一节「进阶用法」)。
- 抗中断:采集若中途停了没结算,次日「采集前」会重新记起点,旧的半截窗口自动作废,不串味。
## 三、设置项
| 项 | 说明 |
|---|---|
| 运行阶段 | 采集前(记起点) / 采集后(结算)——两个实例分别设 |
| 账户标识 | 多账号区分,留空=默认账户 |
| 统计摩拉 / 统计狗粮经验 | 各自可单独开关(两个实例要设成一致) |
| 清空本账户统计 | 设「是」跑一次=重新起算 |
| 发送通知 | 结束时是否推送报告 |
## 四、点位与「消耗」注意事项(重要,决定测得准不准)
本脚本测的是「采集前→采集后」两次读数之差。**任何在这两点之间发生的「消耗」都会让收获被少算或被判异常跳过**。务必注意:
### 1.「采集后(结算)」要放在一切“消耗”操作之前
把结算放在下列任务**之前**,否则收获会在结算前就被花掉/转走:
- **吃掉狗粮经验的**:自动**强化圣遗物**、自动套用「已储存经验」、祝圣狗粮等——经验进了你装备的圣遗物就离开了统计池。
- **花掉摩拉的**:自动**购买**(商店/树脂/狗粮)、**合成**、**升级天赋/武器**、尘歌壶洞天宝钱购买等。
> 正确顺序:`采集前 → 采集任务 → 【每日收获统计·采集后】 → 强化/购买/合成等消耗任务`
> 做不到就**关掉这些自动消耗功能**,或单独跑收获统计。
### 2. 「自动分解」不影响统计
分解只是把狗粮**转换成经验瓶 / 已储存经验**——这两样本脚本都统计(总和 = 可分解狗粮 + 经验瓶 + 已储存经验),价值仍在池子里,分解前后总量不变,**不用管**。**真正让数值减少的是「强化圣遗物」**(把经验喂进你装备的圣遗物,离开统计池),见上一条。
### 3. 「采集前(记起点)」要紧贴你想统计的采集任务
起点之**前**产出的狗粮/摩拉不会被算进。若想把多个产出任务都统计进去,把「采集前」放在它们**全部之前**。
### 4. 统计窗口内别手动操作
「采集前」到「采集后」之间,别手动花钱或强化圣遗物——否则会混进收获差值(净正会被低估,净负会被判异常跳过)。(单纯分解不影响,可不管)
### 5. 锁定的狗粮不计
筛选用「未锁定」,被自动/手动锁定的圣遗物不算狗粮(合理:你要留的不是狗粮)。
## 五、其它注意事项
- 需 **1920×1080、无影响画面的滤镜**;摩拉、原石走背包「贵重物品」页(模板数字识别,同一页一并读出),狗粮走背包圣遗物分解界面(均复用现有脚本的识别逻辑)。
- 「采集前」「采集后」两个实例的「统计摩拉/狗粮」开关、账户标识要**一致**,否则结算项对不上。原石跟随「统计摩拉」开关、无需单独设置。
- 只放了「采集后」没放「采集前」→ 提示「未找到采集起点」并跳过。
- **想看统计**(每次自动刷新,二选一):
- `local/harvest_report.html`:**双击用浏览器打开**,汇总卡片(摩拉 / 狗粮 / 原石 + 连续天数 + 周期汇总)+ 每日趋势图(摩拉 / 狗粮 / 原石 三档切换)+ 可排序、**可翻页**的明细表(还能切换配色主题),最直观(推荐小白用);
- `local/harvest_report.txt`:记事本就能开的纯文本版。
- 运行日志/通知里也会显示。
- `local/harvest_stats.json` 是**程序用的数据**(含 `.bak` 备份 + 回读校验),请**勿手动修改**;`saved_files` 已声明防升级丢失。
## 六、常见问题(FAQ)
**Q:第一次跑只显示「已记录采集起点」,没有收获数字?**
A:正常。采集前只记起点;收获要「采集后」结算才有。第一个完整周期跑完就出数。
**Q:只跑了采集前,报告文件里怎么没有收获?**
A:采集前生成的报告是「空壳」(只有累计历史、没有今天收获)。今天的收获要采集后结算才会出现。
**Q:在哪看统计结果?**
A:打开 `local/harvest_report.html`(浏览器,最直观)或 `local/harvest_report.txt`(记事本);日志/通知里也有。`harvest_stats.json` 是程序数据,别手动改。
**Q:同一天跑了好几次采集,会重复算天数吗?**
A:不会。同一「服务日」(凌晨 04:00 重置线)的多次采集,收获**合并到同一天累加**,采集天数不变、日均分母不变。
**Q:半夜跑、跨天了怎么算?**
A:重置线是 **04:00**。跨午夜但不跨 04:00 = 同一天;跨了 04:00 = 这笔记在「采集后」那天。无论怎样,**累计/日均始终正确**。
**Q:能重复跑「采集前」吗?**
A:能,**以最后一次为准**(覆盖起点),不会弄脏累计。注意「最后一次采集前」要在你想统计的采集**开始之前**。
**Q:今天收获是负数?**
A:统计的是采集窗口净收获。采集只会增加,**负值视为读数异常、不计入**。若常出现负数,多半是「采集后」放在了强化/购买等消耗任务之后,调整点位即可(见第四节)。
**Q:狗粮经验怎么算的?会不会把我的狗粮分解掉?**
A:**只读不动你的东西**。总值 = 已储存经验 + 未分解狗粮折算(按张数 × 单价 1★420 / 2★840 / 3★1260 / 4★2520)+ 经验瓶(小×2500 / 大×10000)。全程不点「执行分解」,狗粮安然无恙。
**Q:不小心点了「重置/清空统计」,能找回吗?**
A:能,但要**尽快**。重置前的上一份数据还在 `local/harvest_stats.bak.json` 里——把它复制为 `harvest_stats.json` 覆盖即可恢复。⚠️ 一旦脚本再次运行写盘,`.bak` 会被刷新,就救不回来了。
**Q:多账号怎么用?**
A:在「账户标识」给每个账号填一个唯一标识,各存各的统计,互不干扰(两个阶段的标识要填一致)。
**Q:更新脚本版本,之前攒的统计数据会丢吗?**
A:不会。升级只更新功能本身,你已经攒下的累计数据(摩拉 / 狗粮 / 原石 / 天数等)会原样保留,可放心更新。
## 后续计划
敬请期待后续版本更新 —— 计划加入**材料 / 采集物收集汇总**等更多统计维度(各类养成材料、特产、当地特产的收集统计),让这份「收获战报」更全面。欢迎反馈你想看到的统计项。
## 更新日志
### 1.3
- 修复「连坐」bug:以前某项(如狗粮)出现负收获/异常时,会把整段所有指标(连正常的摩拉、原石)一起丢弃。现改为**各指标独立**——某项异常只丢该项、单独在通知里点名,其余指标照常记录。
- 报告对「某天只统计到部分指标」的情况更稳:缺的项显示「—」,日均只按该指标真正测得的天数算(不会被没测那天按 0 稀释)。
### 1.2
- 修复原石等后加入指标的日均口径
- 修复周/月汇总数据bug(统一按服务日分桶)
- 趋势图新增时间范围切换(7/30/180/全部),逐日明细取消保留上限;未统计原石的旧天不再被画成 0
- 明细表新增「当天原石」列、数字列居中,修复「—」格子行高异常,明细/趋势图日期改按服务日显示(不再错位、重复或跳号)
- 长期使用累计/天数改用全时计数器,不再受明细窗口影响
- 读数更稳:摩拉/原石连读校验(对不上就重读或放弃),识别框加宽适配千万级数值,减少偶发读错
- 一些内部优化与代码整理,不影响使用。
### 1.1
- 新增**原石**统计(累计 / 今天 / 日均,软指标,与摩拉同页读取、读不到不影响结算)。
- 新增**连续采集天数**、**周 / 月汇总**、**今天 vs 昨天 / 本周 vs 上周**环比。
- 网页报告:每日趋势图加**原石**第三档切换;明细表过长时**自动分页**(每页 12 天)。
- 补充原石 / 连续天数 / 周月汇总 / 环比的纯逻辑单元测试。
### 1.0
- 首次发布:两阶段(采集前/后)统计采集窗口净收获,排除手动花费;负收获不计;跨天累计与日均;多账号;抗中断;含纯逻辑单元测试。