# 声音资源说明

这个目录包含代码质量检查系统的提示音文件。

## 声音文件

### success.wav
- **用途**: 检查通过时播放
- **特征**: 愉悦、轻松、短促
- **建议**: 800Hz 频率，200ms 时长

### warning.wav
- **用途**: 检查未通过需要修复时播放
- **特征**: 警示、引起注意但不刺耳
- **建议**: 400Hz 频率，300ms 时长

### attention.wav
- **用途**: 需要深度审查时播放
- **特征**: 重要、需要立即关注
- **建议**: 600Hz 频率，400ms 时长

## 生成方法

### 方法 1: 使用 Windows 系统声音（默认回退方案）
如果声音文件不存在，系统会自动使用 Windows `winsound.Beep()` 生成简单的提示音。

### 方法 2: 使用在线工具生成
1. 访问 https://www.beepbox.net 或类似的在线音效生成器
2. 创建简单的音效
3. 导出为 WAV 格式
4. 放置到此目录

### 方法 3: 使用 Python 生成
```python
import numpy as np
from scipy.io import wavfile

def generate_beep(frequency, duration_ms, volume=0.5):
    sample_rate = 44100
    t = np.linspace(0, duration_ms/1000, int(sample_rate * duration_ms/1000))
    wave = np.sin(2 * np.pi * frequency * t) * volume
    wave = (wave * 32767).astype(np.int16)
    wavfile.write('success.wav', sample_rate, wave)

generate_beep(800, 200)  # 成功音
generate_beep(400, 300)  # 警告音
generate_beep(600, 400)  # 注意音
```

### 方法 4: 使用免费音效库
从以下网站下载免费的短音效：
- Freesound.org
- Zapsplat.com
- Mixkit.co

搜索关键词：beep, notification, success, warning, alert

## 注意事项

- 文件大小：建议每个文件 < 50KB
- 格式：WAV（最佳兼容性）
- 采样率：44.1kHz 或 48kHz
- 位深度：16-bit
- 声道：单声道或立体声都可以

## 快速开始

如果没有声音文件，系统仍然可以正常工作，会使用 Windows 系统 Beep 音效作为回退方案。