Skip to content

WindowBack 0.2.0

Choose a tag to compare

@dct74 dct74 released this 13 Nov 14:52
· 4 commits to main since this release

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