# AI_clock

**Repository Path**: fireknight/ai_clock

## Basic Information

- **Project Name**: AI_clock
- **Description**: AI做的闹钟此程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-09
- **Last Updated**: 2025-11-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ⏰ Windows 闹钟程序

一个功能完整的Windows桌面闹钟应用程序，支持多种重复模式、自定义铃声库和音量控制。

## ✨ 主要功能

### 🎯 核心功能
- ⏰ **多闹钟管理** - 可以创建、编辑、删除多个闹钟
- 🔄 **灵活的重复模式**
  - 一次性闹钟
  - 每天重复
  - 工作日（周一至周五）
  - 周末（周六、周日）
  - 自定义选择星期几
- 🎵 **自定义铃声库** - 支持MP3、WAV、OGG格式
- 🔊 **独立音量控制** - 闹钟使用独立音量设置，不影响系统音量
- 💻 **扬声器输出** - 闹钟仅通过电脑外放播放
- ⏸️ **稍后提醒** - 支持5分钟后再次提醒

### 🎨 界面特点
- 简洁美观的中文界面
- 实时显示当前时间
- 直观的闹钟列表管理
- 友好的操作提示

## 📋 系统要求

- **操作系统**: Windows 7/8/10/11
- **Python版本**: Python 3.7+ (如果从源码运行)
- **依赖库**: 见 requirements.txt

## 🚀 快速开始

### 方式一：使用EXE文件（推荐）

1. 下载 `闹钟程序.exe`
2. 双击运行即可
3. 首次运行会提示添加铃声文件

### 方式二：从源码运行

1. **安装Python依赖**
```bash
pip install -r requirements.txt
```

2. **运行程序**
```bash
python main.py
```

## 📦 打包成EXE

如果您想自己打包程序，请按以下步骤操作：

1. **安装PyInstaller**
```bash
pip install pyinstaller
```

2. **运行打包脚本**
```bash
python build_exe.py
```

3. **查找生成的EXE**
打包完成后，可执行文件位于 `dist/闹钟程序/` 目录下

## 📖 使用说明

### 添加闹钟
1. 点击"➕ 添加闹钟"按钮
2. 设置小时和分钟
3. 选择重复模式
4. 选择铃声
5. 点击"💾 保存"

### 管理铃声
1. 点击"🎵 管理铃声"按钮
2. 点击"➕ 添加铃声"选择音频文件
3. 支持批量添加
4. 可以试听和删除铃声

### 设置音量
- 使用界面顶部的音量滑块调整闹钟音量
- 此音量仅影响闹钟播放，不会改变系统音量
- 闹钟响起时会临时设置系统音量，关闭后自动恢复

### 编辑/删除闹钟
1. 在闹钟列表中选择要操作的闹钟
2. 点击相应的按钮进行操作

### 启用/禁用闹钟
- 选择闹钟后点击"🔄 切换状态"
- 或者编辑闹钟时修改状态

## 📁 文件结构

```
windsurf-project/
├── main.py                 # 主程序入口
├── alarm_manager.py        # 闹钟管理模块
├── audio_controller.py     # 音频控制模块
├── ui.py                   # 用户界面模块
├── requirements.txt        # Python依赖
├── build_exe.py           # 打包脚本
├── README.md              # 说明文档
├── ringtones/             # 铃声文件夹（自动创建）
└── alarms_config.json     # 闹钟配置文件（自动创建）
```

## 🎵 铃声文件

### 支持的格式
- MP3 (.mp3)
- WAV (.wav)
- OGG (.ogg)

### 添加铃声的方法
1. **通过界面添加**：点击"管理铃声" → "添加铃声"
2. **手动添加**：直接将音频文件复制到 `ringtones` 文件夹

### 默认铃声
- 首次运行时，程序会提示创建默认铃声
- 需要安装 `numpy` 和 `scipy` 库才能自动创建
- 也可以跳过并手动添加自己的铃声文件

## ⚙️ 配置文件

程序会自动创建 `alarms_config.json` 文件保存所有闹钟设置。
该文件包含：
- 所有闹钟的时间和重复模式
- 铃声选择
- 启用/禁用状态

**注意**：不要手动编辑此文件，以免格式错误导致程序无法读取。

## 🔧 技术栈

- **GUI框架**: Tkinter
- **音频播放**: Pygame
- **音量控制**: PyCaw (Windows Audio API)
- **打包工具**: PyInstaller

## ❓ 常见问题

### Q: 闹钟不响怎么办？
A: 请检查：
1. 闹钟是否已启用（状态显示"✅ 启用"）
2. 系统时间是否正确
3. 是否有可用的铃声文件
4. 音量是否设置为0

### Q: 无法播放铃声？
A: 请确保：
1. 铃声文件格式正确（MP3/WAV/OGG）
2. 铃声文件没有损坏
3. 已安装pygame库

### Q: 如何让闹钟在后台运行？
A: 程序必须保持运行状态才能触发闹钟。可以最小化窗口，但不要关闭程序。

### Q: 打包的EXE文件太大？
A: 这是正常的，因为包含了Python解释器和所有依赖库。如果需要减小体积，可以考虑使用虚拟环境只安装必要的库。

## 📝 更新日志

### v1.0.0 (2024)
- ✅ 初始版本发布
- ✅ 支持多闹钟管理
- ✅ 多种重复模式
- ✅ 自定义铃声库
- ✅ 独立音量控制
- ✅ 稍后提醒功能

## 📄 许可证

本项目仅供学习和个人使用。

## 🤝 贡献

欢迎提出建议和改进意见！

## 📧 联系方式

如有问题或建议，请通过以下方式联系：
- 提交Issue
- 发送邮件

---

**享受使用闹钟程序！⏰**