half-full

half-full（半饱）是一款专为职场人士设计的轻量级命令行饮食记录与健康管理工具，以"生活的高潮所在"为理念，倡导正念饮食（mindful eating），摒弃了传统健身应用复杂的社交功能和云端依赖，专注于提供纯粹、私密的本地化健康管理体验。

核心用法
用户通过简洁的命令行交互记录每日用餐情况，支持拍照存档、自动计算营养成分（基于简化版 USDA 数据库）、追踪体重变化趋势。所有数据均以 JSON 格式存储在本地 data/ 目录下，无需注册账号或网络连接即可查看历史记录、分析摄入趋势，真正实现数据自主掌控。

显著优点
隐私保护是该工具最突出的优势。作为纯本地应用，所有饮食记录、体重数据均存储在用户设备，不存在云端泄露风险，特别适合注重数据隐私的用户。技术架构上，工具仅依赖 Python 标准库（json、os、argparse 等），无第三方包依赖，从根本上避免了供应链攻击风险。安全性方面，采用 argparse 进行严格的参数类型检查与边界限制，文件操作使用安全路径计算，无 SQL 注入、命令注入或路径遍历风险。权限设计合理，仅申请必要的本地文件读写权限，无过度授权问题。

潜在缺点与局限性
纯本地架构也带来了功能局限：缺乏多设备同步能力，无法在手机与电脑间无缝切换，只适合单设备使用场景。数据来源为个人开发者（T3 等级），长期维护能力和代码审计频率不如大型组织或企业级项目。交互界面为命令行模式，对非技术用户不够友好，缺少图形化界面和可视化图表。此外，内置营养数据库为简化版本，不适合需要专业医疗级饮食分析或精确营养素计算的用户。

适合的目标群体
这款工具最适合以下人群：注重隐私保护的上班族，希望饮食数据完全掌握在自己手中；极简主义者，不需要复杂的社交功能、云服务和订阅模式；具备基础命令行使用能力的技术用户；以及仅需基础饮食记录和体重追踪，无需专业营养分析的轻量级健康管理需求者。

使用风险
尽管获得 A 级安全评级，用户仍需注意：数据备份责任完全由个人承担，本地 JSON 文件若未定期备份，设备故障将导致数据永久丢失；作为个人项目，未来功能更新和漏洞修复存在不确定性；虽然当前版本无网络通信，但用户应谨慎对待版本更新，确保后续版本保持本地化处理原则；此外，命令行操作对普通用户有一定学习门槛，误操作可能导致数据录入错误或误删记录。