天氣輕語：一張會自動收起的天氣卡片

前言¶

在 DeepSeek Harness（DSH）裏打開一個智能體會話，如果只是對話，界面容易變得單調。要添加一點視覺提示，常規做法要麼手動在聊天裏發一段文字，要麼接入外部服務，增加配置複雜度。這裏介紹一個輕量插件，它在會話啓動時在角落展示一張天氣卡片，隨後自動收起，平時只剩一個圖標，點擊即可查看。

它是什麼¶

天氣輕語（dsh-weather-whisper）是一個 DeepSeek Harness 的趣味換裝類插件，由 RAK7S 維護。它利用免費接口獲取當前與未來天氣，通過卡片形式展示，並提供一套簡單的主題 API，可以調整顏色、分隔線樣式、角落花紋、一週字型等。插件不依賴賬號或遙測，僅把經緯度、IP 和城市名發送給定位與天氣服務。

核心功能¶

定位：先通過 ipinfo.io 獲取經緯度，再用 BigDataCloud 反查爲中文城市名。
天氣數據：來自 Open-Meteo，包括當前溫度、體感、溼度、風況、逐時降水與陣風、未來 8 天的高低溫與降水概率。
極端天氣：本地推算未來 36 小時的逐時降水、陣風、雪碼，以及今明兩天的極端溫度。它不會宣稱自己是官方預警。
緩存與離線：數據緩存 30 分鐘，斷網時顯示一句提示而非報錯碼。
播報頻率：每個會話啓動時出現一次；平時縮爲右下角的一個 🌤️ 圓點，點擊展開。

安裝與啓用¶

在終端執行以下命令：

# 從 npm（如果已發佈）
dsh plugin --profile web add dsh-weather-whisper

# 或從本倉庫
dsh plugin --profile web add github:RAK7S/dsh-weather-whisper

安裝完成後重啓 DeepSeek Harness，卡片會在啓動時出現一次。

典型用法¶

主題預設¶

卡片右上角有 ✎ 按鈕，可以直接選擇預設，包括石墨、墨白、暖沙、櫻粉、深海。

控制台修改¶

在 DSH 的控制台裏，可以直接調用 API 調整主題：

// 只改一處
DSHWeatherWhisper.set({ palette: { accent: "#f5c2d0" } });

// 一次改一組
DSHWeatherWhisper.set({
  palette: { bg: "#14161a", bg2: "#0b0c0e", fg: "#f2f1ec", dim: "#a8a69e",
             accent: "#f2f1ec", line: "#6f7380", alert: "#e8dcc4" },
  decor: { sep: "───", corner: "❋", glyphs: "hanzi", sparkle: false },
  radius: 14,
});

DSHWeatherWhisper.reset();          // 回到默認
DSHWeatherWhisper.presets;          // 預設名列表

設置以 cookie ww_dsh-weather-whisper:theme 存儲（同時鏡像到 localStorage["dsh-weather-whisper:theme"]），結構如下：

{
  "palette": { "bg": "#2b303c", "bg2": "#171a21", "fg": "#e7ecf7",
               "dim": "#9fb0cc", "accent": "#d8deea", "line": "#8fa1c0",
               "alert": "#e6c9a8" },
  "decor": { "sep": "┄┄┄", "corner": "", "glyphs": "hanzi", sparkle: false },
  "radius": 18
}

sep 可選 ┄┄┄ ─── · · · ・・・ 〜〜〜 ✿ ✿ ✿ ✧ ✧ ✧ 或空字符串。
corner 可選 ✿ ❀ ❁ ✧ ❋ ⁂ 或不填。
glyphs 爲 hanzi（一週格子用漢字）或 emoji。

其他小開關¶

Cookie 鍵	作用
`ww_dsh-weather-whisper:city`	手動指定城市，如 `"杭州"`；留空則自動定位
`ww_dsh-weather-whisper:pos`	卡片位置，拖動時自動寫入

適用場景與注意¶

適合希望在 DSH 會話中增加視覺提示、又不想引入複雜配置的開發者。插件以當前 DSH 進程權限運行，安裝前建議查看源碼與許可證。

結語¶

天氣輕語用一張會自動收起的卡片，把天氣信息融入會話啓動流程，同時提供一套輕量的主題 API。如果你想在 DeepSeek Harness 裏給會話加一點“溫度感”，可以參考它的實現思路。

插件目錄：https://www.skillhub.cn/plugins/RAK7S/dsh-weather-whisper
GitHub：https://github.com/RAK7S/dsh-weather-whisper