经期管理 / Period Tracker

经期管理 / Period Tracker - 女性健康周期追踪工具。全自然语言交互，无需记命令。功能：(1) 经期记录 - 说'月经来了'即可记录；(2) 症状记录 - 说'痛经2级'或'心情烦躁'；(3) 周期预测 - 说'下次月经什么时候'；(4) 排卵期管理 - 受孕概率日历；(5) 定时提醒 - 说'帮我设置经期提醒'；(6) 健康统计；(7) 数据导出。触发词：记录经期、月经来了、大姨妈、排卵期、安全期、易孕期、受孕概率、备孕、经期统计、月经周期、经期日历、经期提醒。

全自然语言交互 - 无需记命令，直接对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`