高峰时段徽章 lco117/dsh-peak-hours

dsh-peak-hours

GitHub Stars
GitHub Forks
GitHub Issues
GitHub Pull Requests
License

dsh-plugin
北京时间自动刷新纯 JS

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 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#。

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

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

验证

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

使用

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

MIT © 2026 lco117

⭐ Star History

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