This repository has been archived on 2026-03-09. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
AIMisc/code-quality-system/sounds/README.md
T
2026-01-30 00:42:33 +08:00

69 lines
1.9 KiB
Markdown

# 声音资源说明
这个目录包含代码质量检查系统的提示音文件。
## 声音文件
### 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 音效作为回退方案。