Phantomat

Phantomat 把桌面当成一个有相机的场景，把 Hyprland 当成借来的渲染器。每个被管理的窗口在世界坐标里有一个盒子；每台显示器持有相机偏移和缩放；渲染路径画出每台相机看到的那一块。插件没有重写合成器。它钩住画工作区、排帧、路由 surface damage、摆 popup 的那几个函数，用画布场景换掉工作区场景。这个选择保住了 Hyprland 的窗口模型、输入路由和协议支持，也把维护负担压在它钩住的那些内部函数签名上。画布层被拆成职责很窄的模块：Navigator 管搜索和选择，Hud 管覆盖层，BarrelShader 管透镜，Memory 管持久化，Config 管 Lua 设置面，Window 管 X11 和弹窗的坐标翻译。最大的文件 scrollOverview.cpp 仍然是画布状态和渲染循环碰头的地方。

main.cpp

插件入口和生命周期。声明 14 个 CFunctionHook 指针，装上和卸下，暴露 PLUGIN_API_VERSION；已经有别的预览插件占着钩子时，弹一条通知然后失败。

scrollOverview.cpp / scrollOverview.hpp

画布本身：CScrollOverview，每台显示器一个，持有相机偏移、缩放、窗口盒子、联屏相机共享、全屏、填充和固定状态、渲染循环和输入转发。.cpp 有 9,305 行。

Navigator.cpp

打字查找：折叠文字，按标题、类名、分类给词打分，排序，画应用图标，实现方向键的几何规则和 Alt-Tab 切换。

Hud.cpp / Tuning.cpp

覆盖层和实时调参：面板、小地图、按键表、四角读数，以及把每次调整写进调参 Lua 文件的设置清单。

BarrelShader.cpp / shaders/barrel.frag

最终 pass 的透镜：桶形畸变、边缘模糊、暗角、红蓝边缘；HUD 和小地图在畸变之后合成。

Memory.cpp

布局持久化：XDG_STATE_HOME 下的 TSV 文件，最多 96 个窗口条目，每台显示器一个相机，读进来的每个值都做合理性检查。

Config.cpp / examples/spatialoverview.lua

Lua 设置面：plugin.spatialoverview 下的 96 个配置值和六个 Lua 函数，外加安装脚本复制的示例配置。

tests/ and scripts/

17 个嵌套 Python 测试和 C 辅助程序，加上安装、卸载和安全卸载脚本。

依据kaolti/phantomat 的 main 分支（2026-11-02 读取）：README.md、docs/window-rules.md、main.cpp、scrollOverview.cpp、scrollOverview.hpp、Navigator.cpp、Memory.cpp、Config.cpp、BarrelShader.cpp、shaders/barrel.frag、Hud.cpp、Tuning.cpp、Window.cpp、tests/、scripts/install.sh、hyprpm.toml、CMakeLists.txt、examples/spatialoverview.lua；另读 GitHub API 里的九个提交信息和文件清单。