huckleberry

👶 自然语言婴儿活动智能记录管家

基于 Huckleberry 官方 API,支持自然语言快速记录婴儿睡眠、喂养与成长数据,简化育儿日志管理。

收藏
9.1k
安装
2k
版本
v1.0.1
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Huckleberry Baby Tracker 是一款通过命令行接口与 Huckleberry 婴儿追踪应用交互的 Skill,基于反向工程的 Python API 客户端实现。它允许家长通过自然语言或 CLI 命令快速记录婴儿的睡眠、喂养、尿布更换及成长数据,所有记录实时同步至 Huckleberry 的 Firebase 后端,与移动端应用保持数据一致。

核心用法围绕 hb.py 脚本展开,支持多种活动类型的精细化管理。睡眠追踪提供完整的计时器功能(开始、暂停、恢复、完成),母乳喂养支持左右侧切换与时长记录,奶瓶喂养可记录奶量与类型(配方奶/母乳),尿布更换则提供详细的生理指标记录(颜色、质地、量)。此外,成长数据(体重、身高、头围)和历史查询功能帮助家长全面掌握婴儿发育趋势。对于多子女家庭,可通过 --child 参数指定不同孩子。

显著优点在于其自然语言交互能力与数据完整性保障。Agent 能够解析"宝宝睡着了"、"左边喂奶"等日常用语并转换为精确命令,大幅降低记录门槛。所有数据通过 Firebase Firestore gRPC 接口实时同步,确保移动端即时可见。特别值得注意的是其 AI 归因机制,自动在备注中添加"Created via AI"标记,建立数据审计追踪。详细的参数验证(如尿布颜色、大便质地的医学参考)也体现了专业育儿知识整合。

潜在局限性主要包括来源可信度与功能边界。作为 T3 级个人开发者项目,虽然代码已开源可审计,但长期维护稳定性不及商业产品。该 Skill 依赖 Woyken/py-huckleberry-api 这一社区维护的反向工程库,若 Huckleberry 官方 API 变更可能导致功能失效。此外,部分 Huckleberry 原生功能(如睡眠环境标记、情绪状态记录)因上游 API 限制尚未支持。配置过程需要用户提供 Huckleberry 账户密码,虽支持环境变量和配置文件管理,但仍存在凭据泄露风险。

适合的目标群体明确指向已使用 Huckleberry 移动应用的家长,特别是习惯命令行操作或希望通过 AI Agent 快速记录育儿数据的用户。对于需要详细医学记录(如新生儿黄疸监测、精确喂养计量)的家庭,其细粒度的尿布和喂养记录功能具有实用价值。同时,多子女家庭的支持使其适合托儿所或保育员使用。

使用风险主要集中在数据安全与隐私层面。尽管代码本身无恶意行为,但用户需将 Huckleberry 账户凭据配置在本地环境变量或 ~/.config/huckleberry/credentials.json 文件中,建议严格设置文件权限(chmod 600)。由于数据通过第三方库传输至 Firebase,用户应充分了解 Huckleberry 的隐私政策。网络依赖意味着离线状态下无法记录,且若 Huckleberry 服务或 API 发生变更,可能导致数据同步失败。此外,虽然 Skill 本身无高危操作,但错误的成长数据录入(如单位混淆)可能导致误判,使用时需仔细核对计量单位(公制/英制)。

安全解读

核心用法

Huckleberry Baby Tracker是一个基于Python CLI的婴儿活动追踪工具,通过反向工程Huckleberry应用的Firebase后端API实现。用户可通过自然语言指令(如"宝宝睡着了"、"左边喂奶")触发相应的命令行操作,自动记录睡眠、母乳喂养、奶瓶喂养、尿布更换和生长数据。

主要功能模块:

  • 睡眠追踪:启动/暂停/恢复/完成睡眠计时器
  • 母乳喂养:左右侧切换、暂停恢复、时长累计
  • 奶瓶喂养:支持母乳/配方奶/混合,ml/oz单位
  • 尿布记录:详细记录大小便量、颜色、质地(含健康提示)
  • 生长数据:体重、身高、头围测量,公制/英制切换
  • 历史查询:按日期/天数/类型筛选查看记录

安装配置:
需从GitHub安装huckleberry-api库(PyPI版本暂不支持奶瓶喂养),配置邮箱密码环境变量或本地JSON凭证文件。

显著优点

1. 效率优先:CLI操作比手机App更快,适合电脑旁带娃场景
2. 自然语言友好:AI Agent可解析口语化指令自动转换命令

3. 数据透明:直接访问Firestore,可导出JSON历史数据

4. 多设备同步:修改实时同步到Huckleberry手机App

5. 详细记录:尿布颜色/质地指南内置健康参考信息

潜在缺点与局限性

1. 依赖风险:核心库来自个人GitHub仓库,非官方维护,存在供应链安全风险
2. 凭证安全:需存储Huckleberry账户密码,不支持2FA

3. 功能缺口:不支持睡眠情绪状态、睡眠地点等Huckleberry原生功能

4. API稳定性:Firebase接口变更可能导致功能中断

5. 隐私顾虑:婴儿敏感数据上传至第三方云服务

适合人群

  • 习惯终端/命令行操作的技术型父母
  • 需要快速记录、减少手机操作干扰的育儿场景
  • 希望将婴儿数据整合到个人自动化工作流的用户
  • 已有Huckleberry App使用基础,希望扩展CLI能力的用户

常规风险

  • 凭证泄露:配置文件权限不当可能导致密码暴露
  • 数据丢失:上游API变更或账户问题可能影响数据访问
  • 隐私合规:缺乏GDPR明确的同意机制,数据跨境存储
  • 误操作:自然语言理解偏差可能导致错误记录(需人工确认关键数据)

huckleberry 内容

scripts文件夹
手动下载zip · 9.5 kB
hb.pytext/plain
请选择文件