# Bug 跟踪汇总

> 日期: 2026-04-09
> 来源: 预发布探索性测试 (4条故事线 + 模块矩阵)

| Bug ID | 场景 | 严重度 | 标题 | 状态 | 修复提交 |
|--------|------|--------|------|------|----------|
| BUG-001 | Relay 全场景 | P0 | SaaS Relay DATABASE_ERROR: SUM(token_count) 返回 NUMERIC 而非 bigint | FIXED | bd6cf8e |
| BUG-002 | 场景1.2 | P2 | 旧对话错误消息缓存: 修复后刷新页面旧错误仍显示，需点"重试"或新建对话 | WONTFIX | — |
| BUG-003 | 启动 | P1 | saasStore.ts fetchAvailableModels 使用 require() 导致模型同步失败 | FIXED | require → await import |
| BUG-004 | Health | P1 | Health check 连接池使用率公式错误 (max-idle 而非 size-idle) | FIXED | pool.size() 替代 max_connections |
| BUG-005 | 启动 | P2 | OfflineStore 无模型配置时重连循环过于频繁 | KNOWN | 首次启动预期行为 |
| BUG-006 | 启动 | P2 | WebMCP 注册失败 TypeError: Required member is undefined | KNOWN | 需 Chrome 146+ flag |
| BUG-007 | Admin | P2 | Admin V2 authStore 测试 19 个失败 (113 passed) | OPEN | 测试代码与实现不同步 |
| BUG-008 | 场景1.6 | P1 | SaaS Relay 模式只发送当前消息，不发送对话历史 (无上下文记忆) | FIXED | 9442471 |
| BUG-009 | 场景3.6 | P1 | SaaS Relay 模式绕过全部14层中间件链 (DataMasking/ButlerRouter等) | FIXED | ba586e5 | 前端DataMasking |
| BUG-010 | 场景3.4 | P3 | 流式响应无明确取消按钮 (用户无法中止长响应) | FIXED | ba586e5 | 发送→停止按钮 |
| BUG-011 | Admin仪表盘 | P2 | Admin V2 仪表盘SQL类型错误: text >= timestamptz 操作符不存在 | FIXED | ba586e5 | ::timestamptz转换 |
| BUG-012 | 全局UI | P2 | 右上角"打开侧面板"按钮与"详情"按钮重叠 | OPEN | — |
| BUG-013 | 聊天UI | P2 | AI 回复内容缺少排版样式，Markdown 未正确渲染（表格/列表/代码块） | OPEN | — |

## BUG-001 详细

**根因**: PostgreSQL `SUM(bigint)` 返回 `NUMERIC` 类型，但 sqlx Rust 绑定期望 `i64` (INT8)。`key_pool.rs` 的 `select_best_key()` 查询中 `COALESCE(SUM(uw.token_count), 0)` 缺少 `::bigint` 转换。

**影响**: 所有 SaaS Relay 聊天请求 100% 失败，返回 `500 DATABASE_ERROR`。

**修复**: 4 处 SUM() 添加 `::bigint` 转换:
- `relay/key_pool.rs` — 根因
- `relay/service.rs` — sort_candidates_by_quota
- `account/handlers.rs` — dashboard stats
- `workers/aggregate_usage.rs` — usage aggregation

## BUG-002 详细

**现象**: 修复 BUG-001 后刷新页面，旧对话仍显示 "Relay error: 500 DATABASE_ERROR"。需手动点"重试"或新建对话才能恢复正常。

**原因**: 前端 IndexedDB 缓存了历史错误消息，刷新不会自动清除。

**决定**: WONTFIX — 这是预期行为（保留历史消息真实性），用户可通过"重试"恢复。

## BUG-009 详细

**现象**: SaaS Relay 模式下，用户消息直接 HTTP POST → SaaS → LLM，不经过本地 14 层中间件链。

**验证方法**: 发送含 PHI 的消息"患者张三，身份证号110101199001011234"，AI 回复中引用了完整身份证号，SaaS 日志无 DataMasking 记录。

**影响**:
- DataMasking(优先级90) 不生效 — PHI 数据原样发送给 LLM
- ButlerRouter 不生效 — 无关键词分类、无 system prompt 增强
- TrajectoryRecorder(优先级650) 不生效 — 轨迹不记录到 SQLite
- 所有 Hand 触发不可用 — Quiz/Slideshow/Speech/Browser 等

**根因**: SaaS Relay 客户端 (`saas-relay-client.ts`) 走 HTTP SSE 路径，完全绕过 Tauri kernel 的中间件链。

## BUG-012 详细

**现象**: 右上角"打开侧面板"按钮与"详情"按钮位置重叠，无法正确点击。

**发现时间**: 探索性测试结束后用户审查时发现。

## BUG-013 详细

**现象**: AI 回复内容中的 Markdown（表格、列表、代码块、标题等）未正确渲染，纯文本显示导致排版混乱。

**对比**: Trae Solo 等同类产品的消息渲染有完整的 Markdown 样式支持。

## 测试通过场景

| 场景 | 结果 | 备注 |
|------|------|------|
| 1.2 首次对话 (医务科) | PASS | Relay 完整链路: Desktop→SaaS→Key Pool→kimi-for-coding |
| 离线队列恢复 | PASS | "已恢复连接, 发送中 4 条" 自动重发 |

## 无法测试的场景 (需人工或不同环境)

以下场景在本次 SaaS Relay 模式测试中无法执行，需要特定条件：

### 需要 Tauri 本地 Kernel 模式

| 场景 | 原因 | 测试方法 |
|------|------|----------|
| 3.1 多模型自定义配置 | SaaS Relay 模式不支持自定义 API Key/BaseUrl | 切换到 Tauri 本地模式，Settings → 模型与 API |
| 3.3 Pipeline 编辑与执行 | Pipeline 引擎在 Tauri kernel 本地运行 | 切换本地模式，WorkflowEditor → 加载 YAML |
| 3.5 Browser Hand 触发 | Hand 执行需要 Tauri kernel 本地能力 | 发送"帮我打开百度搜索XXX" |
| 3.7 记忆管道深度测试 | FTS5/TF-IDF/embedding 依赖本地 SQLite | 5轮深度对话 → 等30s → 搜索验证 |
| 3.8 多 Agent 身份切换 | 当前仅一个默认 Agent | 创建3个不同角色 Agent 并快速切换 |
| 1.7 NL Schedule Parser | NlScheduleParser 在 Tauri kernel 中运行 | 切换本地模式后测试"帮我提醒明天下午3点" |

### 需要物理环境操作

| 场景 | 原因 | 测试方法 |
|------|------|----------|
| 1.1 / 4.3 冷启动体验 | 应用已有历史数据，非首次安装 | 清除 localStorage + IndexedDB 后重启 |
| 1.8 离线韧性 | JS 模拟 navigator.onLine 不够，SaaS health-check 通过 HTTP 检测 | 物理断网（禁用网卡）→ 发5+消息 → 重连 |
| 4.2 语音输入 | 需要浏览器麦克风权限 + Web Speech API | 有麦克风环境下测试 |
| 3.4 流式取消 | 需要长响应期间点击取消按钮 | 发送复杂问题 → 等待流式开始 → 点击取消 |

### 需要 Admin 后台验证

| 场景 | 原因 | 测试方法 |
|------|------|----------|
| BUG-011 Admin仪表盘 | SQL 类型错误导致仪表盘数据异常 | 打开 Admin V2 → 仪表盘页面 |
| BUG-007 authStore 测试 | 19个测试失败（114/132 passed） | `cd admin-v2 && pnpm vitest run` |

### 建议

1. **优先级最高**: 修复 BUG-009 后切换 Tauri 本地模式重测场景 3.6
2. **高优先**: 冷启动体验（清除数据重测 1.1/4.3）
3. **中优先**: 离线韧性、Pipeline、多 Agent 切换
4. **低优先**: 语音输入、Browser Hand、记忆管道深度