CycleSync

智能经期追踪 | AI驱动预测 | 隐私优先

在线体验 · 功能介绍 · 快速开始

---

功能特性

AI 智能预测

• 基于历史数据和症状信号综合分析
• 识别 PMS 症状模式，提前预警
• 自然语言表达预测结果（如"预计明天来"）
• 提供个性化健康建议

周期追踪

• 直观的日历视图
• 记录经期、症状、心情
• 自动计算周期长度和排卵期
• 受孕窗口提示

隐私保护

• 数据本地存储 - 所有数据保存在你的设备上
• API Key 加密 - 使用 AES-GCM 加密存储
• 无服务器 - 纯前端应用，无数据上传
• 开源透明 - 代码完全公开可审计

现代体验

• PWA 支持，可安装到桌面
• 离线可用
• 响应式设计，适配手机和平板
• 支持中英双语

---

快速开始

在线使用

访问 https://dweb-channel.github.io/cyclesync/

本地开发

# 克隆项目
git clone https://github.com/dweb-channel/cyclesync.git
cd cyclesync

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 运行测试
npm test

---

配置 AI 功能

CycleSync 使用 智谱 AI 提供智能预测功能。

1. 访问 智谱开放平台 注册账号
2. 创建 API Key
3. 在应用的 设置 页面输入 API Key
4. 开始享受 AI 智能预测

API Key 仅存储在你的浏览器本地，不会上传到任何服务器。

---

技术栈

类别	技术
框架	React 19 + TypeScript 5.8
构建	Vite 6
样式	Tailwind CSS
存储	IndexedDB + LocalStorage
AI	智谱 GLM-4-Flash
PWA	vite-plugin-pwa
加密	Web Crypto API (AES-GCM)

---

项目结构

cyclesync/
├── components/          # React 组件
│   ├── calendar/       # 日历视图
│   ├── dashboard/      # 仪表板
│   ├── modals/         # 弹窗组件
│   └── settings/       # 设置页面
├── hooks/              # 自定义 Hooks
├── services/           # 业务逻辑
│   ├── aiService.ts    # AI 预测服务
│   ├── crypto/         # 加密模块
│   └── storage/        # 数据存储
├── utils/              # 工具函数
├── constants/          # 常量定义
└── types.ts            # 类型定义

---

AI 预测原理

历史经期数据 ──┐
              ├──► AI 综合分析 ──► 预测结果
症状/心情记录 ──┘         │
                         ▼
                   ┌─────────────┐
                   │ 预计后天来   │
                   │ 置信度: HIGH │
                   │ 症状分析...  │
                   └─────────────┘

分析因素：

• 历史周期长度和规律性
• PMS 症状信号（乳房胀痛、情绪波动等）
• 心情变化趋势
• 周期标准差（评估置信度）

---

贡献指南

欢迎提交 Issue 和 Pull Request！

# 运行测试
npm test

# 代码检查
npm run lint

---

开源协议

MIT License

---

用心呵护每一天

Made with love