trimet

🚃 Portland实时公交查询助手

基于TriMet官方API的Portland公交查询工具,需自主配置API Key,提供实时到站、路线规划与延误警报服务。

收藏
6.2k
安装
1.7k
版本
v0.1.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

Trimet Skill 是一个基于文档的 CLI 工具包装器,旨在帮助用户便捷地获取 Portland 地区的公共交通信息。用户需预先通过 npm 安装 trimet-cli 全局包,并从 TriMet 官方网站申请免费的 API Key 配置为环境变量 TRIMET_APP_ID。该 Skill 提供四大核心功能模块:实时到站查询trimet arrivals)可查看指定站点的车辆到达时间并支持按线路筛选;智能路线规划trimet trip)支持通过站点 ID 或自然语言地址(如 "Pioneer Square")规划行程,可指定出发或到达时间;快速下一班trimet next)提供简化的近期班次视图;服务警报trimet alerts)实时推送线路延误或运营异常信息。所有命令均支持 --json 输出格式,便于开发者进行数据集成。

显著优点

该 Skill 的最大优势在于安全性与透明度——作为纯 Markdown 文档型资产,其本身不包含任何可执行代码,彻底杜绝了代码注入或恶意脚本执行的风险。数据权威性方面,直接对接 TriMet 官方 API,确保公交时刻、路线规划的准确性。交互设计上,支持自然语言输入(如 "5:30 PM"、"PDX Airport"),降低了使用门槛。此外,文档提供了详尽的站点 ID 对照表和 MAX 线路编号参考,配合丰富的场景化示例(如 "何时前往机场"、"5点前到达市中心"),使新手也能快速上手。对开发者友好,JSON 输出模式便于与其他工具链集成。

潜在缺点与局限性

地域限制是该 Skill 的显著短板,其服务范围严格限定于 Portland 地区,对其他城市用户毫无价值。环境依赖较重,需要 Node.js 运行时和外部 npm 包支持,增加了系统开销。使用门槛方面,强制要求用户自行注册获取 API Key 并配置环境变量,对非技术用户不够友好。作为纯文档包装器,其功能完全受制于外部 trimet-cli 工具的更新节奏,若该依赖停止维护,Skill 将立即失效。此外,作者为个人 GitHub 账号(T3 来源),缺乏组织级背书,长期维护承诺存疑。

适合的目标群体

主要面向 Portland 本地居民与通勤者,特别是依赖 MAX 轻轨和公交系统的日常出行人群;前往 Portland 的商务差旅人士与游客,需要快速规划从机场(PDX)到市区的交通;熟悉命令行的效率工具爱好者,习惯在终端完成快速查询;以及需要将公交数据集成到自动化工作流的开发者,可利用 JSON 输出构建个性化应用。

使用风险

依赖项风险:核心功能完全依赖第三方 npm 包 trimet-cli,若该包出现安全漏洞或停止维护,将直接影响使用。网络与性能风险:查询需实时连接 TriMet 服务器,网络波动或 API 服务中断会导致功能不可用。配置安全风险:尽管 API Key 仅涉及公共交通查询权限,用户仍需妥善保管,避免在共享环境中明文暴露。地域误用风险:系统缺乏地理位置自动检测,非 Portland 用户可能因误操作产生无效查询,浪费 API 调用额度。

安全解读

核心用法

TriMet CLI 是一款面向波特兰都会区公共交通用户的命令行工具,通过调用 TriMet 官方开放 API,提供实时到站查询、智能路线规划和运营状态提醒三大核心功能。

实时到站查询:通过 trimet arrivals <stop-id> 获取指定站点的下一班车到达时间,支持按线路过滤和 JSON 格式输出,适用于通勤者快速查看车次动态。

智能路线规划trimet trip -f <起点> -t <终点> 支持站点 ID、地标名称(如 "Pioneer Square")或地址作为起止点,并可指定到达时间(--arrive-by)或出发时间(--depart-at),帮助用户反向推算出发时刻。

运营状态监控trimet alerts 可查看全系统或特定线路的服务公告,包括延误、施工绕行等突发状况。

简化查询视图trimet next 提供更简洁的下一班车信息,支持限制返回选项数量和线路过滤。

显著优点

  • 官方数据源:直接对接 TriMet 官方 API,数据准确性与实时性有保障
  • 自然语言友好:支持 "Pioneer Square"、"PDX Airport" 等地标名称和 "5:30 PM" 等自然时间格式
  • 轻量化设计:纯文档型 Skill,本身无代码执行,依赖成熟 npm 包
  • 本地化适配:内置波特兰核心站点 ID 速查表(Pioneer Square 8383、机场 10579 等)
  • 隐私友好:仅要求用户自行配置 API 密钥,无数据收集行为

潜在局限

  • 地域限制:仅覆盖俄勒冈州波特兰都会区 TriMet 服务范围,无法用于其他城市
  • 外部依赖:需单独安装 trimet-cli npm 包并申请免费 API 密钥,增加初次配置成本
  • 无可视化界面:纯 CLI 交互,对非技术用户存在学习门槛
  • API 配额限制:免费 API 密钥存在调用频率限制,高频使用可能受限
  • 环境变量管理:API 密钥需手动配置环境变量,多设备同步不便

适合人群

  • 波特兰地区日常通勤的技术工作者
  • 需要脚本化查询公交信息的开发者
  • 偏好命令行效率的重度终端用户
  • 短期访问波特兰、需要快速掌握公共交通的游客

常规风险

  • API 密钥泄露风险:环境变量配置不当可能导致密钥暴露
  • 外部包供应链风险trimet-cli 包的更新安全性需自行关注
  • 服务中断风险:TriMet API 或 npm 包停服将导致功能失效
  • 数据准确性边界:实时数据依赖 GPS 更新,极端天气或信号盲区可能存在延迟

trimet 内容

手动下载zip · 1.4 kB
SKILL.mdtext/markdown
请选择文件