bettergi-scripts-list/repo/js/DailyHarvestStats
Repository files (latest commit first)
Filename Latest commit message Latest commit date
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
..
assets feat(js): 每日收获统计 v1.1 — 原石/连续天数/周月汇总/环比 + 明细表分页 (#3335) 2026-06-24 15:55:27 +08:00
local feat(js): 新增 每日收获统计 脚本 (#3325) 2026-06-21 10:38:46 +08:00
main.js fix(js): 每日收获统计 v1.3 — 各指标独立、不连坐(负收获/异常只丢该项,不拖累其余) (#3484) 2026-08-18 17:09:31 +08:00
manifest.json fix(js): 每日收获统计 v1.3 — 各指标独立、不连坐(负收获/异常只丢该项,不拖累其余) (#3484) 2026-08-18 17:09:31 +08:00
README.md fix(js): 每日收获统计 v1.3 — 各指标独立、不连坐(负收获/异常只丢该项,不拖累其余) (#3484) 2026-08-18 17:09:31 +08:00
settings.json feat(js): 新增 每日收获统计 脚本 (#3325) 2026-06-21 10:38:46 +08:00

每日收获统计

只统计采集脚本运行期间的收获(摩拉、可分解狗粮经验、原石):采集前读一次起点,采集后读一次终点,收获 = 终点 − 起点。中间你手动花费摩拉、强化圣遗物消耗狗粮的部分天然被排除。

📊 每日收获统计 [账户: 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

  • 首次发布:两阶段(采集前/后)统计采集窗口净收获,排除手动花费;负收获不计;跨天累计与日均;多账号;抗中断;含纯逻辑单元测试。