calorie-detective-v1-0-2

# 🔍 热量侦探 v1.0.0

🕵️ **再隐蔽的热量也逃不过我的眼睛！**

通过 AI 视觉识别技术，像侦探一样找出食物中隐藏的热量，自动计算卡路里和营养成分，帮助你更好地管理饮食健康。

## ✨ 功能特性

1. **📸 拍照识别** - 上传食物照片，AI 自动识别食物种类
2. **🔥 卡路里计算** - 自动计算总卡路里和宏量营养素
3. **📊 营养报告** - 生成详细的营养分析报告
4. **💡 健康建议** - 提供饮食改进建议
5. **🌐 中文优化** - 专为中餐优化，识别更准确
6. **💾 本地数据库** - 内置常见食物营养数据

## 🚀 快速开始

### 方式 1：Kimi Claw 一键部署（推荐）

```bash
# 1. 访问 Kimi 控制台
https://platform.moonshot.cn/console/claw

# 2. 上传 skill 包
# 选择 calorie-detective-v1.0.2.zip

# 3. 使用 config/kimi_claw.yaml 配置

# 4. 部署完成后，在 Kimi 中使用：
/卡路里 [上传食物照片]
```

**优点：**
- ✅ 一键部署，无需配置环境
- ✅ 自动扩展，无需管理服务器
- ✅ 使用 K2.5 模型（Allegretto 套餐包含）
- ✅ 支持自然语言触发

---

### 方式 2：本地安装

```bash
# 解压 skill
unzip calorie-detective-v1.0.2.zip -d calorie-detective
cd calorie-detective

# 安装依赖
pip install -r requirements.txt

# 配置 API Key
export KIMI_API_KEY="your_kimi_key"

# 运行
./run.sh data/food.jpg
```

## ⚙️ 配置

### 配置 API Key

**方式 1：环境变量（推荐）**
```bash
export KIMI_API_KEY="your_kimi_key"
```

**方式 2：配置文件**
编辑 `config/config.local.yaml`：
```yaml
api_keys:
  kimi: "your_kimi_key"
```

**获取 Kimi API Key：**
1. 访问 https://platform.moonshot.cn
2. 注册/登录账号
3. 进入控制台 → API Keys
4. 创建新 Key
5. 新用户注册送免费额度

### config/config.yaml

```yaml
# 视觉识别配置
vision:
  provider: kimi        # 推荐使用 Kimi
  model: moonshot-v1-auto
  
# 使用限制
usage:
  max_requests_per_day: 10
  max_requests_per_user: 5
```

## 📤 输出示例

```
🕵️ **热量侦探 - 营养分析报告**

📝 一碗牛肉拉面，配有青菜和红油汤底

📊 **营养分析**

🔥 总卡路里：**696 大卡**
💪 蛋白质：26.4g
🍚 碳水化合物：50.9g
🥑 脂肪：43.1g

📋 **详细分解**

• **面条** (1 碗)
  - 卡路里：220 大卡
  - 蛋白质：5.0g | 碳水：50g | 脂肪：1.0g

• **牛肉** (80 克)...