单测 Spec — 表格横向拖拽与表头固定优化

status: apply created: 2026-07-04

0. 测试原则

本变更是前端交互增强，优先执行 lint/build 与浏览器交互验证。
执行验证前读取 code-copilot/rules/automated-testing-standard.md。
记录命令、结果、警告和跳过项到 execution-log.md。

1. 测试框架

项目	值
前端框架	Vue 3 + Vite
组件库	Naive UI
自动化方式	pnpm build / 可选 Playwright

2. 覆盖范围

P0 — 核心交互

场景	输入	预期结果
表格 body 横向拖动	按住表格空白/单元格横向移动	表格 `scrollLeft` 改变
行内按钮点击	点击按钮/链接/输入/复选框	不触发拖拽，不阻断原交互
表头粘性	表格垂直滚动	表头停留在表格可视区域顶部

P1 — 回归

场景	预期结果
AiCrudPage 列表	表格正常加载、分页正常
直接 n-data-table 页面	表格视觉不破坏
暗色模式	表头背景不透明且可读

不测试

后端接口和数据库：本变更不涉及。

3. 执行计划

Step 1: 读取自动化测试标准。
Step 2: 执行前端构建或 lint。
Step 3: 项目未安装 Playwright，Node REPL 浏览器工具不可用；本轮使用 jsdom 指令烟测覆盖核心拖拽交互。

4. 历史验证基线

时间	范围	命令	结果	备注
无	新变更	-	-	-

5. 本轮增量验证

时间	变更范围	必跑项	实际命令	结果	跳过/警告
2026-07-04	表格拖拽指令、AiTable 接入、全局表头样式	前端构建	`source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build`	通过	存在既有组件命名冲突、动态导入、CSS `//` 注释、chunk size warning，未阻断
2026-07-04	表格拖拽指令	指令烟测	`node --input-type=module -e <jsdom smoke>`	通过	项目未安装 Playwright；使用 jsdom 验证拖拽同步和交互元素保护
2026-07-04	本轮相关文件	空白检查	`git diff --check -- <本轮相关文件>`	通过	无
2026-07-04	操作列初始可见、少量数据隐藏竖向滚动条回归修复	指令回归烟测	`node --input-type=module -e <jsdom regression smoke>`	通过	验证横拖同步、行内按钮保护、无纵向溢出 class、纵向溢出 class 移除
2026-07-04	操作列初始可见、少量数据隐藏竖向滚动条回归修复	前端构建	`source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build`	通过	仍有既有组件命名冲突、动态导入、CSS `//` 注释、chunk size warning，未阻断
2026-07-04	本轮回归修复相关文件	空白检查	`git diff --check -- <本轮相关文件>`	通过	无
2026-07-04	自定义操作列默认右固定补丁	前端构建	`source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build`	通过	仍有既有 warning，未阻断
2026-07-04	表头操作列固定兜底	源码烟测	`source ~/.nvm/nvm.sh && nvm use v20.19.0 >/dev/null && node --input-type=module - <<'NODE' ...`	通过	验证操作列默认标题、默认 `fixed: right`、`forge-table-action-column` class 和 CSS 右固定兜底
2026-07-04	表头操作列固定兜底	前端构建	`source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build`	通过	仍有既有组件命名冲突、动态导入、CSS `//` 注释、chunk size warning，未阻断

6. 执行证据

execution-log.md：已记录本轮构建、烟测、空白检查结果。