dsh-weather-plugin

dsh-weather-plugin

天气工具 + 沉浸式天气主题的 DSH UI 增强插件：常驻生效，无需问答——
页面打开即按 IP 自动定位并应用整个主页的天气效果；模型问答天气时再按回答
切换。所有组件按天气换色、全屏飘雨/飘雪/阳光/闪电氛围、一只沿页面底部游弋
的官方 FishLogo 鲸鱼宠物（右下角 HUD，可点开面板），聊天里还有带环境
音效、动植物伙伴和科普的交互卡片。

• 数据源：Open-Meteo（免费，不需要 API key）
• 定位：IP 自动定位（ipwho.is → ipapi.co 回退链）+ 手动城市覆盖
• 主题：ctx.theme.overrideTokens 官方第三方 token 覆盖层（全组件生效）
• UI：tool.call.toolview 工具卡片 + 插件体自管的 HUD 与全屏氛围层

功能一览

功能	说明
常驻生效	打开页面即查询（浏览器直连，无需模型问答），30 分钟自动刷新；问答结果覆盖常驻状态
IP 自动定位	不带城市时按公网 IP 自动定位（📍 标签）；HUD 可手动输入城市，记住在 localStorage
全组件换色	8 套天气配色覆盖 --dsw-alias-*：背景、卡片、侧栏、边框、文字、品牌色，明暗双模式
全屏氛围层	每类天气一套动态效果：晴=太阳光芒（夜=月亮星星）、多云=飘云、阴=色罩、雾=缓慢漂移的雾带、毛毛雨=彩虹+细雨、雨=全屏雨丝、雪=飘雪、雷暴=雨丝+闪电双闪
季节粒子	随季节点缀：春飘花瓣、夏浮光点、秋落树叶（按纬度判断南北半球季节）
天气宠物鲸鱼	官方 DeepSeek FishLogo 轮廓（canvas 矢量渲染）：分部件关节动画（尾鳍/背鳍/胸鳍）、呼吸、眨眼、喷泉、随天气换配件（雨伞/围巾/闪电/太阳/月亮/云/雾/雨丝），沿页面底部巡游，点击打开面板
HUD 悬浮胶囊	收起态：鲸鱼+温度+城市；展开：天气手动切换（8 选 1 + 实时）、详情/伙伴/科普 + 声音/深色模式/刷新/隐藏氛围开关、城市输入
交互卡片	聊天流内天气卡片：天气图标 + 温度 + 城市 + 状态，可展开看体感/湿度/风力、动植物伙伴、季节与科普；自带 🔊 声音开关
环境音效	Web Audio 程序化合成，自动跟随当前天气：晴=微风、阴=低频风声、毛毛雨/雨=雨声、雪=轻沙沙、雷暴=雨声+闷雷、雾=静音；HUD 与卡片各有 🔊 开关（首次点击符合自动播放策略）
动植物伙伴	每类天气一只动物 + 一株植物，晴天按季节变化（南北半球按纬度判断）
科普小知识	每类天气一句科普，随 UI 语言切换（zh/en）
无障碍	prefers-reduced-motion 关闭动画保留色罩；全屏层 pointer-events: none

安装

# 已发布到 npm 后
dsh plugin --profile web add dsh-weather-plugin

# 或本地 checkout / tarball
dsh plugin --profile web add ./dsh-plugin
dsh plugin --profile web add ./dsh-weather-plugin-1.0.0.tgz

# 验证配置层并启动
dsh --profile web --dump-config
dsh web

打开 Web UI 就能看到效果：右下角出现鲸鱼宠物 + 天气胶囊，整个页面已按当前
天气换色并渲染氛围层——不需要问任何问题。提问「今天天气怎么样」会得到
卡片并刷新常驻状态。

关于 IP 定位

IP 定位的是网络出口，不是设备位置：如果电脑经过代理/VPN/云服务器上网，
定位结果就是出口节点所在城市。插件内置双数据源（ipwho.is → ipapi.co）交叉
验证；如果你所在城市与定位不符，在 HUD 展开面板里输入城市即可覆盖
（记住在 localStorage），或在 profile 配置里设 defaultCity。

配置

字段	默认	说明
defaultCity	'北京'	IP 定位失败或关闭时的城市
language	'zh'	模型可见文案语言（zh / en）
autoLocate	true	城市参数为空时按主机公网 IP 自动定位
timeoutMs	10000	上游请求超时（毫秒）

# profile 的 cordis.patch.yml 覆盖
- id: weather
  config:
    defaultCity: '上海'
    language: en
    autoLocate: false

本地开发

pnpm install
pnpm typecheck     # 类型检查
pnpm build         # tsdown 构建 lib/index.js + lib/client.js，tsc 出 d.ts
pnpm watch         # tsdown --watch（配合 dev:web 的 client HMR 链）

在 harness 源码 checkout 中联调：

pnpm dsh plugin --profile web add <本目录绝对路径>
pnpm dsh web

注意：dsh-client-modules 提供的是构建后的 lib/client.js，不是源码；
client 代码改动后必须重新 pnpm run build（或 pnpm run watch）才会生效。

发布

pnpm run build
npm publish            # 先发布到 npm（预构建 lib/，用户无需构建授权）

plugin.dshdesk.com 市场从 GitHub 仓库收录插件（自动校验 dsh.bundle
manifest 与 cordis.patch.yml）。发布到市场的步骤：

1. 把仓库推送到 GitHub（公开仓库，设置 topics：deepseek-harness、dsh-plugin）
2. 注册表每 2 小时自动发现；也可在站点「发布」页提交仓库 URL 走人工收录
3. 在 plugin.dshdesk.com 确认插件出现且
   「Manifest 检查通过」

打包安装细节见官方打包教程。

数据源与许可

• 天气数据：Open-Meteo（免费，无需 API key；商业使用需其商业许可）
• IP 定位：ipwho.is → ipapi.co（免费层有请求限额，遵守各自服务条款）
• 宠物鲸鱼为 DeepSeek 官方 FishLogo（@deepseek-ai/dsh-client-ui-primitives），动画与音效全部程序化生成，无第三方素材