Topit 上手指南5 分钟让任何窗口乖乖悬浮在屏幕最上层【免费下载链接】TopitPin any window to the top of your screen / 在Mac上将你的任何窗口强制置顶项目地址: https://gitcode.com/gh_mirrors/to/Topit屏幕就那么大窗口却总爱叠罗汉——写文档要对照资料时来回切换最磨人。Topit 是一款开源的免费 macOS 小工具核心功能一句话把任意应用的窗口「钉」在屏幕最上层随时看、随时点多窗口工作从此不再手忙脚乱。下面这份指南带你从零开始把它用起来。它和系统自带的「置顶」到底差在哪很多人以为这只是个让窗口永远在最前的小开关其实不然。系统级的置顶通常只给窗口加一个层级标记窗口一失去焦点就半透明、反应迟钝体验很别扭。Topit 走的是另一条路用 macOS 13 引入的 ScreenCapture Kit 框架对目标窗口做硬件加速的实时画面捕获再投放到一个无边框悬浮层里。打个比方相当于给那个窗口开了场实时直播再把直播画面投射到一块透明的玻璃板上——画面是活的你能点、能滚、能打字和原生窗口几乎没有差别。而且这块玻璃板想开几块就开几块置顶数量不设上限钉三个、四个都行。更难得的是开销很低。捕获工作交给系统底层管线同时钉住三四个窗口CPU 占用也维持在很小的范围。这套核心逻辑全部收敛在 Topit/Supports/SCManager.swift 里负责流的创建、配置、帧率上限和错误恢复算是整套机制的心脏。因为要用系统级捕获能力首次启动时 Topit 会向你索要两类权限屏幕录制权限捕获窗口内容和辅助功能权限读取窗口列表、模拟交互。这是 macOS 安全机制的正常要求按提示在「系统设置 → 隐私与安全性」里各授予一次即可。装好它第一分钟怎么跑通安装非常简单终端里执行一条命令brew install lihaoyun6/tap/topit想自己折腾源码也可以把仓库克隆下来用 Xcode 编译运行git clone https://gitcode.com/gh_mirrors/to/Topit装好后按下面三步走第一分钟就能看到效果第 1 步打开 Topit主界面会以缩略图网格的形式展示当前所有打开的窗口左上角有搜索框窗口多时按标题快速筛选。第 2 步单击选中目标窗口的缩略图右上角的按钮会变成蓝色操作入口中文界面显示为「立即置顶」点下去窗口就被钉住了。第 3 步回到桌面看一眼——被钉住的窗口已经浮在最上层右上角多了一条小小的控制条拖动、缩放都随你。整个过程无需任何脚本和配置点击即用。窗口一多怎么一眼锁定目标开了一堆窗口时网格列表反而容易让人眼花。这时候有三个小技巧很好用搜索筛选左上角搜索框按标题过滤输入关键词立刻缩小范围。刷新列表右上角的刷新按钮重新拉取窗口列表新开的窗口马上出现。直接选择懒得在缩略图里翻找的话可以用「直接选择」模式——它注册了全局鼠标监听鼠标悬停到哪个窗口上列表就高亮哪个比肉眼找缩略图直观得多。这个功能由 Topit/ViewModel/WindowHighlighter.swift 实现。图片里能看到一个细节已经被置顶的窗口缩略图右上角会带绿色对勾标记。哪些在顶层、哪些还没处理一眼就能分清。置顶之后这个悬浮窗都听你的被钉住的窗口上那条控制条藏着三个按钮取消置顶、暂停、关闭。其中「暂停」尤其贴心——比如你暂时不想让这个窗口浮在最上面点一下暂停它就安静地退回去想恢复再点一下即可。更多交互细节在设置面板里对应源码 Topit/ViewModel/OverlayView.swift几个实用开关值得一说激活方式默认鼠标悬停到置顶窗口就激活也可以改成单击激活。如果你经常跨窗口连续打字还能开启「防止焦点切换」避免鼠标掠过悬浮窗时键盘输入被打断。控制条位置控制条可以放在悬浮窗的四个角怎么顺手怎么摆。加边框给置顶窗口加一圈边框明确这块是置顶的半透明窗口尤其需要。它会挡我干活吗比你想的更懂礼貌这是我最喜欢的设计之一。当你正在某个窗口里专注操作时置顶窗口会自动「让位」凡是与当前活动窗口重叠的置顶窗口Topit 会自动把它们暂时隐藏等鼠标回到置顶窗口上再出现。就像合租的室友看到你在忙主动把客厅让出来。这套活动窗口区域的追踪逻辑由 Topit/ViewModel/OverlayView12.swift 维护。画面表现上也处处用心深色模式下悬浮窗自动跟随系统主题夜间使用不刺眼。另外「窗口」设置页里还有个最大刷新率选项30 / 60 / 120 Hz 或不限。如果置顶的窗口以静态内容为主比如文档、表格把帧率调到 30 Hz省电效果立竿见影。能不能彻底摆脱鼠标能Topit 的快捷键页基于 KeyboardShortcuts 库实现一共提供 5 个可自定义的组合键常用操作都能脱离鼠标快捷键功能作用Select a Window to Pin弹出一个窗口让你选择置顶目标Open Window Selector打开窗口选择器主面板Pin / Unpin Under-Mouse Window置顶 / 取消置顶鼠标下的窗口Pin / Unpin Frontmost Window置顶 / 取消置顶当前最前面的窗口Unpin All Pinned Windows一键取消所有置顶还有个容易被忽略的「应用过滤」页对应 Topit/ViewModel/AppBlockSelector.swift。它维护一个应用黑名单被拉黑的 App 不会出现在选择列表里「不显示无标题窗口」这个开关也能让列表更清爽。比如有些辅助工具的窗口你永远不想置顶直接屏蔽掉选择器界面立刻干净不少。顺带一提Topit 的本地化做得很完整简体中文、繁体中文和英文界面随系统语言自动切换语言资源都放在 Topit/zh-Hans.lproj/Localizable.strings 这类路径下中文用户没有任何门槛。值得提前知道的 3 个边界任何工具都有适用范围提前了解能少走弯路系统版本有要求。核心依赖 ScreenCapture Kit 是 macOS 13 才引入的框架官方要求 macOS 13.0 及以上更老的系统上部分能力会缺失体验不完整。权限是硬门槛。屏幕录制和辅助功能两项缺一不可中途遇到「捕获失败」的报错优先回去检查权限是不是被系统重置或关闭了。多窗口置顶会带来功耗。单窗口开销很低但钉住的窗口一多笔记本续航还是会受影响——建议只钉高频使用的窗口刷新率调到够用就好。另外有个 macOS 层面的现象值得留意部分系统版本下窗口被捕获置顶期间系统通知的弹出可能会被暂停。这是系统对 ScreenCapture Kit 会话的处理方式并非 Topit 的缺陷。常见问题速查窗口列表里找不到某个窗口点击右上角刷新按钮重新拉取列表依然看不到就确认该窗口确实处于打开状态并检查它是否被加入了「应用过滤」黑名单。置顶窗口点了没反应先确认权限是否完整再检查「窗口」页的激活方式——如果选的是单击激活第一次点击只是获得焦点需要再点一下才能操作。觉得占资源把「窗口」页的最大刷新率调低同时减少同时置顶的窗口数量体感会明显改善。报错信息反复出现退出 Topit 后重新打开或到系统设置里关闭再重新开启相关权限大多数捕获异常都能这样恢复。Topit 的价值不在于功能列表有多长而在于它把「窗口永远在眼前」这件事做得足够自然。写代码时把 API 文档钉在侧边做设计时把参考图钉在主画布旁写材料时把资料页钉在顺手的位置——一旦这些动作变成习惯「切换窗口」在一天里出现的频率会骤降注意力也因此更连贯。工具是开源的仓库里既有完整源码也有多语言文档感兴趣就下载体验遇到问题或有好点子也欢迎到仓库反馈、参与讨论。把屏幕的每一寸都用好有时候只需要一个正确的置顶。【免费下载链接】TopitPin any window to the top of your screen / 在Mac上将你的任何窗口强制置顶项目地址: https://gitcode.com/gh_mirrors/to/Topit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考