@xixka/dsh-hub 0.4.11 → 0.4.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/README.md +11 -0
  2. package/icon.svg +5 -0
  3. package/lib/aggregate-adapter.d.ts.map +1 -1
  4. package/lib/aggregate-adapter.js +11 -0
  5. package/lib/aggregate-adapter.js.map +1 -1
  6. package/lib/astudio-adapter.d.ts.map +1 -1
  7. package/lib/astudio-adapter.js +7 -1
  8. package/lib/astudio-adapter.js.map +1 -1
  9. package/lib/astudio.d.ts +28 -0
  10. package/lib/astudio.d.ts.map +1 -1
  11. package/lib/astudio.js +42 -2
  12. package/lib/astudio.js.map +1 -1
  13. package/lib/atomcode-auth.js +3 -3
  14. package/lib/atomcode-auth.js.map +1 -1
  15. package/lib/atomcode-credits.js +3 -3
  16. package/lib/atomcode-credits.js.map +1 -1
  17. package/lib/atomcode-product.d.ts +8 -0
  18. package/lib/atomcode-product.d.ts.map +1 -1
  19. package/lib/atomcode-product.js +10 -0
  20. package/lib/atomcode-product.js.map +1 -1
  21. package/lib/auto-adapter.d.ts +0 -8
  22. package/lib/auto-adapter.d.ts.map +1 -1
  23. package/lib/auto-adapter.js +17 -8
  24. package/lib/auto-adapter.js.map +1 -1
  25. package/lib/buddy-adapter.d.ts.map +1 -1
  26. package/lib/buddy-adapter.js +5 -5
  27. package/lib/buddy-adapter.js.map +1 -1
  28. package/lib/buddy-balance-rank.d.ts +121 -15
  29. package/lib/buddy-balance-rank.d.ts.map +1 -1
  30. package/lib/buddy-balance-rank.js +267 -20
  31. package/lib/buddy-balance-rank.js.map +1 -1
  32. package/lib/buddy-balance-selector.d.ts +20 -0
  33. package/lib/buddy-balance-selector.d.ts.map +1 -1
  34. package/lib/buddy-balance-selector.js +23 -2
  35. package/lib/buddy-balance-selector.js.map +1 -1
  36. package/lib/cache-token-count.d.ts +21 -0
  37. package/lib/cache-token-count.d.ts.map +1 -0
  38. package/lib/cache-token-count.js +23 -0
  39. package/lib/cache-token-count.js.map +1 -0
  40. package/lib/chromium-session.d.ts +125 -51
  41. package/lib/chromium-session.d.ts.map +1 -1
  42. package/lib/chromium-session.js +402 -162
  43. package/lib/chromium-session.js.map +1 -1
  44. package/lib/client/jet-hub.js +722 -58
  45. package/lib/doubao-login.d.ts +0 -20
  46. package/lib/doubao-login.d.ts.map +1 -1
  47. package/lib/doubao-login.js +53 -17
  48. package/lib/doubao-login.js.map +1 -1
  49. package/lib/doubao-signin.d.ts +0 -32
  50. package/lib/doubao-signin.d.ts.map +1 -1
  51. package/lib/doubao-signin.js +21 -35
  52. package/lib/doubao-signin.js.map +1 -1
  53. package/lib/gemini-messages.d.ts.map +1 -1
  54. package/lib/gemini-messages.js +4 -3
  55. package/lib/gemini-messages.js.map +1 -1
  56. package/lib/index.d.ts.map +1 -1
  57. package/lib/index.js +9 -2
  58. package/lib/index.js.map +1 -1
  59. package/lib/jet-hub-rpc.js +115 -4
  60. package/lib/jet-hub-rpc.js.map +1 -1
  61. package/lib/llm-adapter.d.ts.map +1 -1
  62. package/lib/llm-adapter.js +12 -5
  63. package/lib/llm-adapter.js.map +1 -1
  64. package/lib/llm-register-compat.d.ts.map +1 -1
  65. package/lib/llm-register-compat.js +6 -1
  66. package/lib/llm-register-compat.js.map +1 -1
  67. package/lib/lobsterai-adapter.d.ts.map +1 -1
  68. package/lib/lobsterai-adapter.js +5 -5
  69. package/lib/lobsterai-adapter.js.map +1 -1
  70. package/lib/login.d.ts +7 -20
  71. package/lib/login.d.ts.map +1 -1
  72. package/lib/login.js +7 -21
  73. package/lib/login.js.map +1 -1
  74. package/lib/loomy-adapter.d.ts.map +1 -1
  75. package/lib/loomy-adapter.js +23 -7
  76. package/lib/loomy-adapter.js.map +1 -1
  77. package/lib/minimax-messages.d.ts.map +1 -1
  78. package/lib/minimax-messages.js +2 -1
  79. package/lib/minimax-messages.js.map +1 -1
  80. package/lib/model-promotions.d.ts +122 -0
  81. package/lib/model-promotions.d.ts.map +1 -1
  82. package/lib/model-promotions.js +260 -0
  83. package/lib/model-promotions.js.map +1 -1
  84. package/lib/models.d.ts +14 -0
  85. package/lib/models.d.ts.map +1 -1
  86. package/lib/models.js +105 -4
  87. package/lib/models.js.map +1 -1
  88. package/lib/officeace-lock.d.ts +32 -2
  89. package/lib/officeace-lock.d.ts.map +1 -1
  90. package/lib/officeace-lock.js +53 -7
  91. package/lib/officeace-lock.js.map +1 -1
  92. package/lib/openai-compat.d.ts +32 -0
  93. package/lib/openai-compat.d.ts.map +1 -1
  94. package/lib/openai-compat.js +17 -5
  95. package/lib/openai-compat.js.map +1 -1
  96. package/lib/openai-gateway/responses.d.ts.map +1 -1
  97. package/lib/openai-gateway/responses.js +2 -1
  98. package/lib/openai-gateway/responses.js.map +1 -1
  99. package/lib/openai-gateway/stream.d.ts.map +1 -1
  100. package/lib/openai-gateway/stream.js +15 -5
  101. package/lib/openai-gateway/stream.js.map +1 -1
  102. package/lib/openai-gateway/usage.d.ts +1 -2
  103. package/lib/openai-gateway/usage.d.ts.map +1 -1
  104. package/lib/openai-gateway/usage.js +4 -3
  105. package/lib/openai-gateway/usage.js.map +1 -1
  106. package/lib/qoder-catalog.d.ts.map +1 -1
  107. package/lib/qoder-catalog.js +74 -5
  108. package/lib/qoder-catalog.js.map +1 -1
  109. package/lib/qoder-product.d.ts +15 -0
  110. package/lib/qoder-product.d.ts.map +1 -1
  111. package/lib/qoder-product.js.map +1 -1
  112. package/lib/raccoon-account-queue.d.ts +15 -0
  113. package/lib/raccoon-account-queue.d.ts.map +1 -0
  114. package/lib/raccoon-account-queue.js +59 -0
  115. package/lib/raccoon-account-queue.js.map +1 -0
  116. package/lib/raccoon-adapter.d.ts +60 -9
  117. package/lib/raccoon-adapter.d.ts.map +1 -1
  118. package/lib/raccoon-adapter.js +297 -190
  119. package/lib/raccoon-adapter.js.map +1 -1
  120. package/lib/raccoon-auth.d.ts +11 -0
  121. package/lib/raccoon-auth.d.ts.map +1 -1
  122. package/lib/raccoon-auth.js +96 -4
  123. package/lib/raccoon-auth.js.map +1 -1
  124. package/lib/raccoon-login-page.d.ts.map +1 -1
  125. package/lib/raccoon-login-page.js +11 -1
  126. package/lib/raccoon-login-page.js.map +1 -1
  127. package/lib/token-ledger.d.ts +1 -1
  128. package/lib/token-ledger.d.ts.map +1 -1
  129. package/lib/token-ledger.js +21 -4
  130. package/lib/token-ledger.js.map +1 -1
  131. package/lib/trae.d.ts.map +1 -1
  132. package/lib/trae.js +3 -2
  133. package/lib/trae.js.map +1 -1
  134. package/lib/types.d.ts +65 -0
  135. package/lib/types.d.ts.map +1 -1
  136. package/lib/types.js.map +1 -1
  137. package/lib/usage-badge.d.ts +8 -0
  138. package/lib/usage-badge.d.ts.map +1 -1
  139. package/lib/usage-badge.js +20 -0
  140. package/lib/usage-badge.js.map +1 -1
  141. package/lib/zcode-anthropic.d.ts.map +1 -1
  142. package/lib/zcode-anthropic.js +2 -1
  143. package/lib/zcode-anthropic.js.map +1 -1
  144. package/package.json +5 -2
@@ -34,12 +34,18 @@
34
34
  *
35
35
  * | 档位 | 判据 | 含义 |
36
36
  * |---|---|---|
37
- * | 1 | `expiring > 0` | 有 **15 天内到期**的积分 —— 再不用就作废,优先消耗 |
38
- * | 2 | `permanent > 0` | 只剩「永久」积分(≥ 15 天后才到期) |
39
- * | 3 | 其余(含**查询失败**) | 无可用余额 |
37
+ * | 1 | `imminent > 0` | 有 **5 天内到期**的积分(临期)—— 再不用立刻作废,最优先 |
38
+ * | 2 | `expiring > 0` | 只剩 **5~15 天内到期**的积分(短期) |
39
+ * | 3 | `permanent > 0` | 只剩「永久」积分(≥ 15 天后才到期) |
40
+ * | 4 | 其余(含**查询失败**) | 无可用余额 |
41
+ *
42
+ * ⚠️ 三档判据是**嵌套**的:`临期 ⊂ 15 天内`,故 `expiring` 桶同时包含临期与短期,
43
+ * `imminent` 是它的子量。这样「锁定永久积分」的可用性判据(`expiring > 0`)不变。
40
44
  *
41
45
  * ⚠️ **档内保持传入顺序**(= 用户在 Jet Hub 拖拽的手动顺序),**不重排** ——
42
- * 与 `AccountPool.getAvailableAccount` 的既有语义一致。
46
+ * 与 `AccountPool.getAvailableAccount` 的既有语义一致。**临期档内同样如此**:
47
+ * 两笔都临期时,顺序完全由帐号顺序决定,不按"谁更急"二次排序
48
+ *(用户 2026-11-17 明确要求「原来是什么策略就使用什么策略」)。
43
49
  *
44
50
  * ⚠️ **查询失败归入最后一档**:宁可把请求发给能确认余额的号(与 Loomy 同规)。
45
51
  *
@@ -57,6 +63,38 @@ import { type CreditBalance } from './credits.js';
57
63
  export declare const BUDDY_EXPIRING_WINDOW_DAYS = 15;
58
64
  /** 由天数换算的毫秒窗口(导出供单测按同一口径构造时间戳)。 */
59
65
  export declare const BUDDY_EXPIRING_WINDOW_MS: number;
66
+ /**
67
+ * 「临期积分」的时间窗口:距扣费截止不足 **5 天**的积分算临期(最优先烧掉)。
68
+ * 用户 2026-11-17 定的判据。
69
+ *
70
+ * ## 它与 15 天那条是**嵌套**关系,不是并列
71
+ *
72
+ * ```
73
+ * 临期(< 5 天) ⊂ 短期(5 ~ 15 天) ⊂ 原「临时」(< 15 天)
74
+ * ```
75
+ *
76
+ * 引入它的原因(用户 2026-11-17 需求):原先**只有一条线**,于是「14 天后到期」
77
+ * 与「3 天后到期」都算同一档 `expiring` ⇒ 排序时**全靠帐号顺序**决定先烧谁
78
+ * ⇒ 一个还有 14 天的号会长期霸占轮换,而 3 天后作废的积分**一分没用上**。
79
+ *
80
+ * ## ⚠️ 它是 `expiring` 的**子量**,不是第 4 个平级桶
81
+ *
82
+ * `expiring` 的语义(15 天内)**逐字节不变** —— 这是刻意的,因为
83
+ * `split.expiring > 0` 是「锁定永久积分」的可用性判据
84
+ *(`src/officeace-lock.ts:255`、`plugin-src/client/usage-badge.js` 的 `expiringOf()`),
85
+ * 改它的含义会让锁定态把一个「只有 3 天积分」的可用号误判成不可用。
86
+ * 与 `permanent` 承载 `unknownExpiry` 子量是同一手法(见 `src/credits.ts:289-310`)。
87
+ */
88
+ export declare const BUDDY_IMMINENT_WINDOW_DAYS = 5;
89
+ /** 由天数换算的毫秒窗口(导出供单测按同一口径构造时间戳)。 */
90
+ export declare const BUDDY_IMMINENT_WINDOW_MS: number;
91
+ /**
92
+ * 覆盖「临期」窗口的环境变量名。
93
+ *
94
+ * ⚠️ 与 15 天那条同理:不同渠道的发卡节奏差别极大,5 天对某家合适、对另一家过紧。
95
+ * 设成 `0` 可**关掉临期档**(退化成原来的两档)。
96
+ */
97
+ export declare const DSH_BUDDY_IMMINENT_WINDOW_DAYS = "DSH_BUDDY_IMMINENT_WINDOW_DAYS";
60
98
  /**
61
99
  * 覆盖窗口的环境变量名。
62
100
  *
@@ -89,20 +127,70 @@ export declare const DSH_BUDDY_EXPIRING_WINDOW_DAYS = "DSH_BUDDY_EXPIRING_WINDOW
89
127
  export declare function buddyExpiringWindowDays(env?: NodeJS.ProcessEnv): number;
90
128
  /** 当前生效的窗口(毫秒)。 */
91
129
  export declare function buddyExpiringWindowMs(env?: NodeJS.ProcessEnv): number;
130
+ /**
131
+ * 当前生效的「临期」窗口(天)。
132
+ *
133
+ * ⚠️ **解析纪律与 {@link buddyExpiringWindowDays} 逐条相同**:`0` 是**合法值**
134
+ * (表示「关掉临期档,退化成两档」),故**绝不能**写 `Number(raw) || 默认值` ——
135
+ * 那会把 `0` 静默换成 5。非法值(空 / 非数字 / 负数)回落到默认。
136
+ */
137
+ export declare function buddyImminentWindowDays(env?: NodeJS.ProcessEnv): number;
138
+ /** 当前生效的临期窗口(毫秒)。 */
139
+ export declare function buddyImminentWindowMs(env?: NodeJS.ProcessEnv): number;
140
+ /**
141
+ * 生效的临期窗口(毫秒)—— **全仓唯一的钳制点**。
142
+ *
143
+ * ## 为什么要钳制
144
+ *
145
+ * 两个窗口是**嵌套**的(临期 ⊂ 15 天)。用户可分别用两个环境变量调它们,
146
+ * 于是出现「临期窗口比总窗口还大」时,分档表就自相矛盾了:
147
+ *
148
+ * | `DSH_BUDDY_EXPIRING_WINDOW_DAYS` | `DSH_BUDDY_IMMINENT_WINDOW_DAYS` | 不钳制的后果 |
149
+ * |---|---|---|
150
+ * | 15 | 20 | 「短期」档的判据 `5~15 天` 变成空区间 ⇒ 该档永远为 0(看着像缺陷) |
151
+ * | 3 | 5 | 「临期」判据 `>3 天 且 <5 天` 两处比较打架 ⇒ 必须钳到 3 |
152
+ *
153
+ * 钳制后语义始终自洽:**临期 ⊂ 总窗口**,最坏情况是「短期档消失」,
154
+ * 而那是用户显式把两个窗口调到相等/倒挂的**直接推论**,不是缺陷。
155
+ *
156
+ * ⚠️ 只在**这一处**钳制。调用方拿到的值已经是合法的 —— 别在别处再
157
+ * `Math.min` 一次,那会让「同一语义两套判据」重新出现(本仓首条红线)。
158
+ *
159
+ * @param windowMs - 总窗口(15 天,已按 env 解析)。
160
+ * @param imminentMs - 临期窗口候选值;省略时读环境变量。
161
+ * @returns 恒 `>= 0` 且 `<= windowMs`。
162
+ */
163
+ export declare function resolveImminentWindowMs(windowMs: number, imminentMs?: number): number;
92
164
  /** 账号余额档位。数字越小越优先。 */
93
165
  export declare const BUDDY_BALANCE_TIER: Readonly<{
94
- /** 有 15 天内到期的积分 —— 优先消耗(再不用就作废)。 */
95
- readonly expiring: 0;
96
- /** 只剩永久积分(≥ 15 天后到期)。 */
97
- readonly permanent: 1;
98
- /** 无余额 / 查询失败。 */
99
- readonly none: 2;
166
+ /** 有 5 天内到期的积分(临期)—— 最优先消耗,否则直接作废。 */
167
+ readonly imminent: 0;
168
+ /** 只剩 5~15 天内到期的积分(短期)—— 次优先。 */
169
+ readonly expiring: 1;
170
+ /** 只剩永久积分(≥ 15 天后到期,或到期时间未知)—— 最后才用。 */
171
+ readonly permanent: 2;
172
+ /** 无余额 / 查询失败 / 锁定态下只剩永久积分。 */
173
+ readonly none: 3;
100
174
  }>;
101
175
  export type BuddyBalanceTier = (typeof BUDDY_BALANCE_TIER)[keyof typeof BUDDY_BALANCE_TIER];
102
- /** 两类余额的拆分结果。 */
176
+ /** 三类余额的拆分结果。 */
103
177
  export interface BuddyCreditSplit {
104
- /** 15 天内到期、**且尚未作废**的积分合计(本计费周期口径)。 */
178
+ /**
179
+ * 15 天内到期、**且尚未作废**的积分合计(本计费周期口径)。
180
+ *
181
+ * ⚠️⚠️ **语义与引入「临期」档之前逐字节相同**(= 临期 + 短期)。
182
+ * 它是「锁定永久积分」的可用性判据(`split.expiring > 0` ⇒ 该号可烧),
183
+ * 故**绝不能**把它改成「只有 5~15 天」—— 那会让一个只剩 3 天积分的可用号
184
+ * 在锁定态被判成不可用。临期额度请读 {@link imminent}。
185
+ */
105
186
  expiring: number;
187
+ /**
188
+ * {@link expiring} 的**子量**:其中 5 天内到期的部分(临期,最优先烧掉)。
189
+ *
190
+ * 不变量 `0 <= imminent <= expiring`;只在 `> 0` 时出现在返回值里
191
+ *(与 {@link expired} 同款约定,避免给每个调用方加一个恒 0 的键)。
192
+ */
193
+ imminent?: number;
106
194
  /** 其余积分合计(≥ 15 天后到期,或到期时间未知)。 */
107
195
  permanent: number;
108
196
  /**
@@ -128,6 +216,15 @@ export interface BuddyAccountBalance {
128
216
  id: string;
129
217
  /** 15 天内到期的积分;`undefined` = 查询失败。 */
130
218
  expiringBalance?: number;
219
+ /**
220
+ * 其中 5 天内到期的部分({@link expiringBalance} 的子量);`undefined` = 查询失败。
221
+ *
222
+ * ⚠️ 可选且**不校验**它是否真的 `<= expiringBalance` —— 分桶层
223
+ *({@link splitBuddyCreditsByExpiry})天然保证 `imminent += remaining` 与
224
+ * `expiring += remaining` 在同一分支里同时发生。外部手工构造的对象若倒挂,
225
+ * 最坏后果只是档位判「临期」而金额偏小,不会误烧长期积分。
226
+ */
227
+ imminentBalance?: number;
131
228
  /** 永久积分;`undefined` = 查询失败。 */
132
229
  permanentBalance?: number;
133
230
  }
@@ -149,9 +246,13 @@ export interface BuddyAccountBalance {
149
246
  * @param balance - `fetchCreditBalance` 的结果;`null`(查询失败)返回 `undefined`。
150
247
  * @param now - 当前时刻(毫秒),注入以便单测断言边界。
151
248
  * @param windowMs - 窗口,默认 {@link BUDDY_EXPIRING_WINDOW_MS}。
152
- * @returns 两桶合计;`balance` 为 null/undefined 时返回 `undefined`(= 查询失败)。
249
+ * @param imminentMs - 「临期」子窗口,默认 {@link BUDDY_IMMINENT_WINDOW_MS}。
250
+ * ⚠️ 由调用方经 {@link resolveImminentWindowMs} 归一(保证 ≤ `windowMs`)
251
+ * —— 这里给默认值只为既有调用点(含大量用例)不必改动。
252
+ * @returns 三桶合计(`expiring` 内含 `imminent` 子量);`balance` 为 null/undefined
253
+ * 时返回 `undefined`(= 查询失败)。
153
254
  */
154
- export declare function splitBuddyCreditsByExpiry(balance: CreditBalance | null | undefined, now?: number, windowMs?: number): BuddyCreditSplit | undefined;
255
+ export declare function splitBuddyCreditsByExpiry(balance: CreditBalance | null | undefined, now?: number, windowMs?: number, imminentMs?: number): BuddyCreditSplit | undefined;
155
256
  /** 分档选项。 */
156
257
  export interface BuddyTierOptions {
157
258
  /** 是否允许消耗永久积分。默认 `true`(解锁)。 */
@@ -269,6 +370,7 @@ export declare function rotateFromPreferred<T extends BuddyAccountBalance>(ranke
269
370
  */
270
371
  export declare function buddyBalanceTier(balance: {
271
372
  expiringBalance?: number;
373
+ imminentBalance?: number;
272
374
  permanentBalance?: number;
273
375
  }, options?: BuddyTierOptions): BuddyBalanceTier;
274
376
  /**
@@ -325,6 +427,10 @@ export declare function rankBuddyAccountsByManualOrder<T extends BuddyAccountBal
325
427
  *
326
428
  * ⚠️ 两个桶都为 0 时返回「无可用积分」而不是「临时 0 / 永久 0」——
327
429
  * 用户读后者需要自己推断,前者一眼可见。
430
+ *
431
+ * ⚠️ **有临期额度时必须把它单列**(`临期 X · 5 天内到期 Y · 永久 Z`):
432
+ * 若只说「15 天内到期 Y」,「其中 X 会在 5 天内烧掉」这个最关键的决策信息
433
+ * 就丢了 —— 而这正是引入临期档的全部目的。
328
434
  */
329
- export declare function describeBuddyCreditSplit(split: BuddyCreditSplit | undefined, windowDays?: number): string;
435
+ export declare function describeBuddyCreditSplit(split: BuddyCreditSplit | undefined, windowDays?: number, imminentDays?: number): string;
330
436
  //# sourceMappingURL=buddy-balance-rank.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"buddy-balance-rank.d.ts","sourceRoot":"","sources":["../src/buddy-balance-rank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAExE;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C,mCAAmC;AACnC,eAAO,MAAM,wBAAwB,QAAmD,CAAA;AAExF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,8BAA8B,mCAAmC,CAAA;AAE9E;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAMpF;AAED,mBAAmB;AACnB,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAElF;AAED,sBAAsB;AACtB,eAAO,MAAM,kBAAkB;IAC7B,oCAAoC;;IAEpC,yBAAyB;;IAEzB,kBAAkB;;EAET,CAAA;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAA;AAE3F,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,6BAA6B;AAC7B,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACzC,GAAG,GAAE,MAAmB,EACxB,QAAQ,GAAE,MAAiC,GAC1C,gBAAgB,GAAG,SAAS,CAuJ9B;AAED,YAAY;AACZ,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,EAC/D,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,OAAO,GAAE,gBAAqB,GAC7B,CAAC,EAAE,CA2BL;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAKlB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAE/D;AAQD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,mBAAmB,EACtE,QAAQ,EAAE,SAAS,CAAC,EAAE,EACtB,OAAO,GAAE,gBAAqB,GAC7B,CAAC,EAAE,CAKL;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,mBAAmB,EAC1E,QAAQ,EAAE,SAAS,CAAC,EAAE,EACtB,OAAO,GAAE,gBAAqB,GAC7B,CAAC,EAAE,CAUL;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,UAAU,GAAE,MAAmC,GAC9C,MAAM,CAMR"}
1
+ {"version":3,"file":"buddy-balance-rank.d.ts","sourceRoot":"","sources":["../src/buddy-balance-rank.ts"],"names":[],"mappings":"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"}
@@ -34,12 +34,18 @@
34
34
  *
35
35
  * | 档位 | 判据 | 含义 |
36
36
  * |---|---|---|
37
- * | 1 | `expiring > 0` | 有 **15 天内到期**的积分 —— 再不用就作废,优先消耗 |
38
- * | 2 | `permanent > 0` | 只剩「永久」积分(≥ 15 天后才到期) |
39
- * | 3 | 其余(含**查询失败**) | 无可用余额 |
37
+ * | 1 | `imminent > 0` | 有 **5 天内到期**的积分(临期)—— 再不用立刻作废,最优先 |
38
+ * | 2 | `expiring > 0` | 只剩 **5~15 天内到期**的积分(短期) |
39
+ * | 3 | `permanent > 0` | 只剩「永久」积分(≥ 15 天后才到期) |
40
+ * | 4 | 其余(含**查询失败**) | 无可用余额 |
41
+ *
42
+ * ⚠️ 三档判据是**嵌套**的:`临期 ⊂ 15 天内`,故 `expiring` 桶同时包含临期与短期,
43
+ * `imminent` 是它的子量。这样「锁定永久积分」的可用性判据(`expiring > 0`)不变。
40
44
  *
41
45
  * ⚠️ **档内保持传入顺序**(= 用户在 Jet Hub 拖拽的手动顺序),**不重排** ——
42
- * 与 `AccountPool.getAvailableAccount` 的既有语义一致。
46
+ * 与 `AccountPool.getAvailableAccount` 的既有语义一致。**临期档内同样如此**:
47
+ * 两笔都临期时,顺序完全由帐号顺序决定,不按"谁更急"二次排序
48
+ *(用户 2026-11-17 明确要求「原来是什么策略就使用什么策略」)。
43
49
  *
44
50
  * ⚠️ **查询失败归入最后一档**:宁可把请求发给能确认余额的号(与 Loomy 同规)。
45
51
  *
@@ -57,6 +63,38 @@ import { isExclusiveCreditPool } from './credits.js';
57
63
  export const BUDDY_EXPIRING_WINDOW_DAYS = 15;
58
64
  /** 由天数换算的毫秒窗口(导出供单测按同一口径构造时间戳)。 */
59
65
  export const BUDDY_EXPIRING_WINDOW_MS = BUDDY_EXPIRING_WINDOW_DAYS * 24 * 60 * 60 * 1000;
66
+ /**
67
+ * 「临期积分」的时间窗口:距扣费截止不足 **5 天**的积分算临期(最优先烧掉)。
68
+ * 用户 2026-11-17 定的判据。
69
+ *
70
+ * ## 它与 15 天那条是**嵌套**关系,不是并列
71
+ *
72
+ * ```
73
+ * 临期(< 5 天) ⊂ 短期(5 ~ 15 天) ⊂ 原「临时」(< 15 天)
74
+ * ```
75
+ *
76
+ * 引入它的原因(用户 2026-11-17 需求):原先**只有一条线**,于是「14 天后到期」
77
+ * 与「3 天后到期」都算同一档 `expiring` ⇒ 排序时**全靠帐号顺序**决定先烧谁
78
+ * ⇒ 一个还有 14 天的号会长期霸占轮换,而 3 天后作废的积分**一分没用上**。
79
+ *
80
+ * ## ⚠️ 它是 `expiring` 的**子量**,不是第 4 个平级桶
81
+ *
82
+ * `expiring` 的语义(15 天内)**逐字节不变** —— 这是刻意的,因为
83
+ * `split.expiring > 0` 是「锁定永久积分」的可用性判据
84
+ *(`src/officeace-lock.ts:255`、`plugin-src/client/usage-badge.js` 的 `expiringOf()`),
85
+ * 改它的含义会让锁定态把一个「只有 3 天积分」的可用号误判成不可用。
86
+ * 与 `permanent` 承载 `unknownExpiry` 子量是同一手法(见 `src/credits.ts:289-310`)。
87
+ */
88
+ export const BUDDY_IMMINENT_WINDOW_DAYS = 5;
89
+ /** 由天数换算的毫秒窗口(导出供单测按同一口径构造时间戳)。 */
90
+ export const BUDDY_IMMINENT_WINDOW_MS = BUDDY_IMMINENT_WINDOW_DAYS * 24 * 60 * 60 * 1000;
91
+ /**
92
+ * 覆盖「临期」窗口的环境变量名。
93
+ *
94
+ * ⚠️ 与 15 天那条同理:不同渠道的发卡节奏差别极大,5 天对某家合适、对另一家过紧。
95
+ * 设成 `0` 可**关掉临期档**(退化成原来的两档)。
96
+ */
97
+ export const DSH_BUDDY_IMMINENT_WINDOW_DAYS = 'DSH_BUDDY_IMMINENT_WINDOW_DAYS';
60
98
  /**
61
99
  * 覆盖窗口的环境变量名。
62
100
  *
@@ -99,14 +137,67 @@ export function buddyExpiringWindowDays(env = process.env) {
99
137
  export function buddyExpiringWindowMs(env = process.env) {
100
138
  return buddyExpiringWindowDays(env) * 24 * 60 * 60 * 1000;
101
139
  }
140
+ /**
141
+ * 当前生效的「临期」窗口(天)。
142
+ *
143
+ * ⚠️ **解析纪律与 {@link buddyExpiringWindowDays} 逐条相同**:`0` 是**合法值**
144
+ * (表示「关掉临期档,退化成两档」),故**绝不能**写 `Number(raw) || 默认值` ——
145
+ * 那会把 `0` 静默换成 5。非法值(空 / 非数字 / 负数)回落到默认。
146
+ */
147
+ export function buddyImminentWindowDays(env = process.env) {
148
+ const raw = env[DSH_BUDDY_IMMINENT_WINDOW_DAYS];
149
+ if (typeof raw !== 'string' || raw.trim().length === 0)
150
+ return BUDDY_IMMINENT_WINDOW_DAYS;
151
+ const parsed = Number(raw.trim());
152
+ if (!Number.isFinite(parsed) || parsed < 0)
153
+ return BUDDY_IMMINENT_WINDOW_DAYS;
154
+ return parsed;
155
+ }
156
+ /** 当前生效的临期窗口(毫秒)。 */
157
+ export function buddyImminentWindowMs(env = process.env) {
158
+ return buddyImminentWindowDays(env) * 24 * 60 * 60 * 1000;
159
+ }
160
+ /**
161
+ * 生效的临期窗口(毫秒)—— **全仓唯一的钳制点**。
162
+ *
163
+ * ## 为什么要钳制
164
+ *
165
+ * 两个窗口是**嵌套**的(临期 ⊂ 15 天)。用户可分别用两个环境变量调它们,
166
+ * 于是出现「临期窗口比总窗口还大」时,分档表就自相矛盾了:
167
+ *
168
+ * | `DSH_BUDDY_EXPIRING_WINDOW_DAYS` | `DSH_BUDDY_IMMINENT_WINDOW_DAYS` | 不钳制的后果 |
169
+ * |---|---|---|
170
+ * | 15 | 20 | 「短期」档的判据 `5~15 天` 变成空区间 ⇒ 该档永远为 0(看着像缺陷) |
171
+ * | 3 | 5 | 「临期」判据 `>3 天 且 <5 天` 两处比较打架 ⇒ 必须钳到 3 |
172
+ *
173
+ * 钳制后语义始终自洽:**临期 ⊂ 总窗口**,最坏情况是「短期档消失」,
174
+ * 而那是用户显式把两个窗口调到相等/倒挂的**直接推论**,不是缺陷。
175
+ *
176
+ * ⚠️ 只在**这一处**钳制。调用方拿到的值已经是合法的 —— 别在别处再
177
+ * `Math.min` 一次,那会让「同一语义两套判据」重新出现(本仓首条红线)。
178
+ *
179
+ * @param windowMs - 总窗口(15 天,已按 env 解析)。
180
+ * @param imminentMs - 临期窗口候选值;省略时读环境变量。
181
+ * @returns 恒 `>= 0` 且 `<= windowMs`。
182
+ */
183
+ export function resolveImminentWindowMs(windowMs, imminentMs) {
184
+ const raw = imminentMs ?? buddyImminentWindowMs();
185
+ // 总窗口本身若是脏值(NaN / 负),退化成默认,避免把临期窗口也污染成 NaN。
186
+ const total = Number.isFinite(windowMs) && windowMs >= 0 ? windowMs : BUDDY_EXPIRING_WINDOW_MS;
187
+ if (!Number.isFinite(raw) || raw < 0)
188
+ return Math.min(BUDDY_IMMINENT_WINDOW_MS, total);
189
+ return Math.min(raw, total);
190
+ }
102
191
  /** 账号余额档位。数字越小越优先。 */
103
192
  export const BUDDY_BALANCE_TIER = Object.freeze({
104
- /** 有 15 天内到期的积分 —— 优先消耗(再不用就作废)。 */
105
- expiring: 0,
106
- /** 只剩永久积分(≥ 15 天后到期)。 */
107
- permanent: 1,
108
- /** 无余额 / 查询失败。 */
109
- none: 2,
193
+ /** 有 5 天内到期的积分(临期)—— 最优先消耗,否则直接作废。 */
194
+ imminent: 0,
195
+ /** 只剩 5~15 天内到期的积分(短期)—— 次优先。 */
196
+ expiring: 1,
197
+ /** 只剩永久积分(≥ 15 天后到期,或到期时间未知)—— 最后才用。 */
198
+ permanent: 2,
199
+ /** 无余额 / 查询失败 / 锁定态下只剩永久积分。 */
200
+ none: 3,
110
201
  });
111
202
  /**
112
203
  * 把一个账号的积分余额拆成「快到期」与「永久」两桶。
@@ -126,12 +217,38 @@ export const BUDDY_BALANCE_TIER = Object.freeze({
126
217
  * @param balance - `fetchCreditBalance` 的结果;`null`(查询失败)返回 `undefined`。
127
218
  * @param now - 当前时刻(毫秒),注入以便单测断言边界。
128
219
  * @param windowMs - 窗口,默认 {@link BUDDY_EXPIRING_WINDOW_MS}。
129
- * @returns 两桶合计;`balance` 为 null/undefined 时返回 `undefined`(= 查询失败)。
220
+ * @param imminentMs - 「临期」子窗口,默认 {@link BUDDY_IMMINENT_WINDOW_MS}。
221
+ * ⚠️ 由调用方经 {@link resolveImminentWindowMs} 归一(保证 ≤ `windowMs`)
222
+ * —— 这里给默认值只为既有调用点(含大量用例)不必改动。
223
+ * @returns 三桶合计(`expiring` 内含 `imminent` 子量);`balance` 为 null/undefined
224
+ * 时返回 `undefined`(= 查询失败)。
130
225
  */
131
- export function splitBuddyCreditsByExpiry(balance, now = Date.now(), windowMs = BUDDY_EXPIRING_WINDOW_MS) {
226
+ export function splitBuddyCreditsByExpiry(balance, now = Date.now(), windowMs = BUDDY_EXPIRING_WINDOW_MS, imminentMs = BUDDY_IMMINENT_WINDOW_MS) {
132
227
  if (balance === null || balance === undefined)
133
228
  return undefined;
229
+ /**
230
+ * ⚠️⚠️ **容器层也要挡**(2026-11-18 对抗审计 P2-③)。
231
+ *
232
+ * 元素层早有 `if (!pkg) continue`(2026-10-21 那次审计加的),但 `packages`
233
+ * 本身是 `{}` / 字符串 / `{ packages: {} }` 时 `for...of` 直接抛
234
+ * `TypeError: packages is not iterable`,而 `selector.classify` 没有 try/catch
235
+ * ⇒ **整条 `jet-hub/usage-badge` RPC 崩掉**(不是某个 provider 显示异常)。
236
+ *
237
+ * 客户端的 `splitCreditsByExpiry`(`plugin-src/client/credit-expiry.js:146`)
238
+ * 同输入返回 `null`(= 不适用)⇒ 修前是**前后端两套答案**。这里对齐成
239
+ * `undefined`(= 查询失败),与 `balance === null` 同义。
240
+ */
241
+ if (!Array.isArray(balance.packages))
242
+ return undefined;
134
243
  let expiring = 0;
244
+ /**
245
+ * `expiring` 的**子量**:其中距到期不足 `imminentMs` 的部分。
246
+ *
247
+ * ⚠️ 累加点与 `expiring` **在同一分支里成对发生**(见下方窗口比较)——
248
+ * 这是 `0 <= imminent <= expiring` 这条不变量的**唯一**保证方式。
249
+ * 若把它们写在两个 if 里,任何一次改动都可能让子量脱离母量。
250
+ */
251
+ let imminent = 0;
135
252
  let permanent = 0;
136
253
  let expired = 0;
137
254
  for (const pkg of balance.packages) {
@@ -284,12 +401,38 @@ export function splitBuddyCreditsByExpiry(balance, now = Date.now(), windowMs =
284
401
  expired += remaining;
285
402
  continue;
286
403
  }
287
- if (endMs - now < windowMs)
404
+ /**
405
+ * ⚠️⚠️ **临期判定必须与 `expiring` 累加在同一分支里成对发生**。
406
+ *
407
+ * `imminent` 是 `expiring` 的**子量**(`0 <= imminent <= expiring`)——
408
+ * 这是本文件最重要的一条不变式,也是「锁定永久积分」不会误判的前提。
409
+ * 若拆成两个独立 `if`(先把 `expiring` 累加、再单独判临期),
410
+ * 将来任何一次边界调整都可能让子量脱离母量(子量 > 母量)。
411
+ *
412
+ * 边界方向与 15 天那条**严格一致**:`<` 才是窗口内。
413
+ * ⇒ 正好 `imminentMs` 的那笔算**短期**,不算临期。
414
+ */
415
+ const left = endMs - now;
416
+ if (left < imminentMs) {
417
+ imminent += remaining;
418
+ expiring += remaining;
419
+ continue;
420
+ }
421
+ if (left < windowMs)
288
422
  expiring += remaining;
289
423
  else
290
424
  permanent += remaining;
291
425
  }
292
- return { expiring, permanent, ...expired > 0 ? { expired } : {} };
426
+ /**
427
+ * ⚠️ `imminent` / `expired` 都只在 `> 0` 时出现 —— 与前端 `unknownExpiry` 同款约定:
428
+ * 多一个恒 0 的键会让所有「逐键 `toEqual`」的既有用例全线变红,且对 0 值毫无信息量。
429
+ */
430
+ return {
431
+ expiring,
432
+ permanent,
433
+ ...imminent > 0 ? { imminent } : {},
434
+ ...expired > 0 ? { expired } : {},
435
+ };
293
436
  }
294
437
  /**
295
438
  * 「轮换起点」的**唯一实现**:把已排好序的候选从指定账号处绕一圈。
@@ -366,10 +509,85 @@ export function rotateFromPreferred(ranked, options = {}) {
366
509
  // 全不可用 ⇒ 原样,交给上层报出真实原因(不要在这里抛)。
367
510
  if (anchor < 0)
368
511
  return [...ranked];
369
- // 起点已是首位 ⇒ 无需旋转(但仍返回新数组,保持「不改入参」约定)。
370
- if (anchor === 0)
371
- return [...ranked];
372
- return [...ranked.slice(anchor), ...ranked.slice(0, anchor)];
512
+ /**
513
+ * ★★★★ **S5 语义:起点**绝对第一** + 其余按档位优先 + 同档内循环**
514
+ * (用户 2026-11-18 三次定稿,最终版)。
515
+ *
516
+ * ## 迭代脉络(每一次都是真实报障驱动的)
517
+ *
518
+ * | 版本 | 规则 | 报障 |
519
+ * |---|---|---|
520
+ * | S3 | 整条数组循环 | ⚠️ 起点在永久档时永久排第一、**临期沉底**,白等到过期 |
521
+ * | S2 | 只把起点摘出来放最前(不循环)| ⚠️ 位次 7 被甩到最后 |
522
+ * | S4 | 起点档内循环,**更优先的档整档前置** | ⚠️ **起点被挤到第 2 位** |
523
+ * | **S5** | **起点绝对第一** + 其余档位优先 + 同档循环 | ✅ |
524
+ *
525
+ * ## 用户两次要求的原话(必须同时满足)
526
+ *
527
+ * 1. 「起点只提升自己,自己是什么档次就使用它的档次,
528
+ * 然后剩余全部按默认策略档位排列」 ⇒ **起点第一**
529
+ * 2. 「都是同一档次的情况下,肯定是按照循环来,
530
+ * 而不是现在这种只是把选号 6 提到第一,其他的不变」 ⇒ **同档循环**
531
+ *
532
+ * S4 把第 1 条实现错了:它让「更优先的档」压过起点。
533
+ * 用户实测(Qoder 7 个账号,起点=位次5 永久档、位次2 是临期):
534
+ *
535
+ * ```
536
+ * S4 ⇒ 位2(临期) → 位5(起点) → 位6 → … ❌ 起点不是第一
537
+ * S5 ⇒ 位5(起点) → 位2(临期) → 位6 → … ✅
538
+ * ```
539
+ *
540
+ * ## 规则(三条,按优先级)
541
+ *
542
+ * 1. **起点绝对第一**(无论它是什么档);
543
+ * 2. 其余账号按**档位优先序**:临期 → 短期 → 永久 → 不可用;
544
+ * 3. **起点所在档内**从起点之后继续循环(绕回该档首),其余档保持原序。
545
+ *
546
+ * ⚠️⚠️ **已知代价(用户明确接受)**:起点在「永久」档且池里存在临期账号时,
547
+ * 永久积分会先被烧掉 —— 这正是三档机制原本要避免的(临期会过期)。
548
+ * 弹窗的起点档位提示(`rotationStartHint`)已把该后果告知用户。
549
+ * 这里**不再替用户做「保护临期」的决定** —— 那是 S4 的错误。
550
+ *
551
+ * ## 三条不变量(S5 版)
552
+ *
553
+ * 1. **集合不变**:只重排,不增删;
554
+ * 2. **起点必在首位**:只要找到可用起点,`out[0].id === startId`;
555
+ * 3. **档内循环**:起点所在档内的相对顺序是「循环位移」,
556
+ * 其余档内相对顺序**逐字节不变**。
557
+ */
558
+ const startAccount = ranked[anchor];
559
+ const anchorTier = buddyBalanceTier(startAccount, options);
560
+ /** 分档边界用未锁定口径(`none` 档在锁定态可能是「只剩永久」,会混淆分组)。 */
561
+ const tierRankOf = (account) => buddyBalanceTier(account, { allowPermanent: true });
562
+ const anchorRank = tierRankOf(startAccount);
563
+ // 按档分组(保持组内原序)
564
+ const byRank = new Map();
565
+ for (const account of ranked) {
566
+ const rank = tierRankOf(account);
567
+ const group = byRank.get(rank);
568
+ if (group === undefined)
569
+ byRank.set(rank, [account]);
570
+ else
571
+ group.push(account);
572
+ }
573
+ const result = [startAccount];
574
+ for (const rank of [...byRank.keys()].sort((a, b) => a - b)) {
575
+ const group = byRank.get(rank);
576
+ if (rank !== anchorRank) {
577
+ // 其他档:整档原样(组内已排除起点?不 —— 起点只在 anchorRank 组里)
578
+ result.push(...group);
579
+ continue;
580
+ }
581
+ // 起点所在档:从起点**之后**继续循环,再绕回该档首至起点之前
582
+ const posInTier = group.findIndex((a) => a.id === startAccount.id);
583
+ const ordered = posInTier >= 0
584
+ ? [...group.slice(posInTier + 1), ...group.slice(0, posInTier)]
585
+ : group;
586
+ result.push(...ordered);
587
+ }
588
+ // ⚠️ `anchorTier` 只为可读性保留(真正的分组边界用 tierRankOf,见上方说明)
589
+ void anchorTier;
590
+ return result;
373
591
  }
374
592
  /**
375
593
  * 判定单个账号的档位。
@@ -394,6 +612,13 @@ export function rotateFromPreferred(ranked, options = {}) {
394
612
  * 只剩永久积分的账号直接落入 `none`(不可用),而不是降到 `permanent` 档。
395
613
  */
396
614
  export function buddyBalanceTier(balance, options = {}) {
615
+ /**
616
+ * ⚠️ 两个「会作废」的档**必须在 `allowPermanent === false` 之前判**:
617
+ * 临期与短期都在 15 天内 ⇒ 锁定时**仍可烧**。这保证「锁定永久积分」的
618
+ * 可用性判据与引入临期档**之前逐字节相同**(那是最不能回归的一格)。
619
+ */
620
+ if (positiveOrZero(balance.imminentBalance) > 0)
621
+ return BUDDY_BALANCE_TIER.imminent;
397
622
  if (positiveOrZero(balance.expiringBalance) > 0)
398
623
  return BUDDY_BALANCE_TIER.expiring;
399
624
  if (options.allowPermanent === false)
@@ -478,15 +703,37 @@ export function rankBuddyAccountsByManualOrder(accounts, options = {}) {
478
703
  *
479
704
  * ⚠️ 两个桶都为 0 时返回「无可用积分」而不是「临时 0 / 永久 0」——
480
705
  * 用户读后者需要自己推断,前者一眼可见。
706
+ *
707
+ * ⚠️ **有临期额度时必须把它单列**(`临期 X · 5 天内到期 Y · 永久 Z`):
708
+ * 若只说「15 天内到期 Y」,「其中 X 会在 5 天内烧掉」这个最关键的决策信息
709
+ * 就丢了 —— 而这正是引入临期档的全部目的。
481
710
  */
482
- export function describeBuddyCreditSplit(split, windowDays = BUDDY_EXPIRING_WINDOW_DAYS) {
711
+ export function describeBuddyCreditSplit(split, windowDays = BUDDY_EXPIRING_WINDOW_DAYS, imminentDays = BUDDY_IMMINENT_WINDOW_DAYS) {
483
712
  if (split === undefined)
484
713
  return '余额查询失败';
485
714
  const expiring = roundCreditsInline(split.expiring);
486
715
  const permanent = roundCreditsInline(split.permanent);
716
+ const imminent = roundCreditsInline(split.imminent ?? 0);
487
717
  if (expiring <= 0 && permanent <= 0)
488
718
  return '无可用积分';
489
- return `${windowDays} 天内到期 ${expiring} · 永久 ${permanent}`;
719
+ /**
720
+ * ⚠️⚠️ `imminent` 是 `expiring` 的**子量** ⇒ 明细行里必须减掉它,否则三段相加会
721
+ * 大于合计(`临期 100 · 15 天内到期 350 · 永久 1000` 读起来是 1450,实际 1350)。
722
+ *
723
+ * 2026-11-18 正向审计 P3-a:上面这句注释一直这么写,但代码**没减**,而
724
+ * `tests/unit/buddy-balance-rank.spec.ts` 的用例把错的输出钉死了 ⇒ 注释与实现
725
+ * 互相矛盾、CI 全绿。修法是把实现改成注释说的样子(区间也随之收窄成
726
+ * `5~15 天内到期`,与 `plugin-src/client/credit-expiry.js` 的 `expiryBucketLabel`
727
+ * 同一口径)。
728
+ *
729
+ * 本函数**当前无生产调用点**(只在 spec 里)—— 保留是为了将来接回展示层时
730
+ * 不再犯同一个错;不删是因为删掉会丢掉「三段相加 = 合计」这条不变式的记录。
731
+ */
732
+ const imminentPart = imminent > 0 ? `临期 ${imminent} · ` : '';
733
+ const restDays = imminent > 0 ? `${imminentDays}~${windowDays}` : `${windowDays}`;
734
+ // `imminent > expiring` 是上游数据异常 ⇒ 用 `Math.max(0, …)` 兜底,不输出负数。
735
+ const rest = imminent > 0 ? Math.max(0, roundCreditsInline(split.expiring - imminent)) : expiring;
736
+ return `${imminentPart}${restDays} 天内到期 ${rest} · 永久 ${permanent}`;
490
737
  }
491
738
  /** 展示用规整:两位小数(服务端精确值带浮点尾数噪声)。 */
492
739
  function roundCreditsInline(value) {
@@ -1 +1 @@
1
- {"version":3,"file":"buddy-balance-rank.js","sourceRoot":"","sources":["../src/buddy-balance-rank.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"buddy-balance-rank.js","sourceRoot":"","sources":["../src/buddy-balance-rank.ts"],"names":[],"mappings":"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"}
@@ -244,6 +244,14 @@ export type BuddySelectionDeps<TProduct = BuddyProduct, TCredential = BuddyCrede
244
244
  errorTtlMs?: number;
245
245
  /** 「临时积分」窗口覆盖(测试用)。 */
246
246
  windowMs?: number;
247
+ /**
248
+ * 「临期」窗口覆盖(测试用)。
249
+ *
250
+ * ⚠️ 与 `windowMs` **同款**:每次现算、绝不缓存。
251
+ * 生效值由 {@link resolveImminentWindowMs} 钳制(恒 ≤ `windowMs`),
252
+ * 故调用方无需自己保证两个窗口的嵌套关系。
253
+ */
254
+ imminentWindowMs?: number;
247
255
  /**
248
256
  * **带原因**的余额查询(可选,传了就优先用它)。
249
257
  *
@@ -288,6 +296,18 @@ export declare class BuddyBalanceSelector<TProduct = BuddyProduct, TCredential =
288
296
  * 而提示文案与选号判据必须取同一个值 —— 缓存会让两者在不同时刻分裂。
289
297
  */
290
298
  private windowMs;
299
+ /**
300
+ * 当前生效的「临期」窗口(毫秒),**恒 ≤ {@link windowMs}**。
301
+ *
302
+ * ⚠️ 同样**每次调用都重新解析**(理由见 `windowMs()` 上方):
303
+ * 一笔「5 天 + 30 秒」的余额,半分钟后就成了临期 ——
304
+ * 缓存这个值会让选号继续按「短期」处理一笔马上要作废的积分。
305
+ *
306
+ * ⚠️ 钳制走 {@link resolveImminentWindowMs}(全仓唯一钳制点):
307
+ * 用户可能把 15 天调到 3 天而临期仍是默认 5 天,此处必须自动收敛,
308
+ * 否则「临期窗口 > 总窗口」会让分档表自相矛盾。
309
+ */
310
+ private imminentWindowMs;
291
311
  /**
292
312
  * 查一个账号的余额分类(**缓存原料、每次现算**)。
293
313
  *