# pointerfocus2

**Repository Path**: larntin/pointerfocus2

## Basic Information

- **Project Name**: pointerfocus2
- **Description**: 鼠标跟随高亮，点击，双击，右键点击时有简单效果，适合录屏讲解
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-01
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PointerFocus2

一个 PointerFocus 风格的演示辅助工具。**v1 实现「鼠标高亮」**：在系统光标周围
显示一个半透明实心圆，悬浮于所有窗口之上、实时跟随光标，适合演示、录屏、在线教学。

![图片描述](docs/images/p0.png)
![图片描述](docs/images/p1.png)
![图片描述](docs/images/p2.png)

windows 可执行文件下载：https://gitee.com/larntin/pointerfocus2/releases/download/1.1/pointerfocus2.zip

## 运行环境

- Windows 10 / 11
- .NET 6 桌面运行时（运行）/ .NET 6 SDK（编译）

## 构建与运行

```powershell
# 编译
dotnet build -c Release src/PointerFocus2/PointerFocus2.csproj

# 运行
dotnet run -c Release --project src/PointerFocus2/PointerFocus2.csproj
# 或直接运行编译产物
src/PointerFocus2/bin/Release/net6.0-windows/PointerFocus2.exe
```

## 使用

- 启动后默认开启高亮，光标周围出现黄色半透明圆圈。
- **Ctrl+F2**：开/关高亮（可在 config.json 改）。
- **系统托盘图标**：右键菜单「启用高亮 / 退出」，双击图标也可切换。

## 配置

首次运行会在可执行文件同目录生成 `config.json`，可编辑后重启生效：

```json
{
  "Color": "#FFFF00",        // 颜色，#RRGGBB 或 #AARRGGBB
  "Radius": 25,              // 半径（DIP）
  "Opacity": 0.4,            // 不透明度 0~1
  "Hotkey": "Ctrl+F2",       // 开关快捷键
  "EnabledOnStartup": true,  // 启动即开
  "PollingIntervalMs": 15    // 光标轮询间隔（毫秒）
}
```

## 测试

```powershell
dotnet test tests/PointerFocus2.Core.Tests/PointerFocus2.Core.Tests.csproj
```

## 已知限制

v1 保证单一 DPI（含相同缩放的多显示器）下坐标准确；混合 DPI 多屏留作后续。

## 设计文档

见 [`docs/superpowers/specs/2026-06-30-mouse-highlight-design.md`](docs/superpowers/specs/2026-06-30-mouse-highlight-design.md)。