Repository navigation
v0.6.2 - 无报错退出诊断增强与剪贴板恢复加固
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 升级
- 下载
SonicInput-v0.6.2-win64.exe。 - 关闭旧版本并替换可执行文件。
- 正常使用即可;若再次出现异常退出,请提供
%AppData%/SonicInput/logs/下诊断文件。
说明
- 输入策略未改为 sendinput 优先,剪贴板恢复功能保持。
- 若使用离线模型,继续保持 exe 与
models/同目录。
系统要求
最低: Windows 10 64-bit,4GB RAM,500MB 磁盘
推荐: Windows 11 64-bit,8GB RAM,1GB 磁盘(离线模型需额外空间)
支持
- 配置:
%AppData%/SonicInput/config.json - 日志:
%AppData%/SonicInput/logs/app.log - Issues:https://github.com/Oxidane-bot/SonicInput/issues
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, andfault.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 Qualityworkflow (lint / tests / security) passed.
Upgrade Steps
From v0.6.1
- Download
SonicInput-v0.6.2-win64.exe. - Close the old build and replace the executable.
- 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
- Config:
%AppData%/SonicInput/config.json - Logs:
%AppData%/SonicInput/logs/app.log - Issues: https://github.com/Oxidane-bot/SonicInput/issues
核心改进: v0.6.2 重点加固“无报错退出”相关路径,保留剪贴板恢复能力的同时提升崩溃可观测性。
Core Improvements: v0.6.2 hardens silent-exit paths and improves crash observability while preserving clipboard restore behavior.