Open Data Hub Cli_知识管理 skill-PHP中文网

Open Data Hub Cli

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

在需要使用 Open Data Hub、NOI Techpark 数据、ODH API、Tourism API、Mobility API、A22 交通数据或查询 Open...时使用此技能。

打开数据枢纽 CLI. 使用odh 而不是刮掉 Open Data Hub 页面

功能概述

打开数据枢纽 CLI. 使用odh 而不是刮掉 Open Data Hub 页面是一项面向实际任务的技能，主要用于大部分实用数据是 South Tyrol / Academy Province of Bolzano；验证从坐标、来源或位置得出的记录级别位置。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

Open Data Hub CLI

请使用 odh 命令行工具，而非手动爬取 Open Data Hub 网页。大部分实用数据来自南蒂罗尔 / 博尔扎诺自治省；请务必通过坐标、来源或元数据验证每条记录的具体地理位置。

安装与初始化

odh version
odh doctor --timeout 10s

当前命令契约、数据集指引、来源（source）/溯源（provenance）字段、交通辅助功能、GTFS/公共交通支持、按条件筛选的最新测量值、逗号安全的 --param 参数、transit journey --with-realtime 及 MCP 服务端模式等功能，均需 odh v0.4.0+ 版本支持。

推荐的手动安装方式：

go install github.com/galjos/odh-cli/cmd/odh@v0.4.0
brew install galjos/odh/odh

Agent 主机亦可利用本技能中声明的 OpenClaw Go 安装器元数据进行部署。若直接从源码仓库运行，请使用 ./odh。

偏好使用 MCP 协议而非 Shell 命令的 Agent 主机，可通过 odh mcp serve 启动同一套经人工校验的命令接口；其工具输出严格遵循与 CLI 相同的 JSON 契约格式及警告机制。

输出规范

经人工校验的命令默认以表格形式输出。如需解析结果，请显式添加 --json 或 --format json 参数。
该规则尤其适用于 traffic、a22 status、transit、tourism types、mobility types 和 mobility datatypes 等命令。
将 stderr 视为诊断信息，而非有效数据。
非零退出码表示执行失败；退出码 2 通常表示命令调用错误（bad invocation）。
在受控的 Agent 循环中，请将全局超时参数置于子命令之前，例如：odh --timeout 20s traffic today --area bozen-unterland --json。
若不确定某命令的具体用法，可先运行 odh --help；当前帮助文档包含面向具体任务的示例。
在猜测提供方名称、数据类型、站点 ID 或区域 ID 之前，请优先使用发现类（discovery）命令。
相比推断溯源信息，应优先采用返回结果中的 source、source_detail、endpoint、archive、realtime 和 warnings 字段。
稳定可用的结构化 JSON 字段定义详见代码仓库中的 docs/json-contracts.md。

数据发现

odh apis
odh datasets guide "ev charging availability" --format json
odh datasets search parking
odh openapi mobility
odh openapi tourism
odh mobility types --kind station
odh mobility origins --station-type ParkingStation
odh mobility datatypes --station-type TrafficSensor --origin A22 --limit 1000 --json

面对不熟悉的数据主题时，请首先运行 odh datasets guide --format json，并依据其返回的 discovery、verify 和 caveats 字段指导后续操作，再选择更底层的命令。

在任何使用 --origin 进行过滤的查询前，务必先执行 odh mobility origins --station-type 。即使来源看似明确（如 A22、ALPERIA、PROVINCE_BZ），也须如此操作：来源名称属于上游词汇表（upstream vocabulary），已编目来源或数据类型本身，并不能保证存在对应开放的实测数据行。

对于已知端点，可使用 odh call --param key=value。其中 --param 可重复指定，且参数值允许包含逗号。

交通信息

道路施工、封闭及各类道路事件：

odh traffic zones --json
odh traffic categories --json
odh traffic today --area ueberetsch-unterland --type roadworks --json
odh traffic search badia --today --zone-id 6 --json
odh traffic today --near 46.42,11.25 --radius 15km --json

优先使用 traffic 命令，而非原始的 mobility events --origin PROVINCE_BZ。请向用户呈现过期警告（stale warnings）和来源警告（source warnings）。切勿将过期或无明确时效性的开放数据行，当作已确认的当前道路封闭信息展示。

A22 高速公路：

odh a22 status --limit 10 --json
odh mobility events --origin A22 --latest --limit 20

a22 status 面向当前/实时状态。请勿基于 TrafficForecast 类型数据推断实时事故。若需查询历史本地 A22 事故，应说明 ODH/A22 实时数据流通常不保留历史记录，必要时请参考带时间戳的外部数据源。

出行测量数据

获取当前可用性数据时，请先发现来源（origin）与数据类型（datatype），再按时效性进行筛选：

odh diagnostics ev-charging --origin ALPERIA --fresh-within 24h
odh diagnostics parking-forecasts --origin "Municipality Merano" --fresh-within 2h --forecast-minutes 60
odh mobility latest --station-type ParkingStation --data-type free --origin "Municipality Merano" --active --fresh-within 2h --sort newest --request-limit 10000 --limit 10 --format table

原始的“最新”数据行可能包含已失效或非活跃站点。请向用户呈现 warnings 字段内容。若诊断结果显示 current_only，则仅报告当前占用状态，不得展示过期的预测数据。

旅游活动事件：

odh diagnostics tourism-events --date 2026-05-18 --limit 20
odh tourism poi --limit 1 --seed 42 --fields Detail.en.Title,GpsInfo

在做出“今日附近”类推断前，请务必检查 date_status、location_status 及 GpsInfo 字段。

公共交通

odh gtfs datasets
odh gtfs realtime --dataset sta-time-tables --feed trip-updates --limit 5
odh transit stops search merano --limit 10
odh transit departures --stop-id  --date 2026-05-16 --around 13:00 --mode train --json
odh transit trip --from-stop-id  --to-stop-id  --date 2026-05-16 --time 13:00 --mode train --json
odh transit journey --from-stop-id  --to-stop-id  --date 2026-05-16 --time 13:00 --max-transfers 3 --with-realtime --json
odh transit delay-stats --from auer --to brenner --time 14:05 --weekday saturday --json

当站点名称存在歧义时，请使用站点 ID（stop ID）。journey --with-realtime 将静态路线与当前 GTFS-RT 数据叠加标注，但**不执行动态重路径规划（live-reroute）**。缺失实时实体（realtime entities）并不意味着服务准点。若未归档 GTFS-RT 历史数据，则无法支持历史延误概率分析；此时请使用 delay-stats，切勿主观猜测。

评估（Evals）

scripts/run-agent-evals.sh

请使用 evals/agent/tasks.json 进行人工评分，使用 evals/agent/recipes.json 作为机器可读的命令配方（command recipes）。通过评估结果判断反复失败是否需要更新文档、优化技能指引、改进 Agent 推理逻辑，或引入特定 CLI 功能增强。