lco117

dsh-peak-hours

Name: dsh-peak-hours
Author: lco117

A DeepSeek Harness plugin that displays a peak-hours status badge in the session header.

Stars: 2
Language: JavaScript
Created: Aug 16, 2026
Updated: Aug 16, 2026

Web UI

GitHub repo

Introduction

dsh-peak-hours

DeepSeek Harness 插件：在会话顶栏（对话区域顶部）显示「高峰时段」状态徽章。插件获取当前系统时间，转换为北京时间（UTC+8），当时间落在 09:00–12:00 或 14:00–18:00 时显示 🔴 高峰时段，否则显示 🟢 非高峰时段，旁边附带当前北京时间。

界面预览 · 功能 · 工作原理 · 安装 · 使用 · 开发 · 开源发布 · Star History

界面预览

高峰时段（🔴）	非高峰时段（🟢）

功能

会话顶栏徽章：位于对话区域顶部，与其它会话工具项排在一起，并排在「会话日志下载」的左边。
始终北京时间：把绝对时间戳直接平移 UTC+8（无夏令时）再判断，无论机器在哪个时区，状态都正确。
两个高峰区间：09:00–12:00 与 14:00–18:00（半开区间：12:00:00 与 18:00:00 属于非高峰）。
每 15 秒自动刷新：到达整点边界后最多 15 秒内状态翻转，无需刷新页面。
语言可配置：在 设置 → 通用 → 徽章语言 选择徽章显示语言（中文 / English），选择持久化，重启后保持。
跟随主题：使用外壳的语义色 token（--dsw-alias-*），浅色/深色主题下都协调。
零延迟：纯客户端时间计算——没有网络请求、没有额外模型调用。

工作原理

半	职责
`client.js`（浏览器半）	挂载时及每 15 秒读取 `new Date()`；转换为北京时间钟面分钟（`UTC+8`，无夏令时）；对照两个半开高峰区间判断；把徽章注册进 `conversation.session.header.utilities`（排在会话日志工具左边），并把「徽章语言」选择行注册进 `settings.general.item`
`index.js`（Host 半）	注册 `peak-hours` 设置命名空间（`language` 字段，默认 `zh`）与私有 loopback RPC 通道 `/peak-hours`（`get`/`set`），供浏览器半读写该语言设置

为什么用私有 RPC 通道而不是 settings RPC？ dsh-host-apiproxy 只向显式白名单（WEB_SETTINGS_NAMESPACES / PRODUCT_SETTINGS_NAMESPACES）内的命名空间开放 settings 读写，第三方插件注册的命名空间会收到 settings-not-exposed，选择无法持久化。因此浏览器半走宿主进程内私有通道（ctx.connection.rpc.handle），宿主内对 ctx.settings 的读写不受该白名单限制——持久化保持不变。

为什么高峰判断仍在客户端？ 需求是"当前系统时间，转为北京时间"。浏览器时钟就是系统时间，UTC+8 平移是常量，因此徽章本地计算即可：没有 Host RPC 往返、没有额外失败点。

conversation.session.header.utilities 座位由会话顶栏渲染，因此打开会话时徽章可见（首次运行的空白欢迎页会隐藏整个顶栏）。

安装

要求：已安装 dsh CLI 并初始化过 profile（dsh plugin --profile <name> add 会自动初始化）。

从 GitHub 直装（推荐）

dsh plugin --profile web add github:lco117/dsh-peak-hours

纯 JS 包没有 prepare 构建脚本，只有 @deepseek-ai/schemastery 一个运行时依赖，不需要 pnpm ≥10 的 allowBuilds 许可，GitHub 直装即装即用。建议像官方文档建议的那样固定提交：github:lco117/dsh-peak-hours#<commit-sha>。

从本地目录安装（开发时）

dsh plugin --profile web add ./dsh-peak-hours

验证

dsh --profile web --dump-config   # 应出现 "# == dsh-peak-hours" 层

使用

启动 dsh web。
打开（或保持打开）任意会话——徽章出现在会话顶栏工具行的最左侧（会话日志下载按钮的左边）。
阅读状态：09:00–12:00 / 14:00–18:00 期间显示 🔴 高峰时段 + 北京时间，其余时间显示 🟢 非高峰时段。鼠标悬停可查看完整区间说明。
可选：打开 设置 → 通用，在「徽章语言」中选择中文或 English。选择会持久化，重启后保持。

开发

dsh-peak-hours/
├── package.json       # 声明 dsh.bundle 与 dsh.client
├── cordis.patch.yml   # 插件行：mount 本包的两个半
├── index.js           # Host 半：设置命名空间 + /peak-hours RPC 通道
├── client.js          # 浏览器半：高峰时段徽章 + 语言设置行（手写 factory bundle）
├── README.md          # English docs
├── README.zh-CN.md    # 中文说明
└── screenshots/       # README 截图（webp）

高峰区间与刷新间隔是 client.js 顶部的常量——在 PEAK_WINDOWS / REFRESH_MS 处调整即可。徽章文案在 LANGUAGES（client.js），设置 schema 在 index.js；新增语言时需要同步两处。

技术栈

类别	技术
插件平台	DeepSeek Harness (DSH)
插件框架	Cordis
语言	JavaScript (ESM)
Schema	@deepseek-ai/schemastery
构建	无（纯 JS，GitHub 直装）

License

⭐ Star History

如果这个项目对你有帮助，欢迎点一个 ⭐ Star，让更多人发现 dsh-peak-hours。