## 建立一个最小真实测试项目

准备一个小文本、一个小 CSV 和一个空的允许输出目录。先验证最少输入的正常流程，再逐步加入大文件、网络和模型能力。不要用敏感资料作为可公开的复现样例。

记录宿主版本、组件版本、启用状态和本次测试环境；每次只调整一个因素。

## 窗口与生命周期

| 操作 | 应看到的结果 |
| --- | --- |
| 首次打开 | 清晰界面和可用操作，不出现无说明的空白 |
| 重复点击入口 | 宿主既有窗口行为正常，不重复创建业务任务 |
| 关闭后再打开 | 一套节点、一套按钮，不叠加监听 |
| 停用后重新启用 | 自己的样式与功能恢复，无遗留后台操作 |
| 窄窗口和长文本 | 按钮可触达，内容不撑宽窗口 |
| 运行中关闭 | 遵守组件明确的保存与取消约定 |

## 文件与保存

先在当前窗口通过受支持的选择或项目流程取得路径，再测试读取、分页、写入与预览。复制一个磁盘路径到输入框，不能代替授权流程验收。

保存后到实际目录核对文件内容。测试失败时保留编辑器内容，恢复权限或选择其他位置后再保存。原件只读和输出不可写是不同问题，提示也应该区分。

## 异步、网络与取消

1. 正常运行到完成，核对日志与产出。
2. 重复点击开始，确认不并发创建相同任务。
3. 中途取消，确认真实后台状态，而不只看按钮文字。
4. 取消后立即重试，确认旧回调不覆盖新结果。
5. 模拟断网或模型失败，检查阶段错误、重试边界和数据保留。
6. 在失败后重新打开，确认没有隐藏占用和无法恢复的状态。

## 性能检查

窗口打开只读元信息，不应因为用户选择大表格就把完整文件复制到多个数组。表格预览分页，重计算放到受支持的后台路径；大量日志需要合并和有界展示，避免每个字符都触发一次 DOM 更新。

观察打开、执行、取消和关闭前后的内存与后台活动。一次瞬时峰值不代表泄漏，但反复打开后持续增长、计时器一直运行或旧进程未退出，必须定位。

| 场景 | 重点 |
| --- | --- |
| 大 CSV | 预览只读当前页，未知总数仍可继续 |
| 大量输出 | 界面能滚动、取消与响应输入 |
| 视口外动画 | 暂停不必要绘制 |
| 反复开关窗口 | DOM、监听、对象 URL 和进程得到清理 |
| 工具启动失败 | 指明环境、路径或阶段，不只显示“超时” |

## 功能完整性与可解释失败

检查完成状态是否对应真实文件、模型结果和必要输出。只写出标题或论文骨架，不应该报告整段任务完成。

失败提示至少说明哪一步、什么对象和用户可以采取什么下一步。底层详细日志可以用于诊断，但不要把原始敏感请求直接暴露到界面。

## 从开发版走向正式版

开发版允许的源码扫描不等于生产包导入。完成这里的检查后，交付测试记录和源码，继续验证实际发行文件；最后一次验收必须针对最终准备发给用户的包。