dsh-deepseek-peak-clock 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 esketids
+
+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,79 @@
-# Temporary Holding Version
+# dsh-deepseek-peak-clock
 
-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.
+A [DeepSeek Harness](https://github.com/deepseek-ai) plugin that shows whether the DeepSeek API is
+in its **peak** or **off-peak** billing window — right in the composer HUD row, next to turns,
+tok/s and cache hit rate.
+
+```
+● Off-peak · ends in 1h 22m      green dot, half price
+● Peak · ends in 2h 04m          amber dot, full price
+```
+
+The countdown ticks every second. Hovering the cell shows the window end in your local time and the
+current per-1M-token rates:
+
+```
+Peak · input / cached input / output · until 12:00
+Flash $0.30 / $0.006 / $1.20 · Pro $1.32 / $0.044 / $3.96 · per 1M tokens
+```
+
+## Schedule
+
+Peak windows are **01:00–04:00** and **06:00–10:00 UTC**, everything else is off-peak at half price.
+Since 2026-08-22 16:00 UTC the split only applies Monday–Friday Beijing time; Saturdays, Sundays and
+Chinese public holidays are off-peak all day.
+
+The rules are a port of the logic behind [deepakness.com/deepseek](https://deepakness.com/deepseek/)
+and its [price clock extension](https://github.com/deepakness/deepseek-price-clock), which in turn
+follow the [official DeepSeek pricing page](https://api-docs.deepseek.com/quick_start/pricing).
+
+## Install
+
+This is a Harness bundle: a package whose `cordis.patch.yml` inserts one Loader row.
+
+1. Clone the repo somewhere stable (the profile links to the directory, so do not delete it).
+2. Install it into your profile with the plugin manager, pointing at the checkout directory:
+
+   ```
+   plugin_manager install_bundle /absolute/path/to/dsh-deepseek-peak-clock
+   ```
+
+   Or add it by hand to your profile's Cordis composition:
+
+   ```yaml
+   - insert:
+       - id: deepseek-peak-clock
+         name: dsh-deepseek-peak-clock
+   ```
+
+3. Refresh the Web GUI. The cell appears under the composer; it is session-scoped, so open a
+   session to see it.
+
+The Host half is a no-op: the schedule is pure UTC arithmetic, so the clock renders entirely in the
+browser and works offline.
+
+## Configuration
+
+None. The plugin adds one locale namespace, one HUD cell and nothing else.
+
+## Maintenance
+
+`CN_HOLIDAYS` in `client.js` lists Chinese public holidays that DeepSeek bills off-peak all day.
+The State Council publishes the next year's arrangement around November, so add those dates when
+they are announced. Everything else (windows, weekend rule) only changes when DeepSeek changes its
+pricing, which this plugin does not detect automatically — compare with the pricing page
+occasionally.
+
+## Layout
+
+| File | Purpose |
+| --- | --- |
+| `index.js` | Host half (empty `apply`; no services, no network) |
+| `client.js` | Schedule port + the HUD cell component |
+| `cordis.patch.yml` | Loader row that activates the bundle |
+| `locale/en.json`, `locale/zh.json` | Plugin title and description for the Plugins page |
+| `icon.svg` | Half-green/half-red clock icon |
+
+## License
+
+MIT. The schedule logic derives from DeepakNess's price clock; see the license file.

package/client.js

@@ -0,0 +1,278 @@
+/**
+ * DeepSeek peak/off-peak clock, rendered in the HUD row under the composer.
+ *
+ * Schedule logic is a port of deepakness.com/deepseek and
+ * github.com/deepakness/deepseek-price-clock `price.js` — keep SWITCH_MINUTES,
+ * WEEKEND_RULE_START and CN_HOLIDAYS in sync with the site.
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-deepseek-peak-clock',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+
+    const NS = 'deepseek-peak-clock';
+    const SLOT = 'conversation.composer.dock';
+    const CELL_ID = 'deepseek-peak-clock';
+
+    // --- schedule ---------------------------------------------------------
+
+    // Peak window switch instants in UTC minutes-of-day: 01:00 and 06:00 open
+    // a peak window, 04:00 and 10:00 close one. Everything else is off-peak.
+    const SWITCH_MINUTES = [60, 240, 360, 600];
+
+    // Since 00:00 Beijing time on Sunday August 23, 2026 (16:00 UTC Saturday
+    // August 22) the split only applies Monday to Friday Beijing time.
+    const WEEKEND_RULE_START = Date.UTC(2026, 7, 22, 16);
+
+    // Chinese public holidays as Beijing dates; DeepSeek bills them off-peak
+    // all day. Add the next year's dates once the State Council announces them.
+    const CN_HOLIDAYS = [
+      ['2026-09-25', '2026-09-27'], // Mid-Autumn
+      ['2026-10-01', '2026-10-07'], // National Day
+    ];
+
+    function isBeijingWeekend(date) {
+      const day = new Date(date.getTime() + 8 * 3600000).getUTCDay();
+      return day === 0 || day === 6;
+    }
+
+    function beijingDateKey(date) {
+      return new Date(date.getTime() + 8 * 3600000).toISOString().slice(0, 10);
+    }
+
+    function isBeijingHoliday(date) {
+      const key = beijingDateKey(date);
+      for (const [from, to] of CN_HOLIDAYS) {
+        if (key >= from && key <= to) return true;
+      }
+      return false;
+    }
+
+    // A Saturday, Sunday or public holiday under the current rules is off-peak
+    // all day.
+    function offPeakAllDay(date) {
+      return (
+        date.getTime() >= WEEKEND_RULE_START &&
+        (isBeijingWeekend(date) || isBeijingHoliday(date))
+      );
+    }
+
+    function kindAtInstant(date) {
+      if (offPeakAllDay(date)) return 'off';
+      const minuteOfDay = date.getUTCHours() * 60 + date.getUTCMinutes();
+      return (minuteOfDay >= 60 && minuteOfDay < 240) ||
+        (minuteOfDay >= 360 && minuteOfDay < 600)
+        ? 'peak'
+        : 'off';
+    }
+
+    function isSwitchInstant(date) {
+      const minuteOfDay = date.getUTCHours() * 60 + date.getUTCMinutes();
+      for (const m of SWITCH_MINUTES) {
+        if (minuteOfDay === m) return !offPeakAllDay(date);
+      }
+      return false;
+    }
+
+    function nextSwitch(now) {
+      const dayStart = Date.UTC(
+        now.getUTCFullYear(),
+        now.getUTCMonth(),
+        now.getUTCDate(),
+      );
+      let day = 0;
+      let index = 0;
+      // Bounded scan: a gated weekend/holiday stretch never exceeds a few days.
+      for (let guard = 0; guard < 4000; guard++) {
+        const instant =
+          dayStart + day * 86400000 + SWITCH_MINUTES[index] * 60000;
+        const candidate = new Date(instant);
+        if (instant > now.getTime() && isSwitchInstant(candidate)) {
+          return { date: candidate, kind: kindAtInstant(candidate) };
+        }
+        index++;
+        if (index >= SWITCH_MINUTES.length) {
+          index = 0;
+          day++;
+        }
+      }
+      return null;
+    }
+
+    // --- formatting -------------------------------------------------------
+
+    function formatDuration(ms) {
+      const total = Math.max(0, Math.round(ms / 1000));
+      const hours = Math.floor(total / 3600);
+      const minutes = Math.floor((total % 3600) / 60);
+      const seconds = total % 60;
+      if (hours > 0) {
+        return hours + 'h ' + String(minutes).padStart(2, '0') + 'm';
+      }
+      if (minutes > 0) {
+        return minutes + 'm ' + String(seconds).padStart(2, '0') + 's';
+      }
+      return seconds + 's';
+    }
+
+    function formatLocalTime(date) {
+      try {
+        return date.toLocaleTimeString([], {
+          hour: '2-digit',
+          minute: '2-digit',
+        });
+      } catch {
+        return date.getUTCHours() + ':00';
+      }
+    }
+
+    // Rates per 1M tokens, from deepakness.com/deepseek (off-peak is half price).
+    const RATES = {
+      off: {
+        flash: ['$0.15', '$0.003', '$0.60'],
+        pro: ['$0.66', '$0.022', '$1.98'],
+      },
+      peak: {
+        flash: ['$0.30', '$0.006', '$1.20'],
+        pro: ['$1.32', '$0.044', '$3.96'],
+      },
+    };
+
+    function rateLine(kind, t) {
+      const table = RATES[kind];
+      return (
+        'Flash ' +
+        table.flash.join(' / ') +
+        ' · Pro ' +
+        table.pro.join(' / ') +
+        ' · ' +
+        t('perMillion')
+      );
+    }
+
+    // --- dictionaries -----------------------------------------------------
+
+    const DICTS = {
+      en: {
+        offPeak: 'Off-peak',
+        peak: 'Peak',
+        endsIn: 'ends in',
+        endsAt: 'next window',
+        until: 'until',
+        prices: 'input / cached input / output',
+        perMillion: 'per 1M tokens',
+        aria: 'DeepSeek API price window',
+      },
+      zh: {
+        offPeak: '低谷',
+        peak: '高峰',
+        endsIn: '剩余',
+        endsAt: '下次切换',
+        until: '截至',
+        prices: '输入 / 缓存输入 / 输出',
+        perMillion: '每百万 tokens',
+        aria: 'DeepSeek API 峰谷计费时段',
+      },
+    };
+
+    // --- component --------------------------------------------------------
+
+    function useTicker(periodMs) {
+      const [now, setNow] = React.useState(() => new Date());
+      React.useEffect(() => {
+        const id = setInterval(() => setNow(new Date()), periodMs);
+        return () => clearInterval(id);
+      }, [periodMs]);
+      return now;
+    }
+
+    function Clock(props) {
+      const t = props.t;
+      const now = useTicker(1000);
+      const next = nextSwitch(now);
+      const kind = kindAtInstant(now);
+      const offPeak = kind === 'off';
+
+      if (!next) return null;
+
+      const label = t(offPeak ? 'offPeak' : 'peak');
+      const remaining = formatDuration(next.date.getTime() - now.getTime());
+      const flip = formatLocalTime(next.date);
+      const accent = offPeak
+        ? 'var(--dsw-alias-state-success-primary)'
+        : 'var(--dsw-alias-state-warn-primary)';
+
+      const title =
+        label +
+        ' · ' +
+        t('prices') +
+        ' · ' +
+        t('until') +
+        ' ' +
+        flip +
+        '\n' +
+        rateLine(kind, t);
+
+      return h(
+        'span',
+        {
+          title,
+          'aria-label': t('aria') + ': ' + label + ' ' + remaining,
+          style: {
+            display: 'inline-flex',
+            alignItems: 'center',
+            gap: '6px',
+            fontSize: '11px',
+            lineHeight: 1.4,
+            whiteSpace: 'nowrap',
+            userSelect: 'none',
+            color: 'var(--dsw-alias-label-secondary)',
+            fontVariantNumeric: 'tabular-nums',
+          },
+        },
+        h('span', {
+          'aria-hidden': true,
+          style: {
+            width: '6px',
+            height: '6px',
+            borderRadius: '50%',
+            flex: '0 0 auto',
+            background: accent,
+            boxShadow: '0 0 0 3px color-mix(in srgb, ' + accent + ' 18%, transparent)',
+          },
+        }),
+        h(
+          'span',
+          { style: { color: 'var(--dsw-alias-label-primary)' } },
+          label,
+        ),
+        h('span', { 'aria-hidden': true, opacity: 0.5 }, '·'),
+        h('span', null, t('endsIn') + ' ' + remaining),
+      );
+    }
+
+    return {
+      inject: ['slots', 'locale'],
+      apply(ctx) {
+        ctx.effect(() => {
+          const disposers = [];
+          for (const [locale, dict] of Object.entries(DICTS)) {
+            disposers.push(ctx.locale.register(NS, locale, dict));
+          }
+          return () => {
+            for (const dispose of disposers) dispose();
+          };
+        });
+
+        const t = ctx.locale.bind(NS);
+
+        ctx.slots.inject(SLOT, () =>
+          ctx.slots.register({ name: SLOT, id: CELL_ID, order: 2 }, () =>
+            h(Clock, { t }),
+          ),
+        );
+      },
+    };
+  },
+});

package/cordis.patch.yml

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

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <circle cx="32" cy="32" r="26" fill="#16a34a"/>
+  <path d="M32 6 A26 26 0 0 1 32 58 Z" fill="#dc2626"/>
+  <circle cx="32" cy="32" r="26" fill="none" stroke="#0f172a" stroke-opacity="0.22" stroke-width="2"/>
+  <path d="M32 17 V32 L42 39" fill="none" stroke="#ffffff" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/index.js

@@ -0,0 +1,7 @@
+/**
+ * Host half of the DeepSeek peak/off-peak clock bundle.
+ *
+ * The schedule is a pure function of UTC time, so nothing runs on the Host:
+ * the Client module renders the clock in the composer HUD on its own.
+ */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DeepSeek Peak Clock",
+    "description": "Shows whether DeepSeek API billing is in the peak or off-peak window, with a live countdown to the next price flip, in the row under the composer."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DeepSeek 峰谷电价时钟",
+    "description": "在输入框下方的状态行显示 DeepSeek API 当前处于高峰还是低谷计费时段，并实时倒计时到下一次价格切换。"
+  }
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "dsh-deepseek-peak-clock",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "type": "module",
+  "description": "DeepSeek peak/off-peak price clock for the DeepSeek Harness composer HUD.",
+  "license": "MIT",
+  "author": "esketids",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "pricing",
+    "hud"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/esketids/dsh-deepseek-peak-clock.git"
+  },
+  "homepage": "https://github.com/esketids/dsh-deepseek-peak-clock#readme",
+  "bugs": {
+    "url": "https://github.com/esketids/dsh-deepseek-peak-clock/issues"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": { "patch": "./cordis.patch.yml" },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": ["@deepseek-ai/dsh-client-ui-conversation"]
+    }
+  }
+}