Repository navigation
WindowBack 0.2.0
0.2.0
它解决什么
合盖工作、拔掉外接显示器、开盖解锁 —— macOS 会把窗口坐标留在已经消失的那块屏上,标题栏拖不到。WindowBack 在亮屏/解锁后把出界的窗口收回内屏。
能力
- 监听显示器重配置(
CGDisplayRegisterReconfigurationCallback)+ AppKit 屏幕参数通知,熄屏→亮屏也算拓扑变化 - 亮屏
screensDidWake、解锁com.apple.screenIsUnlocked(外加 0.5s 轮询兜底)都触发归位 - 归位分多趟(0.1 - 4 秒内),每趟幂等:只处理当时确实出界的窗口
- 最小化窗口也会预先摆正:由
AXObserver监听AXWindowDeminiaturized,恢复后不会跑出去 - 跨两块屏幕摆放的窗口不会被误判为出界
- 单趟归位约 0.2s:CG 窗口表定位,AX 只补标题/最小化状态,且只查询有窗口的进程
- 菜单栏常驻、开机启动(
SMAppService)、JSONL 日志 +scripts/analyze.py
安装
下载 WindowBack-0.2.0.zip,解压后拖进 /Applications,然后:
系统设置 → 隐私与安全性 → 辅助功能 → + 添加 WindowBack.app
已知限制
- ad-hoc 签名,每次重新编译都会让辅助功能授权和开机启动失效
- 锁屏期间不做归位,解锁后立即补一次
- 依赖辅助功能 API,不能上架 App Store