dsh-mobile-plugin 0.5.18 → 0.5.20

package/lib/mobile/stats-ledger.cjs

@@ -3,24 +3,12 @@
 /**
  * 统计账本：按天累计的用量 + 每条会话的累计与身份（`$DSH_HOME/mobile-stats.json`）。
  *
- * 它不寄在会话日志上：用户会清理已归档的会话，删的就是日志本身；统计每次现算的话，清理之后
- * 那部分用量会凭空消失。一旦读到增量就落进这个文件，之后会话在不在都不影响历史数字。
+ * 不寄在会话日志上：用户会清理已归档的会话，一旦读到增量就落进这个文件，之后会话在不在都不影响
+ * 历史数字。口径与桌面 dsh-context 的每日账本一致：一天的账落在「观测到增量」的宿主本地日期上，
+ * 计费 token = 未命中输入 + 缓存读 + 缓存写 + 输出。
  *
- * 口径（与桌面 dsh-context 的每日账本一致，只保留手机用得着的部分）：一天的账落在「观测到
- * 增量」的宿主本地日期上；计费 token = 未命中输入 + 缓存读 + 缓存写 + 输出，四个桶分开存；
- * 每条会话一条记录，范围内有量的都上卡片 —— 卡片条数就是页面那个「会话」数字，所以
- * **不按展示需要裁剪**（裁了那个数字就变成上限值了，不再是真的条数）。
- *
- * 第三张表是模型维度 `models`：按「渠道 + 模型」攒量，服务统计页那块「模型用量」。它账的是
- * 同一个增量 —— 也就是说这里没有「按模型拆过一遍」的原始数据，模型名取自**采集那一刻**这条
- * 会话正在用的那个选择（见 stats-collect.cjs 文件头），会话中途换模型的那一段整体归到换后的
- * 那个名下。这是水位法本来就有的近似，不是这里另加的简化。
- *
- * 金额（`cost`）是**估算**，不落盘：折算时按模型桶的四个 token 桶乘单价（`model-prices.cjs`），
- * 价格变了下次出数就跟着变，账本里不留一份会过期的钱。模型归属的近似照旧继承下来；查不到单价
- * 的那一截 token 由 `unpricedBilled` 明说，不摊进合计。
- *
- * 只做纯数据（读写 + 折算），不碰网络；采集在 stats-collect.cjs，路由在 stats.js。
+ * 每条会话一条记录，范围内有量的都上卡片，**不按展示裁剪**（卡片条数就是页面那个「会话」数字）。
+ * 第三张表 `models` 按「渠道 + 模型」攒量，模型名取自采集那一刻这条会话的选择；金额是估算、不落盘，只做纯数据、不碰网络，采集在 stats-collect.cjs。
  */
 
 const fs = require('node:fs');
@@ -120,12 +108,9 @@ function modelKeyOf(provider, model) {
 /**
  * 模型选择的清洗：provider / model 缺一个才算没有，展示名缺了留空串。
  *
- * 展示名不算有效性判据：目录里那条模型下架了、渠道被卸载了，都只是「名字对不上」，这条用量
- * 该记在哪个渠道哪个模型名下仍然是确定的。以前把「展示名齐不齐」当成归属是否有效的判据，
- * 于是这种记录一重启读盘就变回「没有模型」，下一轮又触发一次老账本回填，同一段累计量在
- * 模型桶里翻倍。
- *
- * 展示名按「非空才覆盖」的规矩用，空串不能把已经记下的名字擦掉。
+ * 展示名不算有效性判据：目录下架、渠道卸载只是「名字对不上」，这条用量记在哪个渠道哪个模型名下
+ * 仍是确定的。别拿「展示名齐不齐」当归属判据 —— 那样记录一重启读盘就变回「没有模型」，下一轮
+ * 又触发老账本回填，同一段累计量在模型桶里翻倍。展示名按「非空才覆盖」用，空串不能擦掉已知名。
  */
 function sanitizeModelSelection(source) {
   if (!source || typeof source !== 'object') return null;
@@ -185,11 +170,25 @@ function addDays(day, delta) {
 /** 范围起点（含）；`all` 返回 null，表示不设下限。 */
 function startDayOf(range, now) {
   const today = dayKeyOf(now);
+  if (range === 'today') return today;
+  if (range === 'yesterday') return addDays(today, -1);
+  if (range === '3d') return addDays(today, -2);
   if (range === '7d') return addDays(today, -6);
   if (range === '30d') return addDays(today, -29);
   return null;
 }
 
+/**
+ * 范围终点（含）：只有「昨天」不看今天。
+ *
+ * 逐日补零、合计、`usageInRange` 都走它。单看昨天却把今天的量算进去，是这一档最容易错的
+ * 地方 —— 用户多半正是用着这台机器的时候打开统计页。
+ */
+function endDayOf(range, now) {
+  const today = dayKeyOf(now);
+  return range === 'yesterday' ? addDays(today, -1) : today;
+}
+
 /**
  * `YYYY-MM-DD` → 那天本地零点的毫秒数。
  *
@@ -516,18 +515,18 @@ function moneyOf(value) {
 }
 
 /**
- * 一条会话在 [startDay, today] 里的用量。
+ * 一条会话在 [startDay, endDay] 里的用量。
  *
  * `startDay` 为 null（`all`）时直接用记录里的累计值 —— 累计值是权威，而它那份按天用量
  * 只保留最近 `MAX_DAILY_DAYS` 天。
  */
-function usageInRange(record, startDay, today) {
+function usageInRange(record, startDay, endDay) {
   const billed = record.billed || emptyUsage();
   if (!startDay) return sanitizeUsage(billed);
   const usage = emptyUsage();
   const daily = record.daily || {};
   for (const [day, value] of Object.entries(daily)) {
-    if (day < startDay || day > today) continue;
+    if (day < startDay || day > endDay) continue;
     for (const key of USAGE_KEYS) usage[key] += num(value[key]);
   }
   return usage;
@@ -544,6 +543,7 @@ function usageInRange(record, startDay, today) {
 function summarize(ledger, range, now) {
   const today = dayKeyOf(now);
   const startDay = startDayOf(range, now);
+  const endDay = endDayOf(range, now);
   const allDays = Object.keys(ledger.days).sort();
   const firstDay = startDay || allDays[0] || today;
 
@@ -559,7 +559,7 @@ function summarize(ledger, range, now) {
       requests: num(source.requests),
       turns: num(source.turns),
     });
-    if (cursor >= today) break;
+    if (cursor >= endDay) break;
   }
 
   const kpi = {
@@ -604,7 +604,7 @@ function summarize(ledger, range, now) {
   let composition = null;
   let compositionSession = null;
   for (const [sessionId, record] of Object.entries(ledger.sessions)) {
-    const usage = usageInRange(record, startDay, today);
+    const usage = usageInRange(record, startDay, endDay);
     if (record.composition && num(record.lastAt) > num(compositionSession && compositionSession.lastAt)) {
       composition = {
         systemTokens: num(record.composition.systemTokens),
@@ -658,7 +658,7 @@ function summarize(ledger, range, now) {
   let costPricedRows = 0;
   for (const bucket of Object.values(ledger.models || {})) {
     if (!bucket || typeof bucket !== 'object') continue;
-    const usage = usageInRange(bucket, startDay, today);
+    const usage = usageInRange(bucket, startDay, endDay);
     const billedTokens = billedOf(usage);
     const turns = num(usage.turns);
     // 与卡片同一条规矩：范围内一个 token、一轮都没有的组合不上卡。

package/lib/mobile/stats.js

@@ -1,21 +1,25 @@
 'use strict';
 
 /**
- * GET /api/mobile/v1/stats/overview?range=7d|30d|all[&fresh=1]（token）
+ * GET /api/mobile/v1/stats/overview?range=today|yesterday|3d|7d|30d|all[&fresh=1]（token）
  *
  * 统计页的唯一接口：先采一轮（水位差记账），再把账本按范围折算成页面要的那份。
  *
  * 采集失败**不**让整页报错：账本里已有的数字照样是真的，宁可让用户看到一份偏旧的统计，
  * 也不要为了「这次没采上」把整页变成错误页。要重新采就用 `fresh=1`（下拉刷新那条）。
  *
- * 范围词只有三档，别的值一律按 `7d`：多一档就要在页面和这里各维护一份日历口径。
+ * 范围词是 App 与这里共用的一份词汇表（`app/src/types/stats.ts` 的 `StatsRange`）：
+ * 「今天 / 昨天」是单天窗口，`3d` / `7d` / `30d` 是含今天往前数的天窗，`all` 不设下限。
+ * 日历口径只有 `stats-ledger.cjs` 的 `startDayOf` / `endDayOf` 一份，App 不自己算。
+ * 认不出来的词一律按 `7d`（老 App 照旧发那三档）；**新范围词遇到老插件就会落到这一条**，
+ * 所以 App 拿回包里的 `range` 与请求的对不对得上当作「插件较旧」的判据（见 A2-60）。
  */
 
 const { sendJson } = require('../http/routing.js');
 const { collectStats, DEFAULT_BUDGET_MS } = require('./stats-collect.cjs');
 const ledger = require('./stats-ledger.cjs');
 
-const RANGES = new Set(['7d', '30d', 'all']);
+const RANGES = new Set(['today', 'yesterday', '3d', '7d', '30d', 'all']);
 
 function normalizeRange(value) {
   return typeof value === 'string' && RANGES.has(value) ? value : '7d';