test-report.md 29 KB

智能工作台 UI / 交互 / 业务逻辑 E2E 测试报告

  • 测试日期:2026-11-19 20:23 – 20:45
  • 测试方式:ZCode 内置浏览器(In-app Browser)真实点击/输入/截图,辅以接口快照、磁盘文件与后端日志交叉验证
  • 被测环境:前端 http://localhost:3100(Vite 7.2.7 dev)、后端 http://127.0.0.1:8980/js/a(ai-server-1.0.jar)
  • 账号 / 案件:系统管理员(admin) / Ces(caseId 2121846987260764162)
  • 模型:deepseek-v4.1-flash:1017
  • 约束:全程未修改任何源代码(git status 为空);仅创建测试会话/产物,并在 HITL 测试中临时撤销后再恢复 execute 信任

本轮按要求先重启前后端:后端新进程 PID 9732(Started in 8.367 s),前端新进程 PID 7232(ready in 3.707 s),端口 8980 / 3100 正常监听。


一、结论摘要

维度 结论
前后端重启 通过。后端 8.4 s 启动、前端 3.7 s 就绪;登录态保留,打开案件、进入/退出工作台均正常
工作台入口与会话恢复 通过。主窗口 →「打开智能工作台」→ /workbench/chat;返回自主模式后再进入,自动恢复上次会话、产物面板与产物列表
菜单与页面完整性 通过(20/20 菜单页全部打开)。侧栏 5 组共 20 个菜单页全部可导航并正确渲染
任务工作台主链路 通过。新建任务、发送、流式生成、停止、复制、重新生成(含禁用原因)、删除确认、重命名校验、结束任务确认均符合预期
HITL 变更前确认 通过(撤销信任后验证)。出现确认卡片(允许本次/记住该工具/拒绝);「记住该工具」后命令执行、信任恢复
产物闭环 通过。write_file → 磁盘文件 → /artifacts 接口 → 右侧产物面板 → 预览(渲染/源码)/下载 全链路打通
知识库问答 / 来源 通过。检索测试命中 5 条并显示得分;指定专家问答引用知识库,5 条参考来源可展开、可查看文档全文
管理页业务逻辑 通过。列表检索/分页/详情/表单校验/连通性测试/健康自检/工具调用与编排审计均可操作,结果与接口一致
UI 与响应式 存在问题。窄窗口三栏挤压、窗口缩放后布局不重算、未挂载路由导致主区空白等(见缺陷 D1–D3)
后端/前端日志 后端无 ERROR;前端 Vite 无报错。仅见 1 条启动初期的「未登录访问」与 MCP 通知类 WARN,均不影响业务

总体判定:核心业务主链路可用,未发现 P1 级完全阻断缺陷;发现 5 个 P2、8 个 P3 问题。建议优先修复 D1–D5。


二、测试范围与用例总览

2.1 已覆盖页面(20 个菜单页)

分组 页面 主要验证点 结果
智能体 任务工作台 /workbench/chat 新建任务、会话列表、发送/流式/停止、消息操作、资源选择、产物面板 PASS(含 3 个缺陷)
智能体 数剑配置 /workbench/agent/entry 表单回显、保存 PASS(保存提示「保存成功」)
智能体 专家配置 /workbench/agent/expert 列表、搜索无结果、新增校验、查看、复制 PASS
智能体 任务管理 /workbench/agent/session 搜索、分页、消息明细、工具调用展开、导出下载 PASS
智能体 长期记忆 /workbench/agent/memory 三个 Tab、记忆配置、记忆内容、运行健康 PASS(发现 D6)
智能体 技能仓库 /workbench/agent/skill 列表、SKILL.md 预览、新增校验 PASS
智能体 场景包 /workbench/agent/pack 列表、详情、新增校验 PASS
模型与推理 模型配置 /workbench/model/config 列表、连通性测试(978 ms 通过)、新增校验 PASS
模型与推理 上下文与压缩策略 /workbench/model/compaction 配置回显、开关联动、刷新 PASS
知识库 知识库管理 /workbench/kb/base 列表、详情、新增校验、文档跳转 PASS
知识库 文档与切片 /workbench/kb/doc?kbId=... KB 预选、切片弹窗(179 条/36 页)、自动入库开关 PASS
知识库 检索测试 /workbench/kb/retrieval Ctrl+Enter 检索、TopK/阈值、命中得分 PASS
工具与集成 业务工具注册 /workbench/integration/registry 关键词搜索(11 条)、标签管理、详情 Schema PASS
工具与集成 MCP 服务端 /workbench/integration/mcp-server 口令掩码/随机生成、暴露清单、调用示例 PASS(发现 D9)
工具与集成 MCP 客户端 /workbench/integration/mcp-client 连接测试(成功,发现 0 工具) PASS
审计与观测 会话与消息审计 /workbench/audit/message 关键词搜索、消息详情 PASS
审计与观测 工具调用明细 /workbench/audit/tool-call 工具名筛选、入参/出参详情、失败率统计 PASS
审计与观测 链路追踪 /workbench/audit/trace 状态筛选、详情(模型快照/上下文清单/时间线) PASS(发现 D5)
审计与观测 编排运行 /workbench/audit/route-run 统计卡、筛选、详情(路由决策/任务片段/专家调用) PASS
审计与观测 健康自检 /workbench/audit/health 9 通过/4 告警/1 待探测、单项测试转通过 PASS

2.2 额外验证的隐藏路由

路由 情况 结果
/workbench/model/usage(用量与配额) 路由与页面均已实现,但不在侧栏菜单;直接访问触发 D1 空白页 FAIL(D1)
/workbench/not-a-real-page 期望显示 404,实际同样被重定向到 /workbench/chat 并空白 FAIL(D1)

三、关键流程实测记录

3.1 重启与进入工作台

  1. 停止旧进程后启动:
    • 后端:java -jar ai-server/target/ai-server-1.0.jar → Started App in 8.367 seconds,Tomcat 8980//js/a。
    • 前端:pnpm dev → Vite ready 3.707 s,http://localhost:3100。
  2. 打开首页:保持登录态(token ae675a47-…),案件列表显示 8 个案件。
  3. 打开「Ces」→ /data/index(数据工作区),顶栏出现「打开智能工作台(独立窗口,当前页面保留)」。
  4. 点击后进入 /workbench/chat,自动选中上次会话(19:20 的产物会话),右侧产物面板展开。
  5. 「回到自主模式主窗口」→ /data/index;再次「打开智能工作台」→ 会话、消息、产物面板(1 个产物)均恢复。

3.2 任务工作台:新建、流式、停止

  • 点击「新建任务」→ 欢迎页「数剑,我帮您」,输入框占位「今天帮您干点什么?」。
  • 输入两条文本并按 Shift+Enter:DOM value = "第一行测试\n第二行测试",换行语义正确。
  • 发送长文写作任务:
    • 生成中:发送按钮变为 aria-label="停止生成"(danger 样式),textarea disabled=true 且已清空。
    • 点击停止:2 s 内恢复「发送」;页面出现「已中止」;textarea disabled=false。
    • 接口:助手消息 status=3、durationMs=8410、content="",会话未卡死。

3.3 HITL 变更前确认(撤销信任后验证)

前置:平台已有「记住该工具」用户级信任(execute/write_file),因此默认不会弹确认卡。为验证真实 HITL,先通过接口撤销 execute 信任,测试后再由 UI「记住该工具」恢复。

  1. DELETE /ai/agent/1761400000000020302/trusted-tools?userId=1&toolCode=execute → 200,信任列表仅剩 write_file。
  2. 发送「请用 execute 工具执行命令 echo hitl-confirm-test」→ 8 s 内出现确认卡片:
    • 标题「人工确认 / 等待确认」
    • 提示「该操作需要你确认后才会执行」
    • 工具「执行命令」,入参 {"command":"echo hitl-confirm-test"}
    • 操作:允许本次 / 记住该工具 / 拒绝
  3. 点击「记住该工具」→ 卡片变「已允许」,状态「已完成」,输出 hitl-confirm-test(退出码 0)。
  4. 复查 /trusted-tools:execute 信任恢复(createTime 20:41:17)。
  5. 工具调用审计:execute 入参 echo hitl-confirm-test,state=SUCCESS,耗时 26 ms。

结论:HITL 拦截、允许、记住、执行、恢复信任全链路 PASS。

3.4 产物闭环(write_file → 产物面板)

  • 新任务(会话 2123394239460651010),指定「涉毒案件分析研判专家」,发送: 「请用 write_file 工具在当前会话工作区 outputs/ 下创建文件 ui-e2e-artifact.md…」
  • 结果:
    • 路由:action=pinned,专家调用成功(4.6 s,rawOutput 含路径)。
    • 工具:write_file SUCCESS,{"path":"outputs/ui-e2e-artifact.md","content":"# UI E2E artifact\nok\n"},67 ms。
    • 磁盘:qingjian/data/cases/2121846987260764162/ai/workbench/2123394239460651010/outputs/ui-e2e-artifact.md,21 B。
    • 接口:/artifacts 返回 total=1,kind=markdown, previewable=true, downloadable=true。
    • UI:右侧「产物 1」,列表 ui-e2e-artifact.md 21B 11-19 20:33;预览弹窗渲染出标题 UI E2E artifact 与 ok;「源码」显示原文;「下载」触发下载事件。
  • 另:进程重启/再次进入工作台后,该会话与产物仍可恢复。

3.5 知识库问答与来源溯源

  • 新任务(会话 2123396262910341121),指定「涉毒案件分析研判专家」,问「《公安机关办理刑事案件程序规定》自哪一天起施行」。
  • 结果:9.4 s、3 次工具调用、13,203 tokens;回答明确「2020 年 9 月 1 日」,并说明版本沿革与信息边界。
  • 「参考来源」展开后 5 条:评分 1.00 / 0.99 / 1.00 / 0.02 / 0.95,均标注文档与章节。
  • 点击第一条来源 → 抽屉显示相似度、命中片段;「查看文档全文」成功加载全文;「返回命中片段」可回退。

3.6 管理页抽查

操作 实测结果
专家搜索「不存在的专家」 共 0 位,展示「暂无专家」
新增专家空提交 3 条校验:专家名称不能为空 / 专家编码不能为空 / 请选择绑定模型
新增技能空提交 技能标识不能为空 / 用途说明不能为空
新增场景包空提交 场景包编码/名称不能为空
新增模型空提交 配置名称不能为空 / 模型标识不能为空
模型连通性测试 「连通性测试通过(978ms)」
新增知识库空提交 名称/编码/向量模型三条校验
文档切片 公安办案程序.md 179 条切片,5 条/页,共 36 页
检索测试 「取保候审的条件是什么?」→ 命中 5 条,最高分 0.7555,Ctrl+Enter 生效
业务工具搜索「通话」 共 11 条;工具详情展示 JSON Schema
标签管理空提交 标签名称不能为空
MCP 客户端测试 「连接成功,发现 0 个工具:(无工具)」(因出口未挂载工具,符合当前配置)
健康自检单项测试 外部 MCP 连接由「待探测」变为「通过:连通,发现 0 个工具」
任务导出 触发下载事件(浏览器下载)
数剑配置保存 「保存成功」

四、缺陷与问题清单

严重级别:P1 阻断 / P2 高 / P3 中低。本轮无 P1;以下按影响排序。

D1【P2·高】未挂载/未知工作台路由导致主区域空白,且菜单无法恢复,只能刷新

  • 复现:
    1. 地址栏访问 http://localhost:3100/workbench/model/usage(该页路由与页面已实现,但侧栏菜单没有入口)。
    2. 页面被重定向到 /workbench/chat,但主区域只剩空白(顶栏、侧栏正常,会话列表/聊天/输入区全部不渲染)。
    3. 点击侧栏「任务工作台」仍无法恢复;按 F5 刷新后恢复。
    4. 访问 /workbench/not-a-real-page 现象相同,预期的 404 页(workbench/views/notFound)从未显示。
  • 影响:深链/异常路由进入后工作台“假死”,普通用户只能刷新;已实现的「用量与配额」页面无法从 UI 到达,直接访问反而触发该问题。
  • 证据:screenshots/12-unmounted-route-blank-main.png;路由定义见 src/core/router/routes/index.ts:218(model/usage)与 :297(WorkbenchNotFound)。
  • 建议:
    • 路由守卫对「不在授权叶子集合」的路径,渲染 WorkbenchNotFound 或明确提示,而不是 replace('/workbench/chat') 后留下未挂载状态。
    • 重定向后确保目标组件强制重新挂载(避免同一路由重复导航被吞)。
    • 若「用量与配额」已验收,补进 perm_menu 的 workbench 子树;否则从静态路由移除。

D2【P2·高】窗口高度变化后工作台布局不重算,输入区/发送按钮被裁切

  • 复现:
    1. 视口 1280×720 打开工作台(初始布局 chat-workbench 高度 680、底边 720)。
    2. 将窗口缩小到 1280×640。
    3. 实测 chat-workbench 仍为 680 高、底边 720;composer-send-btn 底边 686 > 视口 640,发送按钮与底部工具栏完全不可见。
    4. 反向从 768 缩到 720 时同样残留 768 的旧高度(底边 768 > 720)。
  • 影响:Electron 窗口缩放或分屏时,用户会看不到发送按钮/确认按钮;必须刷新才能恢复。
  • 证据:screenshots/16-resize-640-composer-hidden.png;实测数据 innerHeight=640, workbench.bottom=720, send.bottom=686。
  • 建议:布局高度改用 100dvh/calc() 或监听 resize/ResizeObserver 动态计算,避免挂载时一次性读取高度;聊天主区用 flex 自适应,composer 固定占位。

D3【P2·高】窄窗口三栏布局挤压,聊天内容一字一行、工具栏重叠

  • 复现:视口 1024×768,打开任一会话并展开右侧产物面板。侧栏约 236 px、会话列表约 264 px、产物面板约 300 px,聊天列仅剩约 130 px:
    • 用户气泡按单字换行(outputs/ 下创建文 件 ui-e2e- artifact.m d…)。
    • 输入框占位「今天帮您干点什 么?」换行;「变更前确认」与「+」/「计划模式」重叠;Enter 发送… 提示被裁切。
    • 收起产物面板后聊天列仍约 500 px,「由 AI 生成」在消息页脚竖向折行(1280 宽时已出现该现象)。
  • 影响:小屏/分屏不可用;用户难以阅读与发送消息。
  • 证据:screenshots/13-responsive-1024-artifact-open.png、14-responsive-1024-artifact-closed.png、15-sidebar-collapsed-composer-clipped.png。
  • 建议:为聊天列设置最小宽度(如 560 px);小于断点(约 1200 px)时产物面板改为抽屉/浮层,会话列表可折叠;消息页脚允许换行或隐藏次要指标,避免竖排单字。

D4【P2】专家直答场景下回答正文被截断,且以「成功」状态落库

  • 复现:会话 2123394239460651010 指定专家写文件后,助手消息正文为: 文件已写入(内容为 # UI E2E artifact 与 —— 以一个未闭合的反引号结束,句子不完整。
  • 接口佐证:
    • 消息 content 同上,status=0(正常)、toolCallCount=2。
    • 编排详情中专家 rawOutput 也为 outputs/ui-e2e-artifact.md\n\n文件已写入(内容为# UI E2E artifact与"`,说明截断发生在专家输出落库之前/之时,而非前端渲染丢失。
  • 影响:用户看到半句话且无任何“已中断/内容不完整”提示;审计留档同样不完整,影响可信度。
  • 证据:evidence/artifact-session-messages.json、evidence/artifact-session-toolcalls.json;同会话 UI 截图 screenshots/18-artifact-preview-modal.png 背景可见该消息。
  • 建议:
    • 在流式结束/专家调用完成时检测未闭合代码块或异常结束标记;若检测到截断,消息标记为「部分完成」并提供重试。
    • 排查专家侧 finish_reason(length/stop/其他)与编排器合并逻辑,避免把半截文本当作成功结果。
    • 入口智能体在 route_decision 后应完全静默,防止其补写内容与专家输出拼接/竞争。

D5【P2】链路追踪存在多天未收敛的「执行中」僵尸记录

  • 现象:按状态筛选「执行中」,共 3 条,均为 0 ms / 0 工具 / 0 Token:
    • 2026-11-19 17:57:29(数剑,《长夜灯塔》,实际已中止)
    • 2026-11-19 10:33:05(涉毒专家,echo hello 会话)
    • 2026-11-16 15:28:07(数剑,「你好,简单介绍一下你自己」),已跨 3 天与多次重启仍为执行中
  • 影响:审计/排障误判“仍在运行”;与消息状态、编排运行状态不一致;跨重启不收敛说明无启动补偿或超时回收。
  • 证据:screenshots/19-trace-stale-running.png;接口筛选 status=running 返回 3 条。
  • 建议:为 ai_trace 增加超时回收(与消息/编排 run 的 reaper 对齐);应用启动时把遗留 running 行置为 aborted 并写入原因;UI 对超过阈值仍未心跳的记录显示「疑似失联」。

D6【P3】长期记忆「删除记忆」按钮不可见(白字白框)

  • 现象:记忆内容 Tab 的卡片头部有 5 个操作,前 4 个可见;「删除记忆」DOM 存在、可点击,但计算样式为 color: rgb(255,255,255)、border: 1px solid rgb(255,255,255),在白底上完全不可见。
  • 证据:screenshots/06-memory-delete-button-invisible-clip.png;DOM 类名 ant-btn-background-ghost ant-btn-dangerous。
  • 建议:该处改用普通 danger 按钮(非 ghost),或给 ghost 按钮指定 danger 主题色/背景;同时补充 aria-label。

D7【P3】「任务管理」状态「进行中」语义易误解

  • 现象:任务列表 42 条中绝大多数显示「进行中」,实际生成均已结束;该状态仅表示会话未执行「结束任务」。同时「终止」按钮对所有未结束会话均可点。
  • 影响:用户会误以为后台仍在生成;与聊天列表的「生成中」角标语义不同。
  • 建议:改为「未结束 / 已结束」或增加独立列展示 running;「终止」仅在实际运行轮次可用,或改名为「结束会话」。

D8【P3】MCP 访问口令在调用示例中明文展示

  • 现象:MCP 服务端页的口令输入框为 type=password 且提供「随机生成」;但下方 curl 示例与 MCP 客户端配置片段直接拼接当前口令(如 Authorization: Bearer BizBuddy)。
  • 影响:肩窥/投屏/截图即可拿到出口口令;与输入框掩码设计不一致。
  • 建议:示例中使用 <你的访问口令> 占位,或提供「复制含口令示例」显式按钮并二次确认。

D9【P3】交互细节问题集合

编号 问题 证据/复现 建议
D9-1 文档表格点击「切片数」按钮会同时勾选该行,易造成误批量操作 知识库文档页点击 179 后该行 checkbox 变勾选 行点击选择与行内按钮事件隔离(@click.stop)
D9-2 模板库行内操作按钮为纯图标,既无 title 也无 aria-label DOM:<button><span class="i-ant-design:edit-outlined">,title/aria 均为 null 增加 aria-label/tooltip
D9-3 资源菜单浮层与 tooltip 重叠;单选专家选中后菜单不自动关闭 截图 08-chat-resource-menu.png、09-chat-expert-chip-selected.png 打开浮层时禁用/延迟 tooltip;单选后关闭子菜单
D9-4 任务详情抽屉中助手历史正文写着「请在下方确认卡片中处置」,但抽屉内没有确认卡 任务管理 → 消息明细(含待确认轮次) 审计视图改为中性文案或提供「前往会话处理」链接
D9-5 消息页脚「由 AI 生成」在窄列竖排;会话标题在列表/头部被截断,重命名预填的也是 40 字截断标题 1280×720 截图;重命名弹窗 页脚允许换行/隐藏次要信息;重命名回填完整标题(后端保存 fullTitle)
D9-6 侧栏滚动位置在切换页面后保留,可能把当前分组滚出视口 从 MCP 客户端页返回时侧栏停在「模型与推理」段 路由切换后将当前菜单项滚动到可见区域
D9-7 「查看审计链路」仅按 sessionId 过滤列表,筛选区没有可见回显/清除入口 从聊天执行过程跳转后 URL=?sessionId=...,列表仅 2 条,但筛选条未显示该条件 增加可移除的筛选 chip 或自动打开对应链路详情

D10【观察项】历史会话产物缺失,待确认是否旧版本/重启导致

  • 旧会话 2123375792932618241(19:20)的 write_file 工具记录为 SUCCESS(Written to outputs/e2e-artifact-20261119.md),但磁盘无该文件,产物接口 total=0,面板显示「本会话暂无产物」。
  • 在重启后的当前版本中新会话复测,文件、接口、面板全部正常(见 §3.4),因此更可能是旧进程/旧 jar 或重启前工作区未落盘导致。建议确认历史会话是否在会话目录刷新/清理时被误删,并在发布说明中标注旧会话产物不保证可回溯。

五、业务逻辑观察(非缺陷,供产品/研发判断)

  1. 「重新生成」对写操作轮次一律禁用:实测 regenerate/check 返回 allowed=false, reasonCode=UNKNOWN_TOOL_USED,原因「该轮调用了未登记的工具(write_file),无法确认是否只读,不能重新生成」。write_file 是框架内置写工具、语义明确,建议纳入“已知写工具”分类并给出明确的「含写操作,不可重生成」提示,而非“未登记工具”,否则审计口径会误导。
  2. 指定专家会强制路由:即使任务只是“写一个小文件”,入口智能体也被要求先 route_decision。这让简单任务多一次模型调用,并出现专家回答半截被当作最终答案的问题(见 D4)。建议只在「问题需要专家能力」时强制路由,或为“指定专家”增加“仅对话内优先”语义。
  3. HITL 信任是用户级、跨会话持久:一旦点过「记住该工具」,后续同工具不再弹确认卡;测试/演示环境很容易“以为 HITL 失效”。建议在专家/工具配置页提供「已记住工具」入口(后端已有 /trusted-tools 接口)及撤销操作。
  4. 任务状态 = 会话生命周期:status=0/1 与 running 是两套语义;聊天列表已能区分「生成中」角标与「已结束」,任务管理页未区分。建议统一展示口径。
  5. MCP 出口与客户端自连通:平台 MCP 客户端指向自身 /mcp,出口未挂载工具时“连接成功但 0 工具”,健康自检也仅告警。这对首次配置是合理的,但建议在 MCP 客户端「测试」结果中提示“对端暴露清单为空,请先在 MCP 服务端勾选工具”。
  6. 旧版本产物:见 D10,建议明确 ai/workbench/{sessionId} 的保留/清理策略,并在重启、会话结束、案件关闭时保证不误删 outputs/。

六、未覆盖场景与限制

场景 原因
附件上传(图片/文档) 内置浏览器不支持文件选择器(IAB file chooser 不可用),仅验证入口存在
计划模式完整「批准/拒绝」执行链 本轮验证了开关与提示语;批准会触发写操作,为控制数据影响未执行(历史数据中已存在计划拒绝记录)
「完全访问」权限模式 未切换,避免与 HITL 测试混淆
专家的「AI 生成提示词」 会触发额外模型调用,未测
实际删除(任务/专家/文档/知识库/工具标签) 仅验证确认弹窗并取消,避免破坏现有数据
多用户、部门/可见范围权限 单管理员账号,未做跨用户越权验证
断网/SSE 重连/后端重启中生成 上一轮报告已覆盖,本轮未重复
Electron 独立窗口/原生下载管理器 本次在浏览器环境验证,未启动 Electron 壳;下载仅确认触发
移动端/触屏 未测

七、改进建议(按优先级)

P2(建议本迭代修复)

  1. 修复未挂载路由空白(D1):守卫对未授权路径渲染 404/引导页;重定向后强制重新挂载;补 model/usage 菜单或移除路由。
  2. 修复窗口缩放布局(D2):布局高度改为响应式(100dvh/ResizeObserver),保证 composer 始终可见。
  3. 窄屏适配(D3):聊天列最小宽度、产物面板改为抽屉、消息页脚自适应换行。
  4. 流式/专家输出截断保护(D4):检测 finish_reason 与未闭合 Markdown;截断消息标记「部分完成」并支持重试;入口智能体路由后静默。
  5. 链路追踪僵尸执行中(D5):启动补偿 + 超时回收 + UI 失联提示。

P3(排期优化)

  1. 修复「删除记忆」可见性(D6)。
  2. 统一任务状态文案为「未结束/已结束」,并区分实际 running(D7)。
  3. MCP 口令示例改为占位符,或增加“显示口令”确认(D8)。
  4. 补齐图标按钮 aria-label/tooltip、行内按钮事件隔离、浮层与 tooltip 互斥、菜单滚动回显(D9)。
  5. 重命名回填完整标题;消息页脚在窄列隐藏次要指标。
  6. 为「已记住工具」提供管理界面,便于撤销 HITL 免确认(后端接口已具备)。
  7. 在 MCP 客户端测试结果中提示“出口暴露清单为空”,并在健康自检中给出跳转链接。

产品/架构建议

  1. 明确 ai/workbench/{sessionId}/outputs|plans 的生命周期与备份策略,避免重启/清理后历史产物不可追溯(D10)。
  2. 为「用量与配额」页面补菜单与权限口径,避免“实现了但不可达”。
  3. 会话标题采用“短标题展示 + 完整标题存储”双字段,避免重命名/检索被 40 字截断。

八、证据索引

截图(screenshots/)

文件 内容
01-workbench-chat-home-1280.png 工作台首页(1280×720,三栏:侧栏/会话/聊天+产物)
02-agent-entry-config.png 数剑配置表单
03-agent-expert-list.png 专家配置卡片列表
04-agent-expert-create-validation.png 新增专家必填校验
05-memory-content-tab.png 长期记忆 · 记忆内容
06-memory-delete-button-invisible-clip.png 「删除记忆」白字白框(放大)
07-chat-new-task-welcome.png 新建任务欢迎页
08-chat-resource-menu.png 资源/附件菜单与 tooltip 重叠
09-chat-expert-chip-selected.png 指定专家后 chip 与子菜单勾选
10-mcp-client-list.png MCP 客户端列表与测试 tooltip
11-session-item-hover.png 会话项悬停「…」
12-unmounted-route-blank-main.png 未挂载路由导致主区域空白
13-responsive-1024-artifact-open.png 1024×768 + 产物面板打开(严重挤压)
14-responsive-1024-artifact-closed.png 1024×768 收起产物后(页脚竖排)
15-sidebar-collapsed-composer-clipped.png 侧栏收起后输入区被裁切
16-resize-640-composer-hidden.png 缩放到 640 高后发送按钮完全不可见
17-kb-source-fulltext-drawer.png 来源全文抽屉
18-artifact-preview-modal.png 产物预览(渲染视图)
19-trace-stale-running.png 链路追踪「执行中」僵尸记录(3 条)

接口/日志(evidence/)

文件 内容
backend-console.log 后端重启与全程日志(无 ERROR)
frontend-console.log Vite dev 启动日志
artifact-session-messages.json 产物会话消息(含 D4 截断正文)
artifact-session-toolcalls.json write_file / route_decision 入参出参
artifact-session-artifacts.json 产物列表(total=1)
hitl-session-messages.json 停止/HITL 会话消息(status=3 等)
hitl-session-toolcalls.json execute 两次成功调用(含确认前/后)
kb-session-messages.json 知识库问答消息与来源
session-list.json 最近会话列表(含 status/running/pinnedExpert)
trusted-tools.json HITL 信任恢复后的「已记住工具」

关键对象

  • 案件:2121846987260764162(Ces)
  • 产物会话:2123394239460651010(artifacts=1,文件 outputs/ui-e2e-artifact.md)
  • 停止/HITL 会话:2123395916314030081
  • 知识库会话:2123396262910341121(sources=5)
  • 旧产物缺失会话(观察项):2123375792932618241

九、测试数据与合规说明

  • 未修改任何源代码,git status --porcelain 为空。
  • 新建了 3 个测试会话与 1 个测试产物文件(ui-e2e-artifact.md),未删除既有数据。
  • HITL 测试临时撤销了 execute 的用户级信任,测试后已通过「记住该工具」恢复(trusted-tools.json 可复核)。
  • 测试期间修改过浏览器视口尺寸用于响应式验证;服务保持运行(后端 PID 9732 / 前端 PID 7232)。