# 置顶校时器

**Repository Path**: ahkeng/top-timer

## Basic Information

- **Project Name**: 置顶校时器
- **Description**: 这是一个简单而实用的置顶时钟应用程序，使用Go语言和Fyne框架开发，专为Windows系统设计。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-04
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 置顶校时器 (Topmost Timer)

这是一个简单而实用的置顶时钟应用程序，使用Go语言和Fyne框架开发，专为Windows系统设计。

## 功能特点

- ⏰ **实时显示**：显示当前时间和日期
- 🔝 **窗口置顶**：始终保持在其他窗口上方
- 🚫 **禁止最小化**：防止意外最小化
- 🔄 **单实例运行**：确保只运行一个时钟窗口
- 🖼️ **无控制台窗口**：作为纯GUI应用程序运行，无多余黑框

## 预览

![应用预览](preview.png)

## 技术栈

- **编程语言**：Go
- **GUI框架**：Fyne
- **构建工具**：Go编译器

## 安装方法

### 方法一：直接使用预编译的可执行文件

1. 下载仓库中的 `timer.exe` 文件
2. 双击运行即可

### 方法二：从源代码构建

1. 确保已安装 Go 环境（推荐 Go 1.18+）
2. 克隆仓库：
   ```bash
   git clone https://gitee.com/ahkeng/top-timer.git
   cd timer
   ```
3. 安装依赖：
   ```bash
   go mod download
   ```
4. 构建应用程序（无控制台窗口版本）：
   ```bash
   go build -ldflags -H=windowsgui -o timer.exe main.go
   ```

## 使用说明

- 启动应用程序后，时钟窗口会自动置顶显示
- 窗口标题为"置顶层校时器"
- 窗口不能最小化，始终保持可见
- 程序会自动管理实例，避免重复运行

## 开发说明

### 项目结构

```
timer/
├── go.mod        # Go模块定义
├── go.sum        # 依赖校验和
├── main.go       # 主程序代码
└── timer.exe     # 编译后的可执行文件
```

### 主要功能实现

- 使用 Fyne 框架创建 GUI 界面
- 利用 `app.NewWithID` 实现单实例运行
- 通过 `window.SetTopWindow(true)` 设置窗口置顶
- 使用 `go build -ldflags -H=windowsgui` 构建无控制台窗口版本

## 许可证

MIT License

## 贡献

欢迎提交 Issues 和 Pull Requests！