前言¶
DSH（DeepSeek Harness）的插件化生态允许在 Web GUI 上叠加外部能力。dsh-weather-sky 是其中一个天气类插件：它在页面上覆盖一层指针穿透的动画层，用来展示天气与天空状态。它不注册模型工具，主要面向界面展示。下面介绍它的能力、安装方式和适用边界。
这是什么¶
dsh-weather-sky 是 guoPhineas 维护的外部插件，许可证为 MIT。它用于 DSH Web GUI，在界面叠加实时天气与天空动画层。插件以浏览器端为主：天气数据在浏览器端从 Open-Meteo 获取，渲染也在浏览器侧完成；宿主半侧不注册任何模型工具。
核心功能¶
- 定位：优先使用
navigator.geolocation，回退到ipwho.is。 - 天气数据：通过 Open-Meteo 获取温度、天气码、昼夜、云量、降水，无需 API key。
- 昼夜表现：白天显示太阳，夜晚显示月亮和星星。
- 月相：计算并可视化新月、娥眉月、上弦月、盈凸月、满月、亏凸月、下弦月、残月。
- 日月轨迹：太阳按太阳时做东升—中天—西落划弧；月亮按时间和月相划弧。
- 天气可视化：云、雨（随强度缩放）、雪、雾、雷暴闪电。
- 降低遮挡：整层设置
pointer-events:none，采用低透明度，并在右下角显示半透明状态胶囊。
安装与启用¶
命令行方式：
git clone https://github.com/guoPhineas/dsh-weather-sky
cd <harness>
dsh plugin --profile web add ../dsh-weather-sky
也可以在 DSH 会话中发送：
安装这个天气插件：https://github.com/guoPhineas/dsh-weather-sky
该插件依赖 DSH 外部插件运行所需的发布版 @deepseek-ai/cordis，版本范围为 ^4.0.1。按已核实资料，安装通过 dsh plugin --profile web add <path> 完成，无需改动 DSH 源码。
典型用法¶
如果从源码构建，先安装依赖，再执行构建：
pnpm install
pnpm build # tsdown
构建产物输出到 lib/：lib/index.js 是宿主入口，lib/client.js 是浏览器半侧。
适用场景与注意¶
- 适合希望在 DSH Web GUI 中叠加天气和天空动画的使用者。
- 天气与位置请求在浏览器端发起，使用 Open-Meteo 和
ipwho.is回退定位。 - 若天气接口或定位服务偶发失败，插件会保留上一帧画面，并在下一轮 15 秒后自动重试。
- 插件使用
pointer-events:none和低透明度来减少遮挡。 - 安装前建议查看仓库源码、依赖和 MIT 许可证。插件代码会在当前
dsh进程权限下运行，应按自己的信任边界评估。
结尾¶
dsh-weather-sky 提供的是 DSH Web GUI 的天气与天空动画覆盖层，核心是浏览器端获取天气并渲染。仓库地址：
- GitHub：https://github.com/guoPhineas/dsh-weather-sky
