dsh-solar-term

中文文档
0.1.0发布于 2026/11/03MITES Module零依赖

Current solar term and the days left until the next one, shown at the top-left of the conversation

原始使用文档
文档目录5 节
  1. 效果
  2. 算法
  3. 安装
  4. 调整
  5. 原理

dsh-solar-term

对话页左上角的节气牌:当前是哪个节气、几点交节,以及距下一个节气还差几天。

效果

┃ 霜降   10月23日
┃ 立冬 还有 4 天
  • 位置:conversation.header.leading 槽,主面板左上角、侧栏右侧那条头部空位,开会话和没开会话时都在。
  • 第一行是当前节气与交节日期,左侧竖条的颜色按季节换:春青、夏金、秋赭、冬黛。
  • 第二行是下一个节气与倒计时;交节当天显示「立冬 就是今天」。
  • 悬停看精确到分钟的交节时刻和本机时区。
  • 每 30 秒对一次表,切回窗口时立即刷新,零点过后自动翻到新的节气。

算法

节气就是太阳视黄经每走 15° 的时刻。lib/client.js 里内置 VSOP87D 地球黄经截断级数(Meeus 表 32.a),换算成太阳视黄经,再对 15° 的整数倍做牛顿迭代求时刻,最后扣掉 ΔT(TT − UT,2020 年代约 69 秒)。

和紫金山天文台公布的 2026 年时刻对照,24 个节气全部落在同一分钟;2025 年立春 22:10、春分 17:01、冬至 23:03 也对得上。

安装

dsh plugin add dsh-solar-term

装完如果没出现,重启一次 DSH(Loader 行只在启动时读)。

本地开发:

node scripts/install.mjs --profile desktop --apply

调整

想改什么改哪里
尺寸、圆角、背景浓度lib/client.js 里 css 数组的 .dsh-st
节气名 / 日期字号.dsh-st-name、.dsh-st-date
四季竖条配色SEASON_COLORS
刷新频率组件里 setInterval(tick, 30000)
英文节气名TERMS 表里的 en 字段

改完把 lib/client.js 覆盖回 ~/.dsh/profiles/node_modules/dsh-solar-term/lib/,刷新页面即可(客户端插件走 HMR,不用重启 Host)。

原理

宿主半 lib/index.js 只留一个空 apply——它存在的意义是让包成为一条 Loader 行,从而把 dsh.client 声明带进浏览器启动图。真正的逻辑全在 lib/client.js:算节气、注册槽位、渲染那块牌子。天文计算不依赖网络,也没有第三方依赖。

版本与发布记录

dsh-solar-term 共发布 2 个版本,首次发布于 2026/11/03;过去 12 个月发布了 2 个版本。

版本发布日期距今
0.1.0latest2026/11/03今天
0.0.0-stage2026/11/03今天

关于 dsh-solar-term 的常见问题

dsh-solar-term 是什么?

当前节气和下一个节气的剩余天数,显示在对话的左上角

如何安装 dsh-solar-term?

在项目目录运行 npm install dsh-solar-term,或使用 pnpm add / yarn add / bun add。

dsh-solar-term 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dsh-solar-term 是否存在。

dsh-solar-term 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

dsh-solar-term 可以商用吗?

dsh-solar-term 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

dsh-solar-term 还在维护吗?

最新版本 0.1.0 发布于 2026/11/03(今天);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。