# Voice Store 使用说明

这个 Zustand store 管理语音记录列表，实现了以下功能：

## 主要特性

1. **本地存储**: 使用 IndexedDB 永久保存语音数据
2. **当天记录**: 自动获取和过滤当天的语音记录
3. **音频 URL 管理**: 将 base64 数据转换为 Blob URL 供播放使用
4. **不保存 URL**: 保存时不存储 URL 地址，避免无效引用
5. **自动清理**: 页面卸载时自动释放 Blob URL 资源

## 使用方法

### 基本使用

```typescript
import { useVoiceStore } from '../store/voiceStore';

const MyComponent = () => {
  const { 
    voiceList, 
    isLoading, 
    error, 
    initialize, 
    addVoice, 
    updateVoice, 
    deleteVoice 
  } = useVoiceStore();

  // 初始化（通常在组件挂载时调用）
  useEffect(() => {
    initialize();
  }, [initialize]);

  // ... 组件逻辑
};
```

### 添加语音记录

```typescript
// 通过 Blob 添加（推荐方式）
const audioBlob = new Blob([wavBuffer], { type: 'audio/wav' });
const newRecord = await addVoice(temporaryUrl, duration, audioBlob);

// 仅通过 URL 添加
const newRecord = await addVoice(url, duration);
```

### 更新记录

```typescript
await updateVoice(recordId, {
  text: "识别的文字内容",
  speaker: "说话人名称"
});
```

### 删除记录

```typescript
await deleteVoice(recordId);
```

## 数据流程

1. **初始化**: `initialize()` 从 IndexedDB 获取当天记录
2. **生成 URL**: 为每条记录的 base64 数据生成 Blob URL
3. **添加记录**: `addVoice()` 将音频转为 base64 保存到 IndexedDB
4. **播放**: 组件使用生成的 Blob URL 播放音频
5. **清理**: 页面卸载时释放所有 Blob URL

## 存储策略

- **IndexedDB**: 存储 base64 编码的音频数据、文本、元数据
- **内存**: 临时存储 Blob URL 用于播放
- **不存储**: URL 地址不会保存到 IndexedDB

## 注意事项

1. Blob URL 仅在当前会话有效，刷新页面后会重新生成
2. 大量语音记录可能占用较多内存，建议定期清理旧记录
3. 初始化时会自动过滤当天记录，跨天使用需要重新初始化
4. 组件卸载时会自动清理资源，无需手动管理

## 错误处理

Store 提供了错误状态管理：

```typescript
const { error, setError } = useVoiceStore();

// 检查错误状态
if (error) {
  console.error('语音操作失败:', error);
}

// 清除错误
setError(null);
```

## 性能优化

- 使用 Zustand 的 devtools 进行调试
- Blob URL 按需生成，避免内存浪费
- IndexedDB 操作异步执行，不阻塞 UI
- 批量操作支持，提高大量数据处理效率