han-river-water-level

汉江水位

技能功能

默认向 https://k-skill-proxy.nomadamas.org/v1/han-river/water-level 发送请求，获取当前水位和流量的摘要信息。

使用场景

• "汉江大桥现在水位怎么样？"
• "告诉我潜水桥的流量"
• "显示观测站 1018683 的当前值"

输入

• 默认输入：观测站名称/桥梁名称（stationName）
• 替代输入：观测站代码（stationCode）

前提条件

• 可选：jq

默认路径

无需额外的客户端 API 层，只需向代理服务器发送 HTTP 请求即可。

用户无需准备单独的 HRFCO ServiceKey，上游密钥仅在代理服务器中注入。

如果存在 KSKILL_PROXY_BASE_URL 环境变量，则使用其值；否则使用默认路径 https://k-skill-proxy.nomadamas.org。

示例请求

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강대교'

也可以直接通过观测站代码查询：

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationCode=1018683'

保持回答简洁

响应中首先整理以下内容：

• 观测站名称 / 观测站代码
• 观测时间
• 当前水位（米）
• 当前流量（立方米/秒）
• 基准水位（关注/注意/警报/严重）中有值的项目

模糊的观测站名称

如果输入范围过宽，代理将返回 ambiguous_station 和 candidate_stations。

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강'

此时，从候选列表中选择一个，再次通过 stationName 或 stationCode 查询。

详细 API 路径

实现细节请参考以下文档：

• docs/features/han-river-water-level.md
• docs/features/k-skill-proxy.md

失败模式

• 观测站名称过于宽泛，同时匹配多个观测站
• 错误的观测站代码/名称导致观测站查找失败
• 代理服务器中 HRFCO_OPEN_API_KEY 为空
• 实时数据更新延迟，导致最近 10 分钟数据为空

备注

• 默认路径始终为 k-skill-proxy.nomadamas.org 的 water-level 端点。
• 上游通过 waterlevel/info.json 查找观测站元数据，通过 waterlevel/list/10M/{WLOBSCD}.json 获取最新值。
• 结果基于原始数据，因此需同时记录查询时间。