版本概述

V0.3.12 是 IfAI Editor 架构演进的重要里程碑。我们引入了 ChatEventBus 事件总线系统，实现了完全解耦的消息传递架构；创建了 ContentSegmentManager 从根本上解决了 LLM 流式响应中内容与工具调用乱序的行业难题；同时建立了 IndexedDB 事务级持久化 体系，实现数据存储的工业化升级。

核心特性

1. ChatEventBus 事件总线系统（架构革命）

• 完全解耦：消息发送、流式响应、工具调用等模块通过 EventBus 通信，消除直接依赖
• 类型安全：完整的事件类型定义，编译时保证数据结构正确性
• 调试友好：所有事件自动记录，支持事件流追踪与回放

// 事件流示例chat:message:sent → PersistenceManager.saveThreadchat:stream:chunk → ContentSegmentManager.accumulatechat:tool:approved → ToolCallManager.execute

2. ContentSegmentManager 有序段管理器（行业首创）

• Phase 感知：将流式响应分为 pre-tool / in-tool / post-tool 三个阶段
• Order 保证：每个内容段携带 order 序号，确保渲染时严格按序显示
• 物理隔离：文本内容与工具调用完全分离存储，消除混乱

技术突破：这是业界首个完美解决 LLM 流式响应中"内容与工具调用交织乱序"问题的方案。

解决的问题：

❌ 修复前：工具结果插入到文本中间，导致内容错乱✅ 修复后：内容与工具调用严格按序，渲染完美

3. IndexedDB 事务级持久化（存储升级）

• 容量解放：从 LocalStorage 的 5MB 限制升级到 IndexedDB 的 GB 级容量
• 事务安全：基于 EventBus 的细粒度持久化策略发送消息：立即落盘流式响应：200ms 节流持久化响应结束：强制同步最终状态
• 自愈机制：启动时自动修复中断状态（sending/streaming → interrupted）

// 持久化流程PersistenceManager {  chat:message:sent → 立即落盘  chat:stream:chunk → 节流 200ms  chat:stream:finished → 强制同步}

4. StreamingResponseController 重构

• 多版本兼容：统一商业版（ifainew-core）与社区版（BasicAIService）的流式接口
• Finish 事件修复：商业版添加 _finish 事件监听，解决流结束后输入框禁用问题
• 工具调用累积：支持流式传输中 tool_call arguments 的增量接收与 JSON 完整性检测

5. SendMessageOrchestrator 发送编排器

• 生命周期管理：统一管理消息发送、流式接收、工具执行、持久化的完整流程
• 错误隔离：每个环节的错误独立处理，不会影响整体流程
• 可测试性：模块化设计便于单元测试与集成测试

️ 技术架构图

┌─────────────────────────────────────────────────────────────┐│                      用户界面层                               ││  (ChatInputArea, MessageItem, ToolApproval)                  │└──────────────────────┬──────────────────────────────────────┘                       │                       ▼┌─────────────────────────────────────────────────────────────┐│                   ChatEventBus (事件总线)                     ││  ┌───────────┬──────────────┬──────────────┬─────────────┐ ││  │ message   │ stream       │ tool         │ persist     │ ││  │ :sent     │ :chunk       │ :approved    │ :save       │ ││  └───────────┴──────────────┴──────────────┴─────────────┘ │└──────────────────────┬──────────────────────────────────────┘                       │        ┌──────────────┼──────────────┐        ▼              ▼              ▼┌─────────────┐ ┌─────────────┐ ┌─────────────┐│ Orchestrator│ │ Segment     │ │ Persistence ││             │ │ Manager     │ │ Manager     │└─────────────┘ └─────────────┘ └─────────────┘        │              │              │        ▼              ▼              ▼┌─────────────┐ ┌─────────────┐ ┌─────────────┐│   Stream    │ │  Message    │ │  IndexedDB  ││ Controller  │ │   Store     │ │             │└─────────────┘ └─────────────┘ └─────────────┘

测试覆盖

E2E 测试（流式排序）

• tests/e2e/stream-ordering/ 目录下新增 7 个专项测试
• 验证单工具、多工具、嵌套工具的各种流式场景
• 确保内容与工具调用的严格顺序

单元测试

• EventBus 集成测试（EventBusIntegration.test.ts）
• ContentSegmentManager 完整测试（ContentSegmentManager.test.ts）
• 覆盖正常流、异常流、边界情况

修复列表

关键修复

1. 后端 UTF-8 字符边界 Panic：
2. 根因：流式响应在处理多字节 UTF-8 字符（如中文）时，由于物理切片正好落在字符中间导致 Rust panic
3. 修复：引入字符边界感知切片逻辑，确保物理块不破坏 UTF-8 完整性
4. 多 Tab 切换消息乱序与丢失：
5. 修复：物理级消息段落 (Segments) 持久化，实现全量 Session 事务隔离，彻底根治 Tab 切换导致的持久化竞态
6. 工具聚合与 agent_write_file 异常：
7. 修复：补全缺失的 batchId 逻辑，确保并发工具调用下的自动审批与写入操作顺序正确
8. 输入框禁用问题：商业版流结束后无法输入
9. 根因：缺少 {eventId}_finish 事件监听
10. 修复：添加 Finish 事件处理逻辑
11. 社区版 Finish 事件：社区版流响应不发送结束信号
12. 根因：fetch_ai_completion 使用非流式 API
13. 修复：手动构造 finish_reason 事件
14. 工具调用参数累积：流式传输中 JSON 被截断
15. 根因：增量 chunks 直接拼接，未验证 JSON 完整性
16. 修复：使用 Index 映射 + JSON 解析验证
17. 新手引导黑屏：OnboardingTour 的 Markdown 渲染错误
18. 修复：优化动态面板联动与布局定位逻辑，增强渲染稳定性
19. Tab 自动命名：恢复了基于 AI 对话内容的 Tab 自动重命名功能

架构先进性评估

升级建议

短期（1-2 周）

• 添加 Web Worker 后台持久化
• 实现数据压缩（LZMA/Brotli）
• 添加性能监控 Metrics

中期（1-2 月）

• 引入 Background Sync API
• 实现 Service Worker 缓存
• 添加数据版本迁移机制

长期（3-6 月）

• 支持 CRDT 多端同步
• 实现增量同步协议
• 添加端到端加密

迁移指南

对开发者的影响

1. 无破坏性变更：所有公开 API 保持兼容
2. 新增能力：可订阅 EventBus 进行自定义扩展
3. 持久化透明：数据自动迁移至 IndexedDB，无需手动操作

对用户的影响

1. 容量提升：不再有 5MB 存储限制
2. 响应更快：输入框不会卡在加载状态
3. 顺序正确：工具调用不再打断文本内容

相关提交

• 05af4fb - 修复 agent_write_file 缺失 batchId 导致的工具聚合失效
• be30e7d - 修复 UTF-8 字符边界切片导致的后端崩溃 (Panic)
• 2977567 - 实现全量消息段落 (Segments) 的物理级持久化
• fba43aa - 引入有序段管理器
• 3ea6197 - 修复流式传输下的工具调用参数累积与 OpenAI API 格式兼容性
• 97ebf77 - 实现 EventBus + Session 持久化
• 5d41105 - ChatEventBus 基础设施
• fc6a9d5 - 引入 IndexedDB 存储

发布日期：2026-03-25
核心架构：PIVO 3.0 + EventBus + ContentSegmentManager