Skip to content

v0.6.2 - 无报错退出诊断增强与剪贴板恢复加固

Choose a tag to compare

@Oxidane-bot Oxidane-bot released this 23 Feb 09:59
· 63 commits to master since this release

v0.6.2 - 无报错退出诊断增强与剪贴板恢复加固

中文

亮点

稳定性(无报错退出)

  • 修复一类“无报错直接退出”问题:针对剪贴板多格式恢复流程增加格式白名单与数据类型/大小校验,降低 Win32 堆损坏风险(0xc0000374)。
  • 保留剪贴板恢复能力,不回退为慢速输入模式;仅跳过高风险/未知剪贴板格式,优先保障主流程可用性。

崩溃诊断

  • 启动期与运行期新增崩溃诊断标记:runtime_state.json、crash.log、fault.log。
  • 接入 faulthandler、sys.excepthook、threading.excepthook 与退出阶段标记,提升“异常退出但无日志”场景的可追踪性。

测试与质量

  • 新增剪贴板恢复安全测试与运行时诊断测试,覆盖关键回归路径。
  • Code Quality 工作流(lint / tests / security)已通过。

升级步骤

从 v0.6.1 升级

  1. 下载 SonicInput-v0.6.2-win64.exe。
  2. 关闭旧版本并替换可执行文件。
  3. 正常使用即可;若再次出现异常退出,请提供 %AppData%/SonicInput/logs/ 下诊断文件。

说明

  • 输入策略未改为 sendinput 优先,剪贴板恢复功能保持。
  • 若使用离线模型,继续保持 exe 与 models/ 同目录。

系统要求

最低: Windows 10 64-bit,4GB RAM,500MB 磁盘
推荐: Windows 11 64-bit,8GB RAM,1GB 磁盘(离线模型需额外空间)

支持


English

Highlights

Stability (silent exits)

  • Hardened clipboard multi-format restore with allowlist checks and data type/size validation to reduce Win32 heap-corruption risk (0xc0000374).
  • Clipboard restore is preserved (no forced fallback to slow input mode); only risky/unknown clipboard formats are skipped.

Crash diagnostics

  • Added runtime crash markers and files: runtime_state.json, crash.log, and fault.log.
  • Integrated faulthandler, sys.excepthook, threading.excepthook, and shutdown-stage markers for better post-mortem visibility.

Testing & quality

  • Added tests for clipboard-restore safety and runtime diagnostics.
  • Code Quality workflow (lint / tests / security) passed.

Upgrade Steps

From v0.6.1

  1. Download SonicInput-v0.6.2-win64.exe.
  2. Close the old build and replace the executable.
  3. Continue normal usage; if silent exits recur, share diagnostics under %AppData%/SonicInput/logs/.

Notes

  • Input strategy was not changed to sendinput-first; clipboard restore remains enabled.
  • For offline usage, keep the exe and models/ folder together.

System Requirements

Minimum: Windows 10 64-bit, 4GB RAM, 500MB disk
Recommended: Windows 11 64-bit, 8GB RAM, 1GB disk (extra space needed for offline models)

Support


核心改进: v0.6.2 重点加固“无报错退出”相关路径,保留剪贴板恢复能力的同时提升崩溃可观测性。
Core Improvements: v0.6.2 hardens silent-exit paths and improves crash observability while preserving clipboard restore behavior.