类型:事故修复版 | 版本号 1.0.5 → 1.0.6(1.0.5 已发布,号冻结 → 涨号)
触发:用户 2026-10-10 实机反馈「更新有问题 下载完成后点 ok 就没有反应了
重新打开桌面软件还是 1.0.4」
一、事故与现场取证
现象:1.0.5 客户端点「在线更新」→ 进度条走完、提示下载成功 → 点「OK」后毫无反应;
程序没退出也没重启;重新打开仍是 1.0.4。
取证(全部只读,未改动用户机器上的程序):
| 证据 | 内容 | 结论 |
| -------------------- | ------------------------------------------------------------------------------------- | --------------------------------- |
| ui_trace.log(程序目录) | 时间线完整:检查更新 → 下载完成 → 弹「在线更新」框 → 用户点 OK → 之后无任何记录 | 「点 OK 之后」这一段完全没有执行痕迹 |
| D:\FullFrame\ 目录列举 | FullFrame.exe 版本仍是 1.0.4,且目录里没有 _apply_update.*(bat / pending / log 一个不剩) | 替换脚本要么没被创建,要么被创建后被吞掉;主程序字节未动 |
| 进程快照 | 360tray 与 QQPCRTP(电脑管家)在运行 | 旧链路的可拦截点 = cmd + 批处理,正是这两家的重点拦截对象 |
根因:1.0.5 的替换链路是「程序退出 → cmd 批处理轮询 tasklist 等进程结束 →
copy 新文件 → start 拉起新版」。整条链路都是脚本动作,在 360 / 电脑管家环境下被
静默拦截:脚本不执行、也不报错,界面上却已经写了「即将退出并自动完成替换」。
用户看到的「没反应」,实为替换动作从未发生。
这也解释了为什么 1.0.5 里加的「三层防御」(优先认 FullFrame.exe 附件 / 误下安装包时
明确报错 / 更新落地留痕)没能救场 —— 防御都发生在脚本链路内部,链路本身被掐断了。
⚠️ 本节的「根因(安全软件拦截)」后被实测推翻,见第六节。 真正的原因是
current_exe() 在 Nuitka onefile 下取错了对象(sys.executable 指向 %TEMP% 里的
解包副本),这条链路从头到尾没碰到过真正的 exe —— 根本不需要安全软件出手。
本节保留作为「推断 → 被证伪」的记录。
二、修复:进程内直换(delta_update.apply_inplace)
利用 Windows 的一个特性:运行中的 exe 不能被删除/覆盖,但可以被改名。
1) 旧主程序 FullFrame.exe → 改名 → FullFrame.exe.bak(备份)
2) 新版本 _download/xxx/FullFrame.exe → 复制到 → FullFrame.exe(原路径)
3) 校验复制后的大小(校验失败即视为失败)
4) 写日志 log=ok / log=failed;写 _apply_update.pending 哨兵
5) 任一步失败 → 自动回滚:把 .bak 改回原名(程序目录绝不会缺主程序)
- UI 时序调整:弹窗改到复制成功之后才出现 —— 「点 OK 重启进入新版本」。
也就是说 点不点 OK、磁盘上都已经换成新版,用户甚至在任务管理器里手动结束进程也一样生效。
- 兜底:进程内替换失败(例如改名也被拦)才回退老的 bat 链路;
两条链路都失败时明确给出「新版文件所在路径」,让用户手动覆盖,不再有「静默无事发生」。
- 信号改造:
_download_update.worker 不再写 bat,改为 sig_upd_done.emit(path, exe);
主线程 _finish_update(new_file, exe) 负责替换 + 分级弹窗 + 重启。
涉及文件
| 文件 | 改动 |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| delta_update.py | 新增 apply_inplace(new_file, old_file):改名备份 → 复制 → 大小校验 → log → 失败回滚 |
| delta_optimizer_qt.py | sig_upd_done = Signal(str, str);_download_update.worker 去掉 bat 生成;新增/重写 _finish_update;更新成功提示写明「旧版备份为 …bak」 |
| delta_announce.py | 列表最前新增 1.0.6 公告(说明「1.0.5 用户需手动装一次」) |
| 版本号六处 | APP_VERSION / VERSION_LABEL、1.0.6 公告、test_v345.py、test_v366.py(第 13 组 + is_newer 对)、_announce_check.py、installer_fullframe.iss |
| installer_fullframe.iss | MyAppVersion "1.0.6",Source: dist155 → dist156 |
三、回归与踩坑
焦点回归门 _run_regress_v364.py v106fix focus → 26 / 26 全绿
修 1.0.6 过程中发现并修掉的 3 个「测试自身过期」问题(都不是功能回归):
_test_qr141.py 硬编码公告版本 1.0.5 → 涨号后立刻红(焦点集 23/24 的那一个)。
改为动态读 delta_optimizer.APP_VERSION,以后涨号不再牵动这个测试。
_test_bjclock.py 同样硬编码 1.0.5 —— 该套件此前根本没登记进回归集,
属于"游离套件",所以从未暴露。本次一并修好并登记进 SUITES + FOCUS(焦点集 25 套)。
同时两处纪律补齐:
- 收尾
sys.exit(...) → os._exit(3 if FAILS else 0)(Qt 未 join,sys.exit 会 0xC0000409);
- 原来把它把配置里的 scale 归一到 1.0 做了宽度断言却不还原 →
改为记下原值、收尾还原(实测跑完 overlay.json 的 scale 仍为用户的 0.6,
不再污染 C:\ProgramData\FullFrame\overlay.json)。
_test_gf_sources.py(dist144 时代套件)3 条断言过期:来源字样断言写死「三角洲工坊」,
而 dist151 起来源统一显示「在线数据」;回落断言的兜底链在 v1.0.5 后改为
「主源 → 旧在线 → 本地缓存 → 随包快照」。已按实际行为改写(并改成从 be.GF_SOURCE 动态取),
收尾同样改 os._exit,登记进回归集(焦点集 26 套)。
另外确认:test_v345.py 在报告里出现的 "Traceback" 是并行跑批被过滤器误抓的噪声
(该行含 "assert" 字样),单跑 rc=0、ASSERTS_OK,无实际问题。
四、同一批内追加的 5 项反馈修复(并入 1.0.6,不涨号)
判定依据:1.0.6 尚未发布(dist156 只是试跑包,未推 Gitee)→ 这 5 项并入 1.0.6,
版本号六处不动。若 1.0.6 已发布,这 5 项就该是 1.0.7。
4.1 「公告里赞赏码扫不出来」—— 取证到一张 208 字节的断头 PNG
| 证据 | 内容 | 结论 |
| ----------------------------------------------------- | ---------------------------------- | ------------------------ |
| 用户机 C:\ProgramData\FullFrame\qr_cache\donate_qr.png | 208 字节,PNG 魔数齐全,但 0×0、无法解码 | 本地缓存是坏图 |
| 云端同一路径 | HTTP 200,273,883 字节 | 云端图是好的 → 问题在本地缓存 |
| 老 valid_png | 只校验 魔数 + len > 100 | 208B 的坏图照样通过校验并被永久沿用 |
修复:
valid_image() 追加结构校验 —— PNG 必须 IEND 收尾、JPEG 必须 FFD9 收尾、体积 > 1KB
(旧名 valid_png 保留为兼容别名);
resolve_qr() 缓存先验身再用:坏图 os.remove 当场自愈,回落随包素材 + 等本轮云端重下;
refresh_qr_async 落盘改 .part + os.replace 原子写,杜绝进程中途被杀留下的半截文件;
- UI:公告赞赏码 168 → 236px;新增
_qr_zoom_dialog,公告与「关于」页所有二维码点击放大
(屏幕自适应,max(380, min(680, h-240, w-160))),框上加「点击可放大(手机扫码更轻松)」提示。
4.2 「关于」页交流群卡片补第三格赞赏码
群卡片由两格变三格:微信群码(左)/ QQ 群码(中)/ 自愿赞赏码(右 · 请开发者喝瓶水);
文案同步改为「用微信扫中间二维码…自愿赞赏:右侧是赞赏码…」,三格均可点击放大。
4.3 悬浮窗「固定」按钮看不懂:◎ → 📌
- 按钮文字
◎ → 📌,tooltip 写明「固定悬浮窗(鼠标穿透)」到底是什么意思 + 解锁路径;
_build_menu() 返回值 4 元 → 5 元(新增 a_lock),右键菜单增文字项
「📌 固定悬浮窗(鼠标穿透,解锁回主界面开关)」;_test_bjclock.py 同步改菜单解包。
4.4 「卡战备」新增大分类(交易行 / 军需处兑换 / 交易行(无配件))
纠偏:_gf_cpv_scheme 里原有一条注释断言「上游没有 market / mixed 口径」—— 这条是错的。
在上游 config/public 的 rows[*].config_json.topTabList 里找到了口径定义,方案字段 type(1~11)
本身就是「大分类 × 偏好」的枚举:
| 大分类 | 偏好 → type |
| -------- | --------------------------------- |
| 交易行 | 花费最少 4 / 胸挂优先 5 / 背包优先 6 / 实用优先 7 |
| 军需处兑换 | 花费最少 8 / 胸挂优先 9 / 实用优先 11 |
| 交易行(无配件) | 花费最少 1 / 胸挂优先 2 / 背包优先 3 |
实现:delta_gf.config_public() → _cpv_top_tabs() 解析 topTabList
(带 isinstance 防护 —— rows 里混有非 dict 项,缺防护会 AttributeError: 'list' object has no attribute 'get'),
缓存 CPV_TOP_TAB_CACHE,失败回落硬编码 CPV_TYPE_FALLBACK;CPV_CACHE_V 3 → 4(条目新增 type_code);
UI 加「方案来源」chips + 按分类过滤档位与方案列表 + 徽章改用上游偏好名与 bgColor。
旧源 / 旧缓存 type_code = 0 = 全分类兜底(在每个大分类下都出现,符合"口径未知"的语义)。
4.5 「关闭后进托盘」恒开、从设置页移除
去掉 close_to_tray 的设置行;closeEvent 去掉该判断 → 恒进托盘(关窗口 = 继续在托盘工作,
真正退出走托盘菜单「退出」)。公告里同步说明,但不写旧开关的原文标签
(见 5.1:该标签被用作反向针,公告若含同串会让自检误报)。
五、构建与交付
构建:build163.py → dist156/FullFrame.exe(Nuitka 免费加密机器码编译、不可反编译)
| 项 | 值 |
| ---------------- | ------------------------------------------------------------------ |
| 文件 | dist156\FullFrame.exe |
| 体积 | 30,864,896 字节 |
| 版本资源 | FV=1.0.6.0|PV=1.0.6.0 |
| md5 | 21957cce177464f54c89f25ded955139 |
本版改动较多,上面只列了前面一部分。完整日志见 仓库 docs 目录。