DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

LANHJUN /

LANHJUN/dsh-liang-time

Verified

DSH 标题栏插件:北京时间高峰/低谷胶囊(22px,自动跟随国务院节假日与调休上班日)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHubProject homepage
READMESource: main@3bf79901

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 圆点 + 文本,没有其它元素。

胶囊细节:4px 圆点 + 「低谷时间」

安装

方式 A:本地目录(推荐,当前唯一方式)

  1. 把本仓库 clone / 下载到任意目录(路径不要带空格更省事)。

  2. 在 DSH 里让 Agent 执行插件安装(plugin_manager 工具的 install_bundle,target 为本仓库绝对路径),例如:

    plugin_manager: action=install_bundle, target=<本仓库绝对路径>
    

    本地目录安装是 link 方式:profile 里只记录链接,仓库文件改动后重启应用即可生效。

  3. 重启 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 / 任意系统时区下结果一致。

年度维护(不是年抛插件)

新一年的国务院放假安排发布后,只需改数据、重新构建、提交:

  1. 编辑 data/holidays.json:在 years 下新增年份,holidays 写入该年全部放假日(含调休拼出的连休日),workdays 写入被调成上班的周末;更新 meta.updatedAt / meta.source。

  2. 构建并自检(仓库根目录):

    npm run build   # = node scripts/build-liang-time.mjs,重新生成 client.js
    npm run check   # 体检数据格式,并校验 client.js 是否与 data/src 同步(忘 build 会报错)
    npm test        # 逻辑测试(时段边界、周末/节假日/调休上班日、跨年跨长假、缺数据年份回退……)
    
  3. 提交 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

MIT

[^1]: 「梁文峰 / 梁文谷」是社区对 DeepSeek 峰谷计费时段的昵称:峰时段像在爬山(梁文峰),谷时段像在山谷(梁文谷)。本插件用「高峰时间 / 低谷时间」表达。

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit 3bf7990114e2

Community comments

No comments yet. Be the first to write one.