STDF-Viewer 状态管理不崩的 4 个关键点单一数据源怎么落地【免费下载链接】STDF-ViewerA free GUI tool to visualize STDF (semiconductor Standard Test Data Format) data files.项目地址: https://gitcode.com/gh_mirrors/st/STDF-Viewer先聊一个真实踩过的坑数据可视化应用里文件 A 的图还挂在图表页上DUT 表却已经翻到文件 B 的数据点一下 tab进度条卡在 99%表格却刷新了——消息列表和发送中那种不同步在桌面应用里一样会发生。STDF-Viewer 是一个用 PyQt5 写的 STDF 半导体测试数据可视化工具它靠一条固定管线把单一数据源、状态只读、变更可追踪这三件事落了地下面是完整的做法拆解。故障现场界面比数据跑得快想象你维护一个聊天窗口消息列表已经渲染出第 10 条发送中却还指着第 9 条。用户点重试两条消息就重发了。桌面端同样会犯这个错——两个组件各自持有一份当前文件谁先刷新谁说了算界面开始说谎。STDF-Viewer 的做法是把这类事故直接堵死所有查询只认一个数据出口所有刷新只走一个槽函数。为什么状态必须可预测一家只有一个出餐口的餐厅测试汇总页的数据状态示例别急着上框架名词先想一家小餐馆。后厨只有一口出餐口单一数据源服务员UI 组件想吃什么都得喊这一口后厨现做现端点单小票上菜只读谁也不许改单状态只读每铃一响必然对应一道菜端出来铃响了几次端了几道账本上一目了然变更可追踪。反例是那种每家服务员手里都备一份菜、还顺手改小票的店上错菜没人说得清哪来的错。可预测不是玄学就是三条数据只有一个源头界面只读不写每次变更都有明确入口。前端状态管理技巧里反复出现的单一数据源、状态只读、变更可追踪说的就是这家餐厅。数据怎么流动一条管线走到底① 后台线程只干一件事造数据库。STDF 文件由 Rust 解析器在独立 QThread 里逐条记录解析生成 SQLite 库解析完线程把数据库路径交给主线程。源码里有一句关键注释sqlite 连接不能跨线程用所以子线程只负责造库主线程负责连库。② 主线程只认一个对象。DataInterface在deps/DataInterface.py连上库后一次性读出文件清单、测试项列表、可用 site/head、BIN 映射、fail 计数等元数据。UI 里所有取值都走它没有任何组件直接摸库di DataInterface() di.DatabaseFetcher DatabaseFetcher() self.dbConnected False self.availableSites [] self.availableHeads [] self.completeTestList []构造函数把每个状态字段都给了明确初始值之后 UI 调它的都是只读方法比如getTestStatistics()、getWaferMapData()——它只回答数据是什么从不替你改数据。③ 刷新只有一个入口。后台线程完成后发出dataInterfaceSignal主窗口槽函数updateData()一次接管清空旧图表 → 换掉 DataInterface 实例 → 重建 site/head 复选框 → 重挂 DUT 表、datalog 表 → 触发一次onSelect()。全应用没有第二个刷新入口界面任何变化都能沿这条信号链反查。④ 选中状态做对比去重。每次选 test、勾 site 或切 tabonSelect()都会把当前的 (heads, sites, tests) 和selectionTracker里存的上次快照对比没变就跳过查库tab 变了则强制重算统计表。Vue 状态流转讲究状态变了才重渲染这里是同一个思想——状态没变查询就别发。⑤ 配置也是一个数据源。全部设置集中在SettingParamsdeps/SharedSrc.pypydantic 模型带默认值和字段校验启动读一次改完写回同一对象退出自动落盘。改 Cpk 阈值、换语言、调 BIN 配色走的都是同一条路不存在改一处、界面另一半不认。状态自查清单5 个问题对着你的项目过一遍每份数据只有一个主人吗所有查询是否都从DataInterface这一个对象出去如果某个 UI 组件直接连库先把那根线拔掉。UI 能不能改数据过一遍接口只读方法只该返回数据。任何顺手改一下的写法都是未来对不上账的源头。变更入口是不是唯一的刷新界面只该走dataInterfaceSignal这一条信号链出现第二处直接改模型的代码就是事故的起点。有没有记录上次已应用的状态照selectionTracker的做法状态和上次快照相同就跳过查库不同才干活。每个状态字段都有初始值吗打开DataInterface.__init__对一遍没给初始值的字段迟早渲染出个None。做完这 5 问再列一张小清单字段 → 初始值 → 谁写入 → 哪个槽触发。状态对不上时按清单找而不是从头调试。收尾照搬就能用的 3 句话把数据收敛到一个只读对象把刷新收敛到一个信号槽把上次状态存下来做对比——ChatGPT_JCM 状态管理那套单一数据源、状态只读、变更可追踪在 STDF-Viewer 状态管理里就是这么落地的。任何数据可视化应用都适用照着上面的自查清单过一遍状态就再也不会各说各话。【免费下载链接】STDF-ViewerA free GUI tool to visualize STDF (semiconductor Standard Test Data Format) data files.项目地址: https://gitcode.com/gh_mirrors/st/STDF-Viewer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
