AIMisc/code-quality-system/sounds/README.md

声音资源说明

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

声音文件

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 生成

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 音效作为回退方案。