# Floatingball

**Repository Path**: peisonghai/floatingball

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Floatingball

#### 介绍

Windows 悬浮球（Floating Ball）应用：桌面右侧常驻一个可拖拽悬浮球，悬浮时弹出快捷菜单；同时提供系统托盘（tray），收到消息时托盘闪烁，鼠标悬浮托盘显示消息弹窗。

#### 软件架构

- 文档：`docs/`
  - `docs/requirements.md`：需求说明（含待确认项）
  - `docs/design.md`：设计方案
  - `docs/dev-plan.md`：开发计划
- 代码（Go / Windows）：`cmd/`、`internal/`

#### 开发与运行（Windows）

1. 安装 Go（建议 1.21+；你当前环境为 Go 1.25.x 也可）
2. 运行：

```powershell
cd D:\work\gowork\floatingball
go run .\cmd\floatingball
```

3. 模拟收到消息（触发 tray 闪烁）：

```powershell
多条：powershell -NoProfile -ExecutionPolicy Bypass -File .\test_multi_notify.ps1
单条：powershell -NoProfile -ExecutionPolicy Bypass -File .\test_notify.ps1
```


#### 安装教程

1. `go build .\cmd\floatingball`
2. 双击运行 `floatingball.exe`

#### 使用说明

1. 启动后右侧出现悬浮球，可拖拽移动
2. 悬浮悬浮球弹出菜单，点击菜单进入二级弹窗
3. 调用 `/notify` 触发消息后 tray 闪烁；悬浮 tray 显示消息弹窗
4. 悬浮球图片：把你自己的图片替换为 `assets\\ball.png`（建议 PNG 透明背景），然后重启即可生效

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request