@kenz1117/dsh-ui-usage-billing 1.4.8 → 1.4.9

package/lib/index.js

@@ -298,16 +298,22 @@ function isPeakHour(beijingHour) {
 /**
 * 由时刻（epoch 毫秒）推断计费时段；时刻未知/非法时按高峰计（保守：未知
 * 时刻不低估成本，与社区 dsh-usage-chart 的 tierAt 语义一致）。
-* 周末（北京时间周六/周日）全天不区分峰谷，统一按低谷价。
+* 周末（北京时间周六/周日）与中国法定节假日全天不区分峰谷，统一按低谷价
+* （官方 2026-09-19 口径：调休上班的周末、法定节假日全天均按空闲时段计费；
+* 调休上班日全部落在周末，故由周末分支覆盖，无需单列）。
 * @param timeMs - Unix epoch 毫秒；null/undefined/NaN 视为未知。
 */
 function tierAt(timeMs) {
 	if (timeMs === null || timeMs === void 0 || !Number.isFinite(timeMs)) return "peak";
-	return tierAtWithBounds(timeMs, TIER_BOUNDARY_MINUTES);
+	return tierAtWithBounds(timeMs, TIER_BOUNDARY_MINUTES, true);
 }
-/** 按给定峰段边界判档：周末全天低谷；工作日分钟数落在任一 [b(i), b(i+1)) 峰段即为高峰。 */
-function tierAtWithBounds(timeMs, bounds) {
-	if (isBeijingWeekend(timeMs)) return "offPeak";
+/**
+* 按给定峰段边界判档：低谷日全天低谷；工作日分钟数落在任一 [b(i), b(i+1)) 峰段即为高峰。
+* @param holidays - 是否把中国法定节假日并入低谷日。该官方口径只适用于 DeepSeek 按量分时；
+*   智谱 Coding Plan 的积分口径未见节假日说明，故默认不启用，由调用点显式传入。
+*/
+function tierAtWithBounds(timeMs, bounds, holidays = false) {
+	if (isBeijingWeekend(timeMs) || holidays && isBeijingHoliday(timeMs)) return "offPeak";
 	const minute = Math.floor(beijingMillisOfDay(timeMs) / 6e4);
 	for (let i = 0; i + 1 < bounds.length; i += 2) {
 		const start = bounds[i] ?? 0;
@@ -321,6 +327,28 @@ function isBeijingWeekend(timeMs) {
 	const day = new Date(timeMs + 288e5).getUTCDay();
 	return day === 0 || day === 6;
 }
+/**
+* 中国法定节假日 —— **生成块，勿手改**。数据源
+* [NateScarlet/holiday-cn](https://github.com/NateScarlet/holiday-cn)（逐年抓取国务院公告；
+* 2026 年依据 https://www.gov.cn/zhengce/zhengceku/202511/content_7047091.htm）。
+*
+* 只收录峰谷计费起点（{@link WEEKEND_OFFPEAK_START_MS}，北京时间 2026-08-23 00:00）之后的日期：
+* 更早的调用由 v1 规则定价，不涉及节假日。表中没有的年份退化为「仅周末低谷」，
+* 国务院公布下一年安排后在此追加一条即可。
+*
+* 编码为空格分隔的 `YYYYMMDD` 列表（按年分组、同年日期连续排列，便于逐年追加）：
+* 每个键长度固定为 8，故 `includes` 不会跨键误匹配；相比「区间 + 运行时展开」
+* 省掉一段解析代码——client / index 两个 face 都要过 256 KiB 单文件上限。
+*/
+const CHINA_HOLIDAYS = "20260925 20260926 20260927 20261001 20261002 20261003 20261004 20261005 20261006 20261007";
+/** 北京日期键 YYYYMMDD（与宿主时区无关）。 */
+function beijingDateKey(timeMs) {
+	return new Date(timeMs + 288e5).toISOString().slice(0, 10).replace(/-/g, "");
+}
+/** 时刻是否落在北京时间法定节假日（仅覆盖 {@link CHINA_HOLIDAYS} 内已收录的年份）。 */
+function isBeijingHoliday(timeMs) {
+	return CHINA_HOLIDAYS.includes(beijingDateKey(timeMs));
+}
 /** 峰谷切换边界（北京时间的当日分钟数）：09:00 / 12:00 / 14:00 / 18:00。 */
 const TIER_BOUNDARY_MINUTES = [
 	540,

package/lib/types/client/pricing.d.ts

@@ -10,7 +10,8 @@
  * Google-style two-band billing is modeled per model: Gemini's Flex tier
  * prices spare-capacity traffic at -50%; DeepSeek splits peak
  * (weekdays 09:00-12:00 / 14:00-18:00 Beijing) at 2x the off-peak rate —
- * weekends (Sat/Sun, Beijing) are charged at the off-peak rate all day.
+ * weekends (Sat/Sun, Beijing) and Chinese statutory holidays are charged at
+ * the off-peak rate all day (see {@link CHINA_HOLIDAYS}).
  * The estimator mixes both bands by a configured peak share ({@link DEFAULT_PEAK_SHARE}).
  *
  * Time-limited launch promos ({@link PricePromo}) never mutate the catalog:
@@ -182,7 +183,9 @@ export declare function isPeakHour(beijingHour: number): boolean;
 /**
  * 由时刻（epoch 毫秒）推断计费时段；时刻未知/非法时按高峰计（保守：未知
  * 时刻不低估成本，与社区 dsh-usage-chart 的 tierAt 语义一致）。
- * 周末（北京时间周六/周日）全天不区分峰谷，统一按低谷价。
+ * 周末（北京时间周六/周日）与中国法定节假日全天不区分峰谷，统一按低谷价
+ * （官方 2026-09-19 口径：调休上班的周末、法定节假日全天均按空闲时段计费；
+ * 调休上班日全部落在周末，故由周末分支覆盖，无需单列）。
  * @param timeMs - Unix epoch 毫秒；null/undefined/NaN 视为未知。
  */
 export declare function tierAt(timeMs: number | null | undefined): PriceTierId;
@@ -191,9 +194,12 @@ export declare function tierAt(timeMs: number | null | undefined): PriceTierId;
  *
  * 下一切换点统一定义为档位真正变化的最近边界：自当前时刻起逐天扫描工作日的
  * 09:00 / 12:00 / 14:00 / 18:00，候选时刻的档位由 {@link tierAt} 判定——
- * 周末（周六/周日）北京全天低谷、没有边界，扫描自然跳过；工作日深夜跨周末
- * 时落到周一 09:00 而非周末伪边界（issue #33）。
- * 最坏情形（周五 18:00 后 → 周一 09:00）约 63h，7 天窗口必然覆盖。
+ * 周末（周六/周日）与法定节假日北京全天低谷、没有边界，扫描自然跳过；工作日
+ * 深夜跨周末时落到周一 09:00 而非周末伪边界（issue #33）。
+ * 最坏情形是「长假 + 相邻周末」：最长连休 8 天（2025-10-01 ~ 10-08 型）时，
+ * 假期前最后一个工作日深夜的下一切换可落在约 9.4 天之后——故扫描窗口取
+ * 10 天。原实现取 7 天（注释记「最坏 63h」），在连休下会扫不到真边界而落进
+ * 兜底伪边界。
  * @param nowMs - 当前时刻（epoch 毫秒）。
  * @returns 当前档位与到下一切换边界的毫秒数。
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "1.4.8",
+  "version": "1.4.9",
   "keywords": [
     "deepseek-harness",
     "deepseek",