dsh-account-pool 0.2.2 → 0.2.3

package/README.md

@@ -117,13 +117,18 @@ dsh plugin --profile web add dsh-account-pool
 
 全完成显示绿色 `3/3 已完成`，部分完成显示黄色 `2/3`，没做显示灰色 `0/3`。
 
-清单底部还有一行**今日获得积分**：点「全部执行」后，用**执行前后的余额差**
-算出这次实际到手的积分。
+**账号明细**表里还有一列「今日获得」，按账号显示本次到手的积分：
 
-为什么用差值：签到接口只回成功/失败、不回奖励数量，Trae 的任务流也没有
-计费字段——余额差是唯一可靠的真值。只把**正差值**算作获得（负差值可能是
-期间用了额度）；算不出时显示 `—` 而不是编造数字；部分账号缺数据时会注明
-「合计可能偏低」。
+| 情况 | 显示 |
+|---|---|
+| 还没执行过 | `未执行` |
+| 算出收益 | `+150`（有收益时绿色） |
+| 收益为 0 | `+0`——「确实没加」与「不知道」是两回事 |
+| 算不出 | `—`，不编造数字 |
+
+数值来自**执行前后的余额差**：签到接口只回成功/失败、不回奖励数量，
+Trae 的任务流也没有计费字段，余额差是唯一可靠的真值。只把**正差值**
+算作获得（负差值可能是期间用了额度）。
 
 ### 只读与执行分离
 

package/lib/client.js

@@ -617,18 +617,24 @@ window.__ModuleLoader__.load({ id: "dsh-account-pool", factory: (require) => {
 	/**
 	 * 账号明细里的「今日获得」单元格。
 	 *
-	 * 数值来自本次执行的**余额前后差**（后端在 tasks/daily 里算好，
-	 * 挂在每账号结果的 earnedCredits 上）。
+	 * 取值优先级：
+	 *   1. account.earnedCredits —— 后端台账里的**今日累计**，打开页面就有
+	 *   2. lastRun[id].earnedCredits —— 刚执行完的最新值（台账已含它，
+	 *      这里是防状态还没刷新的兜底）
+	 *
+	 * 为什么不是"本次差值"：同一天重复点执行时签到幂等、余额不变，
+	 * 差值会是 0，但今天确实拿到过积分。台账按天累加才是用户要的口径。
 	 *
 	 * 三态刻意区分开：
-	 *   没执行过   → 未执行（灰）
-	 *   算出来了   → +N（绿）；0 也显示 +0，因为「确实没加」与「不知道」不同
-	 *   算不出     → —（灰），不编造
+	 *   有数字   → +N（有收益为绿）；0 也显示 +0，因为「确实没加」与
+	 *              「不知道」不同
+	 *   没数字   → —；从没执行过也走这里（后端台账为空）
 	 */
 	function earnedCell(account, lastRun) {
 		const run = lastRun?.[account.accountId];
-		if (!run) return h("span", { style: { opacity: 0.5 } }, "未执行");
-		const earned = run.earnedCredits;
+		const earned = typeof account.earnedCredits === "number"
+			? account.earnedCredits
+			: run?.earnedCredits;
 		if (typeof earned !== "number") return h("span", { style: { opacity: 0.5 } }, "—");
 		return h("span", {
 			style: { color: earned > 0 ? "var(--dsw-alias-state-success-primary)" : "inherit" },

package/lib/earnings.js

@@ -0,0 +1,146 @@
+/**
+ * 每日积分收益记录器。
+ *
+ * ## 为什么需要它
+ *
+ * 「今日获得」不能直接用「执行前后余额差」表示——那个差值只反映
+ * **本次执行**的变化：
+ *
+ * ```text
+ * 第 1 次点执行  未签到 → 领取 → 余额 +150   显示 +150  ✓
+ * 第 2 次点执行  已签到 → 无变化 → 余额 +0    显示 0     ✗
+ * ```
+ *
+ * 同一天重复点执行（幂等），第二次就开始显示 0，看起来像"没获得积分"，
+ * 但今天确实拿到过 150。用户真正想知道的是**今天累计获得了多少**。
+ *
+ * 所以这里把每次算出的**正收益累加**并按天保存；跨天自动归零，
+ * 不需要清理任务。
+ *
+ * ## 为什么只累加正差值
+ *
+ * 差值为负说明期间有别的消耗（对话），不是"获得了负数积分"。
+ * 只有变多才算收益。另外重复减去同一笔收益不可能发生——每次执行
+ * 的差值本身就是增量。
+ */
+
+import { readFile, writeFile, rename, mkdir } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+
+/** 文件格式版本，字段不兼容时便于识别旧数据。 */
+const FILE_VERSION = 1
+
+/** 把时间戳转成本地日期键（YYYY-MM-DD），与用户看到的"今天"一致。 */
+export function dayKeyOf(timestamp = Date.now()) {
+  const d = new Date(timestamp)
+  const pad = (n) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`
+}
+
+/**
+ * 按天的积分收益台账。
+ *
+ * 结构：`{ version, days: { '2026-09-21': { [accountId]: 150 } } }`
+ * 只保留最近若干天，避免文件无限增长。
+ */
+export class DailyEarningsRecorder {
+  /**
+   * @param {object} options
+   * @param {string} options.file 落盘路径
+   * @param {number} [options.keepDays] 保留多少天（默认 30）
+   */
+  constructor({ file, keepDays = 30 }) {
+    this.file = file
+    this.keepDays = keepDays
+    /** @type {Record<string, Record<string, number>>} */
+    this.days = {}
+    this.loaded = false
+    /** 写操作串行：read→改→write 不是原子的，并发会互相覆盖。 */
+    this.writeQueue = Promise.resolve()
+    /** 待写入标记：多次累加合并成一次写盘。 */
+    this.dirty = false
+  }
+
+  /** 读盘（幂等）。文件不存在或损坏时按空台账处理，不抛错。 */
+  async load() {
+    if (this.loaded) return
+    this.loaded = true
+    try {
+      const doc = JSON.parse(await readFile(this.file, 'utf8'))
+      if (doc?.version === FILE_VERSION && typeof doc.days === 'object' && doc.days !== null) {
+        this.days = doc.days
+      }
+    } catch {
+      // 首次运行或文件损坏：保持空台账
+    }
+  }
+
+  /**
+   * 累加一个账号今天的收益，返回它今天的累计值。
+   *
+   * @param {string} accountId 账号 id
+   * @param {number} delta 本次新增的收益（<=0 时直接返回当前累计，不记负数）
+   * @param {number} [now] 当前时间戳（便于测试）
+   * @returns {Promise<number>} 该账号今日累计收益
+   */
+  async add(accountId, delta, now = Date.now()) {
+    await this.load()
+    const key = dayKeyOf(now)
+    const today = this.days[key] ?? (this.days[key] = {})
+    const current = typeof today[accountId] === 'number' ? today[accountId] : 0
+    if (typeof delta !== 'number' || !Number.isFinite(delta) || delta <= 0) {
+      return current
+    }
+    today[accountId] = Math.round((current + delta) * 100) / 100
+    this.dirty = true
+    await this.flush()
+    return today[accountId]
+  }
+
+  /**
+   * 读某天各账号的累计收益。
+   *
+   * @param {number} [now] 当前时间戳（便于测试）
+   * @returns {Promise<Record<string, number>>}
+   */
+  async today(now = Date.now()) {
+    await this.load()
+    return this.days[dayKeyOf(now)] ?? {}
+  }
+
+  /** 落盘（先串行化，再清理过期天数）。 */
+  async flush() {
+    if (!this.dirty) return
+    this.dirty = false
+    this.prune()
+    const payload = JSON.stringify({ version: FILE_VERSION, days: this.days }, null, 0)
+    this.writeQueue = this.writeQueue.then(async () => {
+      try {
+        await mkdir(dirname(this.file), { recursive: true })
+        // 先写临时文件再改名：避免写一半崩溃留下损坏的 JSON
+        const tmp = `${this.file}.${process.pid}.tmp`
+        await writeFile(tmp, payload, { encoding: 'utf8', mode: 0o600 })
+        await rename(tmp, this.file)
+      } catch {
+        // 落盘失败不影响本次收益的正常返回；下次累加会再试
+      }
+    })
+    await this.writeQueue
+  }
+
+  /** 只保留最近 keepDays 天，防止文件无限增长。 */
+  prune() {
+    const keys = Object.keys(this.days).sort()
+    if (keys.length <= this.keepDays) return
+    for (const key of keys.slice(0, keys.length - this.keepDays)) {
+      delete this.days[key]
+    }
+  }
+}
+
+/** 按区域打开台账（每个区域一份，与凭证/用量文件命名一致）。 */
+export function openDailyEarnings(dshHome, region) {
+  return new DailyEarningsRecorder({
+    file: join(dshHome, `.account-pool.earnings.${region}.json`),
+  })
+}

package/lib/index.js

@@ -35,6 +35,7 @@ import { fetchModels, fetchCredits } from './upstream.js'
 import { AccountPicker } from './selector.js'
 import { createShim } from './shim.js'
 import { UsageRecorder } from './usage.js'
+import { openDailyEarnings } from './earnings.js'
 import { runDailyTasks, fetchStreak, fetchBuddy, fetchLottery, travelStatus as fetchTravelStatus } from './tasks.js'
 import { openTraeStore, accountIdOf as accountIdOfTrae } from './trae-accounts.js'
 import { parseTraeStorage } from './trae-storage.js'
@@ -220,6 +221,9 @@ async function createRegionStack({ region, dshHome, config, logger, ctx }) {
     ],
   })
   await usage.load()
+  // 每日积分收益台账：同一天多次执行要能累计，不能只看本次差值。
+  const earnings = openDailyEarnings(dshHome, region)
+  await earnings.load()
   const picker = new AccountPicker({
     softCooldownMs: (config.softCooldownSeconds ?? 600) * 1000,
     breakerThreshold: config.breakerThreshold ?? 3,
@@ -373,6 +377,7 @@ async function createRegionStack({ region, dshHome, config, logger, ctx }) {
     shim,
     adapter,
     usage,
+    earnings,
     refreshCatalog,
     loadCredits,
     getCatalog: () => catalog,
@@ -981,24 +986,38 @@ export function apply(ctx, config = {}) {
           const after = await stack.loadCredits(true).catch(() => ({}))
 
           /**
-           * 算出每个账号这次获得的积分。
+           * 算出每个账号本次的增量，并**累加进今天的台账**。
            *
-           * 只把**正差值**当作「获得」：
-           *   - 差值为正 → 签到/活动奖励到账
-           *   - 差值为负 → 期间有别的消耗（对话），不算获得，记 0
-           *   - 两边都取不到 → 标 unknown，界面显示 —，不编造数字
+           * 为什么要台账：差值只反映"本次执行"的变化。同一天再点一次
+           * 执行（签到幂等，余额不变）差值就是 0——但今天确实拿到过积分。
+           * 界面要显示的是"今天累计获得多少"，所以按天累加并持久化，
+           * 跨天自动归零（按本地日期分键）。
+           *
+           * 只把**正差值**算作获得：差值为负说明期间有别的消耗（对话），
+           * 不是"获得负数"。
            */
           const earnedOf = (accountId) => {
             const b = before[accountId]?.total
             const a = after[accountId]?.total
             if (typeof b !== 'number' || typeof a !== 'number') return undefined
             const delta = a - b
-            // 负差值可能是「期间用了额度」，不算获得；只取正收益
             return delta > 0 ? Math.round(delta * 100) / 100 : 0
           }
           for (const r of results) {
-            const earned = earnedOf(r.accountId)
-            if (earned !== undefined) r.earnedCredits = earned
+            const delta = earnedOf(r.accountId)
+            if (delta === undefined) continue
+            // add() 返回该账号**今日累计**值；delta<=0 时原样返回已有累计，
+            // 所以重复执行不会把数字冲掉
+            r.earnedCredits = await stack.earnings.add(r.accountId, delta)
+          }
+
+          // 补上今天已经累计、但本次没参与执行（或算不出差值）的账号，
+          // 否则它们的「今日获得」会显示成"未执行"或"—"。
+          const todayEarnings = await stack.earnings.today()
+          for (const r of results) {
+            if (typeof r.earnedCredits === 'number') continue
+            const accumulated = todayEarnings[r.accountId]
+            if (typeof accumulated === 'number') r.earnedCredits = accumulated
           }
 
           const totalEarned = results.reduce(
@@ -1007,8 +1026,6 @@ export function apply(ctx, config = {}) {
             ok: true,
             results,
             totalEarned: Math.round(totalEarned * 100) / 100,
-            // 有账号算不出差值时，界面要对「合计」加注说明，避免误以为是全部
-            earnedPartial: results.some(r => typeof r.earnedCredits !== 'number'),
           })
         } catch (error) {
           json(res, 500, { ok: false, error: safeMessage(error) })
@@ -1031,6 +1048,10 @@ export function apply(ctx, config = {}) {
           const stack = list.find(s => s.region === region)
           if (stack === undefined) { json(res, 503, { ok: false, error: '该区域尚未初始化' }); return }
 
+          // 今日已累计的收益：让「今日获得」在打开页面时就有值，
+          // 不必等到点过执行（台账里存的是按天累计值）。
+          const todayEarnings = await stack.earnings.today()
+
           const out = []
           for (const account of await stack.store.list()) {
             try {
@@ -1048,6 +1069,7 @@ export function apply(ctx, config = {}) {
                   creditsSize: status.creditsSize,
                   ...(status.checkinError === undefined ? {} : { checkinError: status.checkinError }),
                   ...(status.creditsError === undefined ? {} : { creditsError: status.creditsError }),
+                  earnedCredits: todayEarnings[account.id],
                 })
                 continue
               }
@@ -1067,6 +1089,7 @@ export function apply(ctx, config = {}) {
                 buddy,
                 travel: travelNow,
                 lottery,
+                earnedCredits: todayEarnings[account.id],
                 ...(credential.expiresAtMs === undefined ? {} : { expiresAtMs: credential.expiresAtMs }),
               })
             } catch (error) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-account-pool",
   "displayName": "Account Pool",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "把多个 WorkBuddy / Trae 账号汇成账号池接入 DeepSeek Harness：自动切换、限流熔断退避、凭证安全落盘",
   "type": "module",
   "license": "MIT",