核心功能
Translink CLI Skill 是一套面向昆士兰东南部（SEQ）公共交通数据的命令行查询工具，封装了GTFS静态数据（时刻表、站点、线路、行程）与实时数据（车辆位置、服务告警）的本地化访问能力。用户可通过translink_*命令或插件斜杠命令，执行多表关联查询、模糊搜索、分页过滤及模式自省等操作。
显著优点
- 离线可用：静态数据缓存至本地（~/.openclaw/cache/translink/），24小时TTL，支持定时刷新
- 灵活查询：统一参数契约（--where/--contains/--in/--page等）适用于所有命令，降低学习成本
- 实时扩展：支持嵌套JSON展开（--expand）、原始数据保留（--raw）及时间格式切换
- 模式自适应：表头驱动 schema，自动适配新增字段，schema-generated.md 提供权威字段参考
- 防并发冲突：刷新锁机制避免并发提取竞态
潜在局限
- 地域受限：仅覆盖Translink SEQ服务区域，非通用GTFS工具
- 前置依赖：需手动安装github.com/alanburchill/translink-cli-scripts并确保PATH可用
- 缓存延迟：24小时TTL可能导致数据非实时，紧急场景需手动触发--refresh
- 无可视化：纯CLI输出，复杂空间数据（shapes）需外部工具渲染
- 社区维护：非官方Translink项目，更新频率与长期维护依赖个人开发者
适合人群
- 公交数据分析师与Transit技术开发者
- 运维人员排查服务告警与实时车辆偏离
- 研究人员验证GTFS schema变更与数据质量
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据时效性 | 缓存机制导致静态数据最多滞后24小时，实时数据依赖上游API稳定性 |
| 误操作覆盖 | 并发刷新虽加锁，但手动--refresh可能中断依赖缓存的其他查询 |
| 隐私合规 | 实时车辆位置属公开数据，但聚合分析需遵守Translink使用条款 |
| 供应链安全 | CLI脚本来自第三方GitHub仓库，建议审查代码后安装 |
| 字段漂移 | 自动适配新增字段可能导致下游脚本因列序变化而失效 |