# 录音回溯

**Repository Path**: sunshinewithmoonlight/recording-retrospective

## Basic Information

- **Project Name**: 录音回溯
- **Description**: 一个简单的 Windows 系统托盘音频录制工具，可以随时保存最近5、10、30分钟的音频内容
- **Primary Language**: Rust
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-04
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 录音回溯

一个轻量级的 Windows 系统托盘音频录制工具，可以随时保存最近30分钟的音频内容。

## 功能特点

- 系统托盘运行，不占用任务栏空间
- 持续录制最近30分钟的音频
- 支持保存最近5分钟、10分钟或30分钟的录音内容
- 智能声道处理：自动混合多声道输入
- 自适应采样率：自动适配设备实际采样率
- 优化的内存使用：使用16位音频采样
- 高质量人声增强功能
- WAV 格式音频输出

## 系统要求

- Windows 64位系统
- 支持音频输入设备（麦克风或声卡录音）
- 内存占用：约150MB（30分钟录音缓冲）
- 磁盘空间：每10分钟录音文件约50MB

## 技术特点

- 优化的内存管理
  - 使用16位音频采样代替32位，减少50%内存占用
  - 动态缓冲区大小，根据设备采样率自动调整
  - 高效的环形缓冲区实现

- 智能音频处理
  - 自动检测和适配设备采样率
  - 多声道输入智能混合
  - 实时音频处理和过滤

- 人声增强功能
  - 优化的带通滤波器（200Hz-4000Hz）
  - 可调节的增益控制
  - 实时音频信号处理

## 安装说明

1. 从 Releases 页面下载最新版本的可执行文件
2. 双击运行即可，程序会在系统托盘显示图标
3. 首次运行时，音频文件默认保存在系统音频文件夹中
4. 如需开机自启动，可通过托盘菜单打开启动文件夹并创建快捷方式

## 使用方法

1. 运行程序后，将在系统托盘显示一个录音图标
2. 右键点击图标可以看到以下选项：
   - 保存5分钟录音：保存最近5分钟的录音内容，保存后自动打开文件位置
   - 保存10分钟录音：保存最近10分钟的录音内容，保存后自动打开文件位置
   - 保存30分钟录音：保存最近30分钟的录音内容，保存后自动打开文件位置
   - 人声增强：切换人声增强功能，可以提升人声清晰度
   - 打开自启动目录：打开 Windows 启动文件夹
   - 退出：关闭程序

3. 保存录音后会自动打开 Windows 资源管理器并选中保存的文件

## 开发环境

- Rust 2021 Edition
- 依赖项：
  - cpal：音频录制
  - ringbuf：音频缓冲
  - tray-icon：系统托盘支持
  - winit：Windows 事件循环
  - parking_lot：高性能互斥锁
  - crossbeam-channel：无锁通道
  - 其他依赖详见 Cargo.toml

## 构建说明

1. 安装必要工具：
```bash
rustup target add x86_64-pc-windows-gnu
```

2. 克隆仓库：
```bash
git clone [repository-url]
cd recording-retrospective
```

3. 构建发布版本：
```bash
cargo build --target x86_64-pc-windows-gnu --release
```

编译完成后，可执行文件将位于 `target/x86_64-pc-windows-gnu/release/` 目录下。

## 项目结构

```
recording-retrospective/
├── src/
│   └── main.rs          # 主程序代码
├── assets/
│   └── icon.ico         # 程序图标（支持多尺寸）
├── Cargo.toml           # 项目配置和依赖
├── build.rs            # 构建脚本
└── windows.rc          # Windows 资源文件
```

## 技术实现细节

### 音频处理优化
- 采样率自适应：程序启动时自动检测并适配设备实际采样率
- 缓冲区动态调整：根据实际采样率自动计算并分配合适的缓冲区大小
- 多声道处理：自动将多声道输入混合为高质量的单声道输出

### 内存优化
- 使用16位整型(i16)存储音频样本，相比32位浮点数减少50%内存占用
- 精确的缓冲区大小计算，避免内存浪费
- 高效的环形缓冲区实现，确保稳定的录音性能

### 音频增强
- 优化的带通滤波器参数（200Hz-4000Hz），更好地保留人声频段
- 智能增益控制，避免音频失真
- 实时音频信号处理，低延迟响应

## 注意事项

- 程序会持续录制音频，但只保留最近30分钟的内容
- 保存的音频文件格式为 WAV（16位PCM）
- 录音文件命名格式：YYMMDD.HHMMSS.wav
- 多声道输入会被自动混合为单声道输出
- 实际录音时长取决于设备的采样率
- 每10分钟录音文件大小约50MB，请确保有足够磁盘空间