From 87537e7c53db949728820460fe3787957d17fb3d Mon Sep 17 00:00:00 2001 From: iven Date: Thu, 9 Apr 2026 23:02:58 +0800 Subject: [PATCH] test: storyline 2/3/4 exploratory test results + BUG-009/010 Storyline 2 (Teacher): 3 PASS, 1 FAIL (BUG-008 confirmed) Storyline 3 (Tech user): SSE verified, model switch OK, BUG-009 middleware bypass Storyline 4 (Mom): 3 PASS, scene 4.3 anomalous BUG-008 behavior with kimi New findings: - BUG-009 (P1): SaaS Relay bypasses all 14 middleware layers - BUG-010 (P3): No cancel button during streaming --- ...026-04-09-exploratory-test-suite-design.md | 760 ++++++++++++++++++ .../2026-04-09-exploratory/bug-tracker.md | 2 + .../storyline-2-wanglaoshi.md | 70 ++ .../storyline-3-jike.md | 183 +++++ .../storyline-4-mama.md | 62 ++ 5 files changed, 1077 insertions(+) create mode 100644 docs/superpowers/specs/2026-04-09-exploratory-test-suite-design.md create mode 100644 docs/test-results/2026-04-09-exploratory/storyline-2-wanglaoshi.md create mode 100644 docs/test-results/2026-04-09-exploratory/storyline-3-jike.md create mode 100644 docs/test-results/2026-04-09-exploratory/storyline-4-mama.md diff --git a/docs/superpowers/specs/2026-04-09-exploratory-test-suite-design.md b/docs/superpowers/specs/2026-04-09-exploratory-test-suite-design.md new file mode 100644 index 0000000..57bfbfd --- /dev/null +++ b/docs/superpowers/specs/2026-04-09-exploratory-test-suite-design.md @@ -0,0 +1,760 @@ +# ZCLAW 预发布探索性测试套件设计 + +> **日期**: 2026-04-09 +> **目标**: 三端全链路探索式真实场景测试，体验流畅无阻断 +> **范围**: 桌面端 + SaaS + Admin V2 +> **画像**: 医院行政 / 教学教师 / 技术用户 / 零基础小白 + +## 设计理念 + +结构化的探索性测试套件，以四个角色驱动的用户故事线（Part 1）为核心，辅以功能模块矩阵（Part 2）全面覆盖，加上执行框架（Part 3）确保严格性。 + +--- + +## Part 1: 用户故事线（4 条） + +### 故事线 1: 医院行政"小李" — 管家模式日常行政 + +**画像**: 28岁医院行政，医务科，处理会议纪要/数据报告/政策合规。无技术背景。 + +--- + +#### 场景 1.1: 首次启动 — 冷启动问候 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 启动 ZCLAW | 简洁 UI 模式（SimpleTopBar + SimpleSidebar） | +| 2 | 观察初始屏幕 | FirstConversationPrompt 欢迎屏 + 5个快速操作 chip | +| 3 | 验证问候消息 | 显示 agent 名称 + emoji + 领域介绍 | +| 4 | 检查冷启动状态 | localStorage('zclaw-cold-start-state') = "idle" | + +**三级验证**: +- Desktop: SimpleSidebar 显示对话 tab + 搜索框 +- SaaS: 无网络调用（纯本地状态） +- Admin: N/A + +**体验检查**: 首次渲染 < 2s, 无闪烁/布局偏移 + +**边界探测**: 关闭重开 → 冷启动状态是否持久？切换专业模式 → 问候语行为？ + +--- + +#### 场景 1.2: 首次对话 — 科室识别 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 输入"我是医务科的，主要负责医疗质量管理和会诊安排" | 消息作为用户气泡出现，流式指示器开始 | +| 2 | 等待响应 | AI 流式响应，确认科室和职责。ButlerRouter 分类为 healthcare 域 | +| 3 | 验证流式完整性 | 响应完成，无残留"发送中..." | +| 4 | 检查侧边栏 | 对话出现在 SimpleSidebar 列表中 | +| 5 | 检查记忆提取 | (等30s防抖) memory-extractor 触发存储科室信息 | + +**三级验证**: +- Desktop: streamStore.isStreaming true→false, messageStore 2条消息 +- SaaS: relay 收到请求, Token pool 选择 key, PostgreSQL 记录遥测 +- Admin: 使用量页面显示新 token 消耗 + +**体验检查**: 首 token < 3s(GLM-4-Flash), 无空助手消息, 无 UI 冻结 + +**边界探测**: 流式中途发第二条消息, 断网, 500+字符超长输入 + +--- + +#### 场景 1.3: 生成会议纪要（Pipeline） + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 输入"帮我整理今天的会议纪要：[3段会议记录]" | ButlerRouter 分类为 meeting 域 | +| 2 | 等待 AI 响应 | 生成结构化纪要（出席/讨论/决议/行动项） | +| 3 | 切换到专业模式 | UI 平滑切换，完整 TopBar + Sidebar + RightPanel | +| 4 | 导航到 Pipelines 面板 | `pipelines/healthcare/meeting-minutes.yaml` 模板可见 | +| 5 | 触发管道 | 输入会议内容，执行 DAG: 提取→结构化→格式化 | + +**体验检查**: 模式切换动画流畅(AnimatePresence), Pipeline 步骤实时可见 + +--- + +#### 场景 1.4: 数据报告生成（Collector Hand） + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 输入"帮我收集这个月各科室的门诊量和住院数据" | ButlerRouter 分类为 data_report 域 | +| 2 | 观察 Hand 触发 | Collector Hand 触发, 批准提示出现 | +| 3 | 批准执行 | Hand 运行，"收集中..."状态 | +| 4 | 等待完成 | 结果在聊天中显示为结构化格式 | + +**体验检查**: 批准模态框清晰, Hand 执行有加载指示器, 失败有描述性错误 + +--- + +#### 场景 1.5: 政策合规检查 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 输入"请帮我检查这份新的住院患者转科管理制度是否符合最新规定：[政策文本]" | ButlerRouter 分类为 policy 域 | +| 2 | 等待 AI 分析 | 逐点合规分析 + 法规引用 | +| 3 | 请求格式化报告 | 生成正式合规审查报告 | +| 4 | "把报告要点做成PPT" | Slideshow Hand 触发 | + +**体验检查**: PPT 输出正确渲染 + +**后端验证**: DataMasking 中间件应剥离患者敏感数据 — 通过 Rust 日志(log::info!)确认 LLM 提示中身份证号被替换为 [REDACTED]，或查看 SQLite trajectory_store 中记录的实际 prompt + +--- + +#### 场景 1.6: 痛点持久化与记忆召回 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 关闭并重启 ZCLAW | 之前对话在侧边栏列出 | +| 2 | 输入"上周的会议纪要能帮我调出来吗？" | FTS5 搜索记忆，回忆上下文 | +| 3 | 验证记忆注入 | AI 引用过去科室信息无需重新询问 | +| 4 | 检查 ButlerPanel (专业模式) | 洞察/记忆部分有内容 | +| 5 | 检查 PainStorage 持久性 | SQLite pain_storage 表有条目 | + +--- + +#### 场景 1.7: 预约 — NL Schedule Parser + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 输入"帮我提醒明天下午3点准备质量月报" | NlScheduleParser 转换为 cron | +| 2 | 验证识别 | 系统确认时间和任务 | +| 3 | 检查定时任务 | Settings → 定时任务 tab 可见 | + +**边界探测**: "下周 sometime"(模糊), "昨天下午3点"(过去时间), "每周一三五早上9点"(复杂) + +--- + +#### 场景 1.8: 离线韧性 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 发消息时断网 | OfflineIndicator 出现，消息入 offlineStore 队列 | +| 2 | 重连 | health-check 检测到连接，队列消息刷新 | +| 3 | 验证无消息丢失 | 所有消息在历史中完整 | + +**边界探测**: 队列5+条消息后重连, 重连期间 SaaS unreachable → 降级到本地 Kernel + +--- + +### 故事线 2: 教师"王老师" — 教学内容创作 + +**画像**: 35岁小学教师，三年级班主任。创建测验/幻灯片/语音内容。 + +--- + +#### 场景 2.1: 首次启动 — 教育欢迎 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 使用教育模板 Agent 启动 | 冷启动问候面向教师 | +| 2 | 回复"我是三年级2班的班主任，班里38个学生" | AI 记住班级信息 | +| 3 | 验证 Agent 身份 | 名称/角色匹配教育模板 | + +--- + +#### 场景 2.2: 测验生成（Quiz Hand） + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | "帮我出一套三年级语文第三单元的测验题，5道选择题" | Quiz Hand 触发(自动执行) | +| 2 | 等待输出 | 生成5道选择题+答案+解析 | +| 3 | 验证测验内容 | 5道选择题格式正确、有答案+解析+难度 | +| 4 | (如有交互式测验 UI) 测试答题功能 | 如渲染了 quiz UI 可交互答题；否则验证内容在聊天中正确显示 | +| 5 | "根据答题情况调整难度" | AI 响应难度调整请求 | + +**边界探测**: 模糊主题"出测验题"(应询问), 超高数量"出100道题"(应限制/警告) + +--- + +#### 场景 2.3: 课件幻灯片（Slideshow Hand） + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | "帮我做一节关于《桂林山水》的公开课课件，10页" | Slideshow Hand 触发 | +| 2 | 等待生成 | 结构化幻灯片(标题/内容/备注) | +| 3 | 预览幻灯片 | 专用查看器渲染 | +| 4 | "第三页加一个课堂讨论环节" | AI 更新幻灯片 | + +--- + +#### 场景 2.4: 语音合成（Speech Hand） + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | "朗读一下这段课文：桂林山水甲天下..." | Speech Hand 触发 | +| 2 | 验证音频播放 | Browser TTS 生成音频，播放控件出现 | +| 3 | 测试暂停/恢复 | 控件正常工作 | + +**体验检查**: 音频清晰, 中文语音, 控件响应迅速 + +**边界探测**: 超长文本(1000+字)→应分块, 空文本超时处理 + +--- + +#### 场景 2.5: 学生分析 + 跨会话记忆 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | "帮我分析一下张小明，注意力不集中但动手能力强" | AI 个性化分析 | +| 2 | "刘小花呢？上课认真但考试紧张" | AI 记住两个学生 | +| 3 | 新对话问"上次讨论的学生还记得吗？" | Memory pipeline 召回 | + +--- + +#### 场景 2.6: 教育 Pipeline（课程计划） + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 专业模式 → Pipelines → education/lesson-plan.yaml | +| 2 | 填写：主题=桂林山水, 年级=三年级, 时长=40分钟 | +| 3 | 执行管道 | DAG 步骤完成，输出结构化课程计划 | + +--- + +#### 场景 2.7: 技能发现 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | "我想创建一个互动课堂活动" | SemanticSkillRouter 匹配 classroom-generator | +| 2 | 技能执行 | 正确 Tauri 命令 + 参数 | + +--- + +### 故事线 3: 技术用户"极客张" — 复杂工作流 + +**画像**: 30岁软件工程师，测试边缘和系统边界。专业 UI 模式默认。 + +--- + +#### 场景 3.1: 多模型配置 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | Settings → 模型与 API | 添加自定义模型页面 | +| 2 | 添加 DeepSeek: apiKey + baseUrl | OS keyring 存储(非 localStorage) | +| 3 | 切换到自定义模型 | 下拉选择 DeepSeek | +| 4 | 发送消息 | 通过 DeepSeek API 路由，流式响应 | +| 5 | 检查用量 | UsageStats 显示使用量 | + +**边界探测**: 无效 API key → 清晰错误, 空 key → 阻止保存 + +--- + +#### 场景 3.2: Agent 创建与模板 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 侧边栏 → 分身 → 创建 | 创建页面打开 | +| 2 | 选择 SaaS 模板 | fetchAvailableTemplates() 加载列表 | +| 3 | 自定义并保存 | Tauri invoke('agent_create') → SOUL.md 写入磁盘 | +| 4 | 切换 Agent | UI 更新为新身份 | +| 5 | 验证 SOUL.md | 磁盘文件包含正确人格/场景/模型配置(通过 Rust 日志或 `cat ~/.zclaw/agents//SOUL.md` 确认) | + +**边界探测**: 超长 system prompt(10000+字), 1MB JSON 导入, 删除当前活跃 Agent + +--- + +#### 场景 3.3: Pipeline 编辑与执行 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | WorkflowEditor → 加载 research/literature-review.yaml | +| 2 | 修改: 添加步骤, 更改参数 | +| 3 | 保存并执行 | DAG 按依赖顺序运行 | +| 4 | 检查结果 | PipelineResultPreview 显示输出 | +| 5 | 检查历史 | WorkflowHistory 记录运行 | + +**边界探测**: 循环依赖 → 验证错误, 步骤失败 → ActionError 传播, 取消执行 + +--- + +#### 场景 3.4: SaaS Relay 模式（关键缺口） + +> 这是最大的测试缺口 — SaaSRelay 无自动化测试。 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 切换连接模式为 'saas' | connectionStore.getClient() 返回 SaaSRelayGatewayClient | +| 2 | 发送消息 | HTTP POST → SaaS relay → SSE 流式返回 | +| 3 | 验证 SSE 解析 | delta 正确, onDelta 接收内容, onComplete 在 [DONE] 触发 | +| 4 | 测试流式取消 | AbortController 中止 SSE 流 | +| 5 | SaaS unreachable 降级 | health-check 检测失败 → 降级到本地 Kernel | +| 6 | SaaS 恢复 | 重连 → 恢复 SaaS 模式 | + +**三级验证**: +- Desktop: saas-relay-client.ts SSE 事件处理, streamStore 状态机 +- SaaS: relay/handlers.rs 请求处理, key_pool.rs key 选择 +- Admin: Relay 页面显示任务和使用量 + +**体验检查**: SSE 首 token < 2s, 降级对用户透明, 无内存泄漏 + +**边界探测**: 格式错误 SSE 数据, stream_timeout 事件, Token 过期, 429 rate limit + +--- + +#### 场景 3.5: Browser Hand + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | "帮我打开百度搜索 ZCLAW AI" | Browser Hand 触发, 批准模态框 | +| 2 | 批准 | pending_execution 返回 | +| 3 | 测试18种操作类型 | 全部返回 pending_execution 而非崩溃 | + +--- + +#### 场景 3.6: 中间件链验证 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 发含 PHI 消息: "患者张三，身份证号1234567890123456" | DataMasking(优先级90) 剥离 → [REDACTED] | +| 2 | 检查 LLM 接收内容 | 提示中无身份证号 | +| 3 | 医疗关键词: "帮我查住院部床位占用率" | ButlerRouter 分类为 healthcare 域 | +| 4 | 数据报告关键词: "生成本月门诊量统计报告" | ButlerRouter 分类为 data_report 域 | +| 5 | 触发轨迹记录 | TrajectoryRecorder(优先级650) 记录 → SQLite | + +**边界探测**: 混合域查询, 空消息, 50000字超长消息 + +--- + +#### 场景 3.7: 记忆管道深度测试 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 5轮关于机器学习的深度对话 | +| 2 | 等30s(提取防抖) | +| 3 | 搜索"机器学习" | FTS5 返回相关提取 | +| 4 | 新对话提"ML" | Memory pipeline 注入相关上下文 | +| 5 | 验证排序质量 | 最相关的提取排在前面(通过 Rust 日志确认 TF-IDF 评分) | + +--- + +#### 场景 3.8: 多 Agent 身份切换 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 创建3个不同角色 Agent | +| 2 | 快速切换(每个<5s) | +| 3 | 每次切换后发消息 | 各 Agent 以自己身份响应 | +| 4 | 验证会话隔离 | 各 Agent 对话独立 | +| 5 | 测试身份变更提案 | IdentityChangeProposal 组件 → 用户批准/拒绝 | + +--- + +### 故事线 4: 零基础"妈妈" — 零培训采用 + +**画像**: 45岁母亲，从未用过 AI 工具。只用过微信和购物。期待简单。 + +--- + +#### 场景 4.1: 安装和首次启动 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 下载安装 ZCLAW | 安装无误，桌面快捷方式创建 | +| 2 | 首次启动 | 无需登录/配置，默认 Agent 已加载 | +| 3 | 观察界面 | 仅有: 侧边栏(对话) + 聊天区 + 输入栏 | +| 4 | 找到输入区 | 输入栏醒目，占位符给出明确提示 | + +**体验检查**: 安装 < 2min, 首次启动 < 5s, 零配置可用, 无技术术语 + +--- + +#### 场景 4.2: 第一条消息 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 输入"你好" | 流式指示器 → 中文友好问候 | +| 2 | "你能做什么？" | AI 用通俗语言解释功能 | +| 3 | 验证模型选择器隐藏 | (Tauri 模式下模型选择器应隐藏) | + +**体验检查**: 无英文错误消息, 无原始 JSON 可见, 加载指示器清晰 + +--- + +#### 场景 4.3: 使用快速操作 Chip + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 观察 FirstConversationPrompt chips | 5个 chip 可见: 小惊喜/写作/研究/收集/学习 | +| 2 | 点击"小惊喜" | 预填文本, 发送后 AI 创意响应 | +| 3 | 尝试"写作" chip | 预填文本, 可修改后发送 | + +--- + +#### 场景 4.4: 对话历史导航 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 进行3次独立对话 | +| 2 | 侧边栏切换 | 每次切换加载正确对话 | +| 3 | 搜索关键词 | 匹配对话显示 | +| 4 | 删除对话 | 确认对话框 → 删除 | + +**体验检查**: 切换 < 500ms, 搜索实时(防抖), 删除有确认 + +--- + +#### 场景 4.5: 错误韧性 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 断网发消息 | 中文错误提示"网络连接失败，请检查网络设置"，无堆栈 | +| 2 | 重连重试 | 消息成功发送 | +| 3 | 输入乱码 | AI 礼貌请求澄清 | +| 4 | 快速发5条消息 | 按序处理，无重复/UI冻结 | + +**体验检查**: 所有错误中文, 无原始异常, 有重试按钮(验证 P3 bug: 错误按钮不堆叠) + +--- + +#### 场景 4.6: 设置探索 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 点击设置 | 设置页面打开 | +| 2 | 浏览各 tab | 无死胡同/损坏链接 | +| 3 | 切换深色模式 | 主题立即切换，所有 UI 元素正确渲染 | +| 4 | 不保存退出 | 无意外数据丢失 | + +--- + +#### 场景 4.7: 简洁↔专业模式切换 + +| 步骤 | 操作 | 预期 | +|------|------|------| +| 1 | 简洁模式点"更多功能" | UI 平滑动画到专业模式 | +| 2 | 检查专业布局 | 完整侧边栏: 对话/分身/Hands/技能/Pipeline/... | +| 3 | 切回简洁模式 | UI 简化回简洁侧边栏 | +| 4 | 验证状态保留 | 当前对话保持不变 | + +**体验检查**: AnimatePresence 动画流畅, 无布局偏移, z-index 正确 + +--- + +## Part 2: 功能模块矩阵 + +### 模块 1: 聊天系统 + +| # | 测试点 | 子测试 | 优先级 | 已知缺口 | +|---|--------|--------|--------|----------| +| 1.1 | GatewayClient(WS) | 连接/发送/接收/重连/断开 | P1 | E2E 已覆盖 | +| 1.2 | KernelClient(Tauri) | invoke/流式/5min超时守护 | P0 | 已测试 | +| 1.3 | SaaSRelay(SSE) | 连接/SSE解析/delta/complete/error/取消 | P0 | **零测试 — 关键缺口** | +| 1.4 | 流式生命周期 | streamStore 状态机/取消/超时 | P0 | 部分测试 | +| 1.5 | 模型切换 | 模型选择器隐藏(Tauri)/自定义配置 | P1 | P0 bug 已修复 | +| 1.6 | 上下文管理 | sessionKey/agentId/>100消息虚拟化 | P1 | | +| 1.7 | 错误处理 | 空 AI 响应/429/网络错误/重试按钮 | P1 | 已知 P1/P2/P3 bugs | +| 1.8 | 离线队列 | 消息排队/刷新/去重 | P2 | offlineStore 已测试 | +| 1.9 | Thinking/推理 | onThinkingDelta/reasoning_effort | P2 | | + +### 模块 2: 认证系统 + +| # | 测试点 | 子测试 | 优先级 | +|---|--------|--------|--------| +| 2.1 | SaaS 登录 | 邮箱密码/JWT/cookie 设置 | P0 | +| 2.2 | SaaS 注册 | 验证(用户名3-32字符,邮箱RFC 5322) | P0 | +| 2.3 | TOTP 2FA | 设置/验证/恢复码 | P1 | +| 2.4 | Token 池 RPM/TPM | Key 轮换/429标记/缓存失效 | P0 | +| 2.5 | 自动降级 | SaaS unreachable → 本地 Kernel 回退 | P0 | +| 2.6 | 密码安全 | Argon2id/password_version 失效 | P1 | +| 2.7 | Admin 认证 | HttpOnly cookie/JS 不读 token | P1 | +| 2.8 | OS Keyring | JWT 存 keyring 非 localStorage | P0 | +| 2.9 | 账户锁定 | 5次失败 → 锁定15分钟 | P1 | + +### 模块 3: Hands 系统 + +| # | Hand | 测试点 | 优先级 | 已知缺口 | +|---|------|--------|--------|----------| +| 3.1 | Browser | 触发/批准/18种操作类型/stub 行为 | P1 | 架构 stub | +| 3.2 | Collector | 触发/数据收集/格式化 | P1 | | +| 3.3 | Researcher | 触发/报告生成/深度研究 | P1 | | +| 3.4 | Twitter | 触发/12个 API v2/OAuth 1.0a | P2 | | +| 3.5 | Whiteboard | 触发/内容生成/渲染 | P2 | 导出开发中 | +| 3.6 | Slideshow | 触发/幻灯片生成/预览 | P1 | | +| 3.7 | Speech | 触发/Browser TTS/暂停恢复 | P2 | 无真实 Rust 音频 | +| 3.8 | Quiz | 触发/生成/评分/自适应 | P1 | **零测试 — 关键缺口** | +| 3.9 | Clip | 触发/视频处理 | P3 | 需 FFmpeg | +| 3.10 | 批准流程 | 批准模态框/批准拒绝/approvalStore | P0 | | +| 3.11 | 审计日志 | 执行日志/输入输出记录 | P2 | | + +### 模块 4: 技能系统 + +| # | 测试点 | 子测试 | 优先级 | +|---|--------|--------|--------| +| 4.1 | 语义路由 | KeywordClassifier/LLM intent 匹配 | P1 | +| 4.2 | 技能执行 | skill_execute 正确参数传递 | P0 | +| 4.3 | 技能发现 | skill-discovery.ts 搜索推荐 | P2 | +| 4.4 | 错误处理 | 失败优雅降级 | P1 | +| 4.5 | 75技能覆盖 | 抽样10个技能执行验证 | P2 | + +### 模块 5: Pipeline 系统 + +| # | 测试点 | 子测试 | 优先级 | +|---|--------|--------|--------| +| 5.1 | YAML 解析 | v1/v2 格式验证 | P1 | +| 5.2 | DAG 执行器 | 顺序+并行步骤/4 worker | P1 | +| 5.3 | 模板执行 | 抽样3个(医疗/教育/研究) | P1 | +| 5.4 | 错误处理 | 步骤失败/ActionError 传播 | P2 | +| 5.5 | 取消 | pipeline_cancel 有效 | P2 | +| 5.6 | 前端集成 | WorkflowEditor/ResultPreview | P2 | + +### 模块 6: 管家模式 + +| # | 测试点 | 子测试 | 优先级 | +|---|--------|--------|--------| +| 6.1 | ButlerRouter | 4域分类: healthcare/data_report/policy/meeting | P0 | +| 6.2 | 冷启动 | 4阶段: idle→greeting→waiting→completed | P0 | +| 6.3 | 痛点持久化 | 内存Vec+SQLite 双写/频率跟踪 | P1 | +| 6.4 | 简洁 UI | SimpleSidebar/SimpleTopBar | P0 | +| 6.5 | 专业 UI | 完整侧边栏/所有面板 | P0 | +| 6.6 | 模式切换 | 切换动画/状态保留 | P1 | +| 6.7 | 问候定制 | Agent 名称/emoji 插值 | P2 | + +### 模块 7: 记忆系统 + +| # | 测试点 | 子测试 | 优先级 | +|---|--------|--------|--------| +| 7.1 | 提取管道 | 对话→LLM 提取→30s防抖 | P1 | +| 7.2 | FTS5 索引 | unicode61 tokenizer/索引创建更新 | P1 | +| 7.3 | TF-IDF 评分 | 0.7*cosine + 0.3*keyword 排序 | P2 | +| 7.4 | 记忆召回 | 查询→FTS5→相关性排序 | P1 | +| 7.5 | 系统提示注入 | 召回记忆注入 LLM 上下文 | P1 | +| 7.6 | 内容去重 | 内容哈希去重 | P2 | +| 7.7 | Viking 存储 | addWithMetadata/storeWithSummaries | P2 | +| 7.8 | 静默降级 | FTS 索引失败优雅处理 | P2 | + +### 模块 8: Admin 后台(15页) + +| # | 页面 | 测试点 | 优先级 | +|---|------|--------|--------| +| 8.1 | Dashboard | 概览统计/图表渲染 | P1 | +| 8.2 | Accounts | 用户列表/角色分配/锁定解锁 | P0 | +| 8.3 | Agent Templates | CRUD/发布 | P1 | +| 8.4 | Billing | 计划/订阅/支付流程 | P1 | +| 8.5 | Knowledge | CRUD/批量创建(最多50)/搜索 | P1 | +| 8.6 | Login | Admin 认证/session 过期 | P0 | +| 8.7 | Logs | 审计日志/过滤/分页 | P2 | +| 8.8 | Model Services | Provider CRUD/API key 加密/RPM TPM | P0 | +| 8.9 | Prompts | 模板/版本控制 | P1 | +| 8.10 | Relay | 任务/重试/模型列表 | P1 | +| 8.11 | Roles | 权限 CRUD/6+权限键 | P1 | +| 8.12 | Scheduled Tasks | CRUD/调度器 | P2 | +| 8.13 | Usage | Token 使用图表/导出 | P1 | +| 8.14 | Config | 系统配置/CORS/限流 | P1 | +| 8.15 | ConfigSync | 跨设备配置同步 | P2 | + +### 模块 9: Settings(19 tab) + +| # | Tab | 测试点 | 优先级 | +|---|-----|--------|--------| +| 9.1 | General | 主题切换/语言/通知 | P1 | +| 9.2 | Usage Stats | Token 消耗显示 | P2 | +| 9.3 | Credits | 积分余额/历史 | P2 | +| 9.4 | Models & API | 自定义模型 CRUD/API key 安全存储 | P0 | +| 9.5 | MCP Services | MCP 服务器配置 | P2 | +| 9.6 | Skills | 技能浏览安装 | P2 | +| 9.7 | IM Channels | 频道配置 | P3 | +| 9.8 | Workspace | 工作空间设置 | P2 | +| 9.9 | Data & Privacy | 数据导出/隐私控制 | P1 | +| 9.10 | Secure Storage | Keyring 管理/条目查看 | P1 | +| 9.11 | SaaS Platform | SaaS URL/连接模式/登录登出 | P0 | +| 9.12 | Subscription | 计划/支付历史 | P2 | +| 9.13 | Semantic Memory | 记忆浏览/搜索/删除 | P1 | +| 9.14 | Security Status | 安全审计状态 | P2 | +| 9.15 | Audit Log | 本地审计日志 | P2 | +| 9.16 | Scheduled Tasks | NL schedule/任务列表 | P2 | +| 9.17 | Heartbeat | 反射间隔/心跳设置 | P3 | +| 9.18 | Feedback | 反馈提交 | P3 | +| 9.19 | About | 版本信息/更新检查 | P3 | + +### 模块 10: SaaS 后端(12 路由模块) + +| # | 模块 | 测试点 | 优先级 | +|---|------|--------|--------| +| 10.1 | auth | 登录/注册/密码重置/TOTP/刷新 token | P0 | +| 10.2 | account | 用户 CRUD/角色分配/锁定解锁 | P0 | +| 10.3 | billing | 计划管理/订阅/支付回调/配额检查 | P1 | +| 10.4 | knowledge | 知识条目 CRUD/批量导入/FTS5 搜索 | P1 | +| 10.5 | relay | 聊天中转/Key 池轮换/RPM-TPM 限流 | P0 | +| 10.6 | model_config | Provider CRUD/API key AES-256-GCM 加密 | P0 | +| 10.7 | prompt | 模板 CRUD/版本管理 | P1 | +| 10.8 | role | 角色 CRUD/6+权限键管理 | P1 | +| 10.9 | agent_template | 模板 CRUD/发布/列表 | P1 | +| 10.10 | scheduled_task | 定时任务 CRUD(当前为占位符) | P2 | +| 10.11 | telemetry | Token 用量/Hand 执行/导出 | P2 | +| 10.12 | migration | 数据库迁移/up+down | P1 | + +### 模块 11: Hermes 智能管线 + +| # | 组件 | 测试点 | 优先级 | +|---|------|--------|--------| +| 11.1 | ExperienceStore | FTS5 经验存储/检索/去重 | P1 | +| 11.2 | Extractor | 对话→LLM 提取→结构化经验 | P1 | +| 11.3 | UserProfileStore | 用户画像结构化存储 | P2 | +| 11.4 | Profiler | 行为分析→画像更新 | P2 | +| 11.5 | NlScheduleParser | 中文自然语言→cron 转换 | P1 | +| 11.6 | TrajectoryRecorder | 交互轨迹记录/SQLite 持久化 | P2 | +| 11.7 | Compressor | 轨迹压缩/摘要 | P2 | + +--- + +## Part 3: 测试执行框架 + +### Bug 严重度分类 + +#### P0 — 阻断(上线阻断) +必须修复才能发布。影响所有/大多数用户。无替代方案。 + +- 应用无法启动或崩溃 +- 核心聊天功能完全不可用 +- 数据丢失(对话/记忆/配置) +- 安全漏洞允许未授权访问 +- 任何层级无限加载/挂起需强制关闭 + +#### P1 — 严重(功能损坏) +重要功能损坏但有替代方案或影响有限。发布后48h内修复。 + +- Hand 触发但无输出 +- 记忆搜索无结果 +- Pipeline 执行静默失败 +- SaaS 降级不工作 +- 错误消息显示原始 JSON/堆栈 +- Admin 页面完全不可用 + +#### P2 — 中等(体验降级) +令人烦但可用。发布后1周内修复。 + +- UI 故障不影响功能 +- 性能退化(慢但不挂) +- 错误恢复不够优雅 +- 非核心功能 UX 问题 +- 文字/标签不正确 + +#### P3 — 低(外观/未来) +已知限制或外观问题。可积压。 + +- 样式不一致 +- "开发中"功能 +- 文档不完整 +- 边缘场景未优化 + +### 测试结果记录模板 + +``` +场景 ID: [如 1.1] +测试人: [姓名] +日期: [YYYY-MM-DD] +环境: [Desktop/SaaS/Admin 全栈] +连接模式: [tauri/gateway/saas] +Agent 模板: [如 medical-admin] +模型: [如 GLM-4-Flash] + +--- 结果 --- + +步骤 1: PASS / FAIL / BLOCK + 备注: [观察] + +步骤 2: PASS / FAIL / BLOCK + 备注: [观察] + +[...] + +--- 发现的问题 --- + +[Bug ID] 严重度: P0/P1/P2/P3 +标题: [简述] +复现: [具体步骤] +预期: [应发生什么] +实际: [发生了什么] +影响层: Desktop / SaaS / Admin +影响文件: [文件路径] +``` + +### 修复后回归标准 + +修复 P0/P1 bug 后，修复者必须验证: + +1. **原始场景通过** — 复现 bug 的精确场景现在通过 +2. **周围场景未损** — 直接前后场景仍通过 +3. **自动化套件通过**: + ```bash + cargo test --workspace --exclude zclaw-saas # Rust (684+) + cargo test -p zclaw-saas -- --test-threads=1 # SaaS (138+) + cd desktop && pnpm vitest run # Frontend (330+) + ``` +4. **类型检查通过** — `npx tsc --noEmit` 零错误 +5. **构建通过** — `cargo check --workspace` 成功 +6. **回归窗口** — 涉及 streamStore/connectionStore/chatStore 的修复需重跑模块1全部场景。涉及中间件的修复需重跑 684 个 Hermes Rust 测试 + +### 上线签署清单 + +#### 构建与测试 +- [ ] `cargo check --workspace` 通过, warnings ≤ 8 +- [ ] `npx tsc --noEmit` 通过, 零错误 +- [ ] 684 Rust workspace tests 全通过 +- [ ] 138 SaaS integration tests 全通过 +- [ ] 330 Frontend tests 全通过 +- [ ] 61 Admin V2 tests 全通过 +- [ ] E2E Playwright tests 全通过(18 spec 文件, 参考 TRUTH.md) + +#### P0 Bug +- [ ] 零未解决 P0 bug +- [ ] 近期修复已回归验证 + +#### P1 Bug +- [ ] 所有 P1 已解决或有文档记录(含替代方案) +- [ ] 空 AI 响应处理已验证 +- [ ] SaaS relay SSE 错误处理已验证 + +#### 关键缺口区域(手动 E2E) +- [ ] SaaSRelay(SSE) 通过场景 3.4 验证 +- [ ] streamStore 通过流式生命周期场景验证 +- [ ] Quiz Hand 通过场景 2.2 验证 +- [ ] Slideshow Hand 通过场景 2.3 验证 +- [ ] Speech Hand 通过场景 2.4 验证 +- [ ] DataMasking 中间件通过场景 3.6 验证 +- [ ] ButlerRouter 4域分类通过场景 1.2-1.5 验证 +- [ ] 冷启动流程通过场景 1.1 和 4.1 验证 +- [ ] 双 UI 模式切换通过场景 1.3/2.6/4.7 验证 +- [ ] 记忆管道闭环通过场景 1.6 和 3.7 验证 +- [ ] NL Schedule Parser 通过场景 1.7 验证 + +#### 用户体验(来自全部4条故事线) +- [ ] "妈妈"画像可在10分钟内无帮助完成一项任务 +- [ ] "小李"画像可端到端完成会议纪要工作流 +- [ ] "王老师"画像可生成并交付测验 +- [ ] "极客张"画像可配置自定义模型并执行 Pipeline +- [ ] 所有用户可见文本均为中文(无原始英文错误) +- [ ] 深色模式完全正常 +- [ ] 模式切换动画流畅无卡顿 + +#### 安全与合规 +- [ ] API key 不存储在 localStorage(仅 OS keyring) +- [ ] DataMasking 从提示中移除 PHI +- [ ] SaaS CORS 白名单正确配置 +- [ ] 生产环境检查清单全部完成 +- [ ] Cookie 设置正确: HttpOnly + Secure + SameSite=Strict + +#### Admin 后台 +- [ ] 15个页面全部加载无错误 +- [ ] 关键页面 CRUD 正常(Accounts/AgentTemplates/ModelServices/Knowledge) +- [ ] Admin 认证使用 HttpOnly cookie + +#### 性能与资源 +- [ ] SSE 流式后无内存泄漏(场景 3.4 长时间流式后检查内存) +- [ ] 100+消息对话无 UI 卡顿 +- [ ] 100+记忆条目后搜索仍 < 2s + +--- + +## 关键文件参考 + +| 文件 | 重要性 | +|------|--------| +| `desktop/src/store/chat/streamStore.ts` | 核心流式编排，零直接测试覆盖 | +| `desktop/src/lib/saas-relay-client.ts` | SaaSRelay SSE 实现，零自动化测试 | +| `desktop/src/store/connectionStore.ts` | 客户端路由4路分支决策树 | +| `crates/zclaw-runtime/src/middleware/butler_router.rs` | ButlerRouter 4域分类 | +| `docs/TRUTH.md` | 唯一真相源 | diff --git a/docs/test-results/2026-04-09-exploratory/bug-tracker.md b/docs/test-results/2026-04-09-exploratory/bug-tracker.md index f234c6f..ab64721 100644 --- a/docs/test-results/2026-04-09-exploratory/bug-tracker.md +++ b/docs/test-results/2026-04-09-exploratory/bug-tracker.md @@ -13,6 +13,8 @@ | 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等) | OPEN | — | +| BUG-010 | 场景3.4 | P3 | 流式响应无明确取消按钮 (用户无法中止长响应) | OPEN | — | ## BUG-001 详细 diff --git a/docs/test-results/2026-04-09-exploratory/storyline-2-wanglaoshi.md b/docs/test-results/2026-04-09-exploratory/storyline-2-wanglaoshi.md new file mode 100644 index 0000000..bbcb505 --- /dev/null +++ b/docs/test-results/2026-04-09-exploratory/storyline-2-wanglaoshi.md @@ -0,0 +1,70 @@ +# 故事线2: 教师"王老师" — 测试结果 + +> 角色: 初中语文老师 +> 日期: 2026-04-09 +> 模型: kimi-for-coding (via SaaS Relay) +> 连接模式: SaaS Relay (browser) + +## 场景结果 + +| 场景 | 描述 | 结果 | 备注 | +|------|------|------|------| +| 2.1 | 《背影》教学方案设计 | PASS | 2课时完整方案，含教学目标/重难点/活动设计/分层作业 | +| 2.2 | 阅读理解选择题出题 | PASS | 5道高质量选择题，附参考答案和设计说明 | +| 2.3 | PPT结构规划 | PASS | 15页完整PPT结构，4大部分，含设计建议 | +| 2.4 | 上下文记忆测试 | FAIL (BUG-008) | AI无法记忆先前对话，将《背影》PPT误解为"高效沟通的艺术" | + +## 场景2.1 详情 + +**输入**: "你好，我是初中语文老师王老师，下周要讲《背影》这篇课文，能帮我设计一个教学方案吗？" + +**输出质量**: +- 教学目标完整（知识/过程/情感三维） +- 教学重难点明确 +- 2课时安排合理 +- "细节放大镜"活动设计有创意 +- 情感变化图引导到位 +- 分层作业设计考虑周全 + +## 场景2.2 详情 + +**输入**: "帮我出5道关于《背影》的阅读理解选择题，适合初二学生。" + +**输出质量**: +- 5题涵盖内容理解、细节把握、主题分析 +- 答案 C/C/A/B/C 正确 +- 干扰项设计合理 +- 附加设计说明 + +## 场景2.3 详情 + +**输入**: "帮我规划一下《背影》这课的PPT结构，列出每一页的标题和要点内容。" + +**输出质量**: +- 15页结构，分4部分 +- 从导入→品析→升华→练习的递进设计 +- 含视觉风格、配色、动画建议 +- 龙应台《目送》引文作封底升华 + +## 场景2.4 详情 (BUG-008 复现) + +**输入**: "把刚才的PPT大纲整理一下，帮我把第一页封面和第二页学习目标的具体内容写出来，包括可以配什么图片" + +**预期**: 基于《背影》PPT大纲生成封面和学习目标页内容 + +**实际**: AI回复"高效沟通的艺术与技巧"封面页内容，完全丢失《背影》上下文 + +**根因**: BUG-008 — `saas-relay-client.ts:125` 只发送当前消息，不发送对话历史: +```typescript +messages: [{ role: 'user', content: message }], // 只有当前消息 +``` + +## 质量评估 + +| 维度 | 评分 | 说明 | +|------|------|------| +| 内容质量 | 9/10 | 单轮对话质量极高，专业、详细、有创意 | +| 响应速度 | 8/10 | SSE流式响应，首token约2-3秒 | +| 格式呈现 | 9/10 | Markdown格式完善，标题/列表/加粗使用得当 | +| 上下文记忆 | 0/10 | 完全无记忆 (BUG-008) | +| 用户体验 | 6/10 | 单轮体验好，多轮交互断裂严重 | diff --git a/docs/test-results/2026-04-09-exploratory/storyline-3-jike.md b/docs/test-results/2026-04-09-exploratory/storyline-3-jike.md new file mode 100644 index 0000000..2a38b5e --- /dev/null +++ b/docs/test-results/2026-04-09-exploratory/storyline-3-jike.md @@ -0,0 +1,183 @@ +# 故事线3: 技术用户"极客张" — 测试结果 + +> 角色: 30岁软件工程师，测试边缘和系统边界 +> 日期: 2026-04-09 +> 模型: kimi-for-coding → deepseek-chat (切换测试) → kimi-for-coding +> 连接模式: SaaS Relay (browser) + +## 场景结果 + +| 场景 | 描述 | 结果 | 备注 | +|------|------|------|------| +| 3.1 | 多模型配置 | PASS | 模型选择器3模型可用，成功切换deepseek-chat并验证 | +| 3.2 | Agent 创建与模板 | SKIP | 浏览器模式无Tauri invoke，仅验证"创建新Agent"按钮可见 | +| 3.3 | Pipeline 编辑与执行 | SKIP | 浏览器模式无Pipeline UI入口 | +| 3.4 | SaaS Relay 模式（关键缺口）| PASS | SSE流式正常，首token ~2s，delta/complete事件正确 | +| 3.5 | Browser Hand | N/A (预期) | SaaS Relay模式下无法触发Hand，AI以文字回复代替 | +| 3.6 | 中间件链验证 | PARTIAL | DataMasking在SaaS Relay下不生效（绕过本地中间件链）| +| 3.7 | 记忆管道深度测试 | PARTIAL | 上下文记忆因BUG-008失效，kimi-for-coding部分场景异常PASS | +| 3.8 | 多 Agent 身份切换 | PASS | 专业模式智能体tab正常，显示默认助手+创建入口 | + +## 场景3.1 详情 — 多模型配置 + +**测试步骤**: +1. 点击模型选择器 → 下拉列表显示3个模型：deepseek-chat / GLM-4.7 / kimi-for-coding +2. 切换到 deepseek-chat → 发送"你是哪个AI模型？" +3. AI回复"我是DeepSeek，由深度求索公司创造的AI助手" → 切换生效 +4. 切换回 kimi-for-coding → 后续消息正确路由 + +**设置页面验证**: +- 通用设置：Gateway已连接(127.0.0.1:8080)，版本saas-relay，Token已存储(掩码显示) +- 模型与 API：内置模型 + 自定义模型(添加按钮) + Embedding模型(6选项) +- Embedding选项：本地TF-IDF / OpenAI(1536D) / 智谱AI(1024D) / 火山引擎(1024D) / 百炼(1024D) / DeepSeek(1536D) +- 22个设置分类全部可见，从"通用"到"高级"(技能管理/语义记忆/安全状态/审计日志/定时任务/心跳配置) + +**输出质量**: 模型切换即时生效，UI反馈清晰，设置页面结构完整 + +## 场景3.2 详情 — Agent 创建与模板 + +**状态**: SKIP (浏览器模式限制) + +**验证**: 专业模式下"智能体"tab显示： +- "当前: 默认助手" +- "创建新 Agent"链接可见 + +**无法测试**: Tauri invoke('agent_create')、SOUL.md写入、fetchAvailableTemplates() 在浏览器模式不可用 + +## 场景3.3 详情 — Pipeline 编辑与执行 + +**状态**: SKIP (浏览器模式限制) + +Pipeline编辑器需要Tauri运行时支持，浏览器SaaS Relay模式下无UI入口。 + +## 场景3.4 详情 — SaaS Relay 模式（关键缺口） + +**这是最大的测试缺口，本轮完成手动验证。** + +**SSE 流式验证**: +- HTTP POST → SaaS relay → SSE 流式返回：✅ 正常 +- SSE delta 解析：✅ 内容逐字显示，无乱码 +- SSE complete 事件：✅ 响应完成后无残留"发送中" +- 首 token 延迟：~2-3秒（符合预期） +- 长响应（>2000字）：✅ 完整显示，无截断 +- 错误消息：✅ 中文友好（"Relay error: 500"）+ 重试按钮 + +**流式取消测试**: +- 发送长问题后尝试取消 +- 未找到明确的取消按钮（简洁模式和专业模式下均未发现） +- textarea 在流式期间显示"Agent 正在回复..."并禁用 +- **注意**: 可能需要键盘快捷键(Esc)或发送按钮变形来取消，但UI未提供明确指引 + +**Token 用量显示**: +- 专业模式顶栏显示 "88.9K" token累计 +- "发送中 4 条" 错误消息计数器可见 + +**三级验证**: +- Desktop (browser): saas-relay-client.ts SSE事件处理正常 ✅ +- SaaS: relay/handlers.rs 请求处理正常 ✅ +- Admin: 未验证（需要后续在Admin V2验证） + +## 场景3.5 详情 — Browser Hand + +**状态**: N/A（SaaS Relay浏览器模式预期行为） + +**输入**: "帮我打开百度搜索一下 ZCLAW AI 桌面客户端" + +**实际**: AI回复"我无法直接操作您的电脑或打开外部网站"并提供手动搜索步骤 + +**分析**: Hand系统需要Tauri运行时。在SaaS Relay浏览器模式下： +1. LLM不接收Hand工具定义（因为前端未注册Hand处理程序） +2. LLM正确识别无法执行浏览器操作并以文字回复 +3. 这不是bug，而是平台限制 + +## 场景3.6 详情 — 中间件链验证 + +**DataMasking 测试 (FAIL)**: +- 输入: "患者张三，身份证号 110101199001011234" +- 预期: 身份证号被 [REDACTED] 替换 +- 实际: AI响应中完整保留了"患者张三"和"110101199001011234" +- **根因**: SaaS Relay模式下消息直接从浏览器→SaaS→LLM，绕过了本地中间件链（DataMasking@90、ButlerRouter、TrajectoryRecorder@650） +- **影响**: 这意味着SaaS Relay模式下所有14层中间件均不生效 + +**ButlerRouter 测试 (无法验证)**: +- 输入: "生成本月门诊量统计报告，按科室分组" +- 预期: ButlerRouter分类为data_report域 +- 实际: AI正常回复报告模板，但无法确认中间件是否介入分类 +- **原因**: SaaS Relay模式下ButlerRouter不参与消息处理 + +**重要发现 (BUG-009)**: SaaS Relay模式绕过全部中间件链 + +| 中间件 | 本地模式 | SaaS Relay模式 | +|--------|----------|----------------| +| DataMasking@90 | ✅ 生效 | ❌ 不生效 | +| ButlerRouter | ✅ 生效 | ❌ 不生效 | +| TrajectoryRecorder@650 | ✅ 生效 | ❌ 不生效 | +| MemoryInjection | ✅ 生效 | ❌ 不生效 | +| Guardrail | ✅ 生效 | ❌ 不生效 | + +## 场景3.7 详情 — 记忆管道深度测试 + +**状态**: PARTIAL + +**上下文记忆 (BUG-008 确认)**: +- 消息间完全无上下文——每次消息独立 +- 但kimi-for-coding模型在故事线4场景4.3中异常地保留了"三年级"信息 +- **推测**: kimi-for-coding可能有服务端会话管理，但不稳定 + +**FTS5/TF-IDF 记忆注入**: +- SaaS Relay模式下无法验证——记忆注入通过中间件链执行，而中间件链被绕过 +- 本地Kernel模式下应正常工作（已有自动化测试覆盖） + +## 场景3.8 详情 — 多 Agent 身份切换 + +**状态**: PASS (UI层面) + +**验证**: +- 专业模式侧边栏显示"对话"和"智能体"两个tab +- "智能体"tab显示当前Agent为"默认助手" +- "创建新 Agent"按钮可见 +- 快速切换到"对话"tab正常 + +**未测试**: 实际创建Agent、SOUL.md写入、身份切换后对话隔离（需要Tauri运行时） + +## 质量评估 + +| 维度 | 评分 | 说明 | +|------|------|------| +| SaaS Relay SSE | 9/10 | 流式完整、解析正确、首token快速 | +| 模型切换 | 10/10 | 即时生效、3模型可选、UI清晰 | +| 设置页面 | 9/10 | 22分类完整、结构清晰、配置直观 | +| 中间件链 | 2/10 | SaaS Relay下全部14层中间件不生效 | +| Hands系统 | N/A | 浏览器模式无法触发，预期行为 | +| 记忆管道 | 3/10 | BUG-008 + 中间件绕过双重影响 | +| 流式取消 | 3/10 | 无明确取消按钮或UI指引 | + +## 新发现 Bug + +### BUG-009: SaaS Relay模式绕过全部中间件链 (P1) + +**位置**: `desktop/src/lib/saas-relay-client.ts` → SaaS relay endpoint + +**现象**: SaaS Relay模式下，消息直接从浏览器→HTTP→SaaS→LLM，不经过本地中间件链 + +**影响**: +- DataMasking不生效 → PHI数据直接发送到第三方LLM +- ButlerRouter不生效 → 管家模式在SaaS Relay下无法提供域分类 +- TrajectoryRecorder不生效 → 用户体验无法记录 +- MemoryInjection不生效 → 记忆管道断裂 +- Guardrail不生效 → 安全护栏缺失 + +**严重性**: P1（数据隐私合规风险） + +**建议修复方向**: +1. 在SaaS relay服务端实现中间件链（服务端DataMasking） +2. 或在浏览器端实现DataMasking预处理后再发送 +3. ButlerRouter可在SaaS端实现域分类+system prompt增强 + +### BUG-010: 流式响应无明确取消按钮 (P3) + +**现象**: 发送消息后textarea显示"Agent 正在回复..."并禁用，但无明确的停止/取消按钮 + +**影响**: 用户无法主动取消正在生成的长响应 + +**建议**: 在流式期间将发送按钮变为停止按钮，或添加浮动取消按钮 diff --git a/docs/test-results/2026-04-09-exploratory/storyline-4-mama.md b/docs/test-results/2026-04-09-exploratory/storyline-4-mama.md new file mode 100644 index 0000000..078e7c9 --- /dev/null +++ b/docs/test-results/2026-04-09-exploratory/storyline-4-mama.md @@ -0,0 +1,62 @@ +# 故事线4: 零基础"妈妈" — 测试结果 + +> 角色: 全职妈妈，孩子三年级，AI新手 +> 日期: 2026-04-09 +> 模型: kimi-for-coding (via SaaS Relay) +> 连接模式: SaaS Relay (browser) + +## 场景结果 + +| 场景 | 描述 | 结果 | 备注 | +|------|------|------|------| +| 4.1 | 三年级语文学习求助 | PASS | 通俗友好，零基础指导+分步建议 | +| 4.2 | 换季增强免疫力食谱 | PASS | 6道家常食谱，附营养原理+操作建议 | +| 4.3 | 上下文记忆测试 | PASS (异常) | AI正确回忆"三年级"，与BUG-008不一致 | + +## 场景4.1 详情 + +**输入**: "你好，我想请问一下，我家小孩今年上三年级了，语文成绩不太好，有什么方法可以帮他提高吗？我是第一次用这个AI，不太会操作" + +**输出质量**: +- 友好欢迎，消除新手焦虑（"操作很简单——您就像平时聊天一样"） +- 针对三年级承上启下阶段给出专业分析 +- 分步诊断法：基础/阅读/写作/习惯四维度 +- 实用方法：每日听写、大声朗读、亲子共读、脚手架写作 +- 主动教用户如何使用AI（提供具体问题模板） +- 语言通俗，无专业术语堆砌 + +## 场景4.2 详情 + +**输入**: "谢谢！另外想问一下，最近换季孩子容易感冒，有什么增强免疫力的食谱推荐吗？最好是家常菜，简单好做的" + +**输出质量**: +- 先讲核心原则（蛋白质/维C/维A/锌/水分） +- 6道食谱分三类：汤羹(2) + 主食(2) + 菜肴(2) +- 每道菜列出食材、做法、免疫亮点 +- 实用贴士：让孩子参与、变换花样、不必强求完美 +- 语言风格适合家庭用户 + +## 场景4.3 详情 (上下文记忆 — 异常行为) + +**输入**: "对了，我刚才问你小孩语文学习的事情，你还记得我家小孩几年级吗？" + +**预期**: FAIL (基于BUG-008，SaaS Relay不发送对话历史) + +**实际**: AI正确回答 **"上三年级"**，并补充说明"在我们当前这次连续的交流中，您提供的关键信息会保持在对话的上下文中" + +**分析**: 这是与BUG-008矛盾的发现。可能原因： +1. kimi-for-coding 模型可能有服务端会话管理机制 +2. 不同模型的BUG-008表现不一致（之前 deepseek-chat/GLM-4.7 确认FAIL） +3. 需要进一步交叉验证 + +**注意**: 此结果不推翻BUG-008（已在故事线1和2中确认3次），但表明影响范围可能仅限特定模型。 + +## 质量评估 + +| 维度 | 评分 | 说明 | +|------|------|------| +| 内容质量 | 9/10 | 通俗、实用、有温度，适合零基础用户 | +| 响应速度 | 8/10 | SSE流式响应，首token约2-3秒 | +| 格式呈现 | 8/10 | 标题/列表清晰，食谱结构完整 | +| 新手友好度 | 10/10 | 主动消除焦虑、提供AI使用教程 | +| 上下文记忆 | ?/10 | 单次测试PASS，但与已知BUG矛盾 |