Files
jerryandClaude Fable 5 5888e1d5c1 test(docgen): 测试治理资产——131 条验收用例 + 三轮留痕 + E2E/回归套件
- tests/docgen/:DC-UNIT/API/CONF/E2E/UI/REGRESSION/PERF 分组用例与可复跑脚本,报告逐条留痕(R1-R3 全记录)
- 意图 30 条前后端同表双跑(pytest + node)
- Playwright headless:docgen-ui/docgen-regression spec + b3 benchpanel 第 5 TAB 断言更新

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-03 21:13:47 +08:00

5.0 KiB
Raw Permalink Blame History

DC-UI —— 浏览器验收核对清单(人工/半自动)

对应用例:DC-UI-01~13(test_case_report.md §3.15)。 执行方式:浏览器打开 TL 部署的前端(vite 5180 dev 或生产 dist),逐条核对下列检查点, 每条结论(PASS/FAIL)与现象留痕到 test_case_report.md 实测列。 涉及真实生成/导出的条目(03/05/06/07/08/09/10)需 LLM 与 vstore 就绪;不满足则标 BLOCKED(原因=依赖未就绪),不计 FAIL。 检查期间使用占位文本,不提交敏感内容。

逐条检查点

DC-UI-01 拖拽入库(Composer)

  • 拖一个 .docx 到输入区上方:输入区出现拖拽高亮(dragover 视觉态)。
  • 松开:附件 chips 出现,数量=文件数;文本含文件名。
  • 点 chip 的 ×:chip 移除;仅从本次引用拿掉(不影响已入库记录——可到主库管理确认记录仍在)。

DC-UI-02 上传限额预检

  • 拖 6 个文件:前端预检拒绝并提示(不发上传请求——Network 面板无 POST /api/docgen/library)。
  • 拖 1 个 >20MB 文件:同上拒绝并提示。

DC-UI-03 自然触发路由(docgen)

  • 无活动文档时,输入「帮我写一份年度工作总结」发送。
  • Network:出现 POST /api/docgen/generate;消息流出现 docgen pipeline 骨架(五步:解析资料/检索模版/规划大纲/逐节生成/导出文档)。
  • 完成后:pipeline 卡 5/5 done;出现 artifact 文档卡片。

DC-UI-04 QA 原路径不回退

  • 输入「水稻基因是什么?介绍一下」发送(30 条 #8)。
  • Network:出现 POST /api/qa/chat/stream;无 /api/docgen/generate 请求。

DC-UI-05 能力徽标

  • 上一条 docgen 生成消息的 pipeline 卡头部:渲染「文档生成」徽标 chip(capabilities key=doc_writer)。
  • 另发一条 QA 消息:其 pipeline 卡头部渲染本次实际启用的会话能力 chips(联网搜索/答案润色/Superpowers,label 与设置面板一致)。
  • 旧历史消息(无 capabilities 字段):pipeline 卡头部零渲染徽标区,视觉不受影响。

DC-UI-06 文档卡片与 TAB 切换

  • 消息流内文档卡片显示:标题 + 模版名 + 「打开预览」按钮。
  • 点击「打开预览」:工作台切到「文档」TAB;artifact 内容加载中/加载完成有反馈。

DC-UI-07 TAB 预览

  • 文档 TAB 内 markdown 渲染:标题层级、表格、列表、代码块正确。
  • 注入消毒:向 md 插入 <script>alert(1)</script>(PATCH 保存后预览)→ 不执行、渲染为文本或被剥离。

DC-UI-08 就地编辑保存

  • 在预览中点击一个标题/正文段:进入编辑(contenteditable)。
  • 修改文字后 blur:预览即时更新;Network 出现 debounce 后的 PATCH /api/docgen/artifacts/{id}/content。
  • 刷新页面重进 TAB:内容为已保存版本(不丢)。

DC-UI-09 prompt 修改

  • 「用 prompt 修改」输入行输入「把标题改成黑体」提交。
  • Network:POST /api/docgen/artifacts/{id}/edit;TAB 内容替换为新 md;预览更新;编辑态有反馈。

DC-UI-10 导出与下载

  • 点「导出 PDF」→ 下载一个 pdf;本地打开:可打开、页数>0、中文正常显示。
  • 点「导出 DOCX」→ 下载一个 docx;本地用 Word/WPS 打开:段落/样式正常。

DC-UI-11 右栏拖宽

  • 桌面视口(≥1280):工作台左缘出现 .bench-resizer(约 8px,cursor:col-resize)。
  • 按住左缘向左拖:宽度实时跟随;拖到极限 clamp 在 300px~60vw(不溢出、不产生横向滚动条)。
  • 松开:localStorage['pa-bench-width'] 写入当前宽度。
  • 刷新:右栏宽度保持拖拽后的值。
  • 折叠态:resizer 不可拖拽。

DC-UI-12 折叠手柄仿左栏

  • 点右栏展开/收起按钮:折叠后保留 28px 竖条点击区,按钮嵌其上。
  • 按钮样式与左栏 .side-handle-btn 同款:26×26 圆角、hairline 描边、surface-1 底、半嵌左缘(left:0 + translate(-50%,-50%))、垂直居中、图标 13px。
  • 箭头方向镜像左栏:折叠态朝左(指向内容侧)、展开态朝右。
  • 宽度变化与手柄位置联动,transition 0.3s(与左栏一致)。
  • 状态入 localStorage['pa-bench-collapsed'];刷新后保持。

DC-UI-13 聊天输入触发导出(30 条 #14/#27 的 UI 表现)

  • 前置:存在活动文档(生成或打开一个 artifact)。
  • 聊天框输入「导出成PDF」发送。
  • Network:不出现 POST /api/docgen/generate;出现导出路径请求(export/download)。
  • 结果:触发导出下载,浏览器下载一个 pdf 文件。
  • 输入「转成PDF」(#27):同样触发导出。
  • 无活动文档时输入「导出成PDF」(#16):走 QA 原路径,不触发导出。

回填要求

每条在报告实测列留痕(R1: 检查点逐项结果/现象/结论);BLOCKED 条目注明依赖缺失原因。