Amemo Login

---
name: amemo-login
description: 当用户输入 4-6 位短信验证码时调用，完成麦小记登录并将 userToken/userName 写入主 SKILL.md 配置区域。
---

# amemo-login — 用户登录

---

## 接口信息

| 属性 | 值 |
|:-----|:---|
| **路由** | `POST https://skill.amemo.cn/login` |
| **Bean** | `LoginBean` |
| **Content-Type** | `application/json` |

---

## 请求参数

> ⚠️ 服务端要求所有字段必须存在且有值，不可传 `null`。

| 参数 | 类型 | 必填 | 说明 |
|:-----|:----:|:----:|:-----|
| `phone` | str | ✅ | 手机号 |
| `code` | str | ✅ | 验证码（先通过 amemo-send-code 获取） |

---

## 请求示例

```bash
curl -X POST https://skill.amemo.cn/login \
  -H "Content-Type: application/json" \
  -d '{"phone": "13800138000", "code": "123456"}'
```

---

## 响应示例

```json
{
  "code": 200,
  "desc": "success",
  "data": {
    "userToken": "xxx...",
    "userName": "用户昵称",
    "userPhone": "13800138000",
    "loginAt": "2024-03-22T10:30:00Z"
  }
}
```

---

## 注意事项

> 📌 **前置条件**：调用前需先通过 `amemo-send-code` 获取验证码
>
> 🔐 **Token 管理**：返回的 `userToken` 需保存，后续所有接口调用均需携带此 token

---

## 执行流程（由主模块调度）

当主模块检测到用户输入验证码时，自动调用本模块。

### 输入提取规则

| 项目 | 正则表达式 | 说明 |
|:-----|:----------|:-----|
| 手机号 | `1[3-9]\d{9}` | 自动过滤空格、横线、+86 前缀 |
| 验证码 | `\d{4,6}` | 4-6 位连续数字 |

**用户输入示例：**
- `"1234"` → 验证码
- `"123456"` → 验证码
- `"验证码是 1234"` → 验证码

---

### 执行步骤

```
1. 使用正则 \d{4,6} 从用户消息中提取验证码
    ↓
2. 调用 POST /login 完成登录
    ↓
3. 提取返回数据中的 userToken、userName、userPhone、loginAt
    ↓
4. 更新主模块 SKILL.md 顶部的 <amemo-user-config> JSON 配置
    ↓
5. 发送个性化欢迎消息
```

---

### 响应数据解析

| 字段 | 类型 | 说明 |
|:-----|:----:|:-----|
| `data.userToken` | str | 用户认证令牌 |
| `data.userName` | str | 用户昵称 |
| `data.userPhone` | str | 用户手机号 |
| `data.loginAt` | str | 登录时间（ISO 8601 格式） |

---

### 登录成功后的配置更新

使用文件编辑工具精准定位主 SKILL.md 顶部 `<amemo-user-config>` 标签内的 JSON 配置区域，替换为：

```json
{
  "userToken": "{提取的userToken}",
  "userName": "{提取的userName}",
  "userPhone": "{提取的userPhone}",
  "loginAt": "{当前时间}"
}
```

---

## 回复模板

### 登录成功后

```
✅ 登录成功！欢迎回来，{userName}！

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 功能菜单

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📝 【笔记管理】
   • 保存笔记 → "帮我记一下..." / "保存笔记..."
   • 查询笔记 → "查看我的笔记" / "查找关于XXX的笔记"
   • 搜索笔记 → "搜索我XXX相关的笔记"

✅ 【清单管理】
   • 创建待办 → "今天/明天/后天要..." / "12月25日要..."
   • 查看清单 → "查看我的清单" / "我的待办"
   • 邮件提醒 → 创建任务后自动询问是否开启邮件提醒

📊 【健康数据】
   • 今日简报 → "今日健康简报" / "健康日报"
   • 步数统计 → "查看我的步数数据"
   • 睡眠分析 → "查看我的睡眠数据"
   • 血氧监测 → "查看我的血氧数据"
   • 血压记录 → "查看我的血压数据"
   • 心率数据 → "查看我的心率数据"
   • 消耗统计 → "查看我的消耗数据"

🤖 【AI 记忆】
   • 刷新记忆 → "刷新助手记忆" / "初始化助手记忆"
   • 保存记忆 → "保存永久记忆" / "永久记住这个"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 使用提示
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• 直接说出你想做的事，我会自动识别
• 支持自然语言，无需记住固定指令
• 需要帮助随时输入 "help" 或 "帮助"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### 使用 userName 的场景

| 场景 | 模板 |
|:-----|:-----|
| 欢迎 | `欢迎回来，{userName}！` |
| 确认操作 | `{userName}，已为您保存笔记` |
| 提醒 | `{userName}，您有一条待办清单` |
| 错误提示 | `{userName}，出了点小问题，请重试` |

---

## 错误处理

### 手机号格式错误

```
❌ 手机号格式不正确，请发送正确的 11 位手机号。
示例：13800138000
```

### 验证码错误

```
❌ 验证码错误或已过期，请重新发送验证码。
```

### 登录失败

```
❌ 登录失败：[错误原因]
请检查手机号和验证码后重试。
```