小窗浏览器 v1.4.5-test.2｜可调挖孔刷新与白屏恢复测试

小窗浏览器 v1.4.5-test.2（测试版）

此预发布继续验证 v1.4.4 后新增/切换标签时共享 WebView 白屏、网页无法交互，以及圆形挖孔跟随鼠标卡顿的问题，不覆盖 1.4.4 正式版或先前的 test.1。

运行日志与自动清理

• “复制诊断信息”按钮改成“打开日志文件夹”，自动打开与 config.ini 同级的 logs 文件夹。
• 按 UTC 日期生成 XiaoChuang-YYYY-MM-DD.log，记录启动/退出、标签变化、WebView2 导航和错误代码、进程异常、白屏检测/响应、恢复流程及长时间 UI 消息间隔。
• 默认开启日志自动清理，保留 7 天；用户可以关闭自动清理，或者选择保留 3、7、30 天。只删除 logs 文件夹中符合命名规则的旧程序日志，不会删除配置或其他文件。
• 日志策略为应用全局设置，不随场景预设切换；设置、预设的共存检查与清理核心测试已加入。
• 日志默认不包含网页 URL、标题、输入内容、Cookie；不自动上传。异常退出可能丢失最后少量记录。用户手册已更新，安装包仍只保留必要用户文件。

打包提醒文件

• 保留旧有的 小窗吸附后按住Ctrl拖动.txt，与按 0 开启穿透、长时间白屏右键恢复两个提醒并列；三个 TXT 都作为空文件，仅通过文件名提醒操作。

新增：可调白屏检测等待（秒）

• 设置 → 常规 → 白屏检测等待：3–30秒，默认5秒；修改后从下一次新增/切换标签起生效。
• 控制导航后的加载提示兜底与一次性响应探测启动时间，探测还有约2秒响应等待，不是无条件刷新网页。
• 与挖孔刷新间隔、网页缩放、热键等设置一并保存；场景预设各自保存检测等待秒数，旧配置/旧预设缺失时自动采用5秒。
• 发行包新增空白文件 长时间白屏时右键标签页重载.txt；实际菜单项为“网页白屏 / 无法操作？重建网页视图”。
• 发布包中只放软件运行文件、零基础使用说明、三个空白提醒及必要许可证；测试记录、发布日志保留在 GitHub，不打包给普通用户。

界面布局修正

• “挖孔刷新间隔”使用独立标签，单位 ms 放在输入框旁；参数说明另起全宽一行，修复中文说明被截断、折行与下一项“吸附距离”重叠的问题。
• 布局仍需在不同 Windows DPI/字体缩放环境下人工复核。

新增：挖孔刷新间隔

• 设置 → 沉浸 → 挖孔刷新间隔（ms）：默认 16ms，可调 10–100ms。
• 修改后立即生效，重启仍保存；场景预设分别保存和恢复；旧配置自动采用 16ms。
• 只控制圆形挖孔位置更新，整体透明模式仍按原 50ms 检查与移入防抖。Windows 计时器受调度影响，设定值不是保证的画面刷新帧率。
• 包内新增纯空文件 开启鼠标穿透和隐藏标题栏按0.txt，用文件名提醒按 0 切换沉浸/穿透并隐藏标题栏。

白屏：理解并加固可配置的等待与恢复

• test.1 已移除导航前额外 Stop，并保持 WebView 可见。test.2 另修复：从托盘或第二次启动恢复时，不因仍在等待新标签加载而再次隐藏 WebView。
• 加载等待定时器按设置的 3–30 秒控制 UI 提示等待，不是重复执行的强制刷新。
• 每次新增/切换标签，即使 ContentLoading 或 NavigationCompleted 已经触发，仍会在所选等待秒数后发起一次 JavaScript 响应探测；额外约 2 秒没有成功返回，才尝试重建共享 WebView（恢复当前标签导航）；自动恢复有 至少 60 秒冷却，避免异常网站导致持续重建。
• 如果新标签已经触发加载事件、但共享渲染器随后卡住，仍可接受探测；这是 test.2 的第二轮针对性加固。
• 即使自动恢复没有奏效，在顶部标签栏右键选择“网页白屏 / 无法操作？重建网页视图”，无需退出整个小窗即可手动重建共享 WebView。重建会重新加载当前网页，可能中断播放或未保存的表单。
• 正在正常加载但响应探测成功的网页不会被强制重建。网页加载慢、网络不通、GPU 合成故障或 UI 线程卡死不一定能通过该探测识别，不承诺根治所有白屏。

测试重点

1. 使用顶部 +、网页新窗口、关闭新标签、返回原标签、快速连续切换、托盘隐藏/恢复，观察出现白屏后能否自行恢复和是否仍可点击。
2. 进入圆形挖孔，分别选 10、16、25、33、50、100ms 测试流畅度与游戏掉帧；修改后即刻观察，切回整体透明检查是否不受影响。
3. 保存自定义间隔进预设、重启、重新应用预设，确认数值正确；测试旧配置及默认值。
4. 测试全局快捷键、固定网页缩放、视频全屏和切换、隐藏/恢复。

验证范围与升级

GitHub Actions Windows x64 Release 构建及核心测试通过后才发布 ZIP；受托管工具链限制，构建使用 MSVC v143 而不是开发机 v145。自动化核心测试不等于实际 WebView2 故障复现或游戏/显卡实测。

请退出正在使用的旧版，解压到独立目录，不要覆盖旧版配置、缓存和 Cookie；如遇问题附上复现路径、网页地址及诊断信息。此预发布不会自动合并到 master。后续测试改动继续覆盖更新当前 test.2 的 ZIP 资产，不另建新测试版；请以 GitHub Release 页当前 SHA256 为准。