dsh-time&timer
Visual clock and timer plugin for DeepSeek Harness Web GUI.
在 Harness 的对话界面里内置一个与系统时间同步的可视化时钟：首页显示大号数字时钟（含农历、中国法定节假日与调休），对话进行时在标题栏显示紧凑时间条；两种形态都带一个最多 15 分钟的计时器入口。
功能
两种时钟形态
| 模式 | 出现时机 | 位置与尺寸 |
|---|
| StartMode | 首页 / 空白会话（Hero 页） | 对话区域左上角，256 × 64 px 横向数字时钟卡片 |
| DefaultMode | 任意对话进行时 | 标题栏左侧工具区（标题旁的 actions 组）最右端，JetBrains Mono 14px |
- 时间统一为 24 小时制
HH:MM:SS，每秒刷新。
- StartMode 顶部：公历年
YY/MM/DD（如 26/10/18）+ 节假日 / 休息日徽标（国庆节·休、春节·班）。
- StartMode 中部：
HH:MM:SS 作为视觉焦点（HH:MM 30px + 秒 18px），居中偏左。
- StartMode 底部：农历日期，格式
丙午年.九月初九（含生肖年干支），默认关闭、可在插件设置中开启。
- DefaultMode：时间条带一层加深底色块（含 1px 内描边），时间与蓝色计时按钮整体成为标题栏里的聚焦区域。
- 两种模式的计时器入口采用同一套蓝色强调：
- StartMode：
64 × 24 矩形按钮；
- DefaultMode：
24 × 24 正方形按钮；
- 顶部边缘线均有 1px 白色高光（
inset 0 1px 0 #fff，高光仅出现在边缘线上），图标颜色 #27F5F5。
双时间来源
- 默认采信系统时间（浏览器
Date）。
- 在插件设置中开启第三方时间服务器后，Host 半通过 UDP 向
ntp.aliyun.com 查询，Client 按偏移量校正显示；每 5 分钟重新同步一次，失败自动回退系统时间并在设置页显示错误。
- 浏览器无法直接发送 NTP（UDP/123），因此 Host 半注册了
GET /api/time-n-timer/ntp 路由；该路由只查询固定的 ntp.aliyun.com，不是通用 NTP 代理。
计时器（Timer）
- 上限 15 分钟；倒计时档位：
15s / 30s / 1min / 3min / 5min / 10min / 15min；另有正向计时模式（最多 15:00）。
- 点击任意模式的计时按钮打开对话框，进行模式与时长选择；支持开始 / 暂停 / 继续 / 重置。
- 到点自动打开对话框提示「时间到」，并播放三声提示音。
- 计时进行中按钮带状态点（运行 / 暂停 / 结束）；StartMode 顶部徽标在计时中改为显示剩余时间。
- 计时器状态保存在当前页面内存，刷新页面后重置。
插件设置
设置 → 通用 中新增「时间与计时器」两行：
- 显示农历日期（默认关闭）
- 第三方时间服务器（默认关闭；开启后显示同步状态、偏移量与错误）
设置持久化在浏览器 localStorage 的 dsh.time-n-timer.settings.v1。
安装
方式一：从 GitHub 克隆后本地安装
git clone https://github.com/Depar7ure/dsh-time-timer.git
在 Harness 的 Plugin Manager → 安装本地插件（Install bundle） 中选择克隆下来的目录，安装后刷新页面即可。
方式二：交给 Harness Agent 安装
把该目录的绝对路径交给 Agent，并说明「安装这个 bundle」；Harness 会通过 install_bundle 完成安装（安装后刷新页面）。
插件显示名：Time & Timer / 时间与计时器。
项目结构
dsh-time-timer/
├── index.js # Host 半：NTP 查询路由（node:dgram）
├── client.js # Client 半：时钟 / 农历 / 节假日 / 计时器 / 弹窗 / 设置行
├── cordis.patch.yml # Bundle patch（插入一行 dsh-time-timer）
├── package.json # 包清单（dsh.bundle + dsh.client）
├── locale/
│ ├── en.json # 插件显示名与描述（English）
│ └── zh.json # 插件显示名与描述（中文）
├── icon.svg # 插件图标
├── scripts/check.mjs # 本地清单与语法自检
├── CHANGELOG.md
├── LICENSE # MIT
└── README.md
数据说明
- 农历：内置 1900–2100 标准农历表（支持闰月）。已验证 2026-02-17 = 正月初一、2026-09-25 = 八月十五、2026-10-18 = 九月初九。
- 节假日：内置 2025、2026 年国务院办公厅放假安排（含调休上班日）；无数据的年份按周末规则回退。普通周六 / 周日显示「周末·休」，调休上班日显示「班」。
- 节假日数据来源：国务院办公厅《关于 2026 年部分节假日安排的通知》（国办发明电〔2025〕7 号）。
开发
node scripts/check.mjs # 清单、图标、Client 半语法检查
node --check index.js # Host 半语法检查（ESM）
要求：Harness 的 Web 客户端（dsh.client.platform: web）；Node.js ≥ 18（Host 半使用 node:dgram）。
兼容性与已知限制
- 节假日数据目前覆盖 2025–2026，其他年份仅按周末判定。
- 样式使用 Harness 的主题 token（
--dsw-alias-*），浅色 / 深色主题均可用；字号与尺寸依赖宿主布局，宿主大版本升级后可能需要重新核对槽位。
- StartMode 通过
conversation.header.leading 渲染；DefaultMode 通过 conversation.session.header.actions 渲染，空白会话时该槽位不会显示。
- NTP 同步依赖 Host 半与网络可达；离线环境自动回退系统时间。
English
dsh-time-timer is a visual clock and timer for the DeepSeek Harness Web GUI. It shows a 256×64 digital clock on the home (blank) session with an optional Chinese lunar date and China holiday badge, and a compact JetBrains Mono clock strip in the header while a conversation is active. Both modes expose a timer launcher (countdown presets from 15 seconds to 15 minutes, plus a stopwatch capped at 15:00). Time is taken from the system clock by default and can optionally be corrected from ntp.aliyun.com through a Host-side NTP endpoint.
License
MIT © 2026 Depar7ure
