Przeglądaj źródła

📝 docs(stories): 更新STT功能实现计划和开发记录

- 添加"实现真实的转录结果监听"任务,包括AgoraSTTProvider事件监听、状态管理适配等子任务
- 在开发记录中添加版本2.0条目,记录转录结果监听分析和迁移任务
- 添加转录结果监听相关问题记录和状态管理机制确认信息
yourname 4 miesięcy temu
rodzic
commit
2525146249
1 zmienionych plików z 11 dodań i 0 usunięć
  1. 11 0
      docs/stories/005.001.story.md

+ 11 - 0
docs/stories/005.001.story.md

@@ -77,6 +77,13 @@ High - 新功能实现,增强用户体验
     - [ ] 更新管理器组件使用后端API返回的配置常量
     - [ ] 更新`common/request.ts`中的API调用,使用后端Token API而不是直接调用Agora API
     - [ ] 确保所有组件都使用统一的配置获取方式
+- [ ] **实现真实的转录结果监听**
+  - [ ] **在AgoraSTTProvider中实现事件监听**:基于Agora RTT Demo模式,实现`textstreamReceived`事件监听
+  - [ ] 在`useAgoraSTTManager.ts`中替换模拟转录结果,使用真实的`textstreamReceived`事件
+  - [ ] 实现`onTextStreamReceived`回调函数,处理`ITextstream`数据结构
+  - [ ] **适配当前项目的状态管理机制**:使用React状态(useState)和Provider模式
+  - [ ] 确保支持增量式字幕更新和临时/最终结果区分
+  - [ ] 验证Protocol Buffer数据解析正确性
 - [ ] **合并重复的钩子实现**
   - [ ] 分析`useAgoraSTT.ts`和`useAgoraSTTManager.ts`的功能重叠
   - [ ] 将`useAgoraSTT.ts`中的配置获取逻辑迁移到管理器组件
@@ -472,6 +479,7 @@ test('Token API返回配置常量', async () => {
 | 2025-09-23 | 1.7 | **架构改进**:基于Agora RTT Demo实现方式,集成管理器架构和Protocol Buffer | Bob (SM) |
 | 2025-09-24 | 1.8 | **状态检查**:发现前端配置获取不一致和钩子重复问题,状态保持为In Development | Bob (SM) |
 | 2025-09-24 | 1.9 | **E2E测试修复**:修复Agora STT端到端测试,15个测试通过,1个跳过 | Claude Code |
+| 2025-09-24 | 2.0 | **转录结果监听分析**:发现当前项目使用模拟数据而非真实事件监听,基于Agora RTT Demo添加迁移任务 | Bob (SM) |
 
 ## Dev Agent Record
 
@@ -512,6 +520,9 @@ test('Token API返回配置常量', async () => {
 - ⚠️ **前端配置不一致问题**: 管理器组件(RtcManager、RtmManager)仍使用硬编码配置,需要统一使用后端API
 - ⚠️ **钩子实现重复问题**: `useAgoraSTT.ts`和`useAgoraSTTManager.ts`存在功能重叠,需要合并统一
 - ⚠️ **Provider缺失问题**: AgoraSTTComponent需要被AgoraSTTProvider包裹,但目前页面和测试中都没有使用Provider。**重要发现**: 当前组件架构严重依赖Provider提供管理器实例,没有Provider会导致组件完全无法工作
+- ⚠️ **转录结果监听使用模拟数据**: 当前`useAgoraSTTManager.ts`使用模拟数据而非真实的`textstreamReceived`事件。**分析发现**: Agora RTT Demo中已有完整的真实转录结果监听实现,需要迁移到当前项目
+- ✅ **状态管理机制确认**: 当前项目使用React状态(useState)和Provider模式,**没有使用Redux**
+- 📋 **事件监听位置**: 转录结果监听应该在`AgoraSTTProvider`中实现,通过Provider提供管理器实例和事件监听
 
 
 ### File List [基于Agora RTT Demo架构]