前言¶

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