dsh-peak-checker 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The dsh-peak-checker authors
+
+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,57 @@
-# Temporary Holding Version
+# dsh-peak-checker
 
-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.
+在 DSH（DeepSeek Harness）输入框工具行显示当前是否处于 **DeepSeek API 高峰时段**。
+
+Shows whether the DeepSeek API is currently in **peak hours** as a small badge in the DSH composer toolbar.
+
+## 高峰时段 / Peak windows
+
+按北京时间（UTC+8）判断，其余时间均为空闲：/ Evaluated in Beijing time (UTC+8); everything else is off-peak.
+
+| 时段 / Window | 是否高峰 / Peak |
+| --- | --- |
+| 周一至周五 09:00–12:00 / Mon–Fri 09:00–12:00 | 高峰 / peak |
+| 周一至周五 14:00–18:00 / Mon–Fri 14:00–18:00 | 高峰 / peak |
+| 周末全天 / weekends, all day | 空闲 / off-peak |
+| 其他时间 / any other time | 空闲 / off-peak |
+
+徽标每 30 秒自动刷新，跨过高/低峰边界时无需刷新页面。/ The badge re-evaluates every 30 seconds, so it crosses peak boundaries without a page reload.
+
+## 安装 / Install
+
+把本包加入 DSH profile 的依赖并在 `dsh.profile.bundles` 中启用，然后重启 DSH web：
+
+```jsonc
+// ~/.dsh/profiles/web/package.json
+{
+  "dependencies": { "dsh-peak-checker": "^0.1.1" },
+  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-peak-checker"] } }
+}
+```
+
+插件随 bundle 的 `dsh.bundle.patch` 自动插入 Loader 行，无需修改 `cordis.patch.yml` 以外的配置。
+The bundle patch inserts the Loader row automatically.
+
+## 包结构 / What is inside
+
+| 路径 / Path | 作用 / Role |
+| --- | --- |
+| `lib/index.js` | 宿主半：仅作为 Loader 行存在 / host half (Loader row only) |
+| `lib/client.js` | 浏览器半：DSH 客户端插件 bundle / browser half, a `window.__ModuleLoader__` bundle |
+| `lib/peak.js` | 高峰时段判断逻辑 / peak-window logic |
+| `cordis.patch.yml` | 插入 Loader 行的 bundle patch / bundle patch inserting the Loader row |
+
+`lib/client.js` 由 `scripts/build-client.mjs` 用 esbuild 生成：把 `src/client/index.tsx` 打成 lazy-CJS，再由 `window.__ModuleLoader__.load({ id, factory })` 注册；`react` 作为 DSH 客户端基线模块保持 external。
+The client bundle is built with esbuild into the lazy-CJS factory form DSH's module loader expects, with React left external.
+
+## 开发 / Development
+
+```bash
+npm run build      # tsc (host half + types) + esbuild (client bundle)
+npm run typecheck  # host and client type checks
+npm test           # unit tests, including a simulated DSH module loader
+```
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-peak-checker bundle patch.
+# The bundle inserts its own Loader row; the client half is discovered from that
+# row's `dsh.client` declaration and served to the browser as a plugin bundle.
+- insert:
+    - id: dsh-peak-checker
+      name: dsh-peak-checker

package/lib/client.js

@@ -0,0 +1,107 @@
+/* dsh-peak-checker client half — generated by scripts/build-client.mjs; do not edit. */
+window.__ModuleLoader__.load({id:"dsh-peak-checker",factory:require=>{var module={exports:{}};var exports=module.exports;
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.tsx
+var index_exports = {};
+__export(index_exports, {
+  apply: () => apply,
+  inject: () => inject
+});
+module.exports = __toCommonJS(index_exports);
+var React = __toESM(require("react"), 1);
+
+// src/peak.ts
+var BEIJING_OFFSET_MS = 8 * 36e5;
+function getPeakState(date = /* @__PURE__ */ new Date()) {
+  const bj = new Date(date.getTime() + BEIJING_OFFSET_MS);
+  const day = bj.getUTCDay();
+  const minutes = bj.getUTCHours() * 60 + bj.getUTCMinutes();
+  const isWeekday = day >= 1 && day <= 5;
+  if (!isWeekday) return "off-peak";
+  const inMorningPeak = minutes >= 9 * 60 && minutes < 12 * 60;
+  const inAfternoonPeak = minutes >= 14 * 60 && minutes < 18 * 60;
+  return inMorningPeak || inAfternoonPeak ? "peak" : "off-peak";
+}
+
+// src/client/styles.ts
+function badgeStyle(isPeak) {
+  return {
+    display: "inline-flex",
+    alignItems: "center",
+    gap: 4,
+    padding: "2px 8px",
+    borderRadius: 999,
+    fontSize: 11,
+    fontWeight: 500,
+    lineHeight: "18px",
+    whiteSpace: "nowrap",
+    userSelect: "none",
+    cursor: "default",
+    color: isPeak ? "var(--dsh-color-warning, #b45309)" : "var(--dsh-color-success, #15803d)",
+    background: isPeak ? "rgba(234, 179, 8, 0.12)" : "rgba(34, 197, 94, 0.12)",
+    border: `1px solid ${isPeak ? "rgba(234, 179, 8, 0.35)" : "rgba(34, 197, 94, 0.35)"}`
+  };
+}
+
+// src/client/index.tsx
+var inject = ["slots"];
+var SLOT_NAME = "conversation.input.left";
+var REFRESH_MS = 3e4;
+function apply(ctx) {
+  ctx.slots.inject(
+    SLOT_NAME,
+    () => ctx.slots.register(
+      { name: SLOT_NAME, id: "dsh-peak-checker", order: 30 },
+      PeakIndicator
+    )
+  );
+}
+function PeakIndicator() {
+  const [state, setState] = React.useState(getPeakState);
+  React.useEffect(() => {
+    setState(getPeakState());
+    const timer = window.setInterval(() => setState(getPeakState()), REFRESH_MS);
+    return () => window.clearInterval(timer);
+  }, []);
+  const isPeak = state === "peak";
+  return /* @__PURE__ */ React.createElement(
+    "span",
+    {
+      "data-dsh-peak-state": state,
+      title: isPeak ? "\u5F53\u524D\u4E3A DeepSeek API \u9AD8\u5CF0\u65F6\u6BB5\uFF08\u5317\u4EAC\u65F6\u95F4\u5468\u4E00\u81F3\u5468\u4E94 09:00\u201312:00\u300114:00\u201318:00\uFF09" : "\u5F53\u524D\u4E3A DeepSeek API \u7A7A\u95F2\u65F6\u6BB5",
+      style: badgeStyle(isPeak)
+    },
+    /* @__PURE__ */ React.createElement("span", { style: { fontSize: 8, lineHeight: 1 } }, "\u25CF"),
+    isPeak ? "\u9AD8\u5CF0" : "\u7A7A\u95F2"
+  );
+}
+
+return module.exports}})

package/lib/index.js

@@ -0,0 +1,9 @@
+// src/index.ts
+//
+// Host half. This plugin only contributes browser UI, so the host half exists
+// solely as the Loader row that the client module system scans for a
+// `dsh.client` declaration. It intentionally has no host-plane behavior.
+export const name = 'dsh-peak-checker';
+export function apply() {
+    // Nothing to do on the host plane.
+}

package/lib/peak.js

@@ -0,0 +1,25 @@
+/** Beijing time offset from UTC, in milliseconds. */
+const BEIJING_OFFSET_MS = 8 * 3_600_000;
+/**
+ * 按北京时间 (UTC+8) 判断当前是否处于 DeepSeek API 高峰时段。
+ * 高峰：周一至周五 09:00–12:00、14:00–18:00
+ * 空闲：其余时间（含周末全天）
+ *
+ * 实现说明：先把时刻平移到北京时间，再用 UTC getter 读取，因此结果与
+ * 运行机器的本地时区、夏令时规则完全无关。
+ */
+export function getPeakState(date = new Date()) {
+    const bj = new Date(date.getTime() + BEIJING_OFFSET_MS);
+    const day = bj.getUTCDay(); // 0=周日, 1=周一, ..., 6=周六
+    const minutes = bj.getUTCHours() * 60 + bj.getUTCMinutes();
+    const isWeekday = day >= 1 && day <= 5;
+    if (!isWeekday)
+        return 'off-peak';
+    const inMorningPeak = minutes >= 9 * 60 && minutes < 12 * 60;
+    const inAfternoonPeak = minutes >= 14 * 60 && minutes < 18 * 60;
+    return inMorningPeak || inAfternoonPeak ? 'peak' : 'off-peak';
+}
+/** 供 UI 直接用：是否高峰 */
+export function isPeakNow(date = new Date()) {
+    return getPeakState(date) === 'peak';
+}

package/lib/types/index.d.ts

@@ -0,0 +1,2 @@
+export declare const name = "dsh-peak-checker";
+export declare function apply(): void;

package/lib/types/peak.d.ts

@@ -0,0 +1,12 @@
+export type PeakState = 'peak' | 'off-peak';
+/**
+ * 按北京时间 (UTC+8) 判断当前是否处于 DeepSeek API 高峰时段。
+ * 高峰：周一至周五 09:00–12:00、14:00–18:00
+ * 空闲：其余时间（含周末全天）
+ *
+ * 实现说明：先把时刻平移到北京时间，再用 UTC getter 读取，因此结果与
+ * 运行机器的本地时区、夏令时规则完全无关。
+ */
+export declare function getPeakState(date?: Date): PeakState;
+/** 供 UI 直接用：是否高峰 */
+export declare function isPeakNow(date?: Date): boolean;

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+    "meta": {
+        "title": "Peak Checker",
+        "description": "Shows whether the DeepSeek API is currently in peak hours (Beijing time, weekdays)."
+    }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+    "meta": {
+        "title": "高峰时段检查器",
+        "description": "在输入框工具行显示当前是否处于 DeepSeek API 高峰时段（北京时间工作日）。"
+    }
+}

package/package.json

@@ -1,6 +1,61 @@
 {
-  "name": "dsh-peak-checker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "dsh-peak-checker",
+    "version": "0.1.1",
+    "description": "在 DSH 输入框工具行显示当前是否处于 DeepSeek API 高峰时段",
+    "type": "module",
+    "license": "MIT",
+    "main": "lib/index.js",
+    "types": "lib/types/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./lib/types/index.d.ts",
+            "default": "./lib/index.js"
+        },
+        "./client": {
+            "default": "./lib/client.js"
+        },
+        "./locale/*.json": "./locale/*.json",
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "lib",
+        "cordis.patch.yml",
+        "locale",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.json && node scripts/build-client.mjs",
+        "typecheck": "tsc -p tsconfig.client.json && tsc -p tsconfig.json --noEmit",
+        "test": "vitest run",
+        "prepack": "npm run build"
+    },
+    "keywords": [
+        "dsh-plugin",
+        "deepseek-harness",
+        "dsh",
+        "deepseek",
+        "peak-hours"
+    ],
+    "engines": {
+        "node": "^22.19.0 || >=24.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "@types/react": "^18.3.0",
+        "esbuild": "^0.28.0",
+        "typescript": "^5.7.0",
+        "vitest": "^3.0.0"
+    },
+    "dsh": {
+        "bundle": {
+            "patch": "./cordis.patch.yml"
+        },
+        "client": {
+            "platform": "web",
+            "immediately": true,
+            "inject": [
+                "@deepseek-ai/dsh-client-ui-conversation"
+            ]
+        }
+    }
+}