L-mimimi/WinPin

README excerpt

窗口置顶工具 WinPin 一个轻量级的 Windows 窗口置顶工具：按一下快捷键，把当前窗口"钉"在最前面；再按一下取消。纯 Python 标准库 + Win32 API 实现，无任何运行时依赖，打包为单个 exe 即可使用。 功能特性 - 全局快捷键置顶 ：默认 F8 置顶/取消当前活动窗口，可自定义任意组合键（如 Ctrl+Alt+P 、 F9 等） - 常驻状态提示 ：置顶中的窗口外圈会显示彩色边框（颜色、宽度可自定义），一眼看出哪些窗口被置顶 - 即时提示标签 ：置顶/取消时窗口旁弹出短暂的"已置顶 / 已取消置顶"提示标签（带淡入淡出动画） - 系统气泡通知 ：同步发送托盘气泡通知（可在设置中关闭） - 托盘图标 ：常驻系统托盘，图标随置顶状态变化（灰色=空闲，橙色=有窗口置顶） - 左键单击托盘图标：置顶/取消当前窗口 - 双击：打开设置 - 右键：菜单（置顶当前窗口 / 鼠标点选窗口置顶 / 取消全部 / 设置 / 开机自启 / 退出） - 鼠标点选模式 ：菜单选择"选择窗口置顶"后，移动鼠标到任意窗口（带蓝色预览边框和十字光标）， 光标旁跟随标签实时显示目标窗口名称 （"置顶 · 标题"蓝色 / "取消置顶 · 标题"橙色），单击即可置顶或取消，Esc/右键退出 - 多窗口同时置顶 ，互不干扰；窗口关闭后自动解除 - 开机自启 开关（写入注册表 HKCU\...\Run，不弹 UAC） - 配置自动保存 ：快捷键、边框颜色/宽度、提示开关等保存在 exe 同目录的 WinPin.config.json 使用方法 1. 双击运行 窗口置顶工具.exe （或 dist\WinPin.exe ），程序驻留系统托盘 2. 激活想要置顶的窗口，按 F8 （默认）→ 窗口边框变橙色并显示"已置顶"提示，此后它始终显示在其他窗口之上 3. 再次按 F8 （或点击托盘图标）取消置顶 4. 右键托盘图标 → 设置 可自定义快捷键、边框颜色/宽度、提示方式、开机自启 提示：无法置顶的窗口（桌面、任务栏、系统弹窗等）会自动被过滤并给出提示。 常见问题 - 双击后没有反应 / 进程自动结束 ： 1. 查看诊断日志：exe 同目录的 WinPin debug.log ，或 %TEMP%\WinPin.log （文件资源管理器地址栏输入 %TEMP% 回车即可打开该目录）。 2. 运行 WinPin debug.exe （诊断版，带黑色控制台窗口） ，控制台会逐行显示启动过程；若闪退，把控制台截图或日志文件内容发回即可定位问题。 3. 若日志里出现 another instance detected ：说明托盘区已有一个实例在运行，本次是正常退出而非崩溃（右键托盘图标→退出后再启动）。 4. 检查安全中心：Defender/第三方杀软可能拦截单文件 exe。加入信任…

Category