DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在构建智能体应用时，天气查询是一个高频且通用的功能。DSH 插件生态提供了多种联网方案，但直接在 Web GUI 中展示天气并让模型具备调用能力，往往需要自行开发。
这里介绍 dsh-weather 插件。它由 XCKjacksparrow 维护，开源协议为 MIT，定位为联网工具。该插件为 DSH 的 Web GUI 提供了可视化的天气卡片和模型可调用的工具，解决了开发者需要手动集成天气接口的需求。
核心功能¶
插件主要包含以下能力：
- 悬浮天气卡片：在网页右下角提供一个 ☀️ 按钮。点击后展开一个可拖拽的卡片，显示当前天气和未来三天的预报。
- IP 自动定位：首次打开卡片时，插件会通过第三方服务根据访问者的 IP 推断大致城市（例如“南京”），定位失败时默认回退到“北京”。
- 任意城市搜索：支持中文或英文名称搜索，例如“北京”、“上海”、“New York”或“Tokyo”。
- 模型工具调用：插件向模型暴露了一个
weather函数。智能体在回答天气相关问题时，可以直接调用该函数。 - 彩蛋与主题适配：包含天气相关的趣味文案（例如高温提示），并支持深色/浅色模式切换。
安装与启用¶
安装插件需要使用 DSH 的命令行工具。请确保你已安装 DeepSeek Harness 环境。
方式一：直接安装发布包¶
使用官方提供的发布包地址进行安装：
dsh plugin --profile web add https://github.com/XCKjacksparrow/dsh-weather/archive/refs/tags/v0.1.0.tar.gz
安装完成后，需要重启 dsh web 进程，使 Host 端和浏览器客户端重新加载插件。
方式二：本地构建安装¶
如果你需要修改源码或从本地构建：
npm install
npm run build
npm pack
dsh plugin --profile web add ./dsh-weather-0.1.0.tgz
使用方法¶
在 Web GUI 中查看¶
- 打开 DeepSeek Harness 的 Web GUI。
- 在页面右下角找到 ☀️ 按钮。
- 点击按钮，输入城市名称（支持中文或英文）。
- 按 Enter 键或点击“查询”按钮，卡片会显示天气信息。
让模型调用天气工具¶
在对话中直接向智能体提问，插件会自动注册工具。
示例 1：
“上海明天要带伞吗？”
示例 2：
“北京明天天气。”
智能体会识别意图并调用 weather 函数，获取数据后返回给用户。
注意事项与适用场景¶
- 无配置需求：插件无需任何额外配置即可工作。
- 隐私说明：为了实现 IP 自动定位，插件会在首次打开时将 IP 地址发送给第三方地理位置服务（如
api.ipapi.is或get.geojs.io）以推断城市。该过程仅发送一次数据，不存储任何用户信息。 - 数据源：天气数据来源于 Open-Meteo（免费且无需 API Key）。
- 权限与生态：该插件运行在 DSH 进程的权限下，具备联网能力。请注意，该插件由社区开发者维护，与 DeepSeek 或幻方官方无从属关系，使用前请检查源码与许可证。
总结¶
dsh-weather 插件通过封装悬浮卡片和模型工具，降低了在 DSH 环境下集成天气功能的成本。对于需要构建具备实时信息获取能力的智能体开发者，这是一个可以直接落地的方案。更多详情可查看插件目录或源码仓库。
