# FocusBox

**Repository Path**: tugodxx/FocusBox

## Basic Information

- **Project Name**: FocusBox
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FocusBox 🦊

macOS 屏幕演示高亮工具 - 通过拖动鼠标绘制彩色渐变矩形框，让屏幕演示更清晰！

## ✨ 功能特性

- 🎨 **随机渐变边框** - 每次拖动生成独特的渐变色彩
- 🖱️ **简单易用** - 按住鼠标左键拖动即可绘制
- ⏱️ **可调节淡出** - 自定义矩形框停留时间（0.5-5 秒）
- 📱 **触摸板支持** - 完美支持 MacBook 触摸板
- 🎯 **全局监听** - 在任何应用上都能使用
- 🎬 **屏幕录制** - 一键录制整个屏幕（MP4 格式）
- ✨ **智能穿透** - 绘制完成后自动释放鼠标，不影响其他应用操作
- 🚀 **状态栏快捷切换** - 点击状态栏图标快速启用/禁用
- 🚫 **避免选中下层内容** - 框选时不会选中其他应用的内容

## 🚀 使用方法

1. 运行 FocusBox 应用
2. 在任意位置**按住鼠标左键拖动**
3. 看到彩色矩形框后**松开鼠标**
4. 矩形框会在设定时间后自动消失

## ⌨️ 快捷键

| 快捷键 | 功能 |
|--------|------|
| `⌘+⇧+F` | 启用/暂停绘制功能 |
| `⌘+⇧+R` | 开始/停止屏幕录制 |
| `⌘+S` | 打开设置窗口 |
| `⌘+Q` | 退出应用 |

## 📦 构建

```bash
./build.sh
```

构建完成后，应用位于 `build/FocusBox.app`

## ⚠️ 权限要求

首次运行需要授予**辅助功能权限**：

1. 打开 **系统设置** → **隐私与安全性** → **辅助功能**
2. 添加 FocusBox 并启用权限

录制功能需要**屏幕录制权限**：

1. 打开 **系统设置** → **隐私与安全性** → **屏幕录制**
2. 添加 FocusBox 并启用权限

## 🛠️ 技术栈

- Swift 5
- AppKit
- SwiftUI (设置界面)
- AVFoundation (屏幕录制)

## 📝 说明

- **状态栏图标**：右上角虚线矩形图标
- **设置窗口**：启动时自动显示
- **日志文件**：`/tmp/focusbox.log`
- **录制文件**：保存在 `~/Downloads/FocusBox_<时间戳>.mp4`

## 🎨 颜色主题

- 🌈 彩虹 - 多彩渐变
- 🌊 海洋 - 蓝色系渐变
- 🌅 日落 - 橙红色系渐变
- 🌲 森林 - 绿色系渐变
- ⚫ 单色 - 黑白灰渐变

## 📊 版本历史

### v1.6 (2026-03-11) 🎉
- ✅ **修复鼠标事件穿透问题** - 绘制完成后自动释放鼠标控制权
- ✅ **智能事件管理** - 只在绘制时捕获事件，平时穿透到下层应用
- ✅ **优化用户体验** - 松开鼠标后可立即操作其他应用

### v1.5 (2026-03-11)
- ✅ 修复覆盖层阻塞其他应用操作的问题
- ✅ 优化鼠标事件处理逻辑
- ✅ 版本更新：1.0.0 → 1.5

### v1.0.0 (2026-03-11)
- ✅ 鼠标/触摸板拖动绘制渐变边框
- ✅ 5 种颜色主题选择
- ✅ 边框粗细调节（2-20px）
- ✅ 淡出延迟调节（0.5-5 秒）
- ✅ 全局快捷键切换
- ✅ 屏幕录制功能（MP4）
- ✅ 状态栏菜单
- ✅ 系统通知

---

**Made with ❤️ by 老 A**