经期管理 / Period Tracker#

全自然语言交互 - 无需记命令，直接对AI助手说话即可。

快速开始#

告诉你的AI助手：

• "月经来了" → 自动记录经期
• "痛经2级" 或 "心情烦躁" → 记录症状
• "下次月经什么时候" → 查看预测
• "帮我设置经期提醒" → 设置定时提醒

核心功能#

功能自然语言指令说明记录经期"月经来了" / "大姨妈来了"自动记录开始日期记录症状"痛经3级" / "心情烦躁" / "经血量多"记录痛经、情绪、经血量查看状态"今天什么情况"显示经期状态、排卵信息、受孕概率周期预测"下次月经什么时候"预测下次经期、排卵日定时提醒"帮我设置经期提醒" / "每天早上9点发报告"自动提醒经期和排卵检查更新"检查更新" / "更新skill"自动检查并更新到最新版本健康统计"查看统计"平均周期、规律性分析数据导出"导出数据"导出JSON/CSV格式

技术信息#

• 核心脚本： scripts/period_tracker.py
• 数据文件： ~/.openclaw/workspace/period_tracker/data.json
• 依赖：Python 3（标准库，无需安装额外包）
• 数据存储：本地JSON文件，不上传云端

示例交互#

用户： 月经来了

AI： ✅ 已记录经期：2026-03-18。可以说"痛经2级"记录症状。

用户： 痛经2级

AI： ✅ 已记录：痛经2级。

用户： 今天什么情况

AI： 📍 今日状态：经期第1天，还有5天结束。排卵日：4月1日...

用户： 帮我设置经期提醒

AI： ✅ 已设置！预测经期前3天自动提醒。

用户： 检查更新

AI： 🆕 发现新版本：1.2.0，是否更新？(y/n)

隐私说明#

• 所有数据存储在本地电脑
• 不上传任何服务器
• 无需注册账号
• 数据文件可随时导出或删除

添加经期记录#

python3 $SCRIPT add 2025-03-01 --end 2025-03-06

--pain 3 --flow 中 --mood 烦躁 --tags 头痛,腰痛

预测下次经期 + 排卵期 + 安全期 + 今日受孕概率#

python3 $SCRIPT predict

排卵期管理（7天受孕概率日历 + 备孕建议）#

python3 $SCRIPT ovulation

健康统计报告#

python3 $SCRIPT stats

年度日历（含排卵日/易孕期标注）#

python3 $SCRIPT calendar --year 2025

历史记录列表#

python3 $SCRIPT list --limit 10

导出数据#

python3 $SCRIPT export --format csv # 或 json

编辑/删除记录#

python3 $SCRIPT edit 2025-03-01 --end 2025-03-06 python3 $SCRIPT delete 2025-03-01

text

---

## 用户请求处理指南

### 记录经期

| 用户说 | 操作 |
|--------|------|
| "月经来了" / "大姨妈来了" | 询问开始日期 → `add <start>` |
| "月经结束了" | 询问结束日期 → `edit <start> --end <end>` |
| "从3月1号到6号，痛经比较严重" | `add 2025-03-01 --end 2025-03-06 --pain 4` |

### 症状参数

| 参数 | 取值 | 说明 |
|------|------|------|
| `--pain` | 1-5 | 1=轻微，5=剧烈 |
| `--flow` | 少/中/多 | 经血量 |
| `--mood` | 开心/平静/烦躁/低落/焦虑 | 情绪 |
| `--tags` | 逗号分隔 | 头痛、腰痛、痘痘、浮肿等 |

### 排卵期 & 受孕概率

用户说"排卵期" / "易孕期" / "受孕概率" / "备孕"
→ 调用 `ovulation`

受孕概率分级：
- 🔴 排卵日：最高（25-30%）
- 🟠 排卵前1-2天：高（20-25%）
- 🟡 排卵前3-5天：中（10-15%）
- 🔵 排卵后1-2天：低（5-10%）
- 🟢 其他时间：极低（< 3%）

### 今日状态

用户说"今天是什么时期" / "今天安全吗"
→ 调用 `today`，输出：经期中/排卵日/易孕期/安全期 + 受孕概率

---

## 数据格式

详见 `references/data-schema.md`