cycle

女性健康周期追踪

追踪月经周期、PMS症状、排卵期预测，提供个性化健康洞察。

操作类型

1. 记录周期开始 - start

记录月经开始日期，自动计算预测日期。

参数说明：

• description: 周期描述（可选），自然语言描述
• date: 开始日期（可选），格式 YYYY-MM-DD，默认为今天

示例：

/cycle start 今天来月经了
/cycle start 2025-12-28
/cycle start 这个月28号
/cycle start 记录月经开始 12月28日 腹痛

执行步骤：

1. 解析输入

从自然语言中提取：

• 日期信息：今天/指定日期
• 症状关键词：腹痛、腰酸、头痛等
• 流量描述：量很大、正常、量少等

2. 验证输入

检查项：

• 日期不能是未来日期
• 如果有未结束的周期，提示先结束
• 验证日期格式

错误处理：

⚠️ 检测到未结束的周期

当前周期：2025年11月28日开始
提示：请先使用 /cycle end 结束当前周期

3. 创建周期记录

生成 cycle_id：cycle_YYYYMMDD

• 示例：cycle_20251228

周期数据结构：

{
  "cycle_id": "cycle_20251228",
  "period_start": "2025-12-28",
  "period_end": null,
  "cycle_length": null,
  "period_length": null,
  "flow_pattern": {},
  "pms_symptoms": {
    "start_date": null,
    "symptoms": {}
  },
  "daily_logs": [],
  "ovulation_date": null,
  "predictions": {},
  "notes": "",
  "created_at": "2025-12-28T08:00:00.000Z",
  "completed": false
}

4. 计算预测日期

算法：

1. 获取历史周期数据：从 cycle-tracker.json 读取已完成的周期
2. 计算平均周期长度：使用最近6个周期
3. 预测下次月经：period_start + average_cycle_length
4. 预测排卵日期：next_period - 14 days
5. 计算易孕期：ovulation_date - 5 days 至 ovulation_date + 1 day

默认值（无历史数据）：

• 平均周期长度：28天
• 平均经期长度：5天
• 排卵日期：下次月经前14天

5. 更新数据文件

文件 1：data/cycle-tracker.json

{
  "cycles": [
    // ... 添加新周期到数组
  ],
  "current_cycle": {
    "period_start": "2025-12-28",
    "period_end": null,
    "cycle_length": null,
    "predicted_ovulation": "2026-01-11",
    "predicted_next_period": "2026-01-25",
    "days_since_start": 0
  },
  "statistics": {
    // ... 更新统计数据
  },
  "predictions": {
    "next_period": "2026-01-25",
    "ovulation_date": "2026-01-11",
    "fertile_window_start": "2026-01-06",
    "fertile_window_end": "2026-01-12",
    "confidence": "low"
  }
}

文件 2：data/周期记录/YYYY-MM/YYYY-MM-DD_周期记录.json

{
  "id": "cycle_20251228",
  "period_start": "2025-12-28",
  "period_end": null,
  "created_at": "2025-12-28T08:00:00.000Z",
  "initial_symptoms": ["腹痛"],
  "daily_logs": [],
  "metadata": {
    "completed": false
  }
}