dsh-peak-hours 0.0.0-stage → 1.11.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# 更新日志
+
+## 1.11.0 — 2026-10-29
+
+### 修正
+
+- **说明文案与实现对齐**：日程条的说明原来写「红色=高峰、绿色=空闲」，但条子实际是琥珀橙 / DeepSeek 蓝，现已改为「橙色=高峰、蓝色=空闲」（英文同步为 `amber` / `blue`）。
+- 节假日说明不再暴露源码里的 `HOLIDAYS` 常量名，改成数据驱动：从已收录年份自动生成「节假日表已收录 2026 年中秋、国庆」。
+- `package.json` 补充 `./package.json` 导出、`engines`、`scripts.test`，发布物更规范。
+
+### 新增
+
+- **点击复制状态**：点一下角标（或聚焦后按 Enter / 空格）即可把「高峰 ×2 · 3小时11分后转空闲（北京时间）」复制到剪贴板，1.5 秒内显示「已复制」。剪贴板不可用时回退到临时 textarea。
+- **切换前 10 分钟强调**：距峰↔谷切换不足 10 分钟时，倒计时变琥珀色加粗，圆点轻微脉冲（`prefers-reduced-motion` 下自动关闭动画）。
+- **更完整的 tooltip**：新增「明天」预告（明天周末 / 法定节假日 / 工作日），以及点击复制的提示。
+- **可访问性**：角标改为 `role="button"` + `tabIndex`，带 `aria-label`（含状态、倒计时与操作提示），键盘 `:focus-visible` 有可见焦点环。
+- **单元测试与 CI**：`npm test` 用 `node --test` 跑 15 个用例（时段边界 09:00/12:00/14:00/18:00、周末、节假日、跨日倒计时、日程条分段与宽度、游标位置、折叠态、复制、中英文 key 对齐），GitHub Actions 在 22.x 上跑测试与打包检查。
+
+## 1.10.1 — 2026-10-28
+
+- 修正 bundle patch 里的行名仍然指向改名前的 `@local/dsh-peak-hours`，导致重命名后客户端半不装载、角标消失。
+
+## 1.10.0 — 2026-10-28
+
+- 收窄空闲色渐变（`#4d6bfe → #6383ff`），让条子底色与侧栏 logo 的品牌蓝一致。
+- 发布物整理：包名改为 `dsh-peak-hours`，补 LICENSE / README / 图标 / 截图 / `screenshots.json`。
+
+## 1.9.0 — 2026-10-27
+
+- 空闲色从绿色换成 DeepSeek 品牌蓝 `#4d6bfe`；高峰仍为琥珀色 `#f59e0b`。
+
+## 1.4.0 — 2026-10-27
+
+- 进度条改为「当天 00:00–24:00 的日程条」：红/绿分段 + 白色当前时刻标尺。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 run666888
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+# dsh-peak-hours
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+一个 DeepSeek Harness 的侧栏角标：**现在是不是高峰计价时段**。
+
+![侧栏角标](screenshots/screenshot-1.png)
+
+![ci](https://github.com/run666888/dsh-peak-hours/actions/workflows/ci.yml/badge.svg)
+
+## 它显示什么
+
+挂在侧栏底部动作行（`sidebar.footer.action`，「插件市场」下面），一行搞定三件事：
+
+- **状态**：橙点 = 高峰，蓝点 = 空闲；后面跟当前倍率（高峰 `×2`，空闲 `5 折`）
+- **倒计时**：还有多久切换（`3小时11分后转空闲`）
+- **全天日程条**：00:00–24:00 一条 8px 高的条，橙色段是高峰、蓝色段是空闲，白色竖线是当前时刻——一天里什么时候贵，一眼看全
+
+侧栏折叠成窄轨时自动退化为「圆点 + 一小截进度条」，不占地方。
+
+**距切换不到 10 分钟**时，倒计时会变成琥珀色加粗、圆点轻微脉冲，提醒你「要涨价了」或「要降价了」（系统开启减少动态效果时动画自动关闭）。
+
+**点一下角标**（或聚焦后按 Enter / 空格）会把当前状态复制到剪贴板，例如
+`DeepSeek 高峰 ×2 · 3小时11分后转空闲（北京时间）`，方便贴给同事。
+
+鼠标悬停能看到完整说明：当前段起止时间、明天是工作日还是休息、以及高峰/空闲的价格表。
+
+## 计费规则
+
+按 DeepSeek 的峰谷定价：
+
+- **高峰**：北京时间 **09:00–12:00**、**14:00–18:00**
+- **空闲**：其余时间（含午间 12:00–14:00、18:00 之后、09:00 之前）
+- **整天空闲**：周六、周日，以及中国的法定节假日
+- 闲时价 = 高峰价的一半
+
+节假日表是**内置的，不联网**：目前覆盖 2026 年（中秋 9/25–27、国庆 10/1–7）。2026 年 9/20（周日）和 10/10（周六）是调休上班日，按规则仍算空闲。表里没有的年份退化成「周末空闲」规则——这是保守选择：宁可把某天当成空闲（少标高峰），也不误报高峰；遇到新的节假日安排需要更新 `client.js` 里的 `HOLIDAYS`，tooltip 里显示的年份由该表自动推导。
+
+时间一律按北京时间（UTC+8）算，和你浏览器的时区无关。
+
+## 安装
+
+从 npm：
+
+```sh
+dsh plugin --profile web add dsh-peak-hours
+```
+
+从本地目录：
+
+```sh
+dsh plugin --profile web add /绝对路径/dsh-peak-hours
+```
+
+装完刷新页面（或重启 `dsh web`）即可生效。
+
+## 卸载
+
+```sh
+dsh plugin --profile web remove dsh-peak-hours
+```
+
+## 兼容性
+
+- 需要带客户端 UI 的 DeepSeek Harness Web GUI（`dsh.client` 声明为 `platform: web`）
+- 纯客户端插件：不注册 host 工具、不写文件、不发网络请求、不需要任何配置或凭据
+- 颜色是固定值（高峰 `#f59e0b`、空闲 `#4d6bfe`，即 DeepSeek 品牌蓝），不跟随主题 `brand-primary`，以免换皮肤后蓝色被改成别的色
+
+## 开发
+
+```sh
+npm test          # 15 个单元测试（node --test，零依赖）
+npm run verify    # npm pack --dry-run，检查发布清单
+```
+
+测试通过 `vm` 加载 `client.js`，用最小的 React / locale / document 替身渲染组件，因此不用起 GUI 也能验证时段判定、分段宽度、折叠态与复制逻辑。
+
+## 许可
+
+MIT

package/client.js

@@ -0,0 +1,578 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-peak-hours',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+
+    const NS = 'dsh-peak-hours';
+    const MINUTE = 60 * 1000;
+    const BEIJING_OFFSET = 8 * 60 * MINUTE;
+
+    // 高峰时段（北京时间，分钟数）：09:00–12:00、14:00–18:00
+    const PEAK_WINDOWS = [
+      [9 * 60, 12 * 60],
+      [14 * 60, 18 * 60],
+    ];
+
+    // 距峰↔谷切换不足该分钟数时，倒计时与圆点进入强调态。
+    const SOON_MINUTES = 10;
+
+    /**
+     * 中国法定节假日（全天空闲计价）。来源：2026-09-19 官方说明
+     * 「法定节假日全天、调休上班的周末全天均按空闲时段计费」。
+     * 已核对 2026 年中秋、国庆；新一年的放假安排公布后按公告补充，
+     * 未收录的年份只按周末规则判定（周末本就全天空闲，因此不会判错方向）。
+     */
+    const HOLIDAYS = {
+      2026: [
+        '2026-09-25', '2026-09-26', '2026-09-27',
+        '2026-10-01', '2026-10-02', '2026-10-03', '2026-10-04',
+        '2026-10-05', '2026-10-06', '2026-10-07',
+      ],
+    };
+    const HOLIDAY_YEARS = Object.keys(HOLIDAYS).sort();
+    const holidayCache = new Map();
+    function holidaySet(year) {
+      if (holidayCache.has(year)) return holidayCache.get(year);
+      const list = HOLIDAYS[year];
+      const set = list ? new Set(list) : null;
+      holidayCache.set(year, set);
+      return set;
+    }
+
+    const pad2 = (n) => (n < 10 ? '0' + n : '' + n);
+
+    /** 把瞬间投影到北京时间墙上时钟。 */
+    function beijing(ms) {
+      const d = new Date(ms + BEIJING_OFFSET);
+      const year = d.getUTCFullYear();
+      const month = d.getUTCMonth() + 1;
+      const day = d.getUTCDate();
+      return {
+        year,
+        month,
+        day,
+        key: year + '-' + pad2(month) + '-' + pad2(day),
+        dow: d.getUTCDay(),
+        minute: d.getUTCHours() * 60 + d.getUTCMinutes(),
+        clock: pad2(d.getUTCHours()) + ':' + pad2(d.getUTCMinutes()),
+      };
+    }
+
+    function stateAt(ms) {
+      const t = beijing(ms);
+      const holidays = holidaySet(t.year);
+      const isWeekend = t.dow === 0 || t.dow === 6;
+      const isHoliday = holidays ? holidays.has(t.key) : false;
+      const allDayOff = isWeekend || isHoliday;
+      const inWindow = PEAK_WINDOWS.some(
+        (w) => t.minute >= w[0] && t.minute < w[1],
+      );
+      return {
+        peak: !allDayOff && inWindow,
+        isWeekend,
+        isHoliday,
+        allDayOff,
+        beijing: t,
+      };
+    }
+
+    /** 次日的计价形态：holiday / weekend / workday。 */
+    function kindAt(ms) {
+      const t = beijing(ms);
+      const holidays = holidaySet(t.year);
+      if (holidays && holidays.has(t.key)) return 'holiday';
+      if (t.dow === 0 || t.dow === 6) return 'weekend';
+      return 'workday';
+    }
+
+    /** 下一个峰↔谷切换的瞬间（分钟对齐），最多向前找 14 天。 */
+    function nextSwitch(ms) {
+      const current = stateAt(ms);
+      const base = Math.floor(ms / MINUTE) * MINUTE;
+      const limit = 14 * 1440;
+      for (let i = 1; i <= limit; i += 1) {
+        const at = base + i * MINUTE;
+        if (stateAt(at).peak !== current.peak) return at;
+      }
+      return null;
+    }
+
+    /** 当前这一段（高峰段或空闲段）的起点。 */
+    function prevSwitch(ms) {
+      const current = stateAt(ms);
+      const base = Math.floor(ms / MINUTE) * MINUTE;
+      const limit = 14 * 1440;
+      for (let i = 1; i <= limit; i += 1) {
+        const at = base - i * MINUTE;
+        if (stateAt(at).peak !== current.peak) return at + MINUTE;
+      }
+      return null;
+    }
+
+    function phaseOf(ms) {
+      const start = prevSwitch(ms);
+      const end = nextSwitch(ms);
+      let progress = 0;
+      if (start !== null && end !== null && end > start) {
+        progress = Math.min(1, Math.max(0, (ms - start) / (end - start)));
+      }
+      return { start, end, progress };
+    }
+
+    /** 当天 00:00–24:00 的峰谷分段（分钟），画成橙蓝相间的日程条。 */
+    function daySchedule(ms) {
+      const st = stateAt(ms);
+      if (st.allDayOff) return [{ from: 0, to: 1440, peak: false }];
+      const segs = [];
+      let cur = 0;
+      for (const w of PEAK_WINDOWS) {
+        if (w[0] > cur) segs.push({ from: cur, to: w[0], peak: false });
+        segs.push({ from: w[0], to: w[1], peak: true });
+        cur = w[1];
+      }
+      if (cur < 1440) segs.push({ from: cur, to: 1440, peak: false });
+      return segs;
+    }
+
+    const pct = (minute) => ((minute / 1440) * 100).toFixed(3) + '%';
+
+    function fmtDuration(ms, t) {
+      const total = Math.max(1, Math.round(ms / MINUTE));
+      const days = Math.floor(total / 1440);
+      const hours = Math.floor((total % 1440) / 60);
+      const minutes = total % 60;
+      const parts = [];
+      if (days) parts.push(days + t('unit.day'));
+      if (hours) parts.push(hours + t('unit.hour'));
+      if (!days && minutes) parts.push(minutes + t('unit.minute'));
+      const sep = t('unit.sep') || '';
+      return parts.join(sep);
+    }
+
+    function clockLabel(ms) {
+      const b = beijing(ms);
+      return b.month + '-' + pad2(b.day) + ' ' + b.clock;
+    }
+
+    function holidayNote(t) {
+      return (t('tip.table') || '').replace('{years}', HOLIDAY_YEARS.join(' / '));
+    }
+
+    function tooltip(t, st, phase, now) {
+      const lines = [
+        t('tip.head'),
+        t('tip.current') + (st.peak ? t('status.peak') : t('status.off')),
+        t('tip.window'),
+        t('tip.bar'),
+        t('tip.rule'),
+        t('tip.weekend'),
+      ];
+      if (st.isHoliday) lines.push(t('tip.holidayToday'));
+      else if (st.isWeekend) lines.push(t('tip.weekendToday'));
+      const tomorrow = kindAt(now + 1440 * MINUTE);
+      lines.push(
+        tomorrow === 'holiday'
+          ? t('tip.tomorrowHoliday')
+          : tomorrow === 'weekend'
+            ? t('tip.tomorrowWeekend')
+            : t('tip.tomorrowWorkday'),
+      );
+      if (phase.start !== null && phase.end !== null) {
+        lines.push(
+          t('tip.phase') + clockLabel(phase.start) + ' → ' + clockLabel(phase.end),
+        );
+        lines.push(
+          t('tip.next') +
+            fmtDuration(phase.end - now, t) +
+            (st.peak ? t('next.off') : t('next.peak')),
+        );
+      }
+      lines.push(
+        '',
+        t('tip.prices'),
+        t('tip.flash'),
+        t('tip.pro'),
+        '',
+        holidayNote(t),
+        t('tip.tz'),
+        t('tip.hint'),
+      );
+      return lines.join('\n');
+    }
+
+    function copySummary(t, st, phase, now) {
+      const pill = st.peak ? t('price.multiplier') : t('price.discount');
+      const rest =
+        phase.end !== null
+          ? t('tip.next') +
+            fmtDuration(phase.end - now, t) +
+            (st.peak ? t('next.off') : t('next.peak'))
+          : '';
+      return (
+        'DeepSeek ' +
+        (st.peak ? t('status.peak') : t('status.off')) +
+        ' ' +
+        pill +
+        ' · ' +
+        rest +
+        ' ' +
+        t('copy.suffix')
+      );
+    }
+
+    /** 复制到剪贴板：Clipboard API 优先，失败退回临时 textarea。 */
+    function writeClipboard(text) {
+      try {
+        if (
+          typeof navigator !== 'undefined' &&
+          navigator.clipboard &&
+          typeof navigator.clipboard.writeText === 'function'
+        ) {
+          return Promise.resolve(navigator.clipboard.writeText(text)).then(
+            () => true,
+            () => fallbackCopy(text),
+          );
+        }
+      } catch {
+        /* 落到兜底 */
+      }
+      return Promise.resolve(fallbackCopy(text));
+    }
+
+    function fallbackCopy(text) {
+      try {
+        if (typeof document === 'undefined' || !document.body) return false;
+        const area = document.createElement('textarea');
+        area.value = text;
+        area.setAttribute('readonly', '');
+        area.style.position = 'fixed';
+        area.style.opacity = '0';
+        document.body.appendChild(area);
+        area.select();
+        const ok = document.execCommand && document.execCommand('copy');
+        document.body.removeChild(area);
+        return !!ok;
+      } catch {
+        return false;
+      }
+    }
+
+    // 字族跟随宿主，字号显式压到侧栏次级字号（0.8125rem ≈ 13px），
+    // 因为 footer 动作行从根节点继承的是 1rem，直接用 inherit 会比菜单项大一号。
+    const CSS = `
+      .dshph-root {
+        --dshph-peak: #f59e0b;
+        --dshph-off: #4d6bfe;
+        --dshph-peak-hi: #fbbf24;
+        --dshph-off-hi: #6383ff;
+        display: flex; flex-direction: column; gap: 4px;
+        box-sizing: border-box; width: 100%; min-width: 0;
+        padding: 4px 8px 5px; border-radius: 8px;
+        font-family: inherit; font-size: 14px; font-size: .875rem;
+        font-weight: 400; line-height: 1.45;
+        color: var(--dsw-alias-label-primary);
+        user-select: none; cursor: pointer; outline: none;
+        transition: background-color .15s ease;
+      }
+      .dshph-root:hover { background: var(--dsw-alias-bg-layer-2); }
+      .dshph-root:focus-visible {
+        outline: 2px solid var(--dsw-alias-brand-primary, #4d6bfe);
+        outline-offset: 1px;
+      }
+      .dshph-head { display: flex; align-items: center; gap: 6px; min-width: 0; }
+      .dshph-dot { flex: none; width: 7px; height: 7px; border-radius: 50%; }
+      .dshph-peak .dshph-dot {
+        background: var(--dshph-peak);
+        box-shadow: 0 0 0 3px rgba(245, 158, 11, .22);
+      }
+      .dshph-off .dshph-dot {
+        background: var(--dshph-off);
+        box-shadow: 0 0 0 3px rgba(77, 107, 254, .2);
+      }
+      .dshph-dot-soon { animation: dshph-pulse 1.6s ease-in-out infinite; }
+      @keyframes dshph-pulse {
+        0%, 100% { box-shadow: 0 0 0 2px rgba(245, 158, 11, .22); }
+        50% { box-shadow: 0 0 0 5px rgba(245, 158, 11, .06); }
+      }
+      .dshph-label,
+      .dshph-pill,
+      .dshph-next {
+        font-family: inherit; font-size: inherit; font-weight: inherit;
+        line-height: inherit; letter-spacing: inherit; color: inherit;
+      }
+      .dshph-label { flex: none; }
+      .dshph-pill { flex: none; }
+      .dshph-spacer { flex: 1 1 auto; min-width: 4px; }
+      .dshph-next {
+        flex: 0 1 auto; min-width: 0; overflow: hidden;
+        text-overflow: ellipsis; white-space: nowrap;
+      }
+      .dshph-soon .dshph-next { color: #f59e0b; font-weight: 600; }
+      .dshph-toast { color: var(--dsw-alias-label-secondary); }
+      .dshph-track {
+        position: relative; height: 8px; border-radius: 999px;
+        background: var(--dsw-alias-bg-layer-2); overflow: hidden;
+      }
+      .dshph-seg { position: absolute; top: 0; bottom: 0; }
+      .dshph-seg-off {
+        background: linear-gradient(180deg, var(--dshph-off-hi), var(--dshph-off));
+      }
+      .dshph-seg-peak {
+        background: linear-gradient(180deg, var(--dshph-peak-hi), var(--dshph-peak));
+      }
+      .dshph-cursor {
+        position: absolute; top: 0; bottom: 0; width: 2px;
+        border-radius: 1px; background: #fff;
+        box-shadow: 0 0 0 1px rgba(0, 0, 0, .45);
+        transform: translateX(-1px);
+        transition: left .6s linear;
+      }
+      .dshph-rail {
+        align-items: center; justify-content: center; gap: 4px;
+        padding: 0;
+      }
+      .dshph-rail .dshph-track { width: 26px; height: 6px; }
+      .dshph-rail .dshph-cursor { width: 1.5px; }
+      @media (prefers-reduced-motion: reduce) {
+        .dshph-root, .dshph-root * {
+          animation: none !important; transition: none !important;
+        }
+      }
+    `;
+
+    function ensureStyle() {
+      if (typeof document === 'undefined') return () => {};
+      const id = 'dsh-peak-hours-style';
+      if (document.getElementById(id)) return () => {};
+      const el = document.createElement('style');
+      el.id = id;
+      el.textContent = CSS;
+      document.head.appendChild(el);
+      return () => {
+        if (el.parentNode) el.parentNode.removeChild(el);
+      };
+    }
+
+    const ZH = {
+      label: '峰谷时段',
+      'status.peak': '高峰',
+      'status.off': '空闲',
+      'price.multiplier': '×2',
+      'price.discount': '5 折',
+      'next.peak': '后转高峰',
+      'next.off': '后转空闲',
+      'unit.day': '天',
+      'unit.hour': '小时',
+      'unit.minute': '分',
+      'unit.sep': '',
+      'tip.head': 'DeepSeek 峰谷计费',
+      'tip.current': '当前：',
+      'tip.window': '高峰时段：工作日 09:00–12:00、14:00–18:00（北京时间）',
+      'tip.bar': '日程条：当天 00:00–24:00，橙色=高峰、蓝色=空闲，白线是当前时刻',
+      'tip.rule': '其余时间按空闲计价，闲时价为高峰价的一半',
+      'tip.weekend': '周末与法定节假日全天按空闲计价',
+      'tip.holidayToday': '今天：法定节假日，全天按空闲计价',
+      'tip.weekendToday': '今天：周末，全天按空闲计价',
+      'tip.tomorrowHoliday': '明天：法定节假日，全天按空闲计价',
+      'tip.tomorrowWeekend': '明天：周末，全天按空闲计价',
+      'tip.tomorrowWorkday': '明天：工作日，恢复按 09:00–12:00、14:00–18:00 计价',
+      'tip.phase': '本段：',
+      'tip.next': '距切换：',
+      'tip.prices': '价格（元/百万 tokens，空闲 → 高峰）',
+      'tip.flash': 'deepseek-flash：缓存命中 0.02 → 0.04｜未命中 1 → 2｜输出 4 → 8',
+      'tip.pro': 'deepseek-v4-pro：缓存命中 0.15 → 0.30｜未命中 4.5 → 9.0｜输出 13.5 → 27.0',
+      'tip.table': '节假日表已收录 {years} 年中秋、国庆；新一年安排公布后随版本更新',
+      'tip.tz': '判定时区：北京时间（UTC+8）',
+      'tip.hint': '点击复制当前状态',
+      'copy.ok': '已复制',
+      'copy.fail': '复制失败',
+      'copy.suffix': '（北京时间）',
+    };
+
+    const EN = {
+      label: 'Peak hours',
+      'status.peak': 'Peak',
+      'status.off': 'Off-peak',
+      'price.multiplier': '×2',
+      'price.discount': '50% off',
+      'next.peak': ' until peak',
+      'next.off': ' until off-peak',
+      'unit.day': 'd',
+      'unit.hour': 'h',
+      'unit.minute': 'm',
+      'unit.sep': ' ',
+      'tip.head': 'DeepSeek peak/off-peak pricing',
+      'tip.current': 'Now: ',
+      'tip.window': 'Peak: weekdays 09:00–12:00 and 14:00–18:00 (Beijing time)',
+      'tip.bar': 'Day bar: 00:00–24:00, amber = peak, blue = off-peak, white line = now',
+      'tip.rule': 'Everything else is off-peak, priced at half of the peak rate',
+      'tip.weekend': 'Weekends and public holidays are off-peak all day',
+      'tip.holidayToday': 'Today: public holiday, off-peak all day',
+      'tip.weekendToday': 'Today: weekend, off-peak all day',
+      'tip.tomorrowHoliday': 'Tomorrow: public holiday, off-peak all day',
+      'tip.tomorrowWeekend': 'Tomorrow: weekend, off-peak all day',
+      'tip.tomorrowWorkday': 'Tomorrow: weekday, peak windows apply again',
+      'tip.phase': 'This block: ',
+      'tip.next': 'Switch in ',
+      'tip.prices': 'Price (CNY / million tokens, off-peak → peak)',
+      'tip.flash': 'deepseek-flash: cache hit 0.02 → 0.04 | miss 1 → 2 | output 4 → 8',
+      'tip.pro': 'deepseek-v4-pro: cache hit 0.15 → 0.30 | miss 4.5 → 9.0 | output 13.5 → 27.0',
+      'tip.table': 'Holiday table covers {years} (Mid-Autumn, National Day); updated per release',
+      'tip.tz': 'Evaluated in Beijing time (UTC+8)',
+      'tip.hint': 'Click to copy the current state',
+      'copy.ok': 'Copied',
+      'copy.fail': 'Copy failed',
+      'copy.suffix': '(Beijing time)',
+    };
+
+    let translate = (key) => (EN[key] !== undefined ? EN[key] : key);
+
+    function PeakBadge(props) {
+      const t = translate;
+      const [now, setNow] = React.useState(() => Date.now());
+      const [toast, setToast] = React.useState('');
+
+      React.useEffect(() => {
+        const id = setInterval(() => setNow(Date.now()), 15000);
+        return () => clearInterval(id);
+      }, []);
+
+      const st = stateAt(now);
+      const phase = phaseOf(now);
+      const schedule = daySchedule(now);
+      const off = !st.peak;
+      const wide = !props || props.wide !== false;
+      const stateText = off ? t('status.off') : t('status.peak');
+      const title = tooltip(t, st, phase, now);
+      const soon =
+        phase.end !== null && phase.end - now <= SOON_MINUTES * MINUTE;
+      const rootClass =
+        'dshph-root ' +
+        (off ? 'dshph-off' : 'dshph-peak') +
+        (soon ? ' dshph-soon' : '');
+      const cursorLeft = pct(st.beijing.minute);
+      const remaining = phase.end
+        ? fmtDuration(phase.end - now, t) + (off ? t('next.peak') : t('next.off'))
+        : '';
+
+      const onCopy = () => {
+        const text = copySummary(t, st, phase, now);
+        let result;
+        try {
+          result = writeClipboard(text);
+        } catch {
+          result = Promise.resolve(false);
+        }
+        Promise.resolve(result)
+          .then((ok) => setToast(ok ? t('copy.ok') : t('copy.fail')))
+          .catch(() => setToast(t('copy.fail')));
+        setTimeout(() => setToast(''), 1500);
+      };
+
+      const onKeyDown = (event) => {
+        if (event.key === 'Enter' || event.key === ' ' || event.key === 'Spacebar') {
+          event.preventDefault();
+          onCopy();
+        }
+      };
+
+      const headText = toast
+        ? h('span', { className: 'dshph-next dshph-toast' }, toast)
+        : h('span', { className: 'dshph-next' }, remaining);
+
+      const track = h(
+        'div',
+        { className: 'dshph-track' },
+        ...schedule.map((seg, i) =>
+          h('span', {
+            key: 'seg' + i,
+            className:
+              'dshph-seg ' + (seg.peak ? 'dshph-seg-peak' : 'dshph-seg-off'),
+            style: { left: pct(seg.from), width: pct(seg.to - seg.from) },
+          }),
+        ),
+        h('span', { key: 'cursor', className: 'dshph-cursor', style: { left: cursorLeft } }),
+      );
+
+      const common = {
+        title,
+        role: 'button',
+        tabIndex: 0,
+        onClick: onCopy,
+        onKeyDown,
+        'aria-label':
+          t('label') + ': ' + stateText + ', ' + remaining + '. ' + t('tip.hint'),
+      };
+
+      if (!wide) {
+        return h(
+          'div',
+          { ...common, className: rootClass + ' dshph-rail' },
+          h('span', {
+            className: 'dshph-dot' + (soon ? ' dshph-dot-soon' : ''),
+          }),
+          track,
+        );
+      }
+
+      return h(
+        'div',
+        { ...common, className: rootClass },
+        h(
+          'div',
+          { className: 'dshph-head' },
+          h('span', {
+            className: 'dshph-dot' + (soon ? ' dshph-dot-soon' : ''),
+          }),
+          h('span', { className: 'dshph-label' }, stateText),
+          h(
+            'span',
+            { className: 'dshph-pill' },
+            off ? t('price.discount') : t('price.multiplier'),
+          ),
+          h('span', { className: 'dshph-spacer' }),
+          headText,
+        ),
+        track,
+      );
+    }
+
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        ctx.effect(ensureStyle, 'dsh-peak-hours-style');
+
+        // 语言包晚到也不影响：locale 可用时立刻补注册并接管文案。
+        ctx.inject(['locale'], (c) => {
+          if (!c.locale || typeof c.locale.register !== 'function') return;
+          try {
+            c.locale.register(NS, { zh: ZH, en: EN });
+          } catch {
+            /* 已注册过（例如热重载），沿用现有字典 */
+          }
+          try {
+            const bound = c.locale.bind(NS);
+            if (typeof bound === 'function') translate = bound;
+          } catch {
+            /* 保留内置兜底 */
+          }
+        });
+
+        ctx.slots.inject('sidebar.footer.action', () =>
+          ctx.slots.register(
+            {
+              name: 'sidebar.footer.action',
+              id: 'dsh-peak-hours',
+              key: 'dsh-peak-hours',
+              order: 20,
+              locale: NS,
+              label: () => translate('label'),
+            },
+            PeakBadge,
+          ),
+        );
+      },
+    };
+  },
+});

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-peak-hours
+      name: 'dsh-peak-hours'

package/icon.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Peak hours badge">
+  <defs>
+    <linearGradient id="dshphRing" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#f2a03d"/>
+      <stop offset="1" stop-color="#d9534f"/>
+    </linearGradient>
+  </defs>
+  <rect x="2" y="2" width="60" height="60" rx="15" fill="#14181f"/>
+  <circle cx="32" cy="32" r="17" fill="none" stroke="url(#dshphRing)" stroke-width="3.6"/>
+  <path d="M32 21.5V32l7.4 5.2" fill="none" stroke="url(#dshphRing)" stroke-width="3.6" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="32" cy="14.5" r="2.4" fill="#f2a03d"/>
+</svg>

package/index.js

@@ -0,0 +1,8 @@
+/**
+ * Host half of the peak-hours badge.
+ *
+ * The visible UI is a Client module (`./client`), which the Web runtime loads on
+ * its own. The Host entry exists so the bundle has a valid plugin row; it needs
+ * no services, tools or config.
+ */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Peak Hours Badge",
+    "description": "Shows in the sidebar whether DeepSeek API pricing is currently in peak hours, with a countdown to the next switch."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "峰谷时段徽标",
+    "description": "在侧栏标注当前是否处于 DeepSeek 高峰计费时段，并倒计时下一个切换点。"
+  }
+}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "dsh-peak-hours",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.11.0",
+  "type": "module",
+  "description": "Sidebar badge that marks the current DeepSeek peak-pricing window: 24-hour schedule bar, now-cursor, countdown to the next switch, click to copy the state.",
+  "license": "MIT",
+  "author": "run666888 <zhirunli6@gmail.com>",
+  "homepage": "https://github.com/run666888/dsh-peak-hours#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/run666888/dsh-peak-hours.git"
+  },
+  "bugs": {
+    "url": "https://github.com/run666888/dsh-peak-hours/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test",
+    "verify": "npm pack --dry-run"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "peak-hours",
+    "off-peak",
+    "pricing",
+    "sidebar"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "assets",
+    "screenshots",
+    "screenshots.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ]
+    }
+  }
+}

package/screenshots.json

@@ -0,0 +1,3 @@
+[
+  "screenshots/screenshot-1.png"
+]