经期管理 / Period Tracker

经期管理 / Period Tracker - 女性健康周期追踪工具。全自然语言交互，无需记命令。功能：(1) 经期记录 - 说'月经来了'即可记录；(2) 症状记录 - 说'痛经2级'或'心情烦躁'；(3) 周期预测 - 说'下次月经什么时候'；(4) 排卵期管理 - 受孕概率日历；(5) 定时提醒 - 说'帮...

Security Scan

The skill is internally coherent for a local period-tracker: it stores data in a local JSON file, provides prediction and reminder features, and the included scripts match the documented behavior; no unexplained network exfiltration or unrelated credentials are requested.

Purpose & Capability

Name/description (period tracking, ovulation, reminders) aligns with the code and SKILL.md. Minor mismatch: SKILL.md/registry declare no required binaries, but the code optionally invokes 'clawhub' (for update checks) and uses the system 'crontab' command for reminders. These are plausible for the stated purpose but should be noted.

Instruction Scope

Runtime instructions and scripts operate on local data (~/.openclaw/workspace/period_tracker/data.json), run local commands (python3, crontab), and schedule cron jobs. They do not call external web endpoints or read unrelated system credentials. The reminder script parses and rewrites the user's crontab — this is expected for a reminder feature but is a privileged local operation.

Install Mechanism

No install spec (instruction-only with bundled scripts). Nothing is downloaded from external URLs or extracted. Risk from install mechanism is low.

Credentials

The skill requests no environment variables or external credentials. All data is stored locally in a JSON file; the requested access (filesystem and crontab) is proportionate to the stated features.

Persistence & Privilege

The skill does not set always:true and does not request elevated system permissions, but setup_reminder.py will read and overwrite the user's crontab to add scheduled jobs. This grants the skill persistent scheduled execution (as the user) and should be confirmed by the user before enabling reminders.

Assessment

What to consider before installing: - Privacy: all health data is stored locally at ~/.openclaw/workspace/period_tracker/data.json; it is not uploaded by the code. If you want stronger protection, back up/encrypt or delete the file when not needed. - Crontab changes: the reminder script reads and rewrites your user crontab to add scheduled notifications. Review the exact cron lines before allowing setup and be aware it will run the script as your user at scheduled times. - Local commands: the code may invoke 'crontab' and (optionally) 'clawhub' to check updates. If you do not have clawhub installed, that call is wrapped in try/except and will silently do nothing. If you do have clawhub, update-check behavior will run the local binary — consider whether you trust that tool. - Version mismatch: registry metadata shows 1.2.0 while the script's CURRENT_VERSION is 1.1.0 — not a security issue by itself but indicates maintenance/versioning inconsistency you may want to confirm. - Audit before enabling: inspect the cron entries that will be added and the data file contents if you have sensitive notes. If you only want ephemeral use, avoid enabling persistent reminders or delete cron entries after use. Overall this appears coherent and consistent with a local period-tracker; the primary risks are local (crontab modification and storage of sensitive health data) rather than unexplained network or credential access.

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