hermes-web-ui/TODAY_TEST_CASES.md

今日改动测试用例

日期：2026-05-18

基础检查

TC-001 类型检查

步骤：

1. 在项目根目录执行 npx tsc --noEmit -p packages/server/tsconfig.json。
2. 执行 npx vue-tsc -b --noEmit。

期望：

• 两个命令都通过。
• 没有新增 TypeScript 编译错误。

TC-002 启动服务

步骤：

1. 启动本地开发服务。
2. 打开 http://localhost:5173。
3. 观察控制台和服务端日志。

期望：

• Vite 和 server 正常启动。
• 不出现 ECONNREFUSED 127.0.0.1:8648 之外的持续异常。
• 页面可以正常进入 Hermes。

Profile 与模型

TC-010 available-models 返回多 profile 合集

步骤：

1. 准备至少两个 profile，每个 profile 配置不同 provider/model。
2. 请求 GET /api/hermes/available-models。
3. 检查返回模型列表。

期望：

• 返回所有有效 profile 的 provider/model 合集。
• 需要远程拉模型的 provider 按 base URL 去重请求。
• 默认模型优先使用当前 active profile 的默认配置。

TC-011 新建对话选择 profile 和模型

步骤：

1. 点击新建对话。
2. 在弹窗选择 profile、provider、model。
3. 发送第一条消息。

期望：

• 新建时会把选择的 profile/provider/model 带到后端。
• 不依赖前端长期 state 存储 provider/model。
• 聊天使用选择的 profile 启动。

TC-012 Sidebar 模型切换

步骤：

1. 在 sidebar 切换当前会话模型。
2. 等待接口返回。
3. 刷新页面或重新打开会话。

期望：

• UI 不会自动跳回旧模型。
• 当前会话继续显示新模型。
• 后续请求使用新模型。

单聊 Bridge 与上下文压缩

TC-020 多 profile bridge worker

步骤：

1. 使用 default profile 发起一次聊天。
2. 切换到另一个 profile 发起聊天。
3. 查看 bridge 日志。

期望：

• 不会因为切换 profile 杀掉其他 profile 的 worker。
• chat、destroy 日志中的 profile、profile_dir、config 路径匹配实际会话 profile。

TC-021 强制上下文压缩使用会话模型

步骤：

1. 创建一个非 default profile 的会话。
2. 设置不同 provider/model/context_length。
3. 触发上下文压缩。
4. 查看日志和压缩请求。

期望：

• context_length 依据当前 session 的 profile/provider/model 获取。
• 获取顺序为 sqlite 会话信息、profile 配置、硬编码 fallback。
• 压缩请求通过 source=api_server 走 bridge。
• Web UI 本地数据库不写入压缩会话记录。

TC-022 指令压缩

步骤：

1. 在单聊中执行压缩相关指令。
2. 使用非 default profile 会话重复执行。

期望：

• 指令压缩同样使用当前 session 的 profile/provider/model。
• 不固定使用 default 模型。
• 不污染正常聊天历史。

Session 列表与历史

TC-030 Session 列表合并

步骤：

1. 使用多个 profile 创建会话。
2. 打开会话列表。
3. 使用 profile 过滤下拉。

期望：

• 默认显示所有有效 profile 下的会话。
• 传入 profile 过滤时只显示该 profile 会话。
• 已删除 profile 的旧会话被过滤，不再进入后报错。

TC-031 Chat 列表 profile 信息

步骤：

1. 打开普通聊天会话列表。
2. 查看每条 session item。

期望：

• 普通 chat session item 显示 profile 头像和 profile 名称。
• profile 信息位于模型和日期下方。
• history 页面不显示 profile 信息。

TC-032 History profile 过滤

步骤：

1. 打开历史页面。
2. 查看顶部说明和 profile 下拉。
3. 切换 “只显示当前 profile”。

期望：

• 原描述文案被替换为 profile 过滤控件。
• “All Profiles” 已国际化。
• history 列表按过滤条件变化。

删除会话

TC-040 单个删除同步 Hermes

步骤：

1. 创建一个 Hermes 侧存在的会话。
2. 在 Web UI session 列表删除单条会话。
3. 查看本地 DB 和 Hermes profile 侧数据。

期望：

• Web UI 本地会话被删除。
• 如果 Hermes 对应 profile 下存在该 session，也同步删除。
• profile 缺失或 Hermes 侧不存在时不报错。

TC-041 批量删除同步 Hermes

步骤：

1. 选择多个 session，覆盖不同 profile。
2. 点击批量删除。
3. 在确认弹窗确认。

期望：

• 确认弹窗显示 loading。
• 每条会话按自己的 profile 删除 Hermes 侧数据。
• 批量删除期间 UI 不重复提交。
• 部分 Hermes 删除失败时，本地删除逻辑不被无关 profile 阻塞。

群聊基础

TC-050 群聊清空消息

步骤：

1. 进入群聊房间并发送几条消息。
2. 清空群聊消息。
3. 再发起一次群聊。

期望：

• 消息被清空。
• room 生成新的 sessionId/sessionSeed。
• 后续 agent run 不复用旧 session。

TC-051 群聊并发触发

步骤：

1. 在同一条用户消息里 @ 多个 agent。
2. 观察多个 agent 回复。
3. 在某个 agent 回复未结束时再次 @ 同一个 agent。

期望：

• 不同 agent 可以并发回复。
• 同一个 agent 串行处理。
• 同一 agent 忙时新 mention 进入该 agent 的队列，最终只处理最新一条排队消息。

TC-052 群聊 source 使用 api_server

步骤：

1. 在群聊中 @ agent。
2. 查看服务端日志和 bridge 请求。

期望：

• 群聊 agent 调用 source 为 api_server。
• 不再走 cli source。

群聊流式与消息入库

TC-060 群聊流式输出

步骤：

1. @ 一个 agent 并观察回复过程。
2. 刷新前查看 UI。
3. 刷新后再次查看消息。

期望：

• agent 回复流式显示。
• 流式结束前不落库空 content 占位消息。
• 刷新后不会出现空 assistant 消息。
• 完成后 loading/thinking 状态消失。

TC-061 toolcall/toolresult 展示

步骤：

1. 让 agent 执行一个工具调用。
2. 查看群聊消息气泡。
3. 展开工具详情。

期望：

• toolcall 和 toolresult 合并成一条工具消息展示。
• 工具消息显示头像和 agent 名称。
• 工具样式与单聊一致。
• 参数和结果有截断，长内容不撑破 UI。
• hermes_show_tool_calls 只影响群聊自身可见性，不影响单聊常显规则。

TC-062 toolcall 顺序

步骤：

1. 让 agent 回复中先说一句话，再调用工具，再继续回复。
2. 查看 UI 和 group-chat-history-preview.json。

期望：

• 工具调用前的普通文本保留在 toolcall 前面。
• toolcall/toolresult 不被错误插到最终回复下面。
• 最终 agent 回复不会丢失。

TC-063 入库原子性

步骤：

1. 同时 @ 多个 agent。
2. 等待多个 agent 回复完成。
3. 查看 gc_messages。

期望：

• 每个 agent 的一次回复作为完整消息落库。
• 不出现谁先完成谁把别人的消息合并进同一条的情况。
• 工具消息和最终文本消息的归属正确。

群聊 History 组装

TC-070 生成预览 JSON

步骤：

1. 在群聊产生用户消息、agent 回复、toolcall、toolresult。
2. 生成 group-chat-history-preview.json。
3. 检查 JSON 顺序和 role。

期望：

• 当前 agent 自己的普通回复为 assistant。
• 当前 agent 自己的 toolcall 为 assistant，内容格式为 [Calling tool: name with arguments: ...]。
• toolresult 为 user。
• 其他 agent 的回复、toolcall、toolresult 都作为 user。
• 每条内容只带 [发送者]: 前缀，不生成 [发送者 to 目标]:。
• 预览中的 source、sourceRole、originalMessageId 只用于调试，不发送给 bridge。

TC-071 @User 清理

步骤：

1. 用户或 agent 消息中包含 @User-dfd5fd。
2. 生成 history preview。

期望：

• 对应内容转换为 [发送者]: 内容。
• body 中原始 @User-dfd5fd 被移除。
• history preview 中不出现 [test to User-dfd5fd]: 这种前缀。

TC-072 群聊 prompt 约束

步骤：

1. 只 @ 一个 agent，让它回答普通问题。
2. 不要求它转交、邀请、询问其他成员。

期望：

• agent 不会主动 @ 其他人。
• 不会在结尾要求其他 agent 接力。
• 只有明确需要对方执行动作、提供信息、确认决策时才 @。

TC-073 群聊 token 统计

步骤：

1. 群聊中产生多轮 user/assistant/tool 消息。
2. 请求 GET /api/hermes/group-chat/rooms。
3. 对比房间 totalTokens。

期望：

• token 估算逻辑与单聊一致，按 role/input/output/tool_calls 统计。
• 不是简单拼接 content/senderName 计算。
• snapshot 场景下统计不重复。

群聊附件与图片

TC-080 用户发送图片

步骤：

1. 在群聊输入框上传或粘贴图片。
2. 输入文字并发送。
3. 查看本地 UI 和 agent 收到的内容。

期望：

• 用户消息不显示原始 JSON 数组。
• 图片以缩略图展示。
• 点击图片可以预览。
• 文本只显示 text block。
• 发送给 bridge 时图片转 base64，与单聊 ContentBlock[] 处理一致。

TC-081 用户发送文件

步骤：

1. 在群聊发送普通文件。
2. 查看消息展示。

期望：

• 文件以文件附件样式展示。
• 不被错误当作纯文本 JSON 展示。
• 下载链接可用。

TC-082 Windows 路径兼容

步骤：

1. 构造或上传一个路径形如 C:\path\file.jpg 的附件记录。
2. 查看群聊消息。

期望：

• 下载 URL 中路径被标准化为 C:/path/file.jpg。
• 图片和文件都可以正常展示或下载。

群聊语音与操作栏

TC-090 自动播放开关

步骤：

1. 打开群聊输入框的自动播放语音开关。
2. 让 agent 回复一条完整消息。

期望：

• 回复完成后触发语音播放。
• 不在流式未完成时播放半截内容。
• 设置与单聊共用 autoPlaySpeech 行为。

TC-091 手动播放语音

步骤：

1. 点击群聊 assistant 消息底部语音按钮。
2. 再次点击暂停或恢复。

期望：

• 按当前 TTS provider 播放。
• WebSpeech、OpenAI、custom、edge、mimo 路径与单聊一致。
• 播放状态按钮图标变化。

TC-092 呼吸灯和操作栏样式

步骤：

1. 播放群聊 assistant 消息语音。
2. 对比单聊消息播放态。

期望：

• 群聊气泡出现与单聊一致的呼吸灯动画。
• 群聊底部操作栏包含语音按钮、复制按钮、时间。
• 操作栏 hover 显示，移动端常显。
• 操作栏和气泡之间有合理间距，不贴边。

TC-093 复制消息

步骤：

1. 点击群聊消息底部复制按钮。
2. 粘贴剪贴板内容。

期望：

• 复制的是当前气泡可读文本。
• ContentBlock[] 消息只复制文本部分，不复制图片 JSON。
• tool 消息不显示普通复制按钮。

群聊工具可见性

TC-100 工具显示开关

步骤：

1. 在群聊输入框切换工具调用显示开关。
2. 触发一次工具调用。

期望：

• 关闭时隐藏已完成工具消息。
• 正在运行的工具消息仍可见，避免用户误以为卡住。
• 打开后工具消息恢复显示。

回归检查

TC-110 单聊不受群聊改动影响

步骤：

1. 在普通单聊发送文本、图片、工具调用消息。
2. 播放语音并复制消息。
3. 触发上下文压缩。

期望：

• 单聊工具调用仍常显。
• 单聊图片展示、预览、base64 发送正常。
• 单聊语音呼吸灯和操作栏样式不变。
• 单聊压缩仍走正确 session profile/model。

TC-111 已删除 profile 数据

步骤：

1. 创建一个 profile 并产生聊天记录。
2. 删除该 profile。
3. 打开 session 列表和历史页面。

期望：

• 不展示不属于当前全部有效 profile 的聊天记录。
• 不会因为进入旧会话请求缺失 profile 而报错。

TC-112 多语言文案

步骤：

1. 切换到中文、英文、日文等语言。
2. 查看 profile 过滤选项。

期望：

• All Profiles 或对应翻译正常显示。
• 不出现缺失 i18n key。