dsh-liang-time
标题栏里的一枚北京时间状态胶囊:现在算「高峰时间」还是「低谷时间」?[^1]
为 DeepSeek Harness(DSH)Web GUI 桌面窗口准备的本地插件:在标题栏 「编辑」菜单右侧显示一枚 22px 高的胶囊,按北京时间告诉你在「高峰时间」(黄)还是「低谷时间」(绿)。

显示规则
一律按北京时间(Asia/Shanghai,UTC+8,无夏令时)判断:
| 日期类型 | 09:00–12:00 / 14:00–18:00 | 其余时间 |
|---|---|---|
| 工作日(含调休上班的周末) | 高峰时间 #ffd60a |
低谷时间 #55ff55 |
| 周末 | 低谷时间 | 低谷时间 |
| 法定节假日(国务院通知列明的全部放假日,含调休连休) | 低谷时间 | 低谷时间 |
- 边界:
09:00、14:00算高峰;12:00、18:00归低谷(时段左闭右开)。 - 日期判定优先级:调休上班日 > 法定节假日 > 普通周末/工作日。
- 节假日与调休上班日取自国务院办公厅年度放假安排通知,当前数据覆盖 2026、2027(逐条核对记录见 docs/holidays-2026-2027.md)。
- 胶囊只含「• 文案」:4px 圆点 + 文本,没有其它元素。

安装
方式 A:本地目录(推荐,当前唯一方式)
把本仓库 clone / 下载到任意目录(路径不要带空格更省事)。
在 DSH 里让 Agent 执行插件安装(
plugin_manager工具的install_bundle,target 为本仓库绝对路径),例如:plugin_manager: action=install_bundle, target=<本仓库绝对路径>本地目录安装是 link 方式:profile 里只记录链接,仓库文件改动后重启应用即可生效。
重启 DSH Desktop(Windows),或等待客户端热更新后,标题栏「编辑」右边就会出现胶囊。
方式 B:npm / 插件市场
仓库暂未发布到 npm。若你发布(npm publish)后,也可以按包名 dsh-liang-time 通过 DSH 插件管理器/市场安装。
环境要求
- Windows 版 DSH Desktop:胶囊定位依赖桌面壳在标题栏里绘制的「应用 / 编辑」菜单;普通浏览器窗口与 macOS 没有该菜单,胶囊会自动隐藏(不会报错、不会挡界面)。
- 开发与验证基于 2026-11 的 DSH Desktop 构建。插件使用的是
shell.overlay槽位与window.__ModuleLoader__模块格式(DSH 客户端的公开约定),但标题栏菜单属于桌面壳的私有实现,DSH 大版本改版后可能失效(失效表现是隐藏,见「已知限制」)。
位置与实现
- 座位:官方
shell.overlay槽位(框架全局浮层;官方文档说明 badge / status pill 都属于这里),胶囊用position: fixed定位,pointer-events: none,不挡标题栏拖动。 - 定位是动态测量的:读取桌面标题栏里「编辑」按钮的矩形,水平贴其右侧 10px、垂直与其同中心。侧栏折叠(菜单起点 48px ↔ 84px)、窗口缩放、语言切换、字体加载后都会重新贴回「编辑」右边,不写死
right: 131px之类的坐标。 - 不轮询:状态只可能在 00:00 / 09:00 / 12:00 / 14:00 / 18:00 翻转。插件用
setTimeout直接睡到「下一次真正会翻转」的时刻,到点重算并排下一次;周末与长假会自动跳过不会翻转的候选点(例如周六午后直接睡到周一 09:00)。页面从隐藏恢复/窗口重新聚焦时按真实时间纠正一次(防系统休眠导致定时器迟到)。 - 不依赖系统时区:用固定 +8h 偏移把时间戳换算成北京时间分量,UTC / 任意系统时区下结果一致。
年度维护(不是年抛插件)
新一年的国务院放假安排发布后,只需改数据、重新构建、提交:
编辑 data/holidays.json:在
years下新增年份,holidays写入该年全部放假日(含调休拼出的连休日),workdays写入被调成上班的周末;更新meta.updatedAt/meta.source。构建并自检(仓库根目录):
npm run build # = node scripts/build-liang-time.mjs,重新生成 client.js npm run check # 体检数据格式,并校验 client.js 是否与 data/src 同步(忘 build 会报错) npm test # 逻辑测试(时段边界、周末/节假日/调休上班日、跨年跨长假、缺数据年份回退……)提交
client.js与数据,发个新版本;重启 DSH 应用生效。
细节:
client.js是构建产物,已提交到仓库,这样 clone 下来直接就能装、不需要本地构建环境。- 测试对「额外年份」是宽容的:补 2028 数据不需要改测试(只对已知年份断言计数)。
- 缺数据年份不会报错:插件自动回退为「周一至周五 + 9–12/14–18 高峰」的规则,只是不识别那年的节假日与调休。所以即使更新不及时,也不会变成"过期插件"。
开发
dsh-liang-time/
├── package.json # 包清单:dsh.bundle.patch + dsh.client(platform=web, immediately)
├── cordis.patch.yml # 把插件作为 Loader 条目插入 profile
├── index.js # Host 半:空 apply(判定与渲染都在浏览器半)
├── client.js # 浏览器半(自动生成,已提交;勿手改)
├── data/holidays.json # 节假日/调休上班日数据(年度更新入口)
├── src/logic.js # 纯逻辑:北京时间判定 + 下一次翻转时刻
├── src/ui.js # 浏览器半源码:shell.overlay 胶囊、定位、定时器
├── locale/{zh,en}.json # 插件管理器里的显示名称/描述
├── scripts/build-liang-time.mjs # 构建 + 数据体检 + 生成物新鲜度检查
├── tests/liang-time.logic.test.mjs # 逻辑测试(Node 直接跑,不依赖浏览器)
├── docs/ # 截图与节假日数据来源记录
├── icon.svg # 插件图标
└── README.md / README.en.md
- 无第三方运行时依赖;浏览器半只用
require('react')(由 DSH 客户端模块表提供),不 import 任何 DSH Client 包。 - 需要 Node ≥ 18 才能跑构建/测试(DSH 自带运行时里也有 Node)。
.github/workflows/ci.yml在 push / PR 时自动执行npm run check与npm test。
已知限制
- 浅色主题对比度:圆点与文字使用需求指定的精确色值(
#ffd60a/#55ff55),在浅色标题栏上对比度偏低(约 1.2:1);深色主题下观感正常。若需要更醒目,可把胶囊底改成深色或文字改用主题 token。 - 依赖桌面壳的标题栏私有结构:定位来自
div[data-windows-menu]的 open shadow root 中「编辑」按钮的矩形。若 DSH 改版移除该结构,胶囊会静默隐藏(不会报错/挡界面)。 - 仅覆盖全国统一假日:新疆、西藏、广西、宁夏、内蒙古等民族自治地方假日,以及单位/学校自行调休不在数据内。
- 2027 年通知较新(2026-11-05 发布):若国务院后续发布修订通知,需按上面的流程更新数据。
开发说明
本插件是在 DeepSeek Harness 会话里由维护者与 AI Agent 协作完成的:
- 需求整理与复述、插件实现(Host/Client 两端)、国务院 2026/2027 节假日数据整理与逐条核对、独立验证(3,353 项逻辑测试、36,855 项独立复算、浏览器半 mock 执行、截图像素测量)均由 Agent 执行;
- 维护者负责需求提出、验收与发布。
插件自带 scripts/、tests/ 与 GitHub Actions CI,后续年份的数据任何人都可以按上面的流程补齐。
License
[^1]: 「梁文峰 / 梁文谷」是社区对 DeepSeek 峰谷计费时段的昵称:峰时段像在爬山(梁文峰),谷时段像在山谷(梁文谷)。本插件用「高峰时间 / 低谷时间」表达。
No comments yet. Be the first to write one.