天气轻语：一张会自动收起的天气卡片

前言¶

在 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