dsh-peak-checker 0.1.0 → 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

@@ -0,0 +1,57 @@
+# dsh-peak-checker
+
+在 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

@@ -1,6 +1,6 @@
-- op: add
-  path: /-
-  value:
-    id: dsh-peak-checker
-    name: dsh-peak-checker
-    config: {}
+# 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

@@ -1,9 +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(ctx) {
-    ctx.effect(() => {
-        console.log('[dsh-peak-indicator] host half loaded');
-        return () => {
-            console.log('[dsh-peak-indicator] host half unloaded');
-        };
-    });
+export function apply() {
+    // Nothing to do on the host plane.
 }

package/lib/peak.js

@@ -1,13 +1,17 @@
+/** 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 utcMs = date.getTime() + date.getTimezoneOffset() * 60_000;
-    const bj = new Date(utcMs + 8 * 3_600_000);
-    const day = bj.getDay(); // 0=周日, 1=周一, ..., 6=周六
-    const minutes = bj.getHours() * 60 + bj.getMinutes();
+    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';

package/lib/types/index.d.ts

@@ -1,3 +1,2 @@
-import type { Context } from '@deepseek-ai/cordis';
 export declare const name = "dsh-peak-checker";
-export declare function apply(ctx: Context): void;
+export declare function apply(): void;

package/lib/types/peak.d.ts

@@ -3,6 +3,9 @@ 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 直接用：是否高峰 */

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,46 +1,61 @@
-{
-    "name": "dsh-peak-checker",
-    "version": "0.1.0",
-    "description": "在 DSH 输入框工具行显示当前是否处于 DeepSeek API 高峰时段",
-    "type": "module",
-    "main": "lib/index.js",
-    "types": "lib/types/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./lib/types/index.d.ts",
-            "default": "./lib/index.js"
-        },
-        "./client": {
-            "types": "./lib/types/client/index.d.ts",
-            "default": "./lib/client/index.js"
-        },
-        "./package.json": "./package.json"
-    },
-    "files": [
-        "lib",
-        "cordis.patch.yml"
-    ],
-    "scripts": {
-        "build": "tsc -p tsconfig.json && node -e \"require('fs').copyFileSync('src/client/styles.css','lib/client/styles.css')\"",
-        "typecheck": "tsc --noEmit",
-        "test": "vitest run"
-    },
-    "peerDependencies": {
-        "@deepseek-ai/cordis": "*"
-    },
-    "devDependencies": {
-        "@deepseek-ai/cordis": "latest",
-        "@types/react": "^18.3.0",
-        "@types/node": "^22.0.0",
-        "typescript": "^5.7.0",
-        "vitest": "^3.0.0"
-    },
-    "dsh": {
-        "bundle": {
-            "patch": "./cordis.patch.yml"
-        },
-        "client": {
-            "platform": "web"
-        }
-    }
-}
+{
+    "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"
+            ]
+        }
+    }
+}

package/lib/client/index.js

@@ -1,24 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { getPeakState } from "../peak.js";
-import { badgeStyle } from "./styles.js";
-export const name = 'dsh-peak-checker-client';
-export const inject = ['slots'];
-export function apply(ctx) {
-    const slots = ctx.slots;
-    if (!slots)
-        return;
-    slots.inject('conversation.input.left', () => {
-        slots.register({
-            name: 'conversation.input.left',
-            id: 'dsh-peak-indicator',
-            order: 30,
-        }, PeakIndicator);
-    });
-}
-function PeakIndicator() {
-    const state = getPeakState();
-    const isPeak = state === 'peak';
-    return (_jsxs("span", { title: isPeak
-            ? '当前为 DeepSeek API 高峰时段（北京时间周一至周五 09:00–12:00、14:00–18:00）'
-            : '当前为 DeepSeek API 空闲时段', style: badgeStyle(isPeak), children: [_jsx("span", { style: { fontSize: 8, lineHeight: 1 }, children: "\u25CF" }), isPeak ? '高峰' : '空闲'] }));
-}

package/lib/client/styles.css

@@ -1,25 +0,0 @@
-.dsh-peak-indicator {
-  display: inline-flex;
-  align-items: center;
-  gap: 4px;
-  padding: 2px 8px;
-  border-radius: 999px;
-  font-size: 11px;
-  font-weight: 500;
-  line-height: 18px;
-  white-space: nowrap;
-  user-select: none;
-  cursor: default;
-}
-
-.dsh-peak-indicator--peak {
-  color: var(--dsh-color-warning, #b45309);
-  background: rgba(234, 179, 8, 0.12);
-  border: 1px solid rgba(234, 179, 8, 0.35);
-}
-
-.dsh-peak-indicator--off-peak {
-  color: var(--dsh-color-success, #15803d);
-  background: rgba(34, 197, 94, 0.12);
-  border: 1px solid rgba(34, 197, 94, 0.35);
-}

package/lib/client/styles.js

@@ -1,18 +0,0 @@
-export 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)'}`,
-    };
-}

package/lib/clients/index.js

@@ -1 +0,0 @@
-export * from "../client/index.js";

package/lib/clients/styles.js

@@ -1 +0,0 @@
-export { badgeStyle } from "../client/styles.js";

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

@@ -1,4 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "dsh-peak-checker-client";
-export declare const inject: readonly ["slots"];
-export declare function apply(ctx: Context): void;

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

@@ -1,2 +0,0 @@
-import type { CSSProperties } from 'react';
-export declare function badgeStyle(isPeak: boolean): CSSProperties;

package/lib/types/clients/index.d.ts

@@ -1 +0,0 @@
-export * from '../client/index.tsx';

package/lib/types/clients/styles.d.ts

@@ -1 +0,0 @@
-export { badgeStyle } from '../client/styles.ts';