Skip to content

Add plugin 聚光灯 v1.0.0 - #487

Merged
lzx8589561 merged 1 commit into
ZToolsCenter:mainfrom
Reaosen:plugin/spotlight
Sep 2, 2026
Merged

Add plugin 聚光灯 v1.0.0#487
lzx8589561 merged 1 commit into
ZToolsCenter:mainfrom
Reaosen:plugin/spotlight

Conversation

@Reaosen

@Reaosen Reaosen commented Sep 1, 2026

Copy link
Copy Markdown

插件信息

  • 名称: 聚光灯
  • 插件ID: spotlight
  • 版本: 1.0.0
  • 描述: 屏幕聚光灯:一键全屏变暗,光圈平滑跟随鼠标,演示录屏时聚焦视线
  • 作者: Reaosen
  • 类型: 新增

本次变更

Added

  • 聚光灯核心效果:全屏变暗,圆形亮区跟随鼠标指针平滑移动(rAF 插值 + 合成器位移)
  • 入场动画:黑幕从屏幕四角向鼠标位置收拢,退出时淡出
  • 多显示器支持:每块屏幕独立遮罩窗口,光圈跨屏平滑跟随,兼容不同分辨率 / DPI 缩放
  • 设置页:光圈大小(60–600px)、背景暗度(30%–95%)、边缘柔化(0–150px)实时预览调节
  • 开关项:点击屏幕任意处退出、多屏覆盖
  • 快捷键引导:一键跳转 ZTools 全局快捷键设置页(redirectHotKeySetting)
  • 退出方式:Esc / 点击 / 切换窗口(Alt+Tab)自动退出,多窗口 localStorage 令牌联动
  • 显示器诊断:设置页展示检测到的屏幕数量、分辨率、坐标与缩放比
  • macOS 适配:遮罩窗口在所有桌面 Space 及全屏 App 之上可见

截图 / 演示

效果演示

演示视频

设置页面

设置页面

自检清单

  • plugin.json 的 name / title / version / description / author 字段均已检查
  • 已移除调试日志、未使用文件、敏感信息(.env、token、密钥等)
  • 本次 PR 的 diff 仅涉及 plugins/spotlight/ 目录
  • 已在本地 ZTools 客户端实际加载并测试过此插件,主要功能正常
  • 同意以仓库声明的开源协议发布此插件

此 PR 由 ztools-plugin-cli 自动管理:每次 ztools publish 在分支上追加一个 commit,PR 链接保持不变。

- Add plugin spotlight v1.0.0
- feat: spotlight 功能声明 mainHide 进入时自动隐藏主窗口
- fix: 聚光灯开启后重进主窗口时恢复设置页显示,避免残留黑色区域
- feat: 聚光灯退出后自动 outPlugin,重开 ZTools 回到搜索页
@Reaosen
Reaosen marked this pull request as ready for review September 1, 2026 03:21
@lzx8589561
lzx8589561 merged commit aeb93e0 into ZToolsCenter:main Sep 2, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants