# Butler Bot 使用指南 🤖

欢迎使用 Butler，您的 **Bio-Hacker 级个人健康助手**。
本指南将帮助您全面掌握 Bot 的各项能力，从基础记录到深度数据洞察。

---

## 1. 核心能力概览

Butler 的核心逻辑是 **"Data First"**（数据驱动）。它不会凭空给出建议，而是基于您的真实生理数据（Garmin）和行为日志（手动记录）进行分析。

| 模块 | 功能 | 典型场景 |
| :--- | :--- | :--- |
| **Garmin Sync** | 自动同步手表数据 | "昨天睡得怎么样？" |
| **Manual Log** | 记录饮食、补剂、感受 | "记录摄入400mg甘氨酸镁" |
| **Health Analyst** | 深度关联分析 | "镁片真的改善了我的深睡吗？" |
| **Web Search** | 实时科学检索 | "查询最新的长寿研究" |
| **Vision** | *多模态识别 (暂不可用)* | *拍照识别餐食热量* |

---

## 2. 工具与指令使用 (Tool Usage)

Bot 内置了数十个 Function Calls，您只需用自然语言对话，无需记忆硬指令。

### 🩺 数据记录 (Logging)
*   **饮食**: "记录早餐：两个鸡蛋一杯咖啡" / "刚吃了一顿欺骗餐"
*   **补剂**: "记录补充了 Vitamin D3 5000IU" / "Log supplement: Creatine 5g"
*   **感受**: "感觉今天很不舒服，头痛，压力大" (Bot 会记录严重程度 1-10)
*   **断食**: "开始 OMAD 断食模式" / "今天采用 16:8 断食"

### 📊 数据查询 (Reading)
*   **生理指标**: "我今天的静息心率是多少？" / "看看我这周的睡眠趋势"
*   **历史回顾**: "上周我一共喝了几次酒？" / "查一下我最近的压力水平"

### 🧠 深度分析 (Enhanced Analytics) **[NEW]**
这是 Butler 最强大的 Bio-Hacking 功能，支持**因果分析**。

*   **关联性 (Correlation)**:
    *   *指令*: "分析饮酒对第二天睡眠的影响"
    *   *原理*: 自动计算 `Alcohol Units(T)` 与 `Sleep Score(T+1)` 的相关系数。
*   **分组对比 (Group Comparison)**:
    *   *指令*: "比较我有吃镁片和没吃镁片日子的深睡时长"
    *   *原理*: 将历史数据分为 `Has Magnesium` 和 `No Magnesium` 两组，进行 A/B Test。
*   **图片识别**: 支持发送食物图片进行卡路里估算，或发送图表进行分析。
    *   *注意*: 图片在发送给模型前会自动调整为最大 1024x1024 分辨率并进行压缩，以确保响应速度和稳定性。
*   **健康建议**: 基于你的历史数据提供个性化建议。
*   **趋势洞察 (Trends)**:
    *   *指令*: "分析我过去90天的有氧适能趋势" (RHR vs Activity)

---

## 3. 联网搜索 (Web Search)

Butler 集成了 DuckDuckGo 实时搜索。

*   **什么时候自动触发？**
    *   当您询问最新的科学研究（"Search for latest studies on NMN"）。
    *   当您询问客观事实（"berberine side effects"）。
    *   当需要验证某个健康理论时。
*   **隐私说明**:
    搜索内容仅限于关键词，**绝对不会**上传您的个人健康数据到搜索引擎。

---

## 4. 常见问题排查 (Troubleshooting)

### 图片识别不可用 / Bot 无法看到图片
如果您发送图片后 Bot 提示 "I cannot see the image" 或 "无法获取图片内容"，通常是因为 Slack App 缺少文件下载权限。

**解决方法**:
1. 进入 [Slack Apps Console](https://api.slack.com/apps).
2. 选择您的 Bot 应用 -> 左侧菜单 **OAuth & Permissions**.
3. 向下滚动到 **Bot Token Scopes**.
4. 确保已添加 **`files:read`** 权限 (Authorization to read files).
5. 滚动到顶部点击 **Reinstall to Workspace** 以应用更改.

---

## 5. 数据使用与隐私 (Data Privacy)

Butler 是一个 **Local-First** 的设计。

*   **存储位置**: 所有数据（JSON Logs, SQLite Cache）均存储在您本地的 `/data/health/` 目录下。
*   **LLM 交互**:
    *   Manual Logs 和 Garmin Data 会作为 Context 发送给 Gemini LLM 进行推理。
    *   **敏感信息脱敏**: 代码中已对敏感字段（如精确 GPS）进行了过滤，仅发送统计级健康数据。
*   **Obsidian 同步**:
    *   Bot 每天会自动生成一篇 Markdown 格式的健康日报，同步到您的 Obsidian 库中，作为您的永久健康档案。

---

## 5. 提示词灵感 (Prompt Library)

复制以下 Prompt，激发 Butler 的全部潜能：

### 为了获得更好的分析：
> "作为一名 Tech Executive，我最近感觉精力下降。请调取我过去 30 天的睡眠、压力和运动数据，结合我记录的饮食日志，帮我分析可能的原因。如果需要，可以对比工作日和周末的数据差异。"

### 为了测试补剂效果：
> "我已经连续两周服用 Ashwagandha（南非醉伽）了。请用 `analyze_driver` 工具帮我分析一下，这期间我的 平均压力水平(Average Stress) 是否比之前有所下降？"

### 为了制定计划：
> "基于我目前的 RHR (静息心率) 和 Body Battery 趋势，帮我设计下周的跑步训练计划。请确保包含足够的恢复日，因为我最近压力很大。"

---

*Generated by Butler Team (Agent Antigravity) v1.2*