huckleberry

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 本身无高危操作，但错误的成长数据录入（如单位混淆）可能导致误判，使用时需仔细核对计量单位（公制/英制）。