这是一套专为韩国首都圈通勤者设计的智能公交到站提醒解决方案,基于韩国国土交通部 TAGO OpenAPI 官方数据源,通过与 Clawdbot Gateway 及 cron 系统集成,实现精准的定时公交信息推送服务。
核心用法:用户可通过自然语言指令(如"평일 오전 7시, 인천 한빛초등학교, 535")快速注册工作日或周末的提醒规则。系统支持站点名称模糊搜索与方向歧义消解(当存在对向站点时会主动询问确认),并在设定时间自动查询指定线路的到达信息,通过私信(DM)方式推送至用户。提供规则列表查看、单条测试运行及带二次确认的删除功能,并配备交互式注册向导(rule_wizard)降低配置门槛。
显著优点:首先采用韩国官方 TAGO API,数据权威可靠;其次实现零第三方依赖,仅使用 Python 标准库(urllib、argparse 等),从根本上杜绝供应链攻击风险;安全设计完善,API 密钥严格通过环境变量注入,无硬编码风险,且关键操作(如删除、注册)均配备二次确认机制;隐私保护到位,采用 DM-only 投递策略,避免群组广播泄露通勤隐私;部署体验友好,提供自动化 setup.py 脚本,可一键检测并配置 systemd 用户服务。
潜在局限:目前处于 MVP 阶段,调度表达式仅支持"매일/평일/주말"三种固定模式,暂不支持自定义 cron 语法;站点解析主要依赖关键词搜索,虽有 GPS 附近查询功能但受限于区域和密钥权限可能返回空结果;系统强依赖 Clawdbot Gateway 和 cron 基础设施,部署环境要求具备 systemd 支持的 Linux 系统,对非技术用户存在一定门槛。
适合群体:主要面向已部署 Clawdbot 生态的韩国首都圈(首尔、仁川、京畿道)通勤者,特别是有固定通勤时间、需要提前掌握特定站点公交到站信息的上班族和学生群体。适合熟悉基础 Linux 命令行操作或愿意使用交互式向导完成初始配置的用户。
使用风险:作为 T3 级社区来源项目,建议在生产环境使用前进行代码审计;需严格保护 TAGO_SERVICE_KEY API 密钥,避免通过 docker compose config 等命令泄露环境变量;依赖外部 clawdbot CLI 二进制文件执行定时任务管理,虽无用户输入拼接风险,但仍需确保该工具来源可信;systemd 服务配置需用户级权限,在受限环境或企业级安全策略下可能需要额外权限申请。