guoPhineas/dsh-weather-sky

dsh-weather-sky

English

一个 DeepSeek Harness（DSH）Web GUI 的实时天气与天空动画插件：在界面叠加一层指针穿透的动画层——白天显示太阳、夜晚显示带真实月相的月亮，并按天气呈现云、雨（随强度自适应）、雪、雾，以及周期性的闪电。

天气数据在浏览器端直接从 Open-Meteo 获取（无需 API key），通过浏览器定位（navigator.geolocation，回退到 ipwho.is）确定位置。

特性

| 能力 | 说明 |
| --- | --- |
| 定位 | 浏览器定位优先，回退 IP 定位（ipwho.is） |
| 实时天气 | Open-Meteo（免 key）：温度、天气码、昼夜、云量、降水 |
| 昼夜切换 | 白天太阳，夜晚月亮 + 星星 |
| 月相 | 计算并可视化月相（新月 → 娥眉月 → 上弦月 → 盈凸月 → 满月 → 亏凸月 → 下弦月 → 残月） |
| 日月运动 | 太阳按太阳时东升—中天—西落划弧；月亮按时间 + 月相划弧 |
| 天气可视化 | 云、雨（随强度缩放）、雪、雾、雷暴闪电（约每 6 秒一次） |
| 不遮挡文字 | 整层 pointer-events:none、低透明度、右下角半透明状态胶囊 |

天气码映射

| WMO 码 | 条件 | 视觉 |
| --- | --- | --- |
| 0 | 晴 clear | 太阳 / 月亮 |
| 1–2 | 局部多云 partly-cloudy | 太阳 + 少量云 |
| 3 | 阴 cloudy | 云，无日月 |
| 45/48 | 雾 fog | 漂移雾层 |
| 51–57 | 毛毛雨 drizzle | 小雨滴 |
| 61/63/65 | 小雨/中雨/大雨 | 雨滴随强度自适应 |
| 71/73/75 | 小雪/中雪/大雪 | 飘雪 |
| 80–82 | 阵雨 → 暴雨 | 雨滴随强度自适应 |
| 85/86 | 阵雪 | 飘雪 |
| 95–99 | 雷暴 thunderstorm | 深云 + 大雨 + 闪电 |

安装

建议安装操作

给 dsh 发送信息：

安装这个天气插件：https://github.com/guoPhineas/dsh-weather-sky

使用命令行

git clone https://github.com/guoPhineas/dsh-weather-sky
cd
dsh plugin --profile web add ../dsh-weather-sky

目录结构

src/
├── index.ts            # Host 半侧（空 apply，本插件为浏览器端插件）
└── client/index.ts     # Client 半侧：抓取天气 + DOM/CSS 动画层
cordis.patch.yml        # bundle patch（insert 本插件的 dsh.client 入口）
tsdown.config.ts        # 构建（tsdown）
package.json            # 清单：dsh.bundle.patch、dsh.client、peerDeps

构建

pnpm install
pnpm build   # tsdown

构建产物输出到 lib/（index.js 为宿主入口，client.js 为浏览器半侧）。

说明

- 本插件是客户端为主的插件：天气在浏览器端抓取并渲染，宿主半侧不注册任何模型工具。
- DSH 的外部插件依赖发布版 @deepseek-ai/cordis（^4.0.1），通过 dsh plugin --profile  add  安装，无需改动 DSH 源码。
- 若天气接口或定位服务偶发失败，插件会保留上一帧画面，并在下一轮（15 秒）自动重试。

许可证

MIT