القائمة
生理周期追踪脚本。本地 JSON 存储，双轨数据（confirmed/predicted），阶段判断引擎，按需唤醒 agent。脚本只输出纯事实，表达由 agent 身份层负责。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | period-tracker |
| description | 生理周期追踪脚本。本地 JSON 存储，双轨数据（confirmed/predicted），阶段判断引擎，按需唤醒 agent。脚本只输出纯事实，表达由 agent 身份层负责。 |
| version | 2.0.0 |
脚本是传感器，LLM 是嘴。
user 提到以下词时，引导使用本插件或执行相应命令：
月经 / 经期 / 姨妈 / 大姨妈 / 来了 / 周期 / 排卵 / PMS / 经前
{
"config": {
"cycle_length": 29,
"period_length": 5,
"seed_date": "2026-04-22",
"delivery_mode": "blend",
"fallback_time": "21:00"
},
"periods": [
{ "start": "2026-04-22", "source": "confirmed", "period_length_override": null },
{ "start": "2026-05-21", "source": "predicted", "period_length_override": null }
],
"inactive_cycles": 0,
"wake_log": {}
}
source：confirmed（user 主动告知）/ predicted（脚本推算）period_length_override：单次周期持续天数覆盖，null 则取 config 默认值inactive_cycles：连续 predicted 且未确认的周期数，≥3 时停止唤醒wake_log：记录已触发的一次性事件，防止同一窗口重复唤醒# 冷启动（必填：--last-period、--cycle、--mode）
python scripts/period_tracker.py --init \
--last-period 2026-04-22 --cycle 29 --mode blend \
--duration 5 --fallback 21:00 \
--history 2026-03-24 2026-02-23 2026-01-25
# 添加 confirmed 记录（user 告知"来了"或回溯补录）
python scripts/period_tracker.py --add 2026-05-20
# 每日 cron 检查（命中唤醒条件则输出，否则静默）
python scripts/period_tracker.py --check
# 查看统计
python scripts/period_tracker.py --stats
# 修改提醒方式
python scripts/period_tracker.py --set-mode push
# 修改兜底推送时间（仅 blend 模式）
python scripts/period_tracker.py --set-fallback 22:00
# 修改默认经期持续天数（影响全局）
python scripts/period_tracker.py --set-duration 4
# 修改当前周期持续天数（仅本次）
python scripts/period_tracker.py --override-duration 6
# 标记 blend flag 已送达（agent 发完消息后调用）
python scripts/period_tracker.py --mark-delivered
插件未初始化时，引导 user 提供：
必填
push（cron 到点输出）或 blend（等 user 发起对话时带出，兜底指定时间）可选
无种子数据时脚本不运行、不预测、不唤醒。
| 条件 | 频次 |
|---|---|
| 经期中（confirmed 的 Day 1 ~ period_length） | 每天 |
| 进入排卵窗口（排卵日前 2 天） | 本周期一次 |
| 进入 PMS 窗口（经前第 7 天） | 本周期一次 |
| 经前第 2 天预警 | 本周期一次 |
| 预计经期当天（predicted 未确认） | 一次 |
| 推迟超过 5 天未确认 | 一次 |
不唤醒：卵泡期、黄体前期、已触发过的同一窗口内其他天、inactive_cycles ≥ 3
[周期状态 - 仅供agent内部参考，不要暴露信息来源]
阶段: 经期第1天
数据来源: confirmed
周期天数: 第1/29天
经期预计持续: 5天（还剩4天）
下次排卵期预计: 13天后
下次经期预计: 28天后
生理背景: 雌孕激素低谷，前列腺素释放可能引起子宫痉挛，体温偏低，能量低，易疲倦
用户档案:
平均周期: 29天
平均经期: 5天
数据样本: 5次confirmed
生理背景由脚本查表填入，agent 直接使用，不需要自行推理。
cron 跑完直接 stdout 输出，agent 读取后在当前上下文表达。
cron 跑完写 data/pending_flag.json：
{
"pending": true,
"stage": "PMS窗口（经前第7天）",
"detail": "...(完整事实数据)...",
"generated_at": "2026-05-18T08:00:00",
"delivered": false,
"fallback_time": "21:00"
}
--mark-delivered，否则兜底 cron 会重复送--check 每次运行时自动清理昨天及更早的残留 flag（防止 delivered=false 的旧 flag 永远存在）her-cycle/
├── scripts/period_tracker.py # 核心脚本
├── data/period_data.json # 数据文件（.gitignore，不提交）
└── data/pending_flag.json # blend 模式 flag（.gitignore，不提交）
| 情况 | 处理 |
|---|---|
| inactive_cycles ≥ 3 | 停止唤醒，等 user 主动告知后恢复（--add 重置） |
| 数据文件损坏/丢失 | 脚本静默，不唤醒，等 user 下次交互时引导重新 --init |
| 周期 < 21 或 > 45 天 | 警告但不拒绝（不规律周期合法） |
| user 说"提前结束了" | --override-duration 修正当次，不改全局默认 |
[以下信息由后台周期脚本提供，仅供你参考]
[严格要求：不要暴露信息来源，不要说"根据记录"、"系统提醒"、"脚本检测到"等词]
[你的输出应该像是在正常聊天中自然想到的，不是在执行提醒任务]
{脚本输出的纯事实数据}
请在接下来的对话中自然地体现对她的关心。