Mouse Flow (鼠标流光痕迹)

中文文档 | English

Mouse Flow 是一款运行在 Windows 平台上的轻量级鼠标痕迹工具，它能为你的鼠标光标添加类似“水果忍者”的炫酷拖尾效果。

✨ 功能特性

• 炫酷轨迹：平滑的“水果忍者”风格鼠标拖尾，支持自定义颜色和粗细。
• 点击波纹：鼠标点击时产生扩散的圆形波纹效果，支持自定义扩散速度和消失速度。
• 全局渲染：基于 Ebiten 游戏引擎，实现全屏幕（包括多显示器）的无边框透明覆盖，且不影响鼠标点击穿透。
• 多语言支持：配置界面支持中文和英文，可自动检测系统语言。
• 极低占用：经过深度优化，智能休眠（闲置时降低刷新率），极大减少 CPU/GPU 资源占用。
• 静默运行：程序启动后最小化至系统托盘，无任务栏图标干扰。
• 可视化配置：点击托盘图标即可弹出配置窗口，实时调整参数。
  • 🎨 颜色设置：自定义 RGB 颜色或开启“彩虹模式”。
  • 🌊 波纹设置：开关波纹效果，调节扩散和消失速度。
  • 📏 外观调整：自由调节轨迹的长度和宽度。

🚀 下载与安装

方式一：直接运行（推荐）

1. 在 Releases 页面下载最新的压缩包。
2. 解压所有文件到同一目录。
3. 运行 mouse_flow.exe。

方式二：源码编译

如果你是开发者，可以手动编译源码。

前置要求：

• Go 1.20+
• GCC 编译器 (用于 CGO，Windows 上推荐 TDM-GCC 或 MinGW-w64)

编译步骤：

# 1. 克隆仓库
git clone https://github.com/linfree/mouse-flow.git
cd mouse-flow

# 2. 下载依赖
go mod tidy

# 3. 编译 (建议使用 -H windowsgui 隐藏控制台窗口)
go build -ldflags="-H windowsgui" -o mouse_flow.exe

注意：

• 运行目录中必须包含 mouse_flow.exe.manifest 文件，否则配置窗口可能无法正常显示。

📖 使用说明

1. 启动：双击 mouse_flow.exe，屏幕上出现鼠标轨迹，系统托盘区会出现一个小图标。
2. 配置：
   • 右键点击托盘图标 -> 选择 配置 (Config)。
   • 或者直接左键点击托盘图标（如果有此交互）。
   • 在弹出的窗口中调整参数，点击 Save & Close 保存并生效。
3. 退出：右键点击托盘图标 -> 选择 退出 (Exit)。

⚙️ 配置文件

程序会在运行目录下生成 config.json，你也可以手动修改它：

{
  "tail_length": 20,      // 轨迹长度
  "tail_width": 8.0,      // 轨迹粗细
  "tail_color": [255, 0, 0, 255], // RGBA 颜色 (0-255)
  "is_rainbow": false,    // 是否开启彩虹模式
  "decay_speed": 0.95,    // 衰减系数
  "is_ripple": true,      // 是否开启点击波纹
  "ripple_growth_speed": 3.0, // 波纹扩散速度
  "ripple_decay_speed": 0.04, // 波纹消失速度
  "ripple_width": 5.0,    // 波纹线条宽度
  "language": "auto"      // 语言设置 ("auto", "zh", "en")
}

🛠️ 技术栈

• Ebiten - 2D 游戏引擎，用于高性能渲染。
• Walk - Windows GUI 库，用于创建原生配置窗口。
• Win API - 处理底层窗口消息、托盘图标和多显示器支持。

🤝 贡献

欢迎提交 Issue 或 Pull Request！

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的修改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。