@dougen/dsh-deepseek-usage 0.9.2 → 0.10.0

package/README.md

@@ -11,8 +11,7 @@ A sidebar plugin for the **DeepSeek Harness (DSH) Web UI** that answers two ques
 
 - **Balance** in the sidebar footer: your DeepSeek account balance (the symbol follows the account currency: `¥` / `$`).
 - **Unit prices of the active model**: input / input cache / output for the billing window in effect right now. They change when you switch models and when the peak/off-peak window flips.
-- **Peak / off-peak dot with a countdown**: orange during peak hours (Mon–Fri 9:00–12:00 and 14:00–18:00 Beijing Time), green otherwise; next to it, the time left until the next switch (`2d 15h`, `5h 47m`, `23m`).
-- **Collapsed sidebar** (56 px icon rail): only the dot stays, so the rail keeps its shape.
+- **Peak / off-peak dot with a countdown**: orange during peak hours (Mon–Fri, excluding Chinese public holidays, 9:00–12:00 and 14:00–18:00 Beijing Time), green otherwise — weekends, public holidays and the make-up workdays that fall on a weekend are all off-peak; next to it, the time left until the next switch (`2d 15h`, `5h 47m`, `23m`).
 - Refreshes every 5 minutes, and immediately when you click the card or switch models. Follows the app light/dark theme and the DSH language (Chinese / English).
 
 ## Install, uninstall, common errors
@@ -41,12 +40,13 @@ The card then shows the reason instead of numbers:
 
 ### Prices differ from the official page
 
-- Prices come from the local price table `<DSH_HOME>/dsh-deepseek-usage/pricing.json`. The plugin refreshes that file from the official pricing page on the first request of each day and when you click the card, then reads it back — a hand-edited table works after a restart, no code change needed.
+- Prices are the built-in table `PRICE_TABLE` in `lib/pricing.js`, a snapshot of the official pricing page. It changes only when a new version of the plugin ships — there is no local price file and no background sync.
 - If the active model is not in the table, the card falls back to `deepseek-chat` pricing.
+- Off-peak days come from the holiday table `HOLIDAY_RANGES` in `lib/pricing.js` (and its mirror in `lib/client.js`). The State Council usually publishes next year's arrangement in November; update both lists then. Until you do, holidays are treated as ordinary workdays and the card shows peak prices during them.
 
 ## How it works
 
-- The **host half** (`lib/index.js`, `lib/pricing*.js`) registers `GET /api/deepseek-usage`. Per request it reads the API key from DSH credentials, asks the official balance API, resolves the active model's price from the price table (syncing it from the official pricing page at most once a day, or right away when you click the card), and answers with balance, tier prices, the peak flag and the next switch time.
+- The **host half** (`lib/index.js`, `lib/pricing.js`) registers `GET /api/deepseek-usage`. Per request it reads the API key from DSH credentials, asks the official balance API, resolves the active model's price from the built-in price table, and answers with balance, tier prices, the peak flag and the next switch time. `GET /api/deepseek-usage/holidays` hands the browser half the same public-holiday table.
 - The **browser half** (`lib/client.js`) renders that answer into the `sidebar.footer.action` slot, polls every 5 minutes, and refreshes on click or on a model change. The peak state and the countdown come from the same answer, so the card itself holds no pricing logic.
 
 ---
@@ -59,8 +59,7 @@ The card then shows the reason instead of numbers:
 
 - **余额**：侧边栏底部显示 DeepSeek 账号余额（符号随账号币种 `¥` / `$`）。
 - **当前模型的档单价**：输入 / 输入缓存 / 输出，按此刻生效的计费时段显示；切换模型、跨过峰谷切换点时会跟着变。
-- **峰谷指示灯 + 倒计时**：高峰（周一至周五 9:00–12:00、14:00–18:00 北京时间）橙色，其余时间绿色；指示灯旁给出距下次切换的剩余时间（`2d 15h`、`5h 47m`、`23m`）。
-- **侧边栏折叠时**只剩这颗指示灯，图标栏保持原样。
+- **峰谷指示灯 + 倒计时**：高峰（周一至周五、不含中国法定节假日，9:00–12:00、14:00–18:00 北京时间）橙色，其余时间绿色——周末、法定节假日全天，以及调休上班的周末都是空闲；指示灯旁给出距下次切换的剩余时间（`2d 15h`、`5h 47m`、`23m`）。
 - 每 5 分钟自动刷新；点击卡片或切换模型时立即刷新。跟随应用明暗主题与 DSH 语言（中文 / English）。
 
 ### 安装、卸载与常见错误
@@ -87,12 +86,13 @@ dsh plugin --profile web remove @dougen/dsh-deepseek-usage
 
 价格与官方不一致时：
 
-- 价格来自本地价格表 `<DSH_HOME>/dsh-deepseek-usage/pricing.json`；插件在每日首次请求和点击卡片时从官方价格页刷新并回写该文件，手改这份表重启后即生效，不用改代码。
+- 价格是 `lib/pricing.js` 的内置表 `PRICE_TABLE`（官方价格页的快照），只在发布新版本时更新——没有本地价格文件，也没有后台同步。
 - 当前模型不在价格表里时，按 `deepseek-chat` 的价格显示。
+- 放假日期维护在 `lib/pricing.js` 的 `HOLIDAY_RANGES`（`lib/client.js` 有一份镜像，两处要一起改）。国务院办公厅通常在前一年 11 月发布次年安排，届时更新；未更新前，节假日会按普通工作日处理，白天显示高峰价。
 
 ### 简单的工作原理
 
-- **宿主侧**（`lib/index.js`、`lib/pricing*.js`）注册 `GET /api/deepseek-usage`：每次请求读取 DSH 凭据里的 API Key、调用官方余额接口、从价格表解析当前模型档单价（每天最多同步一次官方价格页，点击卡片则立即同步），返回余额、档单价、峰谷状态与下次切换时刻。
+- **宿主侧**（`lib/index.js`、`lib/pricing.js`）注册 `GET /api/deepseek-usage`：每次请求读取 DSH 凭据里的 API Key、调用官方余额接口、从内置价格表解析当前模型档单价，返回余额、档单价、峰谷状态与下次切换时刻；`GET /api/deepseek-usage/holidays` 把同一份法定节假日表交给浏览器侧。
 - **浏览器侧**（`lib/client.js`）把这份响应渲染进 `sidebar.footer.action` 槽位，每 5 分钟轮询一次，点击卡片或模型变化时立即刷新；峰谷状态与倒计时同样来自这次响应，界面自身不做计价逻辑。
 
 ## License

package/lib/client.js

@@ -11,8 +11,8 @@
 //   · 侧边栏折叠——36px 图标栏里只有峰谷指示灯（见下方 `if (!wide)` 分支）。
 //
 // 设计约束（用户只关心"我还能花多少、这会儿什么价"）：
-//   · 插件的内部信息——计价来源、同步状态、价格表文件名与路径、模型改名——一律
-//     不出现在 UI 上（历史上圆点的 title 里塞过这些，已删除）。
+//   · 插件的内部信息——取价路径、模型改名、放假日期来源——一律不出现在 UI 上
+//     （历史上圆点的 title 里塞过这些，已删除）。
 //   · 唯一的交互是「点击卡片刷新」；没有可切换的提示态。
 //   · 只有余额类错误（未配置 Key / 余额接口或网络失败）才置空卡片说明原因。
 // 样式仅使用 `--dsw-*` 主题变量（含兜底值），跟随明暗主题。
@@ -29,6 +29,10 @@ window.__ModuleLoader__.load({
 		// ---- constants -------------------------------------------------
 		const POLL_MS = 5 * 60 * 1000;
 		const USAGE_PATH = "/api/deepseek-usage";
+		// 放假日期：宿主路由（见 lib/index.js），浏览器启动时读一次、并把“未来第 8 段”
+		// 的起始日期写回去（宿主随后自动续跑后续周期、自动合并）。浏览器比宿主更可能
+		// 处于新年份，因此由它来推进这份日期表。
+		const HOLIDAYS_PATH = "/api/deepseek-usage/holidays";
 		// 常态卡片高度：上下 padding 8+16 + 金额行 minHeight 28 + 边框 2 = 54。
 		// 底部多留的 8px 是为了让倒计时那一行与下方单价行之间有呼吸感。
 		// 倒计时与圆点都在金额行内定位，不额外增高（无头 Chromium 实测 cardH=54）。
@@ -41,7 +45,7 @@ window.__ModuleLoader__.load({
 		// ---- i18n（DSH locale 服务；zh 为兜底）----
 		// 注意：卡片上只出现「输入 / 输入缓存 / 输出」这三个标签。峰谷灯没有文字、
 		// 没有 hover；倒计时统一用英文单位（d/h/m）且不带前缀，中英界面完全一致——
-		// 插件内部的同步状态、计价来源、价格表位置等一概不进 UI。
+		// 插件内部的取价路径等一概不进 UI。
 		const NS = "dsh-deepseek-usage";
 		const ZH = {
 			"price.input": "输入",
@@ -60,19 +64,49 @@ window.__ModuleLoader__.load({
 		const SWITCHING = "switching";
 
 		// ---- 峰谷规则（必须与 lib/pricing.js 的 isPeak / PEAK_WINDOWS /
-		// PEAK_WEEKDAYS_ONLY 保持一致；浏览器侧无法 import 宿主模块，只能镜像）----
+		// PEAK_WEEKDAYS_ONLY / HOLIDAY_RANGES 保持一致；浏览器侧无法 import 宿主模块，
+		// 只能镜像。2026 年起官方口径：法定节假日全天、调休上班的周末都是空闲时段，
+		// 所以放假日期必须一起镜像，否则中秋/国庆白天会被误显示成高峰价）----
 		const SHANGHAI_OFFSET_MS = 8 * 60 * 60 * 1000;
 		const PEAK_WINDOWS = [[9, 12], [14, 18]];
 		const PEAK_WEEKDAYS_ONLY = true;
+		// 放假日期（含起止，闭区间）：国务院办公厅 2026 年节假日安排。
+		const HOLIDAY_RANGES = [
+			['2026-01-01', '2026-01-03'],
+			['2026-02-15', '2026-02-23'],
+			['2026-04-04', '2026-04-06'],
+			['2026-05-01', '2026-05-05'],
+			['2026-06-19', '2026-06-21'],
+			['2026-09-25', '2026-09-27'],
+			['2026-10-01', '2026-10-07'],
+		];
+		const HOLIDAY_DAYS = (() => {
+			const set = new Set();
+			const DAY = 24 * 60 * 60 * 1000;
+			for (const [from, to] of HOLIDAY_RANGES) {
+				const start = Date.parse(from + 'T00:00:00Z');
+				const end = Date.parse(to + 'T00:00:00Z');
+				if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) continue;
+				for (let t = start; t <= end; t += DAY) set.add(new Date(t).toISOString().slice(0, 10));
+			}
+			return set;
+		})();
 
 		/** 某时刻的北京时间小时（0–23）。 */
 		function shanghaiHour(ms) {
 			return new Date(ms + SHANGHAI_OFFSET_MS).getUTCHours();
 		}
 
-		/** 某时刻是否为高峰时段（按北京时间；周末恒为空闲）。与 lib/pricing.js 的 isPeak 等价。 */
+		/** 该时刻所在北京时间日历日是否为法定节假日（放假日期）。 */
+		function isHoliday(ms) {
+			return HOLIDAY_DAYS.has(new Date(ms + SHANGHAI_OFFSET_MS).toISOString().slice(0, 10));
+		}
+
+		/** 某时刻是否为高峰时段（按北京时间；节假日全天与周末恒为空闲）。与 lib/pricing.js 的 isPeak 等价。 */
 		function isPeak(ms) {
-			const d = new Date(ms + SHANGHAI_OFFSET_MS);
+			const now = Number.isFinite(ms) ? ms : Date.now();
+			if (isHoliday(now)) return false;
+			const d = new Date(now + SHANGHAI_OFFSET_MS);
 			if (PEAK_WEEKDAYS_ONLY) {
 				const dow = d.getUTCDay();
 				if (dow === 0 || dow === 6) return false;
@@ -83,12 +117,12 @@ window.__ModuleLoader__.load({
 
 		/**
 		 * 距下一个计费时段边界的剩余时间；与 lib/pricing.js 的 nextChange 等价。
-		 * 逐分钟向前探测（上限 8 天，覆盖"周五晚 → 下周一早"）。
+		 * 逐分钟向前探测（上限 16 天，覆盖春节长假 → 假期后首个工作日早晨）。
 		 */
 		function nextChange(ms) {
 			const now = Number.isFinite(ms) ? ms : Date.now();
 			const current = isPeak(now);
-			for (let step = 1; step <= 8 * 24 * 60; step += 1) {
+			for (let step = 1; step <= 16 * 24 * 60; step += 1) {
 				const at = now + step * 60 * 1000;
 				const peak = isPeak(at);
 				if (peak !== current) return { peak, at, ms: Math.max(0, at - now) };
@@ -178,8 +212,22 @@ window.__ModuleLoader__.load({
 			const [error, setError] = useState("");
 			// 倒计时走字用的心跳：每 30 秒 bump 一次，渲染时按当前时刻重算剩余时间。
 			const [tick, setTick] = useState(0);
+			const [holidayRanges, setHolidayRanges] = useState(() => HOLIDAY_RANGES);
+			// 放假日期表变化时重算（与宿主口径一致）。
+			useEffect(() => {
+				const set = new Set();
+				const DAY = 24 * 60 * 60 * 1000;
+				for (const [from, to] of holidayRanges) {
+					const start = Date.parse(String(from) + 'T00:00:00Z');
+					const end = Date.parse(String(to) + 'T00:00:00Z');
+					if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) continue;
+					for (let t = start; t <= end; t += DAY) set.add(new Date(t).toISOString().slice(0, 10));
+				}
+				HOLIDAY_DAYS.clear();
+				for (const day of set) HOLIDAY_DAYS.add(day);
+			}, [holidayRanges]);
 			const mounted = useRef(true);
-			// 快速重试：阶梯下标 + 定时器（宿主正在后台同步时，几秒后自己再看一眼）。
+			// 快速重试：阶梯下标 + 定时器（宿主刚起来、余额接口还没返回时，几秒后自己再看一眼）。
 			const retryStep = useRef(0);
 			const retryTimer = useRef(null);
 			const locale = ctx && ctx.locale;
@@ -204,10 +252,10 @@ window.__ModuleLoader__.load({
 
 			// 宿主还在后台忙（重启后首次余额、接口刚起来）时按 QUICK_RETRY_MS 阶梯补几次请求，
 			// 让卡片几秒内收敛；封顶后回到 5 分钟轮询。失败同样按此节奏重试。
-			// 判断依据只看"有没有拿到余额"，不再依赖宿主内部的同步状态字段。
-			const load = useCallback(async (force) => {
+			// 判断依据只看"有没有拿到余额"，不依赖宿主内部字段。
+			const load = useCallback(async () => {
 				try {
-					const res = await fetch(USAGE_PATH + "?lang=" + lang + (force ? "&refresh=1" : ""), { cache: "no-store" });
+					const res = await fetch(USAGE_PATH + "?lang=" + lang, { cache: "no-store" });
 					let body = null;
 					try {
 						body = await res.json();
@@ -247,7 +295,7 @@ window.__ModuleLoader__.load({
 				mounted.current = true;
 				load();
 				const timer = setInterval(load, POLL_MS);
-				// 模型切换（写入 settings 触发 document-updated）时立即刷新，价格同步。
+				// 模型切换（写入 settings 触发 document-updated）时立即刷新，单价跟着变。
 				let off = null;
 				try {
 					if (ctx && ctx.remote && typeof ctx.remote.$on === "function") {
@@ -271,6 +319,23 @@ window.__ModuleLoader__.load({
 				};
 			}, [load, ctx]);
 
+			// ---- 放假日期表（宿主是唯一权威：启动时拉一次，只用于本地兜底计算）----
+			// 浏览器侧必须镜像峰谷规则（无法 import 宿主模块），放假日期也就不该各写一份，
+			// 否则放假那几天两边会算出不同结果。
+			useEffect(() => {
+				let cancelled = false;
+				(async () => {
+					try {
+						const res = await fetch(HOLIDAYS_PATH, { cache: "no-store" });
+						let body = null;
+						try { body = await res.json(); } catch {}
+						if (cancelled || !res.ok || !body || body.ok !== true) return;
+						if (Array.isArray(body.ranges)) setHolidayRanges(body.ranges);
+					} catch { /* 读不到就用内置表继续 */ }
+				})();
+				return () => { cancelled = true; };
+			}, []);
+
 			// 倒计时走字：每 30 秒重算一次渲染（跨过切换瞬间时，不依赖下一次 5 分钟轮询）。
 			// 30s 而非 60s 是为了保证"剩余不足 1 分钟"的窗口不会被整分钟跳过。
 			useEffect(() => {
@@ -282,7 +347,7 @@ window.__ModuleLoader__.load({
 			const tier = data && data.tier ? data.tier : null;
 			const symbol = balance && balance.currency === "USD" ? "$" : "¥";
 			// 卡片只显示"用户要的数字"：余额、当前档单价、状态圆点、距下次切换的倒计时。
-			// 插件的内部信息（计价来源、同步状态、价格表文件名/路径、模型改名）一律不进 UI，
+			// 插件的内部信息（取价路径、模型改名）一律不进 UI，
 			// 唯一的交互是点击卡片刷新。只有"余额类错误"（未配置 Key / 接口或网络失败）才
 			// 把卡片置空并说明原因——否则余额是空的，用户无从判断。
 			const errs = (Array.isArray(data && data.errors) ? data.errors : []).concat(error ? [error] : []);
@@ -308,12 +373,12 @@ window.__ModuleLoader__.load({
 				background: data && data.peak ? C.peak : C.idle,
 				boxShadow: "0 0 4px rgba(0,0,0,.3)",
 			};
-			// 圆点自身没有任何 hover（历史上的 title 里塞了同步时间、价格表路径等内部信息，
+			// 圆点自身没有任何 hover（历史上的 title 里塞了价格表路径等内部信息，
 			// 对用户毫无意义，已删除）；它只表达"现在是高峰还是空闲"，切换时刻由旁边的
 			// 倒计时承担。
 			// 点击卡片：唯一动作 = 刷新。
 			const onCardClick = () => {
-				load(true);
+				load();
 			};
 
 			// 折叠态（图标栏）：内容宽 36px（侧边栏 56px − 折叠态左右各 10px 内边距），
@@ -331,14 +396,14 @@ window.__ModuleLoader__.load({
 						alignItems: "center",
 						userSelect: "none",
 					},
-					onClick: () => load(true),
+					onClick: () => load(),
 				}, h("span", { style: dot }));
 			}
 
 			// 只有"余额类错误"（未配置 Key / 余额接口或网络失败）才走到这里：卡片置空、
 			// 只显示原因文字，不画余额/单价/圆点/倒计时。minHeight 兜住常态卡片高度
 			// （CARD_MIN_HEIGHT），侧边栏不跳动；文字多行时卡片自然变高。
-			// 注意：这里不显示任何插件内部信息（来源、同步时间、价格表路径），历史上那批
+			// 注意：这里不显示任何插件内部信息（取价路径、放假日期来源），历史上那批
 			// 良性提示已随"去技术化"一起删除。
 			// 折叠态（!wide）早在上面就返回了：它只有峰谷指示灯，没有文字空间。
 			if (blanked) {