隐私友好的智能位置管家

基于GPS的位置感知工具，支持隐私友好型追踪、地理围栏提醒、POI搜索与出行时间估算，数据存储本地可控。

基本信息

• 技能名称?Location Awareness
• 中文名称?隐私友好的智能位置管家
• 作者?hegghammer
• 分类?专业技能
• 版本?1.2.0
• 标签?location-tracking, geofencing, privacy, home-assistant, owntracks, gps, automation, eta, poi, reminders, self-hosted

使用方法

使用说明
核心用法
location-awareness 是一个多源位置服务聚合工具，支持 Home Assistant、OwnTracks、GPSLogger 及通用 HTTP API 四种数据源。用户可通过单一命令接口 scripts/location.sh 完成位置查询、地理围栏管理、智能提醒、POI 发现及出行规划等操作。
主要功能模块：
实时定位 ：获取当前坐标、所在区域及地图链接
ETA 计算 ：支持步行、骑行、驾车三种模式，基于 OpenStreetMap 数据估算时间与距离
地理围栏 ：自定义半径、区域标签、冷却时间，支持启用/禁用及自动化触发
位置提醒 ：一次性到达提醒，触发后自动删除
历史追溯 ：查询特定地点的到访时间、今日轨迹及停留时长统计
POI 发现 ：按类别（咖啡馆、酒吧等）搜索周边设施，支持距离筛选
显著优点

1. 隐私优先设计 ：支持自托管数据源（Home Assistant、GPSLogger），位置数据无需经过第三方云服务；纯本地配置文件管理，支持环境变量注入敏感信息
2. 多源兼容性 ：四种主流方案覆盖从智能家居生态到极简文件追踪的不同场景
3. 灵活的自动化集成 ：通过 OpenClaw 内置 cron 实现周期性检查与通知，无需外部 systemd 服务
4. 语义化地理围栏 ：支持区域（region）和类别（category）标签，便于批量筛选与管理
5. 离线友好 ：基于 OpenStreetMap 的地理编码与 POI 数据，减少商业 API 依赖
   潜在缺点与局限性
   数据源依赖 ：需用户自行配置并维护 Home Assistant、OwnTracks 或 GPSLogger，无开箱即用的托管服务
   精度受限 ：GPSLogger 文件模式存在刷新延迟；HTTP 模式依赖外部 API 稳定性
   移动端适配 ：无原生移动应用，依赖第三方追踪工具的数据推送
   电池消耗 ：持续 GPS 追踪对移动设备电量影响需用户自行权衡
   地理编码局限 ：OpenStreetMap 在某些地区的 POI 覆盖度和地址解析准确性可能不及 Google Maps
   适合人群
   已部署 Home Assistant 或注重自托管隐私的技术用户
   需要基于位置的自动化工作流（如到家触发家务提醒、离开公司发送状态更新）
   通勤规划与日常轨迹管理的效率工具爱好者
   对商业位置服务数据收集持谨慎态度的隐私敏感用户
   常规风险
   位置数据泄露 ：配置文件若权限设置不当，可能导致家庭坐标等敏感信息暴露
   API 令牌管理 ：Home Assistant/OwnTracks 的长期访问令牌需安全存储，建议优先使用环境变量注入
   地理围栏误触发 ：半径设置过小或 GPS 漂移可能导致频繁误报；冷却时间配置不当可能遗漏有效触发
   自动化依赖 ：cron 任务若配置错误可能导致提醒遗漏或重复通知