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