QueryToolkit 测试报告 v8.15.0

QueryToolkit v8.15.0
测试报告

本报告记录 QueryToolkit 8.15.0 的完整验证过程:三层自动化回归(L1 纯函数 / L2 落库回读 / L3 界面端到端)、 6 个版本增量(8.10.0 ~ 8.15.0)的逐项交代、演示数据资产的库内核验、11 条历史缺陷的回归矩阵, 以及 13 张界面验收截图。所有结论都能追溯到一次运行的命令行产物、数据库回读结果或截图, 跑不了的分支与只能肉眼判断的部分写在第九节,不混进通过项。

被测版本 8.15.0 执行日期 2026-11-06 回归耗时 26.1 s 并发 4 workers 退出码 0 用例总数 29
被测产品
QueryToolkit(Query Toolkit)桌面版 8.15.0,Electron + Vue 的 SQL 查询与报表工具
测试类型
功能回归 + 新增功能定向验证 + 界面验收 + 演示数据核验,性能只做耗时统计不做压测
执行时间与方式
2026-11-06 01:54:36 起,一条命令跑完三层,4 并发,26.1 秒结束,退出码 0
数据来源
test-results\20261106-015432-b8b\summary.json 与同目录证据,汇总脚本 app/scripts/make-report-assets.js
数据合规
截图与样例数据全部出自包内演示种子库(编造的「莫须有基金公司」2026-09 账期),不含真实脚本、真实连接与真实业务数据
报告形态
单个 HTML 文件,16 张截图 base64 内嵌,断网可开,可直接上传网站

一、测试结论

通过

29 条自动化用例全部通过:失败 0、flaky 0、跳过 0、超时 0、运行未中断,退出码 0。 8.15.0 相对 8.9.0 的 6 个版本增量中,3 项有自动化或实测证据, 3 项(结果分文件导出、SQL 补全来源开关、标签拖拽排序)只能人工判断或尚未纳入回归,逐条列在第四、九节。 11 条历史缺陷回归用例无复现。演示数据资产四层核对与生成脚本断言一致。

版本一致性:根 VERSION、app/VERSION、app/package.json、CHANGELOG.md 四处均为 8.15.0, 运行时 app.getVersion() 回读 8.15.0,前端产物构建时间晚于源码最新改动。

100%通过率
29 / 29 通过
29用例总数
29通过
0失败
0重试 / 抖动
26.1s总耗时
3.383 s最慢用例
L1 纯函数
8 / 8
L2 落库回读
5 / 5
L3 界面端到端
16 / 16

二、测试范围与方法

按「越靠上越快、越靠下越真」分三层,三层共用同一份夹具库(测试数据/fixture.db)与同一个证据目录约定。 每层跑在独立的用户数据目录上,不碰开发机上的真实库;只有失败用例才保留 profile 目录供复现。

L1 纯函数

不起界面,直接调服务层函数。覆盖 SQL 切分与字面量、只读拦截、报表占位符渲染、S2DI 生成、Excel/CSV 日期与格式。

8 条平均 0.08s最慢 0.297 s

L2 落库回读

走 IPC 写 SQLite,写完立刻按主键/字段回读断言。覆盖脚本、报表、连接的新增改名覆盖删除与级联清空。

5 条平均 1.11s最慢 1.497 s

L3 界面端到端

真实启动 Electron,模拟点击、拖拽、双击改名、执行与导出,断言界面状态与库内结果一致;界面元素优先按 data-dbg 定位。

16 条平均 1.85s最慢 3.383 s

原生对话框的纳入方式

EDict 导入要经过系统文件对话框,自动化点不到它。做法是在用例里替换主进程的 dialog.showOpenDialog, 直接返回预设好的文件列表(app/tests/support/qt.js 的 stubOpenDialog), 于是「多选导入」「按文件名建表」「分隔符识别」都能进回归,而不只是人工验收。

async function stubOpenDialog(app, filePaths) {
  await app.evaluate(({ dialog }, ps) => {
    dialog.showOpenDialog = async () => ({ canceled: false, filePaths: ps })
  }, filePaths)
}

不在本报告范围内的部分

Oracle 真库链路不在本次回归内(三层全部跑 SQLite 夹具,oracledb 只作为依赖存在); 安装包装制、卸载、签名与开机自启未测;性能只统计用例耗时,不做百万行压测与内存曲线; 观感、手感、焦点类判断单列人工验收项。详见第九节。

三、自动化用例明细

29 条用例逐条列出,可点表头排序、按关键词与层过滤。「步骤」是用例内部记录的步骤数(L1 不起界面故为 —), 每条用例的 trace、控制台、主进程日志、应用日志与库副本都落在 cases/<用例ID>/。

显示 29 / 29
用例 ID层断言内容步骤耗时状态
l1-placeholder-renderL1报表占位符渲染:中文 :名称 出单引号字面量、引号转义、{{}} 块内参数留空则整块条件删除、IN 多值自动拼列表—0.027 s通过
l1-sql-literalL1参数值转 SQL 字面量:数字不加引号、空值出 NULL、单引号转义、中文保真;Oracle 出 TO_DATE 且取本地字段,SQLite 出文本字面量—0.016 s通过
l1-split-statementsL1语句切分:字符串 / 行注释 / 块注释 / 双引号标识符 / q'[]' 里的分号都不切,{|} 作分隔符,空段忽略,start-end 偏移能还原原文—0.025 s通过
l1-readonly-guardL1只读拦截:UPDATE / INSERT / DELETE / DROP 四类写语句全部拒绝且返回错误对象不抛异常,整批校验的 index 指向第一条违规—0.021 s通过
l1-s2diL1S2DI 生成:把 SELECT 结果生成 DELETE + INSERT + COMMIT 的可执行脚本,WHERE 原样带入、行值按字面量拼—0.297 s通过
bug-8.8.1-excel-date-tzL1Excel 日期序列号按本地墙上时间算:本地零点不落成前一天 16:00,整列零点时用 yyyy-mm-dd—0.143 s通过
bug-8.8.1-format-HHL1报表导出的 13:00 不再显示成 01:00(HH 映射为 24 小时制)—0.129 s通过
bug-8.8.1-csv-dateL1CSV 日期输出 YYYY-MM-DD[ HH:mm:ss],不再写 GMT 串,无效日期不落 Invalid Date—0.009 s通过
l2-report-saveL2报表保存:主表回读、字段与结果列顺序保真,更新时子表整体重写不留残行41.497 s通过
l2-script-saveL2脚本另存与覆盖:para_code 与正文回读一致,同名同类型拒绝并回传 existingId,覆盖不产生新行41.299 s通过
l2-conn-saveL2连接增改:新增 SQLite 连接回读 db_type 与 enabled,改备注不动连接串41.258 s通过
l2-report-deleteL2删除报表级联清空字段表与结果列表30.767 s通过
l2-script-deleteL2删除脚本后按主键回读为零行20.748 s通过
smoke-edict-import-multiL3一次多选 csv / tsv / txt 三个文件按文件名建三张表,列数按各自分隔符切开、行数与源文件一致31.075 s通过
smoke-edict-import-delim-edge-casesL3分隔符判定的两个边界:无制表符的 txt 仍按逗号切,引号内的逗号不算分隔符30.709 s通过
bug-8.8.5-rename-scriptL3脚本元信息改名后 sql_script.para_code 回读为新名,标签标题同步61.795 s通过
bug-8.8.2-save-report-hangL3保存报表后按钮不留在「保存中」,report 表确实落下一行52.423 s通过
bug-8.8.4-editor-dragL3在选区内按下并拖动 20px 不把 SQL 搬走,选区仍然存在53.079 s通过
bug-8.8.3-report-sql-heightL3报表编辑器的 SQL 编辑区高度不被布局压塌(> 100px)20.517 s通过
smoke-editor-visibleL3ESQL 编辑器可视高度不低于 120px10.311 s通过
smoke-run-scriptL3选连接执行整段脚本,结果按标签出三行33.383 s通过
smoke-report-runL3报表目录选中 → 点查询 → 结果三行30.978 s通过
bug-8.8.5-tab-rename-saveL3双击标签改名后点保存,新名称写回脚本32.079 s通过
bug-8.8.4-status-runningL3执行结束后状态栏不再残留「执行中」32.894 s通过
bug-8.8.3-save-connL3设置页新建连接确实落库,回读 db_conn 字段一致51.481 s通过
smoke-save-conn-editL3点开已有连接改备注保存,备注更新且连接串未被清空30.564 s通过
bug-8.8.4-tab-clickL3带 1~2px 抖动的真实点击仍能切换标签,编辑器内容跟着换63.135 s通过
smoke-export-excelL3导出当前结果为 xlsx,回读工作表行数与结果一致53.259 s通过
smoke-tab-new-closeL3新建 3 个标签关掉后 2 个,仍有激活标签且编辑器可见31.906 s通过
说明列是人工对照 app/tests/**.spec.js 写的,逐条核对过断言原文;生成脚本会检查用例 ID 与说明是否一一对应,缺一条就拒绝出报告。

深挖 带抖动的标签点击 bug-8.8.4-tab-click

  1. 第一个标签写入 A809 ms
  2. 新建标签并写入 B1163 ms
  3. 右下标签为当前标签160 ms
  4. 带抖动点击第一个标签445 ms
  5. 激活态切到第一个标签55 ms
  6. 编辑器内容跟着换53 ms

步骤合计 2.685 s · 用例耗时 3.135 s · 1 次通过,无重试 · worker —

这条用例留下的证据

cases/bug-8.8.4-tab-click/trace.zip1348 KB
cases/bug-8.8.4-tab-click/console.log0 KB
cases/bug-8.8.4-tab-click/app-log.json21 KB
cases/_worker/main-w9.log1 KB
cases/bug-8.8.4-tab-click/db-after0 B 目录

通过用例不落最终截图,过程证据在 trace.zip 的 screencast 里;第七节末尾贴了它跑到后半段的一帧(800×475)。

深挖 执行并导出 Excel smoke-export-excel

  1. 把保存对话框换成固定路径3 ms
  2. 选连接并写入 SQL1974 ms
  3. 执行整个脚本502 ms
  4. 导出当前结果 Excel453 ms
  5. 回读 xlsx 行数56 ms

步骤合计 2.988 s · 用例耗时 3.259 s · 1 次通过,无重试 · worker —

这条用例留下的证据

cases/smoke-export-excel/trace.zip1748 KB
cases/smoke-export-excel/console.log0 KB
cases/smoke-export-excel/app-log.json61 KB
cases/_worker/main-w10.log0 KB
cases/smoke-export-excel/db-after0 B 目录

通过用例不落最终截图,过程证据在 trace.zip 的 screencast 里;第七节末尾贴了它跑到后半段的一帧(800×475)。

深挖 多选批量导入三张表 smoke-edict-import-multi

  1. 打开 EDict 页并点导入715 ms
  2. 等状态栏报出导入张数26 ms
  3. 三张表都建成,列数按各自分隔符切开160 ms

步骤合计 0.901 s · 用例耗时 1.075 s · 1 次通过,无重试 · worker —

这条用例留下的证据

cases/smoke-edict-import-multi/trace.zip375 KB
cases/smoke-edict-import-multi/console.log0 KB
cases/smoke-edict-import-multi/app-log.json10 KB
cases/_worker/main-w7.log1 KB
cases/smoke-edict-import-multi/db-after0 B 目录

通过用例不落最终截图,过程证据在 trace.zip 的 screencast 里;第七节末尾贴了它跑到后半段的一帧(800×475)。

四、版本增量验证

上一次全量回归记录在 8.9.0,之后到 8.15.0 共 6 个版本增量,逐条摘自 CHANGELOG.md, 每条下面写清本报告用什么证据覆盖它。没有证据的直说没有,不借「回归全绿」含糊带过。

8.10.0 · 2026-10-22 新增:自建表格一次导入多个 CSV

  • 文件对话框支持多选:按住 Ctrl / Shift 可一次选中多个 CSV,选中几个就建几张表,不再一个文件来回点一遍
  • 批量导入按文件名建表:选多个时直接用文件名作表名(沿用原有的非法字符清洗),省去逐个输入表名;只选一个时仍是原来的表名对话框,可以改名
  • 同名表一次确认:批量导入遇到已存在的表,先把这些表名一次列全,确认后删除原表再重建;取消则这些表跳过,其余文件照常导入
  • 过程与结果可见:导入期间按钮显示“导入中…”,状态栏显示进度(如 3/8 演示_银行资金流水_202609),结束后给成功 / 失败数;有失败时主区顶部列出前几条原因,完整清单在状态栏长消息里

本报告内的验证 smoke-edict-import-multi 用例(本轮固化)+ 截图 09;同名冲突覆盖与取消跳过两条分支仍靠一次性脚本验证,未进回归

8.11.0 · 2026-10-28 新增:ESQL 全部结果按 SQL 分别导出多个文件

  • 一次查询多条 SQL,结果各存一个文件:「导出结果」菜单新增「全部结果·每结果一个 Excel 文件」与「全部结果·每结果一个 CSV 文件」,选一个文件夹即可,不再只能把多条结果塞进同一个工作簿或同一个 CSV
  • 文件名「序号_表名」:序号按本次导出的文件总数补零(9 个文件是 1 位,十几二十个是 2 位,以此类推),表名取自该条 SQL 的 FROM;JOIN、子查询等取不到表名的退化为 SQL 序号。失败或未执行的语句不生成空文件
  • Excel 每个文件仍带「查询脚本」页:记录该条 SQL 原文、返回行数、耗时与截断状态;文件夹选默认导出目录起步,可直接改位置

本报告内的验证 smoke-export-excel 覆盖「当前结果导出」;「全部结果每结果一个文件」需要选文件夹,未进回归,列在第九节

8.12.0 · 2026-11-04 新增:SQL 补全提示内容可在设置页开关

  • 只保留想要的补全:设置页「界面 → 编辑器」新增「SQL 补全提示内容」,关键字 / 当前连接的表与字段 / 片段模板(sel、ins、upd、del、s2di)三项独立勾选,取消勾选的来源不再弹候选
  • 默认只勾表与字段:新装与升级后默认只提示当前连接的表和字段,不再被大量 SQL 关键字和模板干扰;需要时自行勾回
  • 全局即时生效:作用于所有 SQL 编辑区(ESQL、自定义报表查询、设置页脚本弹窗),切换当场重建补全来源无需重启;选项写入 settings.json 持久化

本报告内的验证 补全候选来源靠肉眼判断弹不弹候选,无法断言,列为人工验收项

8.13.0 · 2026-11-05 新增:自建表格导入支持 TSV,分隔符自动识别

  • 文件对话框能选 .tsv 了:过滤器从 csv / txt 扩到 csv / tsv / txt,系统导出的制表符文件不必先改扩展名才能导
  • 分隔符自动识别:.tsv 按制表符,其余看首行制表符与逗号谁多;把制表符文件命名成 .txt 也能直接导,不用手动转逗号
  • 单个与批量走同一套识别:多选导入时每个文件各自判定,csv 与 tsv 混在一起一次导完

本报告内的验证 smoke-edict-import-multi + smoke-edict-import-delim-edge-cases 两条用例(本轮固化),覆盖单扩展名判定与两种边界

8.14.0 · 2026-11-05 修复:窗口标题栏显示版本号与发布日期

  • 标题栏能看出跑的是哪个包:窗口左上角原生标题栏显示 Query Toolkit v8.14.0 · 2026-11-05(版本号来自 VERSION 文件,日期取它的修改时间,即本版本发布日期);页面里的 <title> 会把标题栏覆盖成光秃秃的 “Query Toolkit”,实测只 preventDefault() 拦不住(Windows 上标题照样被改),现在在 page-title-updated 里再 setTitle 写回
  • 发布包仍然不带任何数据:exe 里不含脚本、连接、自建表格等任何数据,全新安装首启是空库,连接需要自己建
  • 附:演示种子库生成脚本:新增 npm run seed(scripts/make-demo-seed.js),从当前用户库清洗出只含 Demo 脚本、演示报表与 EDICT 演示表的两个库,带数量核对与真实痕迹扫描(内网 IP / 账号密码 / 真实字典表引用),供单独制作的演示版使用;正式版打包不包含它

本报告内的验证 正式版与演示版两个 exe 首启实测,标题栏分别是 Query Toolkit v8.15.0 · 2026-11-05 与 Query Toolkit Demo v8.15.0 · 2026-11-05;证据是文字记录,截图含本机用户名路径不外发

8.15.0 · 2026-11-05 新增:演示版打包(自带 SQLite 演示数据,不连任何数据库服务也能跑完全部流程)

  • 两个包一条命令:打包.bat 现在会问你是否同时打演示版;手工做法是先 npm run seed 再 npm run build:demo,产物 Query Toolkit Demo 8.15.0.exe。首启自带 30 条演示脚本、14 张演示报表、8 张演示自建表,和一个编造的 SQLite 演示库(15 张表 + 3 个视图,莫须有基金公司 2026-09)。正式版依旧零数据
  • 数据目录隔开:演示版走 %APPDATA%\TBA-Demo\tba-data\,与正式版的 %APPDATA%\TBA\ 互不覆盖,两个 exe 可以同机共存;标题栏显示 Query Toolkit Demo v8.15.0 · 日期 分辨身份
  • 30 条脚本 + 14 张报表逐条改写成 SQLite 方言:CONNECT BY LEVEL 造 30 万行改成递归 CTE 现算(924 行持仓 × 300 = 277200 行,与 Oracle 版完全一致);NVL→IFNULL、DATE '2026-08-31' 字面量与“Oracle 空串即 NULL”的写法差异逐处处理;日期参数在 SQLite 下渲染成 'YYYY-MM-DD 00:00:00',演示库存的是 'YYYY-MM-DD',等值比较统一套 DATE() 归一
  • 演示连接存路径占位:种子库里写的是 {{DATA_DIR}}/demo.db,首启导入时换成当地实际绝对路径,换电脑、换用户名都不需要改库
  • 修复:报表列格式在 SQLite 连接上完全不生效:列格式按列名精确匹配,而 Oracle 返回全大写、SQLite 返回 SQL 里写的小写,导致中文表头、千分位、日期格式、对齐与导出全部落空;现在结果列名与列格式键统一按大写比对(结果表格、导出 Excel、列编辑器“预览列”取样例三处)
  • 守门加严:种子脚本除原有数量核对与敏感串扫描(内网 IP / 账号密码 / 真实字典表引用)外,新增“改写后不得残留 Oracle 语法”自检与 demo.db 只含 Demo_ 对象检查,任一不过就拒绝产出
  • 手册补一条常见误区:ESQL 页只认 <VAR01> 变量,:组合 这类命名占位符要“另存为报表”后执行才会弹参数输入

本报告内的验证 第五节演示资产逐项核对;本报告 13 张验收截图全部取自包内演示种子库;首启导入条件收紧后两包重打并复测,全量回归绿

导入功能的验证矩阵

场景操作预期实测结果状态
多选建表一次选中 csv / tsv / txt 三个文件按文件名建三张表,表名沿用非法字符清洗三张表都建成,列数按各自分隔符切开、行数与源文件一致已进回归
扩展名判定导 .tsv直接按制表符切切成 4 列,3 行入库已进回归
内容嗅探制表符内容命名成 .txt(首行 ≥2 个制表符)嗅探为制表符3 列,与内容一致已进回归
保守判定无制表符的 txt / 引号内含逗号的 csv前者判逗号,后者引号内逗号不算分隔符txt 切 3 列 2 行;说明列完整保住「含,逗号的说明」已进回归
状态栏进度批量导入期间与结束按钮显示「导入中…」,结束报出导入张数状态栏出现「已导入 3 张表」,用例以它作完成判定已进回归
单文件分支只选 1 个文件仍弹表名对话框,可改名改名后按新名建表定向验证
同名冲突再导一次相同文件一次列全冲突表名,确认后删除重建确认框列出冲突表名,确认后覆盖成功定向验证
取消跳过冲突确认框点取消冲突表跳过,其余照常导入冲突表保留原数据,其余文件建成定向验证

「定向验证」= 用一次性脚本跑过并记在这里,但依赖原生对话框的确认/取消分支尚未固化成回归用例,建议见第十节。

五、演示数据资产核验

8.15.0 打的是两个包:正式版零数据,演示版自带 SQLite 演示库。下面这些数字是生成报告时直接读包内 app/seed 三个库现查的, 不是引用当初造数据时的日志。

30ESQL 演示脚本
14演示报表
24报表参数字段
132报表结果列
8自建表演示表
15 + 3演示库表 + 视图
277,200大结果集现算行数

库内核验

  • ✓演示脚本 30 条(para_type='Demo' 隔离)
  • ✓演示报表 14 张(分类「演示案例」隔离),参数字段 24 个、结果列 132 个
  • ✓自建表演示表 8 张,统一 演示_ 前缀
  • ✓演示业务库 15 张表 + 3 个视图,只含 Demo_ 对象
  • ✓持仓表 924 行,大结果集脚本用递归 CTE 现算 277,200 行(×300),与 Oracle 版行数一致
  • !演示连接存的是 {{DATA_DIR}}/demo.db 占位,首启导入时换成当地实际绝对路径

发布安全与隔离

  • ✓种子产出守门:数量核对 + 敏感串扫描(内网 IP / 账号密码 / 真实字典表引用)+ 改写后不得残留 Oracle 语法
  • ✓业务数据全部编造:莫须有基金公司、P001 / 000001 之类假代码,2026-09 单个账期
  • ✓首启导入条件收紧为「tba.db 不存在才导三个种子库」,老用户目录不会被塞入演示库
  • ✓演示版走 %APPDATA%\TBA-Demo\,与正式版 %APPDATA%\TBA\ 互不覆盖,同机共存
  • ✓本报告 13 张截图全部用演示种子库补拍,数据目录刻意放在项目内而非系统临时目录,避免把本机用户名拍进发布物
  • !开发期 debug截图/ 里的老图是连真实库时截的,一律不用

六、历史缺陷回归

每个修过的缺陷留一条用例防回归,本报告跑了其中 11 条,全部通过。根因照 CHANGELOG.md 的记录写,不重新解释。

缺陷现象根因回归用例层耗时状态
导出的日期比查询结果早 8 小时ExcelJS 按 Date 的 UTC 瞬间算序列号bug-8.8.1-excel-date-tzL10.143 s通过
报表时间列 13:00 显示成 01:00格式串把 HH 映射成 12 小时制bug-8.8.1-format-HHL10.129 s通过
CSV 里是 GMT 长串,Excel 识别不了直接写 JS Date 默认字符串bug-8.8.1-csv-dateL10.009 s通过
改脚本名点确定没反应确认时丢弃输入值,把打开时的旧名再写一遍bug-8.8.5-rename-scriptL31.795 s通过
保存报表按钮永久停在「保存中」Vue 响应式数组跨进程无法序列化,静默失败bug-8.8.2-save-report-hangL32.423 s通过
选中文本被悄悄搬走,SQL 变成乱串CM6 把「选区内按下再拖动」当成拖移选区bug-8.8.4-editor-dragL33.079 s通过
报表编辑器看不到 SQL 窗口提示区变高后 flex 子项被压缩到 0 高bug-8.8.3-report-sql-heightL30.517 s通过
双击标签改名后保存不落库改名只记在本机会话,保存只写正文bug-8.8.5-tab-rename-saveL32.079 s通过
执行完状态栏还是「成功 · 执行中」merge 语义没清空运行文案bug-8.8.4-status-runningL32.894 s通过
设置页保存连接没反应同上,响应式对象未转纯数据bug-8.8.3-save-connL31.481 s通过
点标签没反应标签可拖拽,按下后有几像素位移就改派原生拖拽、不再派发 clickbug-8.8.4-tab-clickL33.135 s通过

七、界面截图

13 张验收截图统一 2000×1250(窗口 1600×1000,系统 125% 缩放),全部用演示种子库补拍,画面里的路径与数据都可以公开。 截图保留原色不随报告主题反色,深浅模式下靠边框与留白区分边界。文末 3 张是执行过程抓帧,来自用例 trace 的录屏,分辨率只有 800×475,只作过程证据。

ESQL · 脚本列表
ESQL · 脚本列表ESQL 页:30 条演示脚本列表,已选中「演示-基金主数据」2000×1250 · 80KB
ESQL · 执行结果
ESQL · 执行结果执行「演示-基金主数据」:结果表格 + 多语句结果标签 + 状态栏行数2000×1250 · 152KB
ESQL · 大结果集上限
ESQL · 大结果集上限执行「演示-大结果集 30 万行」:递归 CTE 现算约 27.7 万行,命中最大行数上限的提示2000×1250 · 124KB
ESQL · 多标签并存
ESQL · 多标签并存ESQL 多标签并存:标签条可关闭、可切换2000×1250 · 103KB
自定义报表查询 · 目录
自定义报表查询 · 目录报表页:「演示案例」分类下 14 张报表与参数字段区2000×1250 · 55KB
自定义报表查询 · 列格式
自定义报表查询 · 列格式执行「组合概览」:列格式生效(中文表头、千分位、两位小数)2000×1250 · 103KB
报表编辑器
报表编辑器报表编辑器:SQL 编辑区、参数字段表、列格式表(列名/表头/类型/对齐)2000×1250 · 174KB
EDict · 全文搜索
EDict · 全文搜索EDict:8 张演示自建表,跨表全文搜索「莫须有」2000×1250 · 189KB
EDict · 批量导入
EDict · 批量导入EDict:一次选择多个文件按文件名批量建表,状态栏报出导入张数2000×1250 · 75KB
设置 · 数据库连接
设置 · 数据库连接设置 · 数据库连接:演示库是一个本地 SQLite 文件2000×1250 · 46KB
设置 · 界面与主题
设置 · 界面与主题设置 · 界面设置:5 套主题色 × 深浅两档2000×1250 · 90KB
主界面跟随主题
主界面跟随主题换成翠绿主题 + 深色后的 ESQL 结果页(颜色全走 CSS 变量)2000×1250 · 123KB
设置 · Debug 模式
设置 · Debug 模式设置 · Debug 模式开关与运行日志收集2000×1250 · 50KB

执行过程抓帧

bug-8.8.4-tab-click 执行过程抓帧
带抖动的标签点击用例 bug-8.8.4-tab-click 跑到后半段的窗口画面800×475 · 32KB
smoke-export-excel 执行过程抓帧
执行并导出 Excel用例 smoke-export-excel 跑到后半段的窗口画面800×475 · 45KB
smoke-edict-import-multi 执行过程抓帧
多选批量导入三张表用例 smoke-edict-import-multi 跑到后半段的窗口画面800×475 · 25KB

八、性能与环境

这里的「性能」指回归本身的耗时分布与运行环境,不含应用压测。三层合计 26.1 秒跑完 29 条, 界面层平均 1.85 秒、最慢 3.383 s(选连接 + 执行 + 等结果标签落地是主要开销)。

最慢 5 条

#用例层耗时步骤
1smoke-run-scriptL33.383 s3
2smoke-export-excelL33.259 s5
3bug-8.8.4-tab-clickL33.135 s6
4bug-8.8.4-editor-dragL33.079 s5
5bug-8.8.4-status-runningL32.894 s3

没有超过 5 秒的用例;--retries 设为 0,所以「抖动 0」是真的没重试,不是重试后掩盖。

运行环境与指纹

被测形态
源码形态(source),由 qtc 用 _electron.launch 起真实实例;app.getVersion() 回读 8.15.0,窗口标题 Query Toolkit
被测代码指纹
sha256:2dfe12c9e60a5512…(sha256,覆盖 main / preload / services / handlers / tests)
执行命令
node cli\index.js test --layer l1,l2,l3 --workers 4
qtc 版本
8.15.0
运行平台
Windows win32 10.0.22631 · x64 · Node v24.15.0
关键依赖
Electron 31.7.7 · Playwright 1.64.1 · sql.js ^1.14.2 · oracledb ^7.0.1
机器
Intel(R) Xeon(R) Gold 6248R CPU @ 3.00GHz(16 核)· 内存 32 GB(可用 12 GB)· 代码页 936
前端产物
未过期(构建于 2026-11-05 17:24:07,源码最新改动 2026-11-05 14:56:05)
夹具数据指纹
tba.db f01d4fee1135… edict.db 251f69361456… fixture.db 966a702ed855…
运行目录
test-results\20261106-015432-b8b\(summary / env / runtime / plan / interrupted / run.log / index.html + 29 个 cases 子目录)
profile 保留策略
保留失败用例的独立用户数据目录(--keep on-failure),本次无失败故未产出

九、偏差、遗留与未覆盖

与原计划的偏差

偏差原因怎么处理
验收截图另拍,不直接用 trace 抓帧计划原本想从 trace 挑关键帧,实测录屏帧固定 800×475(回归窗口默认 800 宽),达不到发布所需的清晰度补拍 13 张 2000×1250 作验收图,trace 帧降格为「过程抓帧」单列一节
回归跑在源码形态而不是打包 exeexe 形态每次要自解压,慢且不好留 profile正式包与演示包各做一次首启人工实测(标题栏、自带数据、目录隔离),其余按源码形态跑

遗留问题

#问题影响建议状态
1用例通过时不落最终截图界面证据只能从 trace 提取,分辨率如上受限关键用例结束前补一张成功态截图(已用补拍脚本临时解决发布需要)待办
2同名冲突覆盖 / 取消跳过未固化改动导入逻辑后这两条分支不会被回归拦住用同一套 stubOpenDialog + 覆写 dialog.showMessageBox 补两条用例待办
3ESQL 全部结果分文件导出未覆盖8.15.0 的 8.11.0 增量没有自动化证据把导出目录换成预设文件夹,回读文件数与命名(序号_表名)待办
4Oracle 链路整条未跑三层全用 SQLite 夹具,Oracle 方言与真实连接问题回归发现不了至少加一条 l1 方言断言(TO_DATE / NVL / 空串即 NULL),真库留给发布前人工连一次待议
5本机用户名的处理靠约定而非代码截图路径、标题栏日期都取自本机环境,换机器可能把 C:\Users\xxx 拍进发布物截图脚本固定用项目内数据目录(已做),并在自检里扫描画面文字含不含用户名部分完成

人工验收项(无法自动断言,逐项看过)

主题跟随

5 套主题 × 深浅切换后,导航、表格、按钮、结果标签、报表列编辑器全部跟着变色,无残留旧色块;截图 11、12 为证。

补全来源开关

只勾「表与字段」时不再弹 SQL 关键字候选,取消勾选当场生效不重启(8.12.0 增量,肉眼判断)。

导入手感

一次多选 3 个文件,进度与状态栏文案不闪烁、不卡界面;失败原因能在长消息里看到。

大结果集上限提示

277200 行的脚本命中最大行数上限,界面给出提示而不是假死;截图 03 为证。

报表列格式

中文表头、千分位、两位小数在 SQLite 连接上生效(这是 8.15.0 修掉的缺陷);截图 06 为证。

标题栏身份

两个 exe 首启后原生标题栏分别显示 Query Toolkit v8.15.0 · 2026-11-05 与 Query Toolkit Demo v8.15.0 · 2026-11-05。

未覆盖清单

安装 / 卸载 / 代码签名 / 智能安全警告;多显示器与 150% 以上缩放;超长 SQL 与万列结果的渲染极限; 并发执行多条长查询;设置项迁移与升级后 settings.json 兼容;Oracle 真实连接;日志脱敏与证据包上传。 以上均未做,不算通过项。

十、结论与建议

可以发布

8.15.0 的三层回归 29 / 29 通过,11 条历史缺陷无复现,6 个版本增量逐条交代了证据来源, 演示资产与发布安全核对通过。已知的 0 个失败与 5 项遗留都不影响主流程,按第九节的建议排下一轮。

优先级建议:先补第 2、3 两条待办(导入冲突分支与分文件导出),它们是本两轮新增功能的直接盲区; 再做第 4 条 Oracle 方言的最小断言;第 1、5 条属于证据链质量,跟报告生成一起解决。

这轮回归暴露出来、已经顺手修掉的

  • 导入用例首轮假失败:window.tba.db.query 回的是 {success, data},用例把它当数组用导致 .map is not a function;helper 改成解 .data,并在 success 为假时抛错——不然查询失败会被当成「表不存在」静默通过。
  • 首行只有 1 个制表符的 txt:按 t >= 2 的保守规则判成逗号,整行落成一列。这不是缺陷(避免单格文本里一个偶然 tab 就误判),用例改为 3 列制表符文本,并把这条边界固化下来。
  • 首启导入条件:原先逐库判断存在性,源码形态会把孤儿 demo.db 复制进老用户数据目录;现改为整体 gate 在 tba.db 不存在。
  • 前端产物过期拦下回归:qtc diagnose 的产物新鲜度检查发现 ReportColumnsEditor.vue 比 app/renderer 新,先重建再跑——这条检查起作用,说明它不该被跳过。

附录

A. 复现命令

# 三层全量回归(4 并发)
cd app
node cli\index.js test --layer l1,l2,l3 --workers 4

# 环境自检(依赖版本、前端产物是否过期、夹具是否干净)
node cli\index.js diagnose

# 采集验收截图(用包内演示种子库,不连真实数据)
node scripts\capture-report-shots.js

# 汇总报告数据 → 生成单文件报告 → 渲染自检
node scripts\make-report-assets.js
node scripts\make-report-html.js
node scripts\check-report-html.js

B. 证据位置

本次运行
test-results\20261106-015432-b8b\
逐用例证据
test-results\20261106-015432-b8b\cases\<用例ID>\
最新指向
test-results\latest(存绝对路径)
验收截图
测试报告\assets\shots\(13 张 + 抓帧 6 张)
中间数据
测试报告\assets\report-data.json
演示种子库
app\seed\tba.db / edict.db / demo.db
本机用户数据
%APPDATA%\TBA\tba-data\(正式版)与 %APPDATA%\TBA-Demo\tba-data\(演示版),本报告未读取

C. 报告自身的自检

  • ✓生成脚本 15 项数据断言全绿(版本、失败数、退出码、用例数、步骤明细、截图分辨率与体积、演示资产、增量覆盖)
  • ✓无外部依赖:全部图片 base64 内嵌,报告内不出现任何 http 外链
  • ✓目录与章节一一对应:11 个锚点、滚动高亮、点击平滑跳转
  • ✓5 套主题 × 深浅两档均渲染验证;打印时隐藏顶栏与控件
  • ✓1440 与 390 宽无横向滚动;交互控件带 aria-label,状态不只靠颜色

自检脚本 app/scripts/check-report-html.js 用 Electron 实际加载本报告跑这些断言,不是照着 CSS 目测的。

D. 怎么读这份报告

右上角能换配色与深浅,选择存在本机浏览器里,不影响别人看到的版本;宽屏左侧目录常驻,窄屏回退成顶部导航。 第三节表格能排序过滤,想核对某条结论:按用例 ID 去附录 B 的目录里取 steps.json 与 trace.zip, trace 用 npx playwright show-trace 打开能看到每一步的画面与 DOM 快照。