FatSecret 营养 API 技能评估
核心用法
FatSecret 技能提供了与 FatSecret 营养数据库的完整集成，支持 OAuth2（只读） 和 OAuth1（读写） 两种认证模式：
- OAuth2 模式：无需用户登录，可直接进行食品搜索、条形码查询、食谱搜索
- OAuth1 模式：需一次性用户授权（PIN 码），支持饮食日记的读写操作
CLI 命令涵盖 search（食品搜索）、barcode（条码识别）、recipes（食谱搜索）、log/quick（日记记录）等。Agent 集成通过 fatsecret_agent_helper.py 提供状态检查、认证流程、快捷记录等封装函数。
显著优点
1. 官方数据源：直接对接 FatSecret 官方 API，营养数据权威可靠
2. 双模式认证：灵活区分只读查询与日记写入场景
3. 本地凭证管理：OAuth token 与 API 密钥存储于 ~/.config/fatsecret/，用户可控
4. 备用数据源：内置 Open Food Facts 客户端，覆盖欧洲产品免认证查询
5. 代理支持：可选 SOCKS5 代理配置，解决 IP 白名单限制
潜在缺点与局限性
1. 认证复杂度：OAuth1 三-legged 流程需用户交互，对自动化场景不够友好
2. 地理限制：FatSecret 数据库以北美为主，亚洲/欧洲部分产品覆盖不足（需依赖 Open Food Facts 补充）
3. token 持久性：OAuth1 token 长期有效，一旦泄露需手动撤销
4. 速率限制：未明确说明 API 调用频次上限，高并发场景存在风险
5. 隐私依赖：日记数据上传至 FatSecret 云端，非完全本地化管理
适合人群
- 需要精准营养数据查询的健身/减脂用户
- 希望自动化饮食记录的习惯追踪者
- 开发健康饮食助手的 AI Agent 开发者
- 能够完成 OAuth 授权流程的技术用户
常规风险
- 凭证泄露：本地存储的 Consumer Secret 和 OAuth token 若未加密，存在被恶意读取风险
- 授权过度：OAuth1 授予完整日记读写权限，用户可能未充分理解权限范围
- 服务依赖：FatSecret API 服务可用性直接影响技能功能
- 数据隐私：饮食记录上传第三方平台，涉及个人健康数据跨境传输